别再拼凑教程了！Claude Code for macOS完整安装配置，环境+接口一篇搞定
前言
最近想上手Claude Code，但搜了一圈教程要么步骤不全，要么卡在API调用环节。作为非专业开发者，我太懂这种“跟着做还失败”的挫败感了。
这篇文章整理了我实际跑通的完整流程：从Node.js安装到API连接，尤其是针对国内环境的中转方案，尽量把每个配置细节讲清楚，希望能帮你少走弯路。
正文
一、准备工作：安装Node.js
Claude Code要求Node.js版本≥18（建议LTS版），先确保环境满足。
方法一：官网下载（推荐）
访问Node.js官网，下载LTS版本，双击安装包按向导完成即可。
方法二：Homebrew安装
如果习惯命令行，也可以用Homebrew：
brewinstallnode验证安装
安装完成后，打开终端输入以下命令，出现版本号即成功：
node--version# 输出示例：v20.11.0npm--version# 输出示例：10.2.4二、安装Claude Code
Node.js就绪后，通过npm全局安装Claude Code：
npminstall-g@anthropic-ai/claude-code验证安装
输入以下命令，能显示版本号说明安装成功：
claude--version三、配置API连接（核心步骤）
Claude Code需要API密钥才能使用，这里以88api中转为例（国内直连方便，无需海外账户）。
获取API Key
- 访问88api (https://api.88api.shop)，注册登录后，点击 “API 令牌”
2.点击添加令牌 - 创建令牌
名称随便写，没有含义，直接点击提交即可。
- 获取 API KEY
获得 API Key 后请妥善保管，API Key 是你的身份凭证，等同于账号密码，切勿公开或分享给他人。
- 点击“知道了”，可以看到我们刚才创建的，在这里也同样可以点击 复制 按钮去获取 API Key。
配置方式（二选一）
方法一：配置文件（推荐，永久生效）
在用户目录下创建配置文件，步骤如下：
配置文件路径：
~/.claude/settings.json配置内容：
{"env":{"ANTHROPIC_AUTH_TOKEN":"你的API密钥","ANTHROPIC_BASE_URL":"https://api.88api.shop"}}创建步骤：
# 创建.claude目录（如已存在可跳过）mkdir-p~/.claude# 用nano编辑配置文件nano~/.claude/settings.json粘贴上述配置内容，按Ctrl+O保存，Ctrl+X退出。
方法二：环境变量（临时或永久）
如果不想用配置文件，可通过环境变量设置：
临时设置（当前终端有效）：
exportANTHROPIC_BASE_URL="https://api.88api.shop"exportANTHROPIC_AUTH_TOKEN="你的API密钥"永久设置（全局生效）：
将以下内容写入shell配置文件（如~/.zshrc）：
exportANTHROPIC_BASE_URL="https://api.88api.shop"exportANTHROPIC_AUTH_TOKEN="你的API密钥"保存后执行source ~/.zshrc使配置生效。
⚠️ 注意：
- 替换"你的API密钥"为实际复制的Key
- 配置后需重启终端，若用VS Code/Cursor等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”
症状：启动Claude Code后无法连接服务。
解决方案：创建~/.claude.json文件跳过引导流程：
配置文件路径：
~/.claude.json配置内容：
{"hasCompletedOnboarding":true}创建方法：
cat>~/.claude.json<<'EOF' { "hasCompletedOnboarding": true } EOF验证文件是否创建：
cat~/.claude.json重启Claude Code即可。
调试小技巧
若仍无法连接，可检查：
- 网络是否正常
- 重启终端/IDE后重试
- API Key和Base URL配置是否正确
总结
这篇教程从Node.js安装到API连接，再到常见问题处理，覆盖了macOS配置Claude Code的全流程。核心在于API中转方案解决国内环境问题，以及配置文件路径和重启终端的细节——这些都是我实际操作中踩过的坑。
如果按步骤操作仍有问题，欢迎在评论区留言，我们一起排查解决。技术配置虽繁琐，但一步步走总能跑通，祝大家顺利用上Claude Code！