前言

这篇文章整理了我自己在 macOS 上从 0 到 1 跑通的全过程，从 Node.js 安装到 API 连接验证，每个步骤都附了具体命令和配置示例。我用了 API 中转服务来简化国内直连，省去了海外账号和翻墙的麻烦，亲测按照步骤走基本不会踩坑，适合小白以及想快速上手的朋友。

正文

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

Claude Code 对 Node.js 版本有要求，最低需要 v18 及以上（建议用 LTS 稳定版），先确保环境符合要求。

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

直接访问 Node.js 官网，选择「LTS」版本下载，双击安装包后按向导完成安装即可。

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

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

brew install node

验证安装是否成功

安装完成后，在终端输入以下命令检查版本，能正常显示版本号说明安装成功：

node --version  # 查看 Node.js 版本，需 ≥18.x.x
npm --version   # 查看 npm 版本（Node.js 自带）

二、安装 Claude Code 命令行工具

Node.js 环境准备好后，通过 npm 全局安装 Claude Code：

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

验证安装是否成功

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

claude --version

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

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

Claude Code 需要通过 API 连接服务，这里需要先获取 API Key，再配置连接参数。

1. 获取 API Key

调用 Claude 模型需要 API Key，我这次使用的是 88api 中转服务（官网：https://api.88api.shop），主要是为了省去海外账号注册和网络配置的麻烦，直接国内直连，还能统一管理多个模型的 API Key。

这里以88api为例：
获取Key的步骤：

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

2. 点击“添加令牌”
   

3. 选择分组

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

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

提示：如果使用其他 API 服务，获取 Key 的步骤可能不同，但后续配置方法类似。

2. 配置连接参数（两种方法，推荐配置文件）

方法一：通过配置文件（永久生效，推荐）

在用户目录下创建 .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 编辑配置文件（也可用其他编辑器，如 vim）
nano ~/.claude/settings.json

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

方法二：通过环境变量（临时或永久）

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

• 临时生效（仅当前终端会话）：

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

• 永久生效（需配置 shell 配置文件）：
  将以下内容写入 ~/.zshrc（如果用 bash 则写 ~/.bashrc）：

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

  保存后执行 source ~/.zshrc 使配置生效。

⚠️ 注意：配置完成后需重启终端（或彻底重启 VS Code/Cursor 等 IDE），否则配置可能不生效。

3. VSCode 插件配置（可选，如使用插件）

如果在 VSCode 中使用 Claude 插件，还需要额外创建 config.json 文件：

配置文件路径：

~/.claude/config.json

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤：

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

粘贴内容后保存退出即可。

⚠️ 注意：这是 VSCode 插件专用的 config.json，与命令行工具的 settings.json 是两个不同文件，不要混淆。

四、开始使用 Claude Code

配置完成后，在终端输入以下命令启动 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 即可。

💡 调试小技巧：如果仍无法连接，先检查网络是否正常，API Key 是否填对，再重启终端或 IDE 尝试。

总结

Claude Code 的安装配置本身不复杂，但环境依赖和 API 连接容易踩坑。这篇教程从 Node.js 环境准备到 API 配置、问题排查，覆盖了完整流程，尤其解决了国内直连的麻烦——用中转服务省去海外账号和网络配置，对新手友好。

核心步骤就三个：装 Node.js → 装 Claude Code → 配 API Key 和连接地址。按步骤操作，遇到连接问题记得检查 .claude.json 文件。如果还有其他问题，欢迎在评论区留言交流，一起避坑～