前言最近所以整理了这篇针对macOS用户的Claude Code实操指南从Node.js安装到API对接一步到位用88api作为接口中转方案支持国内直连不用折腾海外账号亲测能跑通希望能帮大家少踩坑。正文一、安装Node.jsClaude Code要求Node.js版本≥18建议LTS版先确保环境满足。方法一官网下载访问Node.js官网下载LTS版本双击安装包按向导完成安装即可。方法二Homebrew安装推荐macOS用户推荐用Homebrew一键安装终端执行brewinstallnode验证安装安装完成后终端输入以下命令检查版本确保Node.js和npm都已正确安装node--version# 输出v18.x.x或更高npm--version# 输出对应的npm版本二、安装Claude CodeNode.js环境准备好后用npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code验证安装安装完成后终端输入以下命令检查版本确认安装成功claude--version三、配置API连接前提获取API Key使用Claude Code需要API Key我最近用的是88api(https://api.88api.shop)作为接口中转方案国内直连不用配置海外网络且一个Key可接入多个主流模型方便本地统一管理。有额度推荐大家可以试试或者大家也可以用自己的。获取步骤如下以88api为例获取Key的步骤注册并登录后点击侧边栏“API令牌”。点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用点击提交5. 点击复制按钮复制API令牌也就是API KEY方法一配置文件推荐通过配置文件持久化保存API信息步骤如下配置文件路径~/.claude/settings.json配置内容{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,// 替换为实际复制的API KeyANTHROPIC_BASE_URL:https://api.88api.shop// 88api接口地址}}创建步骤终端执行以下命令创建目录和文件# 创建.claude目录如已存在可跳过mkdir-p~/.claude# 用nano编辑配置文件nano~/.claude/settings.json粘贴上述配置内容按CtrlO保存CtrlX退出编辑器。方法二环境变量如果不想用配置文件可通过环境变量临时或永久配置临时设置当前终端有效exportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥# 替换为实际API Key永久设置全局生效将环境变量写入shell配置文件如~/.zshrc根据你使用的shell调整# 编辑配置文件nano~/.zshrc# 在文件末尾添加以下内容exportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥# 替换为实际API Key# 使配置生效source~/.zshrc⚠️注意请将你的API密钥替换为实际复制的API Key配置后需重启终端若在VS Code/Cursor等IDE的集成终端使用需彻底重启IDE仅重启终端可能不生效VSCode插件配置可选如果使用VSCode的Claude插件需额外创建插件专用配置文件配置文件路径~/.claude/config.json配置内容{primaryApiKey:any}创建步骤# 创建.claude目录如已存在可跳过mkdir-p~/.claude# 用nano编辑配置文件nano~/.claude/config.json粘贴上述内容保存退出即可。⚠️注意此文件config.json与Claude Code命令行工具的配置文件settings.json是两个独立文件不要混淆。四、开始使用配置完成后终端输入以下命令启动Claude Codeclaude首次启动可能需要确认协议按提示操作即可。如需查看命令说明可执行claude--help五、常见问题排查问题1Unable to connect to Anthropic services症状启动后提示无法连接到Anthropic服务。原因首次启动引导未完成。解决方案创建~/.claude.json文件跳过引导配置文件路径~/.claude.json配置内容{hasCompletedOnboarding:true}创建方法终端执行cat~/.claude.jsonEOF { hasCompletedOnboarding: true } EOF验证文件是否创建cat~/.claude.json重启Claude Code即可。调试小技巧若仍无法连接可检查网络连接是否正常API Key是否正确配置参考“配置API连接”章节重启终端或IDE后重试总结这篇教程从Node.js安装到Claude Code配置再到API对接和问题排查覆盖了macOS环境下的完整流程。核心是用88api解决国内直连问题避免海外账号和网络配置的麻烦。关键步骤在于配置文件路径~/.claude/settings.json和API Key的正确替换遇到连接问题时记得检查~/.claude.json文件。如果操作中遇到其他问题欢迎在评论区交流一起完善这个流程~