前言

最近 AI 工具更新太快，很多教程看的时候还行，实际操作就卡壳——要么是海外账号注册麻烦，要么是网络连接问题，尤其是像 Claude Code 这类工具，环境配置对新手不太友好。我自己折腾了大半天，总算在 macOS 上跑通了，所以整理了这篇实操教程。

本文会从 Node.js 安装开始，一步步带你配置 API 连接（用了中转服务省去海外麻烦），最后解决常见的连接报错问题。全程命令和配置直接复制可用，尽量让你少踩坑。

正文

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

Claude Code 要求 Node.js 版本 ≥18（建议用 LTS 稳定版），下面两种安装方法选一种就行。

方法一：官网下载安装

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

方法二：Homebrew 安装（推荐）

如果你平时用 Homebrew 管理软件，直接在终端执行：

brew install node

验证安装是否成功

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

node --version  # 查看 Node.js 版本
npm --version   # 查看 npm 版本

二、安装 Claude Code

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

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

验证安装是否成功

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

claude --version

如果显示版本号（如 0.1.0），说明安装成功。

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

Claude Code 需要 API Key 才能使用，这里我直接用 88api 中转服务（网址：https://api.88api.shop）获取 Key，省去海外账号和翻墙步骤，国内可直连，还支持多模型统一管理。

个人觉得蛮不错的，大家可以试试；或者大家有自己的也可以。

1. 获取 API Key

先注册并登录 88api 平台，按以下步骤操作：

1. 点击侧边栏“API令牌”。
   

2. 点击“添加令牌”
   

3. 选择分组

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

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

2. 配置连接（推荐用配置文件）

创建配置文件是最稳定的方式，步骤如下：

配置文件路径：
~/.claude/settings.json

配置内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",  // 替换成刚才复制的 API Key
    "ANTHROPIC_BASE_URL": "https://api.88api.shop"  // 中转服务地址，固定不变
  }
}

创建步骤：
在终端依次执行以下命令：

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

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

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

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

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

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

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

永久设置（所有终端生效）：
将以下内容写入你的 shell 配置文件（如 ~/.zshrc 或 ~/.bashrc）：

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

保存后执行 source ~/.zshrc（或对应配置文件）使生效。

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

4. VSCode 插件配置（可选）

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

配置文件路径：
~/.claude/config.json

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤：

# 确保 .claude 目录存在
mkdir -p ~/.claude

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

粘贴内容后保存退出（同样 Ctrl+O 保存，Ctrl+X 退出）。

四、开始使用 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 和 ANTHROPIC_BASE_URL 是否配置正确。

总结

本文从 Node.js 安装到 API 配置，再到常见问题解决，带你在 macOS 上完整跑通了 Claude Code。核心是用中转服务解决了国内环境的连接问题，省去了海外账号和翻墙的麻烦。

如果配置时遇到其他报错，欢迎在评论区留言，我会尽量回复。技术工具配置难免踩坑，希望这篇教程能帮你少走弯路，快速用上 Claude Code。