小白也能照着做：Claude Code 在 macOS 上的安装与 API配置全流程分析

目录

• 前言
• 正文
• 一、准备工作：安装 Node.js
• 方法一：官网下载（推荐新手）
• 方法二：Homebrew 安装（适合熟悉终端的用户）
• 验证安装是否成功
• 二、安装 Claude Code 工具
• 三、配置 API 连接（核心步骤）
• 1. 获取 API Key（以 88api 为例）
• 2. 配置 API 信息（两种方法，选一种即可）
• 3. VSCode 插件配置（可选）
• 四、开始使用 Claude Code
• 五、常见问题排查
• 问题 1：启动后提示“Unable to connect to Anthropic services”
• 总结

最近把自己在 macOS 上从 0 到 1 跑通 Claude Code 的全过程整理出来，包括 Node.js 安装、工具部署，以及如何用国内 API 中转服务完成配置。整个流程亲测可行，每一步都有具体命令和配置示例，希望能帮你少踩坑，快速用上这款工具。

Claude Code 依赖 Node.js 环境，官方要求最低版本 ≥18，建议直接安装 LTS 版本（长期支持版），稳定性更好。

访问 Node.js 官网，选择 macOS 对应的 LTS 版本安装包，下载后双击按向导完成安装即可，一路默认选项就行。

如果你已经安装了 Homebrew，直接在终端执行：

brew install node

安装完成后，打开终端输入以下命令，能正常显示版本号就说明安装成功了：

node --version
# 输出示例：v20.11.0（版本号可能因最新 LTS 版本变化）
npm --version
# 输出示例：10.2.4（npm 会随 Node.js 一起安装）

Node.js 环境准备好后，用 npm 全局安装 Claude Code：

npm install -g @anthropic-ai/claude-code

安装完成后验证一下，终端输入：

claude --version

如果能显示版本信息，说明工具安装成功了。

Claude Code 需要通过 API 调用后端服务，这里我用 88api 作为中转，你也可以用自己熟悉的 API 服务。

首先访问88api 官网(https://api.88api.shop)，注册并登录账号：

1.注册登录以后，点击页面上方的“控制台”，然后进入后再点击侧边栏的 “API 令牌”

2.点击添加令牌

3. 创建令牌

名称随便写，没有含义，直接点击提交即可。

4. 获取 API KEY

获得 API Key 后请妥善保管，API Key 是你的身份凭证，等同于账号密码，切勿公开或分享给他人。

点击“知道了”，可以看到我们刚才创建的，在这里也同样可以点击 复制 按钮去获取 API Key。

方法一：配置文件（推荐，永久生效）

在用户目录下创建配置文件，步骤如下：

配置文件路径（固定位置，不要改）：

~/.claude/settings.json

配置内容（替换成你的 API Key）：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",  // 替换成刚复制的 88api Key
    "ANTHROPIC_BASE_URL": "https://api.88api.shop"  // 中转服务地址
  }
}

创建步骤（终端执行）：

# 创建 .claude 目录（如果已存在会自动跳过）
mkdir -p ~/.claude
# 用 nano 编辑配置文件（新手友好的编辑器）
nano ~/.claude/settings.json

打开编辑器后，粘贴上面的 JSON 内容，把“你的API密钥”替换成实际 Key，按 Ctrl+O 保存，Ctrl+X 退出。

方法二：环境变量（临时或永久）

如果不想用配置文件，也可以通过环境变量设置：

临时生效（只对当前终端窗口有效）：

export ANTHROPIC_BASE_URL="https://api.88api.shop"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"  # 替换成实际 Key

永久生效（对所有终端窗口有效）：
把以下内容添加到你的 shell 配置文件（比如 ~/.zshrc 或 ~/.bash_profile）：

export ANTHROPIC_BASE_URL="https://api.88api.shop"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"  # 替换成实际 Key

保存后执行 source ~/.zshrc（或对应配置文件）让设置生效。

⚠️ 注意：配置完成后必须重启终端，如果在 VS Code 等 IDE 的集成终端中使用，需要彻底重启 IDE（不是只关终端窗口），否则配置可能不生效。

如果你用 VSCode 的 Claude 插件，还需要额外创建一个插件专用配置文件：

配置文件路径：

~/.claude/config.json

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤：

# 确保 .claude 目录已存在
mkdir -p ~/.claude
# 编辑配置文件
nano ~/.claude/config.json

粘贴内容后保存退出即可。注意这是插件专用的 config.json，和前面命令行工具的 settings.json 是两个文件，别搞混了。

配置完成后，终端输入以下命令启动工具：

claude

首次启动可能会有简单引导，按提示操作即可。如果想查看所有可用命令，输入 claude --help。

症状：启动 Claude Code 后报错，无法连接服务。
原因：首次启动的引导流程未完成。
解决方法：在用户根目录创建 .claude.json 文件跳过引导：

配置文件路径：

~/.claude.json

配置内容：

{
  "hasCompletedOnboarding": true
}

创建命令（终端执行）：

cat > ~/.claude.json << 'EOF'
{
  "hasCompletedOnboarding": true
}
EOF

创建后验证一下：

cat ~/.claude.json

确认文件内容正确后，重启 Claude Code 即可。

💡 调试小技巧：如果还是连不上，先检查网络、重启终端/IDE，再确认 API Key 和 ANTHROPIC_BASE_URL 配置是否正确（特别是 Key 有没有复制错）。

到这里，Claude Code 在 macOS 上的安装、API 配置和基本使用就全部完成了。整个流程最关键的是 API 中转服务的配置，用国内服务确实能省去不少海外账号和网络的麻烦。

如果你跟着步骤走还是遇到问题，欢迎在评论区留言，我会尽量帮忙解答。技术工具的配置有时就是一层窗户纸，捅破了就简单了，希望这篇教程能帮你少走弯路，快速用上 Claude Code~

到此这篇关于小白也能照着做：Claude Code 在 macOS 上的安装与 API配置全流程的文章就介绍到这了,更多相关Claude Code 安装与API配置内容请搜索风君子博客以前的文章或继续浏览下面的相关文章，希望大家以后多多支持风君子博客！