前言最近尝试在macOS上使用Claude Code发现不少用户卡在安装配置和海外服务连接上——要么Node.js版本不对要么API调用需要翻墙要么首次启动就报错。这篇文章整理了从Node.js安装到Claude Code配置的完整步骤用88api中转解决国内直连问题亲测跑通希望帮大家少踩坑。正文一、安装Node.js最低要求Node.js 18建议LTS版本。方法一官网下载推荐访问Node.js官网下载LTS版本双击安装包按向导完成安装。方法二Homebrew安装brewinstallnode验证安装出现版本号即成功node--version# 输出示例v20.11.0npm--version# 输出示例10.2.4二、安装Claude Code执行以下命令全局安装npminstall-ganthropic-ai/claude-code验证安装claude--version三、配置API连接获取API KEY这里使用88api中转网址https://api.88api.shop大家可以试试或者大家也可以用自己的。步骤如下注册登录以后点击侧边栏的 “API 令牌”点击添加令牌创建令牌名称随意直接提交获取 API Key注意妥善保管不要公开或分享。点击知道了在令牌列表中可以点击复制按钮获取 API Key方法一配置文件推荐在用户目录创建.claude文件夹和settings.json配置路径~/.claude/settings.json配置内容{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,ANTHROPIC_BASE_URL:https://api.88api.shop}}创建步骤# 创建.claude目录如已存在则跳过mkdir-p~/.claude# 编辑配置文件nano~/.claude/settings.json粘贴配置内容后按CtrlO保存CtrlX退出。方法二环境变量临时设置当前终端exportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥永久设置写入~/.zshrc或对应shell配置文件exportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥保存后执行source~/.zshrc⚠️ 注意替换“你的API密钥”为实际令牌配置后重启终端或IDE生效集成终端需重启整个IDE。VSCode插件配置可选若使用VSCode的Claude插件需创建~/.claude/config.json配置内容{primaryApiKey:any}创建步骤mkdir-p~/.claudenano~/.claude/config.json保存退出即可。⚠️ 注意config.json是VSCode插件专用与命令行工具的settings.json不同。四、开始使用运行以下命令启动Claude Codeclaude执行claude --help查看命令说明。五、常见问题排查问题1Unable to connect to Anthropic services症状启动后提示无法连接服务。解决方案创建~/.claude.json跳过引导配置内容{hasCompletedOnboarding:true}创建方法cat~/.claude.jsonEOF { hasCompletedOnboarding: true } EOF验证文件cat~/.claude.json重启Claude Code即可。 调试技巧若仍无法连接检查网络、重启终端/IDE、确认API配置正确。总结这篇教程覆盖了Claude Code在macOS的完整安装流程从Node.js准备到API配置用88api中转解决国内直连问题还包含常见连接失败的修复方案。希望能帮大家快速上手少走弯路。如果遇到其他问题欢迎留言交流
)
