前言

作为踩过坑的开发者，我整理了这篇macOS下的完整实操指南——从Node.js安装到API连接，甚至包含常见报错的解决办法。
我这次用88api作为中转，主要是它支持国内直连，无需海外账号，一个Key还能管理多个模型，省了不少环境配置的麻烦。跟着步骤走，基本能一次跑通。

正文

一、安装Node.js

Claude Code对Node.js版本有要求，最低需v18以上（建议用LTS稳定版），下面是两种安装方法：

方法一：官网下载

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

方法二：Homebrew安装（推荐）

如果你的macOS已经装了Homebrew，直接在终端执行：

brew install node

验证安装

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

node --version  # 输出v18.x.x或更高
npm --version   # 输出对应的npm版本

二、安装Claude Code

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

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

验证安装

安装完成后，输入以下命令检查是否安装成功：

claude --version  # 输出类似1.0.0的版本号

三、配置API连接

这一步是核心，需要先获取API Key，再通过配置文件或环境变量让Claude Code连接到服务。

前提：获取API Key

这里以88api为例（你也可以用其他API服务）。访问https://api.88api.shop注册后，按以下步骤获取Key：

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"  // 88api的服务地址
  }
}

创建步骤：
在终端执行以下命令创建目录和文件：

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

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

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

方法二：环境变量

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

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

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

永久设置（全局生效）：
将以下内容写入你的shell配置文件（如~/.zshrc或~/.bash_profile）：

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

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

⚠️ 注意：

• 务必将"你的API密钥"替换为实际复制的Key，否则无法连接；
• 配置后需重启终端，若在VS Code/Cursor等IDE的集成终端使用，需彻底重启IDE才能生效。

VSCode插件配置（可选）

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

配置文件路径：

~/.claude/config.json

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤：

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

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

粘贴上述内容保存即可。

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

四、开始使用

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

claude

如果需要查看命令说明，可执行：

claude --help

五、常见问题排查

问题1：Unable to connect to Anthropic services

症状：启动后提示无法连接到服务。
原因：首次启动引导未完成。
解决方案：在用户根目录创建.claude.json文件跳过引导：

配置文件路径：

~/.claude.json

配置内容：

{
  "hasCompletedOnboarding": true
}

创建方法：
在终端执行：

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

验证文件是否创建：

cat ~/.claude.json  # 输出上述配置内容即成功

重启Claude Code即可。

调试技巧

如果配置后仍无法连接，可按以下步骤排查：

1. 检查网络连接是否正常；
2. 重启终端或IDE后重试；
3. 确认API Key和ANTHROPIC_BASE_URL配置正确（参考“配置API连接”章节）。

总结

这篇教程从Node.js安装到API配置，再到常见问题解决，覆盖了macOS下Claude Code的完整上手流程。核心是通过配置文件或环境变量正确对接API，遇到连接问题时记得检查.claude.json文件是否创建。如果你在操作中遇到其他报错，欢迎在评论区留言，我们一起排查解决。技术工具上手难，一篇能走通的教程就是最好的助力。