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