前言

最近整理了这篇macOS专属教程，从Node.js环境搭建到Claude Code安装，再到API连接（用了国内中转服务减少麻烦），每一步都亲测过。
如果你也想用Claude Code但被环境配置卡住，跟着这篇走应该能少走不少弯路。

正文

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

Claude Code要求Node.js版本≥18（建议LTS版），先确保环境符合要求。

方法一：官网下载

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

方法二：Homebrew安装（推荐）

如果你常用Homebrew，直接在终端执行：

brew install node

验证安装

安装完成后，检查版本是否达标：

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

二、安装Claude Code

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

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

验证安装

安装完成后，检查是否成功：

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

三、配置API连接（关键步骤）

前提：获取API Key

使用Claude Code需要API Key，我这次用了88api中转服务（https://api.88api.shop），国内直连不用翻墙和注册海外账号，一个Key还能管理多个模型（比如GPT、Gemini），切换模型只需改一行配置，可以试试。 大家用自己也可以。

以88api为例：
获取Key的步骤：

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

2. 点击“添加令牌”
   

3. 选择分组

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

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

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

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

1. 创建配置目录和文件
   Claude Code的配置文件路径是~/.claude/settings.json，先创建目录：

mkdir -p ~/.claude  # 如已存在会自动跳过

2. 编辑配置文件
   用nano打开文件：

nano ~/.claude/settings.json

3. 粘贴配置内容
   输入以下JSON（替换你的API密钥为实际复制的Key）：

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

按Ctrl+O保存，Ctrl+X退出编辑器。

方法二：环境变量（临时或永久）

如果不想用配置文件，也可以通过环境变量设置：

• 临时生效（当前终端）
  直接在终端执行：

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

• 永久生效
  将上述命令写入shell配置文件（如~/.zshrc或~/.bash_profile）：

# 用nano打开配置文件
nano ~/.zshrc

# 在文件末尾添加两行
export ANTHROPIC_BASE_URL="https://api.88api.shop"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

# 保存退出后，执行以下命令使配置生效
source ~/.zshrc

⚠️ 注意：

• 务必替换你的API密钥为实际令牌，否则无法连接。
• 配置后需重启终端，若在VS Code/Cursor等IDE的集成终端使用，需彻底重启IDE（仅重启终端可能不生效）。

VSCode插件配置（可选）

如果用VSCode的Claude插件，还需额外创建~/.claude/config.json：

# 创建文件
nano ~/.claude/config.json

# 输入以下内容并保存
{
  "primaryApiKey": "any"
}

这是插件专用配置，和命令行工具的settings.json是两个不同文件，别搞混了。

四、开始使用Claude Code

配置完成后，在终端输入：

claude

即可启动Claude Code。想了解更多命令，执行claude --help查看帮助文档。

五、常见问题排查

问题1：启动后提示“Unable to connect to Anthropic services”

症状：启动Claude Code后报错，无法连接服务。
原因：首次启动可能未完成引导流程。
解决：在用户根目录创建.claude.json文件跳过引导：

# 创建文件并写入内容
cat > ~/.claude.json << 'EOF'
{
  "hasCompletedOnboarding": true
}
EOF

# 验证文件是否创建成功
cat ~/.claude.json

重启Claude Code即可。

调试小技巧

如果配置后仍无法连接，试试：

1. 检查网络是否正常（国内直连需确保中转服务可访问）；
2. 重启终端或IDE后重试；
3. 核对API Key和ANTHROPIC_BASE_URL是否配置正确。

总结

这篇教程覆盖了macOS下Claude Code从环境准备到API配置的完整流程，核心解决了国内环境下API连接的痛点（不用翻墙和海外账号）。关键步骤是Node.js版本≥18、配置文件路径正确、API Key替换准确，按步骤操作基本能一次跑通。

如果遇到其他问题，欢迎在评论区留言，我会尽量回复。工具用起来才香，赶紧试试吧！