前言

这篇文章专为macOS用户整理，从Node.js安装到API对接全程实操，用88api中转方案省掉翻墙和海外账户麻烦，配置文件和命令直接复制可用，尽量让小白也能跟着走通。

正文

一、安装Node.js

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

方法一：官网下载

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

方法二：Homebrew安装（推荐）

mac用户用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需要API Key，我这次用88api中转（官网：https://api.88api.shop），主要是省掉翻墙和海外账户注册，国内直连方便。
推荐大家试试，或者大家也可以用自己的。

下面以88API 为例：
获取Key的步骤：

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

2. 点击“添加令牌”
   

3. 选择分组

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

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

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

通过配置文件永久保存API信息，路径固定在用户目录下：

配置文件路径：

~/.claude/settings.json

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

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

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

# 创建.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密钥"

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

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

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

# 保存后生效
source ~/.zshrc

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

VSCode插件配置（可选）

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

配置文件路径：

~/.claude/config.json

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤：

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

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

粘贴内容后保存退出。

⚠️ 注意：此文件（config.json）是VSCode插件专用，与命令行工具的配置文件（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配置正确

总结

这篇教程从Node.js安装到API配置，帮macOS用户解决了Claude Code的环境搭建问题，尤其是通过88api中转省掉了翻墙和海外账户的麻烦。核心要点是配置文件路径要正确（~/.claude/settings.json），API Key替换成自己的，重启终端或IDE让配置生效。

如果按步骤操作仍有问题，欢迎在评论区留言，我会尽量回复。技术配置难免踩坑，耐心检查每一步，基本都能解决～