前言
最近整理了一份从零开始在macOS上跑通Claude Code的全过程，涵盖了Node.js安装、工具部署，以及如何利用国内API中转服务完成配置。整套流程亲测可行，每一步都附带了具体的命令和配置示例，希望能帮大家少踩点坑，快速上手这个工具。
正文
一、准备工作：安装 Node.js
在开始之前，得先确保你的Mac上有一个能跑Node.js的环境。Claude Code官方要求Node.js的最低版本是≥18，所以直接安装LTS版本（长期支持版）是最稳妥的选择。
方法一：官网下载（新手友好）
直接去Node.js官网，找到macOS对应的LTS版本安装包。下载完成后，双击安装包，一路“继续”按向导完成安装就行，默认选项完全够用。
方法二：Homebrew 安装（适合终端老手）
如果你对Homebrew不陌生，那么终端里一行命令就能搞定：
brew install node
安装完成后，打开终端验证一下。如果能正常显示出版本号，就说明环境已经准备好了：
node --version # 输出示例：v20.11.0（版本号可能因最新 LTS 版本变化） npm --version # 输出示例：10.2.4（npm 会随 Node.js 一起安装）
二、安装 Claude Code 工具
Node.js就位后，就可以通过npm来全局安装Claude Code了。这一步非常简单：
npm install -g @anthropic-ai/claude-code
安装完毕后，同样在终端里验证一下：
claude --version
如果能正确显示版本信息，那工具安装环节就顺利完成了。
三、配置 API 连接（核心步骤）
Claude Code需要通过API来调用后台服务。这里我用的是88api作为中转，当然，你用其他熟悉的API服务也完全没问题。
1. 获取 API Key（以 88api 为例）
首先，在浏览器中访问88api官网，注册并登录你的账号。
1. 登录后，点击页面顶部的“控制台”，然后在左侧的侧边栏里找到“API 令牌”。
2. 点击“添加令牌”按钮。
3. 在弹出的窗口中，名称可以随便填，只是一个标识，没有实际含义。然后直接点击“提交”。
- 获取你的 API Key。
生成的API Key是你的身份凭证，重要性等同于账号密码，务必妥善保管，千万别公开或分享给他人。
点击“知道了”，就能看到你刚才创建的API Key。在这里，你可以点击复制按钮来获取它。
2. 配置 API 信息（两种方法二选一）
方法一：配置文件（推荐，一次配置，永久生效）
这个方法最省心。在用户目录下创建一个固定路径的配置文件：
配置文件路径：
~/.claude/settings.json
配置内容：
{
"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 退出。
方法二：环境变量（临时或永久）
如果你不想用配置文件，也可以通过环境变量来设置，灵活性更高。
临时生效（只对当前终端窗口有效）：
export ANTHROPIC_BASE_URL="https://api.88api.shop" export ANTHROPIC_AUTH_TOKEN="你的API密钥" # 替换成实际 Key
永久生效（对所有终端窗口有效）：
把以下内容添加到你的shell配置文件中（比如 ~/.zshrc 或 ~/.bash_profile）：
export ANTHROPIC_BASE_URL="https://api.88api.shop" export ANTHROPIC_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。
