前言

最近AI代码工具更新很快，但很多教程要么默认国外环境，要么步骤零散，Mac用户想上手Claude Code常常卡在安装配置环节。
我自己前几天也踩了不少坑，比如API连接失败、终端配置不生效等。所以整理了这篇实操文，从Node.js安装到API对接全程截图+命令，用国内可直连的接口方案，帮大家少走弯路，在Mac上快速跑通Claude Code。

正文

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

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

方法一：官网下载

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

方法二：Homebrew安装（推荐）

如果已安装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连接（关键步骤）

1. 获取API密钥

使用Claude Code需要API密钥，我这次实操中用的是88api作为接口中转方案，它支持国内直连，省去了注册海外账户和翻墙的麻烦，而且一个Key能接入多个主流模型，本地管理起来更方便。

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

获取步骤如下：

获取Key的步骤：

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

2. 点击“添加令牌”

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

4.点击提交

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

2. 配置方式（二选一）

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

在用户目录下创建.claude文件夹和settings.json配置文件，路径为：

~/.claude/settings.json

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

{
  "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密钥"

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

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

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

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

3. VSCode插件配置（可选）

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

~/.claude/config.json

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤：

nano ~/.claude/config.json

粘贴内容后保存退出（此文件与命令行工具的settings.json是两个独立文件）。

四、开始使用Claude Code

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

claude

首次启动会进入交互界面，可输入claude --help查看命令说明。

五、常见问题排查

问题1：启动后提示“Unable to connect to Anthropic services”

原因：首次启动引导未完成。
解决：在用户根目录创建.claude.json文件跳过引导：

# 创建文件并写入配置
cat > ~/.claude.json << 'EOF'
{
  "hasCompletedOnboarding": true
}
EOF

# 验证文件
cat ~/.claude.json

重启Claude Code即可。

调试技巧

若仍无法连接，可检查：
① 网络连接是否正常
② API Key是否正确配置
③ 终端/IDE是否已重启

总结

本文从Node.js安装到API配置，完整覆盖了MacOS下Claude Code的部署流程，重点解决了国内环境直连和常见配置报错问题。核心步骤是：安装Node.js→安装Claude Code→通过配置文件或环境变量对接API→验证启动。
如果遇到连接问题，记得检查.claude.json文件和API密钥是否正确。希望这篇教程能帮你少踩坑，顺利用上Claude Code！有其他问题欢迎在评论区交流~