前言
最近尝试在macOS上使用Claude Code，发现不少用户卡在安装配置和海外服务连接上——要么Node.js版本不对，要么API调用需要翻墙，要么首次启动就报错。
这篇文章整理了从Node.js安装到Claude Code配置的完整步骤，用88api中转解决国内直连问题，亲测跑通，希望帮大家少踩坑。
正文
一、安装Node.js
最低要求：Node.js >=18（建议LTS版本）。
方法一：官网下载（推荐）
访问Node.js官网下载LTS版本，双击安装包按向导完成安装。
方法二：Homebrew安装
brewinstallnode验证安装
出现版本号即成功：
node--version# 输出示例：v20.11.0npm--version# 输出示例：10.2.4二、安装Claude Code
执行以下命令全局安装：
npminstall-g@anthropic-ai/claude-code验证安装
claude--version三、配置API连接
获取API KEY
这里使用88api中转（网址：https://api.88api.shop），大家可以试试，或者大家也可以用自己的。步骤如下：
- 注册登录以后，点击侧边栏的 “API 令牌”
- 点击"添加令牌"
- 创建令牌，名称随意，直接提交
- 获取 API Key，注意妥善保管，不要公开或分享。
- 点击"知道了"，在令牌列表中可以点击"复制"按钮获取 API Key
方法一：配置文件（推荐）
在用户目录创建.claude文件夹和settings.json：
- 配置路径：
~/.claude/settings.json - 配置内容：
{"env":{"ANTHROPIC_AUTH_TOKEN":"你的API密钥","ANTHROPIC_BASE_URL":"https://api.88api.shop"}}- 创建步骤：
# 创建.claude目录（如已存在则跳过）mkdir-p~/.claude# 编辑配置文件nano~/.claude/settings.json粘贴配置内容后，按Ctrl+O保存，Ctrl+X退出。
方法二：环境变量
临时设置（当前终端）
exportANTHROPIC_BASE_URL="https://api.88api.shop"exportANTHROPIC_AUTH_TOKEN="你的API密钥"永久设置
写入~/.zshrc（或对应shell配置文件）：
exportANTHROPIC_BASE_URL="https://api.88api.shop"exportANTHROPIC_AUTH_TOKEN="你的API密钥"保存后执行：
source~/.zshrc⚠️ 注意：替换“你的API密钥”为实际令牌，配置后重启终端或IDE生效（集成终端需重启整个IDE）。
VSCode插件配置（可选）
若使用VSCode的Claude插件，需创建~/.claude/config.json：
- 配置内容：
{"primaryApiKey":"any"}- 创建步骤：
mkdir-p~/.claudenano~/.claude/config.json保存退出即可。
⚠️ 注意：
config.json是VSCode插件专用，与命令行工具的settings.json不同。
四、开始使用
运行以下命令启动Claude Code：
claude执行claude --help查看命令说明。
五、常见问题排查
问题1：Unable to connect to Anthropic services
症状：启动后提示无法连接服务。
解决方案：创建~/.claude.json跳过引导：
- 配置内容：
{"hasCompletedOnboarding":true}- 创建方法：
cat>~/.claude.json<<'EOF' { "hasCompletedOnboarding": true } EOF验证文件：
cat~/.claude.json重启Claude Code即可。
总结
这篇教程覆盖了Claude Code在macOS的完整安装流程，从Node.js准备到API配置，用88api中转解决国内直连问题，还包含常见连接失败的修复方案。希望能帮大家快速上手，少走弯路。如果遇到其他问题，欢迎留言交流！
