前言我整理了一份 macOS 下的 Claude Code 完整实操流程从 Node.js 安装到 Claude Code 配置再到国内 API 直连方案每个步骤都附了具体命令和配置示例。我用的是 88api 作为中转主要图它国内直连不用翻墙一个 Key 还能管理多个模型省了不少环境配置的麻烦。如果你也想少踩坑快速上手跟着这篇一步步来应该没问题。正文一、准备工作安装 Node.jsClaude Code 要求 Node.js 版本至少 18建议用 LTS 稳定版我们先完成 Node.js 的安装。方法一官网下载安装访问 Node.js 官网下载 macOS 的 LTS 版本双击安装包后按向导提示完成安装即可。方法二Homebrew 安装推荐如果你常用 Homebrew直接在终端执行brewinstallnode验证安装是否成功安装完成后打开终端输入以下命令能显示版本号说明安装成功node--version# 查看 Node.js 版本npm--version# 查看 npm 版本二、安装 Claude CodeNode.js 准备好后通过 npm 全局安装 Claude Codenpminstall-ganthropic-ai/claude-code验证安装是否成功安装完成后执行以下命令检查版本claude--version如果能显示版本信息说明 Claude Code 已安装成功。三、配置 API 连接核心步骤前提获取 API Key使用 Claude Code 需要 API 密钥我这里用的是 88api 中转站官网https://api.88api.shop有额度推荐大家试试。你也可以用其他合规的 API 服务。下面以88 API 为例获取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// API 中转地址}}创建步骤在终端依次执行以下命令# 创建 .claude 目录如果已存在会自动跳过mkdir-p~/.claude# 创建并编辑配置文件nano~/.claude/settings.json打开编辑器后粘贴上述配置内容替换「你的API密钥」为实际 Key按CtrlO保存CtrlX退出编辑器。方法二环境变量临时/永久如果不想用配置文件也可以通过环境变量配置。临时设置仅当前终端有效exportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥# 替换为实际 Key永久设置所有终端生效将环境变量写入 shell 配置文件以 zsh 为例如果你用 bash 则修改 ~/.bashrc# 编辑配置文件nano~/.zshrc# 在文件末尾添加以下内容exportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥# 替换为实际 Key# 保存退出后执行以下命令使配置生效source~/.zshrc⚠️注意配置完成后需要重启终端才能生效。如果在 VS Code、Cursor 等 IDE 的集成终端中使用需要彻底重启整个 IDE不只是重启终端标签页否则配置可能不生效。VSCode 插件配置可选如果你使用 VSCode 的 Claude 插件还需要额外创建插件专用的配置文件配置文件路径~/.claude/config.json配置内容{primaryApiKey:any}创建步骤# 创建配置文件nano~/.claude/config.json# 粘贴上述内容保存退出CtrlO 保存CtrlX 退出⚠️注意这是 VSCode 插件的专用配置文件config.json与 Claude Code 命令行工具的配置文件settings.json是两个不同文件不要混淆。四、开始使用 Claude Code配置完成后在终端输入以下命令启动 Claude Codeclaude如果需要查看命令说明可以执行claude--help五、常见问题排查问题 1启动后提示「Unable to connect to Anthropic services」症状启动 Claude Code 后终端显示无法连接到 Anthropic 服务。解决方案这通常是首次启动时引导流程未完成导致的需要手动创建跳过引导的配置文件配置文件路径~/.claude.json配置内容{hasCompletedOnboarding:true}创建方法在终端执行以下命令cat~/.claude.jsonEOF { hasCompletedOnboarding: true } EOF验证文件是否创建cat~/.claude.json确认输出上述配置内容后重启 Claude Code 即可。调试小技巧如果配置后仍无法连接可以检查网络是否正常、API Key 是否填写正确或重启终端/IDE 后再次尝试。总结到这里macOS 下 Claude Code 的安装、API 配置和基本使用就完成了。核心步骤就是装 Node.js → 装 Claude Code → 配 API Key通过配置文件或环境变量→ 启动使用。最容易踩坑的地方是 API 配置路径和终端重启按文中步骤操作基本能避开这些问题。如果你在操作中遇到其他报错欢迎在评论区留言我们可以一起排查解决。希望这篇教程能帮你少走弯路快速用上 Claude Code
