Mac下Claude Code完整配置指南：API中转+环境变量设置一步到位

前言

这篇文章整理了我亲测有效的完整流程：从Node.js安装到Claude Code部署，再到国内API直连配置，每个步骤都附了具体命令和配置示例。我用88api作为接口中转，省去了海外账户注册和翻墙的麻烦，国内环境可直接调用，希望能帮你少走弯路。

正文

1. 安装Node.js

Claude Code要求Node.js版本≥18（建议LTS版）， macOS下有两种安装方式：

方法一：官网下载

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

方法二：Homebrew安装（推荐）

如果已安装Homebrew，直接在终端执行：

bash 复制代码

brew install node

验证安装

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

bash 复制代码

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

2. 安装Claude Code

Node.js就绪后，通过npm全局安装Claude Code：

bash 复制代码

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

验证安装

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

bash 复制代码

claude --version

3. 配置API连接

前提：获取API Key

使用Claude Code需要API Key，我这次实操中用了88api作为接口中转（官网：https://api.88api.shop），国内环境可直连，无需海外账户。

推荐大家可以试试，或者大家可以用自己的。

获取Key的步骤如下：

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

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

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

配置文件路径：

复制代码

~/.claude/settings.json

配置内容：

json 复制代码

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",  // 替换为实际复制的Key
    "ANTHROPIC_BASE_URL": "https://api.88api.shop"  // 中转接口地址
  }
}

创建步骤 ：

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

bash 复制代码

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

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

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

方法二：环境变量

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

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

bash 复制代码

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

永久设置 ：

将环境变量写入shell配置文件（如~/.zshrc）：

bash 复制代码

# 编辑配置文件
nano ~/.zshrc

# 在文件末尾添加以下内容
export ANTHROPIC_BASE_URL="https://api.88api.shop"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"  # 替换为实际Key

# 使配置生效
source ~/.zshrc

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

VSCode插件配置（可选）

如果使用VSCode的Claude插件，需额外创建config.json：

配置文件路径：

复制代码

~/.claude/config.json

配置内容：

json 复制代码

{
  "primaryApiKey": "any"
}

创建步骤：

bash 复制代码

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

粘贴配置内容并保存（同上，Ctrl+O保存，Ctrl+X退出）。

4. 开始使用

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

bash 复制代码

claude

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

bash 复制代码

claude --help

5. 常见问题排查

问题1：Unable to connect to Anthropic services

症状：启动后提示无法连接服务。

解决方案 ：创建~/.claude.json文件跳过引导流程：

配置文件路径：

复制代码

~/.claude.json

配置内容：

json 复制代码

{
  "hasCompletedOnboarding": true
}

创建方法 ：

在终端执行：

bash 复制代码

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

验证文件是否创建：

bash 复制代码

cat ~/.claude.json

重启Claude Code即可。

💡 调试技巧：若仍无法连接，可检查网络、重启终端/IDE，或确认API Key配置是否正确。

总结

这篇教程从Node.js安装到API配置，完整覆盖了Mac下Claude Code的部署流程。核心是通过配置文件或环境变量对接API中转，解决国内环境调用问题。如果你在操作中遇到其他报错，欢迎在评论区留言，我们一起排查解决。技术配置虽繁琐，但一步一步跟着做，总能跑通的！