前言

最近整理了这篇macOS专属的Claude Code实操指南，从Node.js安装到Claude Code配置，再到国内API直连，每一步都附了具体命令和截图。我自己踩过的坑（比如首次启动连不上服务）也会重点说明，尽量让你少走弯路，一篇搞定。

正文

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

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

方法一：官网下载（适合不熟悉命令行的用户）

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

方法二：Homebrew安装（推荐，命令行更高效）

如果你常用终端，直接用Homebrew安装：

brew install node

验证安装是否成功

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

node --version  # 例如输出 v20.10.0
npm --version   # 例如输出 10.2.3

二、安装Claude Code

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

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

验证安装是否成功

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

claude --version  # 例如输出 0.1.0

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

Claude Code需要API密钥才能使用，这里用的是88api中转站（https://api.88api.shop），主要是图个方便——国内直连不用翻墙，也不用注册海外账户，一个Key还能切换多个模型（比如GPT、Gemini），本地统一管理。

1. 获取API Key（以88api为例）

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

2. 点击“添加令牌”

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

4.点击提交

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

2. 配置API（推荐用配置文件，一劳永逸）

在用户目录下创建.claude文件夹和settings.json配置文件，路径和内容如下：

配置文件路径：

~/.claude/settings.json

配置内容（替换"你的API密钥"为实际复制的Key）：

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

创建步骤（终端执行）：

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

# 用nano编辑配置文件（也可用其他编辑器，如VSCode）
nano ~/.claude/settings.json

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

3. 备选方案：环境变量配置（临时或永久）

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

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

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使配置生效。

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

4. VSCode插件配置（可选，如果你用VSCode插件）

如果安装了VSCode的Claude插件，还需额外创建config.json文件：

配置文件路径：

~/.claude/config.json

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤：

mkdir -p ~/.claude  # 已创建可跳过
nano ~/.claude/config.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是否填对（重点检查settings.json或环境变量中的Key是否完整）。

总结

这篇教程从Node.js安装到Claude Code配置，再到国内API直连，覆盖了macOS环境下的全流程。核心是通过配置文件或环境变量解决API连接问题，避开了海外账号和翻墙的麻烦。如果遇到启动报错，记得检查.claude.json文件是否创建——这是我踩过的坑，希望你能直接跳过。

如果操作中还有其他问题，欢迎在评论区留言，我们一起解决。技术工具的配置虽繁琐，但一步步走通后，就能专注于用Claude Code提升开发效率了。