从0到1上手 Claude Code：macOS 安装+API连接全流程（国内可直接用，少踩坑指南）

前言

我整理了这份 macOS 下的完整教程，从 Node.js 安装到 API 连接全程实操，特别是用了 API 中转站来简化国内直连流程，省去翻墙和海外账户的麻烦。亲测跑通，希望能帮你少走弯路。小白也可以实现。

正文

一、安装 Node.js

Claude Code 对 Node.js 版本有要求，最低需要 Node.js >=18，建议直接安装 LTS 版本。

方法一：官网下载

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

方法二：Homebrew 安装（推荐）

如果你习惯用 Homebrew，直接在终端执行：

brewinstallnode

验证安装

安装完成后，打开终端输入以下命令检查版本，确保安装成功：

node--versionnpm--version

二、安装 Claude Code

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

npminstall-g@anthropic-ai/claude-code

验证安装

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

claude--version

如果能正常显示版本号，说明 Claude Code 安装成功。

三、配置 API 连接

要让 Claude Code 正常工作，需要配置 API 连接，核心是获取 API Key 并正确配置。

前提：获取 API Key

我这次使用的是 88api 中转站（官网：https://api.88api.shop），主要是为了国内直连，省去翻墙和海外账户注册的麻烦，大家也可以用自己熟悉的 API 服务。获取 Key 的步骤如下：

获取Key的步骤：

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

2. 点击“添加令牌”
   

3. 选择分组

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

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

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

通过配置文件管理 API 信息更方便，步骤如下：

配置文件路径：

~/.claude/settings.json

配置内容：

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

创建步骤：

# 创建 .claude 目录（如已存在则跳过）mkdir-p~/.claude# 创建并编辑配置文件nano~/.claude/settings.json

粘贴上述配置内容，替换「你的API密钥」为实际复制的 Key，按Ctrl+O保存，Ctrl+X退出编辑器。

方法二：环境变量

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

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

exportANTHROPIC_BASE_URL="https://api.88api.shop"exportANTHROPIC_AUTH_TOKEN="你的API密钥"

永久设置：
将以下内容写入你的 shell 配置文件（如~/.zshrc或~/.bash_profile）：

exportANTHROPIC_BASE_URL="https://api.88api.shop"exportANTHROPIC_AUTH_TOKEN="你的API密钥"

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

⚠️注意：请将「你的API密钥」替换为实际的 Key。配置完成后需重启终端，若在 VS Code 等 IDE 的集成终端使用，需彻底重启 IDE 才能生效。

VSCode 插件配置（可选）

如果使用 VSCode 的 Claude 插件，还需要额外配置插件认证文件：

配置文件路径：

~/.claude/config.json

配置内容：

{"primaryApiKey":"any"}

创建步骤：

# 创建 .claude 目录（如已存在则跳过）mkdir-p~/.claude# 创建并编辑配置文件nano~/.claude/config.json

粘贴上述内容保存即可。注意这是插件专用的config.json，与命令行工具的settings.json是两个文件。

四、开始使用

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

claude

如果需要查看命令说明，可执行claude --help。

五、常见问题排查

问题 1：Unable to connect to Anthropic services

症状：启动后提示无法连接到 Anthropic 服务。
解决方案：这通常是首次启动引导未完成导致的，需要创建~/.claude.json文件跳过引导：

配置文件路径：

~/.claude.json

配置内容：

{"hasCompletedOnboarding":true}

创建方法：

cat>~/.claude.json<<'EOF' { "hasCompletedOnboarding": true } EOF

验证文件已创建：

cat~/.claude.json

重启 Claude Code 即可。

💡调试技巧：若仍无法连接，可检查网络、重启终端/IDE，或确认 API Key 配置是否正确。

总结

到这里，macOS 下 Claude Code 的安装和 API 配置就完成了。核心步骤就是：装 Node.js → 装 Claude Code → 配 API Key（推荐用配置文件）→ 启动使用。遇到连接问题时，创建~/.claude.json跳过引导是关键。

这篇教程尽量把每个步骤写细，特别是国内环境下的 API 连接部分，希望能帮你少踩坑。如果操作中遇到其他问题，欢迎留言交流，一起解决~