Claude Code — macOS 安装配置
本指南帮助你在 macOS 上安装并配置 Claude Code，接入 TinyPx API 服务。
前置要求
- macOS 10.15 (Catalina) 或更高版本
- Node.js 18.0 或更高版本
- npm 或 Homebrew 包管理器
步骤 1：安装 Node.js
方法 1：Homebrew（推荐）
bash
# 安装 Homebrew（如果未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装 Node.js
brew install node方法 2：官网下载
访问 nodejs.org 下载并安装 macOS 版本。
验证安装：
bash
node --version
npm --version步骤 2：安装 Claude Code CLI
bash
sudo npm install -g @anthropic-ai/claude-code或使用 Homebrew：
bash
brew install --cask claude-code验证安装：
bash
claude --version步骤 3：配置 API 端点
创建配置目录：
bash
mkdir -p ~/.claude
cd ~/.claude创建 settings.json：
bash
cat > ~/.claude/settings.json << 'EOF'
{
"env": {
"ANTHROPIC_API_KEY": "粘贴为 Claude Code 专用分组令牌 key",
"ANTHROPIC_BASE_URL": "https://ai.tinypx.cn"
},
"model": "填写该 Claude Code 分组支持的模型名"
}
EOF或用文本编辑器手动创建同样内容的文件。
注意端点格式
Claude Code 不带 /v1 后缀 —— 使用 https://ai.tinypx.cn， 而不是 https://ai.tinypx.cn/v1。详见 API 端点说明。
具体可用模型请到 模型广场 查阅对应分组支持的 model。
步骤 4：设置 API 密钥
方法 1：环境变量（推荐）
Zsh（macOS 默认）：
bash
echo 'export ANTHROPIC_API_KEY="你的 TinyPx API 令牌"' >> ~/.zshrc
source ~/.zshrcBash：
bash
echo 'export ANTHROPIC_API_KEY="你的 TinyPx API 令牌"' >> ~/.bash_profile
source ~/.bash_profile方法 2：写进配置文件
json
{
"env": {
"ANTHROPIC_API_KEY": "你的 TinyPx API 令牌",
"ANTHROPIC_BASE_URL": "https://ai.tinypx.cn"
},
"model": "填写该 Claude Code 分组支持的模型名"
}设置文件权限（重要）：
bash
chmod 600 ~/.claude/settings.json安全提示
chmod 600 确保只有你本人能读取存有 API 密钥的文件。
步骤 5：验证配置
bash
claude "你好，请介绍一下你自己"VSCode 集成（可选）
- 打开 VSCode
- 按
Cmd+Shift+X打开扩展面板 - 搜索 "Claude Code"
- 点击安装
安装扩展后继续使用前面的 ~/.claude/settings.json 即可，不需要单独填写 claude.apiBaseUrl 或 claude.apiKey。
常用命令
bash
# 启动交互式会话
claude
# 非交互式输出
claude --print "请审查 src/ 目录并列出主要问题"
# 查看帮助
claude --help故障排除
权限被拒绝
安装时使用 sudo：
bash
sudo npm install -g @anthropic-ai/claude-code命令未找到
bash
npm config get prefix
echo $PATH如果 npm 全局路径不在 $PATH 中，加进 shell 配置：
bash
# Zsh
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.zshrc
source ~/.zshrc
# Bash
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.bash_profile
source ~/.bash_profileAPI 连接失败
- 检查网络连接
- 验证密钥：
echo $ANTHROPIC_API_KEY - 确认配置：
cat ~/.claude/settings.json - 确认端点是
https://ai.tinypx.cn（不带/v1）
Apple Silicon（M 系列芯片）兼容性
bash
arch -x86_64 npm install -g @anthropic-ai/claude-code配置代理（如需要）
bash
export HTTP_PROXY="http://proxy.example.com:8080"
export HTTPS_PROXY="http://proxy.example.com:8080"下一步
提示
macOS 用户推荐用 Homebrew 安装和管理，更新方便：brew upgrade claude-code