前言最近把自己在 macOS 上从 0 到 1 跑通 Claude Code 的全过程整理出来包括 Node.js 安装、工具部署以及如何用国内 API 中转服务完成配置。整个流程亲测可行每一步都有具体命令和配置示例希望能帮你少踩坑快速用上这款工具。正文一、准备工作安装 Node.jsClaude Code 依赖 Node.js 环境官方要求最低版本 ≥18建议直接安装 LTS 版本长期支持版稳定性更好。方法一官网下载推荐新手访问 Node.js 官网选择 macOS 对应的 LTS 版本安装包下载后双击按向导完成安装即可一路默认选项就行。方法二Homebrew 安装适合熟悉终端的用户如果你已经安装了 Homebrew直接在终端执行brewinstallnode验证安装是否成功安装完成后打开终端输入以下命令能正常显示版本号就说明安装成功了node--version# 输出示例v20.11.0版本号可能因最新 LTS 版本变化npm--version# 输出示例10.2.4npm 会随 Node.js 一起安装二、安装 Claude Code 工具Node.js 环境准备好后用 npm 全局安装 Claude Codenpminstall-ganthropic-ai/claude-code安装完成后验证一下终端输入claude--version如果能显示版本信息说明工具安装成功了。三、配置 API 连接核心步骤Claude Code 需要通过 API 调用后端服务这里我用 88api 作为中转你也可以用自己熟悉的 API 服务。1. 获取 API Key以 88api 为例首先访问88api 官网(https://api.88api.shop)注册并登录账号1.注册登录以后点击页面上方的“控制台”然后进入后再点击侧边栏的 “API 令牌”2.点击添加令牌3. 创建令牌名称随便写没有含义直接点击提交即可。获取 API KEY获得 API Key 后请妥善保管API Key 是你的身份凭证等同于账号密码切勿公开或分享给他人。点击“知道了”可以看到我们刚才创建的在这里也同样可以点击 复制 按钮去获取 API Key。2. 配置 API 信息两种方法选一种即可方法一配置文件推荐永久生效在用户目录下创建配置文件步骤如下配置文件路径固定位置不要改~/.claude/settings.json配置内容替换成你的 API Key{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,// 替换成刚复制的 88api KeyANTHROPIC_BASE_URL:https://api.88api.shop// 中转服务地址}}创建步骤终端执行# 创建 .claude 目录如果已存在会自动跳过mkdir-p~/.claude# 用 nano 编辑配置文件新手友好的编辑器nano~/.claude/settings.json打开编辑器后粘贴上面的 JSON 内容把“你的API密钥”替换成实际 Key按CtrlO保存CtrlX退出。方法二环境变量临时或永久如果不想用配置文件也可以通过环境变量设置临时生效只对当前终端窗口有效exportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥# 替换成实际 Key永久生效对所有终端窗口有效把以下内容添加到你的 shell 配置文件比如~/.zshrc或~/.bash_profileexportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥# 替换成实际 Key保存后执行source ~/.zshrc或对应配置文件让设置生效。⚠️ 注意配置完成后必须重启终端如果在 VS Code 等 IDE 的集成终端中使用需要彻底重启 IDE不是只关终端窗口否则配置可能不生效。3. VSCode 插件配置可选如果你用 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 和ANTHROPIC_BASE_URL配置是否正确特别是 Key 有没有复制错。总结到这里Claude Code 在 macOS 上的安装、API 配置和基本使用就全部完成了。整个流程最关键的是 API 中转服务的配置用国内服务确实能省去不少海外账号和网络的麻烦。如果你跟着步骤走还是遇到问题欢迎在评论区留言我会尽量帮忙解答。技术工具的配置有时就是一层窗户纸捅破了就简单了希望这篇教程能帮你少走弯路快速用上 Claude Code~