告别配置卡壳！Mac上Claude Code手把手教程：Node安装+88api连接+常见报错解决，小白也能跟做

前言最近整理了这篇MacOS专用教程从Node.js安装到Claude Code部署再到API连接用了中转服务省掉翻墙和海外账号每个步骤都亲测过还附上了启动时常见报错的解决方法。如果你也是Mac用户想快速用上Claude Code跟着这篇走应该能少走不少弯路。正文一、准备工作安装Node.jsClaude Code要求Node.js版本≥18建议LTS版先确保环境满足。方法一官网下载适合不熟悉命令行的用户访问Node.js官网下载LTS版本的安装包双击后按向导完成安装即可。方法二Homebrew安装推荐命令行更快捷如果你常用终端直接用Homebrew安装brewinstallnode验证安装是否成功安装完成后打开终端输入以下命令能显示版本号说明安装成功node--version# 输出类似 v18.18.0npm--version# 输出类似 9.8.1二、安装Claude CodeNode.js准备好后用npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code验证安装是否成功安装完成后输入以下命令检查版本claude--version# 输出类似 0.1.0 或更高版本三、配置API连接核心步骤Claude Code需要API密钥才能调用服务这里用API中转服务来简化配置无需翻墙和海外账号。1. 获取API Key我这次用的是88api中转服务官网https://api.88api.shop主要考虑到它支持国内直连且一个Key能管理多个主流模型如GPT、Gemini等本地切换模型只需改一行配置比较方便。有额度推荐大家可以试试或者大家也可以用自己的。1.注册并登录后点击侧边栏“API令牌”。2. 点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用4.点击提交5. 点击复制按钮复制API令牌也就是API KEY2. 配置API两种方法推荐配置文件方法一通过配置文件永久生效推荐在用户目录下创建.claude文件夹和settings.json配置文件路径和内容如下配置文件路径~/.claude/settings.json配置内容替换你的API密钥为实际复制的Key{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配置文件如~/.zshrc或~/.bash_profileexportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥保存后执行source ~/.zshrc或对应配置文件使生效。⚠️注意务必将你的API密钥替换为实际获取的Key否则无法连接配置后需重启终端如果在VS Code/Cursor等IDE的集成终端使用需彻底重启IDE仅重启终端可能不生效。3. VSCode插件配置可选如果使用VSCode的Claude插件需额外创建config.json文件配置文件路径~/.claude/config.json配置内容{primaryApiKey:any}创建步骤终端执行# 创建配置文件nano~/.claude/config.json粘贴内容后保存退出同方法一的编辑步骤。⚠️注意这是VSCode插件专用的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即可。调试小技巧如果配置后仍无法连接可按以下步骤排查检查网络连接是否正常确认API Key和ANTHROPIC_BASE_URL配置正确重启终端或IDE后重试。总结以上就是MacOS下Claude Code的完整安装配置流程从Node.js环境准备到API连接再到常见问题解决每个步骤都尽量写得详细。核心是API配置部分用中转服务能省掉不少环境麻烦亲测国内网络下可以稳定使用。如果跟着做遇到问题欢迎在评论区留言我会尽量回复。希望这篇教程能帮你少踩坑快速用上Claude Code