前言

AI工具更新快，环境配置却常成拦路虎——要么教程零散，要么海外环境不会搞。其实Claude Code的安装配置没那么复杂，选对API方案就能省心不少。

这篇文章带你在macOS上从Node.js开始，一步步搞定Claude Code安装，用API中转实现国内直连，避开常见的连接报错问题。

正文

一、安装Node.js

Claude Code运行依赖Node.js环境，最低要求Node.js ≥18（建议安装LTS版本）。

方法一：官网下载（推荐）

访问Node.js官网下载LTS版本，双击安装包按向导完成安装即可。

方法二：Homebrew安装

如果已安装Homebrew，可直接在终端执行：

brew install node

验证安装

安装完成后，在终端输入以下命令，出现版本号即表示安装成功：

node --version
# 输出示例：v20.11.0

npm --version
# 输出示例：10.2.4

二、安装Claude Code

Node.js环境准备好后，通过npm全局安装Claude Code：

npm install -g @anthropic-ai/claude-code

验证安装

安装完成后，输入以下命令检查版本：

claude --version

若能正常显示版本号，说明安装成功。

三、配置API连接

使用Claude Code需要配置API密钥，这里以88api为例（国内直连，支持多模型统一管理，减少环境配置步骤）。

获取API KEY

1. 访问88api (https://api.88api.shop)，注册登录以后，点击侧边栏的 “API 令牌”

2. 点击"添加令牌"

3. 创建令牌，名称随意，直接提交

4. 获取 API Key，注意妥善保管，不要公开或分享。

5. 点击"知道了"，在令牌列表中可以点击"复制"按钮获取 API Key

方法一：配置文件（推荐）

通过配置文件永久保存API信息，步骤如下：

配置文件路径：

~/.claude/settings.json

配置内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://api.88api.shop"
  }
}

创建步骤：

# 创建.claude目录（如已存在可跳过）
mkdir -p ~/.claude

# 创建并编辑配置文件
nano ~/.claude/settings.json

粘贴上述配置内容，将“你的API密钥”替换为实际Key，按Ctrl+O保存，Ctrl+X退出编辑器。

方法二：环境变量

若不想使用配置文件，可通过环境变量临时或永久配置：

临时设置（当前终端有效）：

export ANTHROPIC_BASE_URL="https://api.88api.shop"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

永久设置：
将以下内容写入~/.zshrc（或你的shell配置文件，如.bashrc）：

export ANTHROPIC_BASE_URL="https://api.88api.shop"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

保存后执行以下命令使配置生效：

source ~/.zshrc

⚠️ 注意：请将"你的API密钥"替换为实际生成的Key；配置完成后需重启终端，若在VS Code等IDE的集成终端使用，需彻底重启IDE才能生效。

VSCode插件配置（可选）

如果使用VSCode的Claude插件，需额外创建专用配置文件：

配置文件路径：

~/.claude/config.json

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤：

# 创建.claude目录（如已存在可跳过）
mkdir -p ~/.claude

# 创建并编辑配置文件
nano ~/.claude/config.json

粘贴上述内容并保存（Ctrl+O保存，Ctrl+X退出）。

⚠️ 注意：此文件（config.json）是VSCode插件专用，与Claude Code命令行工具的配置文件（settings.json）是两个独立文件。

四、开始使用

配置完成后，在终端输入以下命令启动Claude Code：

claude

若需查看命令说明，可执行：

claude --help

五、常见问题排查

问题1：Unable to connect to Anthropic services

症状：启动Claude Code后提示无法连接服务。

解决方案：通常是首次启动引导未完成，需创建.claude.json文件跳过引导：

配置文件路径：

~/.claude.json

配置内容：

{
  "hasCompletedOnboarding": true
}

创建方法：

cat > ~/.claude.json << 'EOF'
{
  "hasCompletedOnboarding": true
}
EOF

验证文件是否创建：

cat ~/.claude.json

重启Claude Code即可。

💡 调试技巧：若仍无法连接，可检查网络、重启终端/IDE，或确认API Key配置是否正确（参考“配置API连接”章节）。

总结

以上就是macOS环境下Claude Code的完整安装配置流程。核心在于Node.js环境准备和API中转配置，避开网络连接问题。按步骤操作，国内用户也能顺利使用Claude Code。如果遇到其他报错，欢迎在评论区留言交流，一起解决~