macOS上Claude Code安装配置保姆级教程：国内直连API，从0到1跑通（附避坑指南）

前言

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

正文

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

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

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

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

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

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

bash 复制代码

brew install node

验证安装是否成功

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

bash 复制代码

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

二、安装Claude Code

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

bash 复制代码

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

验证安装是否成功

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

bash 复制代码

claude --version  # 例如输出 0.1.0

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

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

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

注册并登录后，点击侧边栏"API令牌"。
点击"添加令牌"
选择分组
1. 根据需要调用的模型选择分组
  a. claude 模型建议使用 calude code 分组、
  b. gpt 模型建议使用 codex分组
2. 可通过平台的模型广场查看不同模型支持的分组
3. 若在使用中出现上游分组饱和，请切换分组使用
点击提交

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

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

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

配置文件路径：

复制代码

~/.claude/settings.json

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

json 复制代码

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

创建步骤（终端执行）：

bash 复制代码

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

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

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

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

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

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

bash 复制代码

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

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

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

bash 复制代码

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

配置内容：

json 复制代码

{
  "primaryApiKey": "any"
}

创建步骤：

bash 复制代码

mkdir -p ~/.claude  # 已创建可跳过
nano ~/.claude/config.json

粘贴内容后保存退出（和前面配置文件操作相同）。

四、开始使用Claude Code

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

bash 复制代码

claude

首次启动会进入交互界面，输入claude --help可查看所有命令说明（比如代码解释、生成、优化等功能）。

五、常见问题排查（避坑指南）

问题1：启动后提示「Unable to connect to Anthropic services」

症状：启动Claude Code后，终端显示无法连接服务。

原因：首次启动可能未完成引导流程。

解决：在用户根目录创建.claude.json文件，跳过引导：

配置文件路径：

复制代码

~/.claude.json

配置内容：

json 复制代码

{
  "hasCompletedOnboarding": true
}

快速创建命令（终端执行）：

bash 复制代码

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

创建后验证文件是否存在：

bash 复制代码

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

重启Claude Code即可。

💡 调试小技巧：如果还是连不上，先检查网络、重启终端/IDE，再确认API Key是否填对（重点检查settings.json或环境变量中的Key是否完整）。

总结

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

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