别再拼凑教程了！Claude Code for macOS完整安装配置，环境+接口一篇搞定

前言最近想上手Claude Code但搜了一圈教程要么步骤不全要么卡在API调用环节。作为非专业开发者我太懂这种“跟着做还失败”的挫败感了。这篇文章整理了我实际跑通的完整流程从Node.js安装到API连接尤其是针对国内环境的中转方案尽量把每个配置细节讲清楚希望能帮你少走弯路。正文一、准备工作安装Node.jsClaude Code要求Node.js版本≥18建议LTS版先确保环境满足。方法一官网下载推荐访问Node.js官网下载LTS版本双击安装包按向导完成即可。方法二Homebrew安装如果习惯命令行也可以用Homebrewbrewinstallnode验证安装安装完成后打开终端输入以下命令出现版本号即成功node--version# 输出示例v20.11.0npm--version# 输出示例10.2.4二、安装Claude CodeNode.js就绪后通过npm全局安装Claude Codenpminstall-ganthropic-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粘贴上述配置内容按CtrlO保存CtrlX退出。方法二环境变量临时或永久如果不想用配置文件可通过环境变量设置临时设置当前终端有效exportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥永久设置全局生效将以下内容写入shell配置文件如~/.zshrcexportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥保存后执行source ~/.zshrc使配置生效。⚠️ 注意替换你的API密钥为实际复制的Key配置后需重启终端若用VS Code/Cursor等IDE的集成终端需彻底重启IDEVSCode插件配置可选如果使用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.jsonEOF { hasCompletedOnboarding: true } EOF验证文件是否创建cat~/.claude.json重启Claude Code即可。调试小技巧若仍无法连接可检查网络是否正常重启终端/IDE后重试API Key和Base URL配置是否正确总结这篇教程从Node.js安装到API连接再到常见问题处理覆盖了macOS配置Claude Code的全流程。核心在于API中转方案解决国内环境问题以及配置文件路径和重启终端的细节——这些都是我实际操作中踩过的坑。如果按步骤操作仍有问题欢迎在评论区留言我们一起排查解决。技术配置虽繁琐但一步步走总能跑通祝大家顺利用上Claude Code