小白也能照着做：Claude Code 在 macOS 上的安装与 API配置全流程
前言
最近把自己在 macOS 上从 0 到 1 跑通 Claude Code 的全过程整理出来，包括 Node.js 安装、工具部署，以及如何用国内 API 中转服务完成配置。整个流程亲测可行，每一步都有具体命令和配置示例，希望能帮你少踩坑，快速用上这款工具。
正文
一、准备工作：安装 Node.js
Claude Code 依赖 Node.js 环境，官方要求最低版本 ≥18，建议直接安装 LTS 版本（长期支持版），稳定性更好。
方法一：官网下载（推荐新手）
访问 Node.js 官网，选择 macOS 对应的 LTS 版本安装包，下载后双击按向导完成安装即可，一路默认选项就行。
方法二：Homebrew 安装（适合熟悉终端的用户）
如果你已经安装了 Homebrew，直接在终端执行：
brewinstallnode验证安装是否成功
安装完成后，打开终端输入以下命令，能正常显示版本号就说明安装成功了：
node--version# 输出示例：v20.11.0（版本号可能因最新 LTS 版本变化）npm--version# 输出示例：10.2.4（npm 会随 Node.js 一起安装）二、安装 Claude Code 工具
Node.js 环境准备好后，用 npm 全局安装 Claude Code：
npminstall-g@anthropic-ai/claude-code安装完成后验证一下，终端输入：
claude--version如果能显示版本信息，说明工具安装成功了。
三、配置 API 连接（核心步骤）
Claude Code 需要通过 API 调用后端服务，这里我用 88api 作为中转，你也可以用自己熟悉的 API 服务。
1. 获取 API Key（以 88api 为例）
首先访问88api 官网(https://api.88api.shop)，注册并登录账号：
1.注册登录以后，点击页面上方的“控制台”，然后进入后再点击侧边栏的 “API 令牌”
2.点击添加令牌
3. 创建令牌
名称随便写，没有含义，直接点击提交即可。
- 获取 API KEY
获得 API Key 后请妥善保管，API Key 是你的身份凭证，等同于账号密码，切勿公开或分享给他人。
- 点击“知道了”，可以看到我们刚才创建的，在这里也同样可以点击 复制 按钮去获取 API Key。
2. 配置 API 信息（两种方法，选一种即可）
方法一：配置文件（推荐，永久生效）
在用户目录下创建配置文件，步骤如下：
配置文件路径（固定位置，不要改）：
~/.claude/settings.json配置内容（替换成你的 API Key）：
{"env":{"ANTHROPIC_AUTH_TOKEN":"你的API密钥",// 替换成刚复制的 88api Key"ANTHROPIC_BASE_URL":"https://api.88api.shop"// 中转服务地址}}创建步骤（终端执行）：
# 创建 .claude 目录（如果已存在会自动跳过）mkdir-p~/.claude# 用 nano 编辑配置文件（新手友好的编辑器）nano~/.claude/settings.json打开编辑器后，粘贴上面的 JSON 内容，把“你的API密钥”替换成实际 Key，按Ctrl+O保存，Ctrl+X退出。
方法二：环境变量（临时或永久）
如果不想用配置文件，也可以通过环境变量设置：
临时生效（只对当前终端窗口有效）：
exportANTHROPIC_BASE_URL="https://api.88api.shop"exportANTHROPIC_AUTH_TOKEN="你的API密钥"# 替换成实际 Key永久生效（对所有终端窗口有效）：
把以下内容添加到你的 shell 配置文件（比如~/.zshrc或~/.bash_profile）：
exportANTHROPIC_BASE_URL="https://api.88api.shop"exportANTHROPIC_AUTH_TOKEN="你的API密钥"# 替换成实际 Key保存后执行source ~/.zshrc（或对应配置文件）让设置生效。
⚠️ 注意：配置完成后必须重启终端，如果在 VS Code 等 IDE 的集成终端中使用，需要彻底重启 IDE（不是只关终端窗口），否则配置可能不生效。
3. 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”
症状：启动 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配置是否正确（特别是 Key 有没有复制错）。
总结
到这里，Claude Code 在 macOS 上的安装、API 配置和基本使用就全部完成了。整个流程最关键的是 API 中转服务的配置，用国内服务确实能省去不少海外账号和网络的麻烦。
如果你跟着步骤走还是遇到问题，欢迎在评论区留言，我会尽量帮忙解答。技术工具的配置有时就是一层窗户纸，捅破了就简单了，希望这篇教程能帮你少走弯路，快速用上 Claude Code~