前言

作为踩过不少坑的开发者，我整理了这篇macOS系统下的完整实操教程，从Node.js安装到API配置，再到常见问题解决，尽量把每个步骤讲清楚，帮你少走弯路。

正文

一、准备工作：安装Node.js

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

方法一：官网下载安装

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

方法二：Homebrew安装（推荐）

如果你常用Homebrew管理软件，直接在终端执行：

brew install node

验证安装是否成功

安装完成后，打开终端输入以下命令，能显示版本号说明安装成功：

node --version  # 查看Node.js版本
npm --version   # 查看npm版本

二、安装Claude Code

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

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

验证安装是否成功

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

claude --version

如果能显示版本号，说明Claude Code已安装成功。

三、配置API连接（核心步骤）

1. 获取API Key

使用Claude Code需要API密钥，我这里使用88api中转站 https://api.88api.shop作为接口方案，主要是为了省去海外账户注册和翻墙的麻烦，国内直连更方便。你也可以用其他API服务，这里以88api为例：

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

2. 点击“添加令牌”
   

3. 选择分组

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

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

2. 配置API（推荐用配置文件）

通过配置文件统一管理API参数，比环境变量更方便维护。

配置文件路径：

~/.claude/settings.json

配置内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",  // 替换为刚复制的API Key
    "ANTHROPIC_BASE_URL": "<https://api.88api.shop>"  // 固定中转地址
  }
}

创建步骤：

打开终端，依次执行以下命令：

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

# 用nano编辑配置文件
nano ~/.claude/settings.json

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

3. 环境变量配置（备选方案）

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

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

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

永久设置（所有终端生效）：

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

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

保存后执行source ~/.zshrc（或对应配置文件）使生效。

⚠️ 注意：配置完成后需重启终端；如果在VS Code/Cursor等IDE的集成终端使用，需彻底重启IDE，否则配置可能不生效。

4. VSCode插件配置（可选）

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

配置文件路径：

~/.claude/config.json

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤：

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

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

粘贴上述内容并保存即可。

⚠️ 注意：config.json是VSCode插件专用配置，与Claude Code命令行工具的settings.json是两个不同文件，不要混淆。

四、开始使用Claude Code

配置完成后，在终端输入以下命令启动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是否配置正确。

总结

这篇教程从Node.js安装到Claude Code配置，再到API对接和问题解决，覆盖了国内环境下使用Claude Code的完整流程。核心是通过配置文件或环境变量正确对接API，避开海外账户和翻墙的麻烦。如果按步骤操作仍遇到问题，欢迎在评论区留言，我会尽量帮忙解答。技术工具上手难，但一步步拆解后其实没那么复杂，希望这篇文章能帮你少踩坑，快速用上Claude Code。