前言

最近想上手Claude Code，但翻了不少教程要么默认海外环境，要么步骤零散，配置时总卡在API连接或环境依赖上。
作为非专业开发者，最缺的就是一篇能直接跟着做的完整实操文。今天就分享下在macOS上从0到1安装Claude Code，并通过API中转实现国内直连的全过程，每个步骤都亲测过，希望帮你少走弯路，快速用上这个工具。

正文

一、安装Node.js

Claude Code运行需要Node.js环境，最低要求Node.js ≥18（建议安装LTS版本，稳定性更好）。

方法一：官网下载

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

方法二：Homebrew安装（推荐）

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

brew install node

验证安装

安装完成后，打开终端输入以下命令检查版本，确保Node.js和npm都已正确安装：

node --version  # 应显示v18.x.x或更高
npm --version   # 通常随Node.js一起安装

二、安装Claude Code

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

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

验证安装

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

claude --version

三、配置API连接

要使用Claude Code，需要配置API密钥和连接地址。这里以API中转方案为例（国内可直连，无需海外账户）。

前提：获取API Key

我这次选择88api作为中转接口（官网：https://api.88api.shop），主要是它支持国内直连，无需翻墙和海外账户，还能统一管理多个模型的API Key，减少环境配置的麻烦。

有额度推荐大家可以试试，或者大家也可以用自己的。

下面以88API 为例：

1.注册并登录后，点击侧边栏“API令牌”。

2. 点击“添加令牌”

3. 选择分组
   1. 根据需要调用的模型选择分组
      a. claude 模型建议使用 calude code 分组、
      b. gpt 模型建议使用 codex分组
   2. 可通过平台的模型广场查看不同模型支持的分组
   3. 若在使用中出现上游分组饱和，请切换分组使用
      

4.点击提交

5. 点击复制按钮复制API令牌，也就是API KEY

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

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

配置文件路径：

~/.claude/settings.json

配置内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",  // 替换为实际复制的API Key
    "ANTHROPIC_BASE_URL": "https://api.88api.shop"  // 中转接口地址
  }
}

创建步骤：

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

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

粘贴上述配置内容，按Ctrl+O保存，Ctrl+X退出编辑器。

方法二：环境变量

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

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

export ANTHROPIC_BASE_URL="https://api.88api.shop"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"  // 替换为实际API Key

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

export ANTHROPIC_BASE_URL="https://api.88api.shop"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"  // 替换为实际API Key

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

source ~/.zshrc

⚠️ 注意：请务必将"你的API密钥"替换为实际获取的API Key。配置完成后需重启终端，若在VS Code/Cursor等IDE的集成终端使用，需彻底重启IDE（仅重启终端可能不生效）。

VSCode插件配置（可选）

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

配置文件路径：

~/.claude/config.json

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤：

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

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

粘贴上述内容保存即可（注意：此文件与命令行工具的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和Base URL是否配置正确。

总结

到这里，macOS上Claude Code的安装和API配置就完成了。核心要点：Node.js版本需≥18，通过配置文件或环境变量正确设置API密钥和中转地址，遇到连接问题时用.claude.json跳过引导。整个过程不算复杂，跟着步骤走基本能一次成功。如果操作中遇到其他问题，欢迎在评论区留言，一起交流解决~