前言最近想上手Claude Code的朋友不少但总被环境配置卡住——要么Node.js版本不对要么API调用要海外账户国内直连总失败。网上教程要么步骤零散要么忽略关键配置跟着做还容易报错。这篇文章整理了macOS下从安装到可用的完整流程用API中转解决国内直连问题每个步骤都标了细节帮你少踩坑。正文一、安装Node.js基础环境Claude Code要求Node.js版本≥18建议LTS版先确保环境达标。方法一官网下载推荐访问Node.js官网下载LTS版本安装包双击后按向导完成安装即可。方法二Homebrew安装如果习惯命令行也可以用Homebrew安装brewinstallnode验证安装安装完成后打开终端输入以下命令出现版本号即成功node--version# 输出示例v20.11.0版本≥18即可npm--version# 输出示例10.2.4二、安装Claude Code基础环境就绪后用npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code验证安装安装完成后输入以下命令检查版本claude--version# 出现版本号即安装成功三、配置API连接核心步骤Claude Code需要API密钥才能使用这里用API中转方案解决国内直连问题。我这次用88api网址https://api.88api.shop有额度可以试用。获取API Key1.注册登录后点击 “API 令牌”2.点击添加令牌3. 创建令牌名称随便写没有含义直接点击提交即可。获取 API KEY获得 API Key 后请妥善保管API Key 是你的身份凭证等同于账号密码切勿公开或分享给他人。点击“知道了”可以看到我们刚才创建的在这里也同样可以点击 复制 按钮去获取 API Key。方法一配置文件推荐通过配置文件永久保存API信息避免每次启动都要设置。配置文件路径~/.claude/settings.json配置内容{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,// 替换为刚复制的KeyANTHROPIC_BASE_URL:https://api.88api.shop// 中转接口地址}}创建步骤打开终端依次输入以下命令# 创建.claude目录如已存在会自动跳过mkdir-p~/.claude# 用nano编辑配置文件nano~/.claude/settings.json粘贴上述配置内容按CtrlO保存CtrlX退出编辑器。方法二环境变量临时/永久如果不想用配置文件也可以通过环境变量配置。临时设置当前终端有效exportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥// 替换为实际Key永久设置所有终端生效将以下内容写入shell配置文件如~/.zshrc或~/.bash_profileexportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥// 替换为实际Key保存后执行source ~/.zshrc或对应配置文件使生效。⚠️ 注意配置后需重启终端如果用VS Code/Cursor等IDE的集成终端需彻底重启IDE仅重启终端可能不生效。VSCode插件配置可选如果用VSCode的Claude插件需额外创建插件专用配置文件配置文件路径~/.claude/config.json配置内容{primaryApiKey:any}创建步骤# 创建.claude目录如已存在跳过mkdir-p~/.claude# 编辑配置文件nano~/.claude/config.json粘贴内容后保存退出即可。四、开始使用Claude Code配置完成后在终端输入以下命令启动claude首次启动可能需要简单交互按提示操作即可。想了解更多命令可输入claude --help查看说明。五、常见问题排查问题1提示“Unable to connect to Anthropic services”症状启动后无法连接服务大概率是首次引导未完成。解决在用户根目录创建.claude.json文件跳过引导配置文件路径~/.claude.json配置内容{hasCompletedOnboarding:true}创建方法终端输入cat~/.claude.jsonEOF { hasCompletedOnboarding: true } EOF验证文件是否创建cat~/.claude.json# 输出上述内容即成功重启Claude Code即可。 调试技巧若仍无法连接检查网络、重启终端/IDE或确认API Key和配置文件路径是否正确。总结到这里macOS下Claude Code的安装和API配置就完成了。核心步骤是准备Node.js环境→安装Claude Code→通过配置文件/环境变量对接API中转→解决首次启动引导问题。国内用户重点注意API中转地址和配置文件路径按步骤操作基本能一次跑通。如果遇到其他问题欢迎评论区交流一起完善这个流程~