前言
最近想体验Claude Code的本地编程能力，但国内环境下总被海外账户、网络配置搞得头大？网上教程要么缺斤少两，要么默认你有海外环境，跟着做还是报错。作为踩过坑的开发者，我整理了这篇macOS下的完整实操——从Node.js安装到API对接，不用翻墙，不用海外账户，直接国内直连跑通，尽量帮你少走弯路。
正文
一、准备工作：安装Node.js
Claude Code运行需要Node.js环境，最低要求Node.js ≥18（建议安装LTS版本，更稳定）。
方法一：官网下载（推荐新手）
直接访问Node.js官网，下载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连接，也就是连接模型。这里以88api中转服务为例（https://api.88api.shop），我用它主要是为了省去翻墙和海外账户注册的麻烦，推荐大家也可以试试，或者大家也可以用自己的。
第一步：获取API Key
1.注册登录后，点击 “API 令牌” 
2.点击添加令牌 
3. 创建令牌
名称随便写，没有含义，直接点击提交即可。
获得 API Key 后请妥善保管，API Key 是你的身份凭证，等同于账号密码，切勿公开或分享给他人。 
第二步：配置连接（两种方法，选一种即可）
方法一：配置文件（推荐，永久生效）
通过配置文件保存API信息，步骤如下：
mkdir -p ~/.claude
nano ~/.claude/settings.json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "你的API密钥",
"ANTHROPIC_BASE_URL": "https://api.88api.shop"
}
}
方法二：环境变量（临时或永久）
如果不想用配置文件，也可以通过环境变量配置：
- 临时设置（仅当前终端生效）：
export ANTHROPIC_BASE_URL="https://api.88api.shop"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"
- 永久设置（所有终端生效）： 将以下内容写入你的shell配置文件（如~/.zshrc或~/.bashrc）：
export ANTHROPIC_BASE_URL="https://api.88api.shop"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"
保存后执行source ~/.zshrc（或对应配置文件）使生效。
⚠️ 注意：配置完成后需重启终端，若在VS Code/Cursor等IDE的集成终端使用，需彻底重启IDE（仅重启终端可能不生效）。
（可选）VSCode插件配置
如果使用VSCode的Claude插件，还需额外创建插件专用配置文件：
nano ~/.claude/config.json
{
"primaryApiKey": "any"
}
⚠️ 注意：这是插件专用的config.json，与命令行工具的settings.json是两个不同文件，不要混淆。
四、开始使用Claude Code
配置完成后，在终端输入以下命令启动：
claude
首次启动可能需要简单交互，按提示操作即可。想了解更多命令，可执行claude –help查看说明。
五、常见问题排查
问题：启动后提示“Unable to connect to Anthropic services”
症状：启动Claude Code后显示无法连接服务。 原因：首次启动引导未完成。 解决：创建~/.claude.json文件跳过引导：
cat > ~/.claude.json << 'EOF'
{
"hasCompletedOnboarding": true
}
EOF
cat ~/.claude.json
确认输出上述内容后，重启Claude Code即可。
💡 调试小技巧：若仍无法连接，先检查网络、重启终端/IDE，再确认API Key和ANTHROPIC_BASE_URL配置是否正确。
总结
到这里，macOS下Claude Code的安装和API配置就全部完成了。核心在于Node.js环境准备和API连接配置，按步骤操作基本能避开大部分坑。如果遇到其他问题，欢迎在评论区留言，一起交流解决。希望这篇教程能帮你少折腾环境，专注体验Claude Code的编程能力。
