前言

最近想试试Claude Code的本地代码辅助功能，却发现不少教程要么默认海外环境，要么步骤零散。

作为macOS用户，从Node.js安装到API配置，每一步都怕出错。所以整理了这篇亲测可行的完整流程，新手也能跟着一步步跑通。

正文

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

Claude Code运行依赖Node.js，最低要求Node.js ≥18（建议LTS版本），以下是两种安装方法：

方法一：官网下载（推荐）

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

方法二：Homebrew安装

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

brew install node

验证安装

安装完成后，打开终端输入以下命令，出现版本号即成功：

node --version
# 输出示例：v20.11.0

npm --version
# 输出示例：10.2.4

二、安装Claude Code

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

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

验证安装

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

claude --version

出现版本信息即安装成功。

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

Claude Code需要API密钥才能调用服务，这里使用API中转服务实现国内直连（无需海外账户）。

获取API Key

我这次使用88api中转接口（https://api.88api.shop），个人认为较稳定划算，或者大家也可以用自己的。获取Key的步骤如下：

1.注册登录后，点击 “API 令牌”

2.点击添加令牌

3. 创建令牌

名称随便写，没有含义，直接点击提交即可。

4. 获取 API KEY

获得 API Key 后请妥善保管，API Key 是你的身份凭证，等同于账号密码，切勿公开或分享给他人。

5. 点击“知道了”，可以看到我们刚才创建的，在这里也同样可以点击 复制 按钮去获取 API Key。
   

配置方式（二选一）

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

在用户目录下创建.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（或你的shell配置文件，如.bashrc）：

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

  保存后执行：

  source ~/.zshrc
  

⚠️ 注意：

1. 请将"你的API密钥"替换为实际生成的Key
2. 配置后需重启终端，若在VS Code等IDE的集成终端使用，需重启整个IDE才能生效

VSCode插件配置（可选）

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

配置文件路径：

~/.claude/config.json

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤：

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

粘贴内容后保存退出（同上）。

⚠️ 区分两个配置文件：settings.json是命令行工具配置，config.json是VSCode插件专用，不要混淆。

四、开始使用Claude Code

配置完成后，在终端输入：

claude

即可启动Claude Code。如需查看命令说明，可执行：

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即可。

调试小技巧

若配置后仍无法连接，可按以下步骤排查：

1. 检查网络连接是否正常
2. 确认API Key是否正确（重新复制粘贴一次）
3. 重启终端或IDE后重试

总结

本文从Node.js安装到API配置，完整覆盖了macOS下Claude Code的本地化部署流程。关键步骤在于配置文件的正确填写和环境变量的生效（记得重启终端/IDE）。如果遇到连接问题，可优先检查.claude.json文件是否创建。按步骤操作，基本能一次跑通，有问题欢迎在评论区交流~