前言最近想试试Claude Code的本地代码辅助功能却发现不少教程要么默认海外环境要么步骤零散。作为macOS用户从Node.js安装到API配置每一步都怕出错。所以整理了这篇亲测可行的完整流程新手也能跟着一步步跑通。正文一、准备工作安装Node.jsClaude Code运行依赖Node.js最低要求Node.js ≥18建议LTS版本以下是两种安装方法方法一官网下载推荐访问Node.js官网下载macOS对应的LTS版本双击安装包按向导完成安装即可。方法二Homebrew安装如果已安装Homebrew直接在终端执行brewinstallnode验证安装安装完成后打开终端输入以下命令出现版本号即成功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密钥才能调用服务这里使用API中转服务实现国内直连无需海外账户。获取API Key我这次使用88api中转接口https://api.88api.shop个人认为较稳定划算或者大家也可以用自己的。获取Key的步骤如下1.注册登录后点击 “API 令牌”2.点击添加令牌3. 创建令牌名称随便写没有含义直接点击提交即可。获取 API KEY获得 API Key 后请妥善保管API Key 是你的身份凭证等同于账号密码切勿公开或分享给他人。点击“知道了”可以看到我们刚才创建的在这里也同样可以点击 复制 按钮去获取 API Key。配置方式二选一方法一配置文件推荐永久生效在用户目录下创建.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是终端文本编辑器也可用vimnano~/.claude/settings.json粘贴上述配置内容按CtrlO保存CtrlX退出。方法二环境变量临时或永久如果不想用配置文件可通过环境变量配置临时生效仅当前终端exportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥永久生效需配置shell文件将以下内容写入~/.zshrc或你的shell配置文件如.bashrcexportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥保存后执行source~/.zshrc⚠️注意请将你的API密钥替换为实际生成的Key配置后需重启终端若在VS Code等IDE的集成终端使用需重启整个IDE才能生效VSCode插件配置可选如果使用VSCode的Claude插件需额外创建config.json文件配置文件路径~/.claude/config.json配置内容{primaryApiKey:any}创建步骤# 创建文件nano~/.claude/config.json粘贴内容后保存退出同上。⚠️区分两个配置文件settings.json是命令行工具配置config.json是VSCode插件专用不要混淆。四、开始使用Claude Code配置完成后在终端输入claude即可启动Claude Code。如需查看命令说明可执行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是否正确重新复制粘贴一次重启终端或IDE后重试总结本文从Node.js安装到API配置完整覆盖了macOS下Claude Code的本地化部署流程。关键步骤在于配置文件的正确填写和环境变量的生效记得重启终端/IDE。如果遇到连接问题可优先检查.claude.json文件是否创建。按步骤操作基本能一次跑通有问题欢迎在评论区交流~