macOS 下 Claude Code 安装与 API 配置保姆级教程：国内直连无需海外账户，亲测跑通

前言

最近整理了这篇 macOS 专属教程，从 Node.js 安装到 API 配置全流程，用 API 中转方案解决直连问题，不需要海外账户，亲测能跑通。如果你也想在 macOS 上用上 Claude Code，跟着步骤走应该能少走不少弯路。

正文

一、准备工作：安装 Node.js

Claude Code 依赖 Node.js 环境，最低要求 Node.js ≥18（建议用 LTS 版本，更稳定）。

方法一：官网下载（推荐）

直接访问 Node.js 官网，下载 macOS 的 LTS 版本安装包，双击后按向导完成安装即可。

方法二：Homebrew 安装

如果你习惯用 Homebrew，终端执行以下命令：

bash 复制代码

brew install node

验证安装

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

bash 复制代码

node --version
# 输出示例：v20.11.0（版本号可能因安装版本不同略有差异）

npm --version
# 输出示例：10.2.4（同上）

二、安装 Claude Code

Node.js 环境就绪后，终端执行以下命令全局安装 Claude Code：

bash 复制代码

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

验证安装

安装完成后，输入以下命令检查是否安装成功：

bash 复制代码

claude --version

如果能显示版本信息，说明安装没问题。

三、配置 API 连接（核心步骤）

Claude Code 需要 API 密钥才能调用服务，这里用 API 中转方案（以 88api 为例(https://api.88api.shop)，主要为了国内直连，减少环境配置麻烦）。

获取 API Key

1.注册登录后，点击 "API 令牌"

2.点击添加令牌

创建令牌

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

获取 API KEY

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

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

配置方式（二选一）

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

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

创建配置目录（如果已存在可跳过）：

bash 复制代码

mkdir -p ~/.claude

创建并编辑配置文件：

bash 复制代码

nano ~/.claude/settings.json

粘贴以下配置内容 （替换 你的API密钥 为实际复制的 Key）：

json 复制代码

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://api.88api.shop"
  }
}

保存退出 ：按 Ctrl+O 保存，Ctrl+X 退出编辑器。

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

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

临时设置（仅当前终端生效）：

bash 复制代码

export ANTHROPIC_BASE_URL="https://api.88api.shop"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

永久设置 （所有终端生效）：
编辑 shell 配置文件（比如 ~/.zshrc 或 ~/.bash_profile）：

bash 复制代码

nano ~/.zshrc

粘贴以下内容（替换 你的API密钥）：

bash 复制代码

export ANTHROPIC_BASE_URL="https://api.88api.shop"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

保存退出后，执行以下命令让配置生效：

bash 复制代码

source ~/.zshrc

⚠️ 注意：配置后需重启终端；如果在 VS Code、Cursor 等 IDE 的集成终端使用，需要彻底重启 IDE（仅重启终端可能不生效）。

VSCode 插件配置（可选）

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

创建配置文件：

bash 复制代码

nano ~/.claude/config.json

粘贴以下内容：

json 复制代码

{
  "primaryApiKey": "any"
}

保存退出 ：Ctrl+O 保存，Ctrl+X 退出。

⚠️ 注意：这个 config.json 是 VSCode 插件专用，和前面的 settings.json 是两个不同文件，别搞混了。

四、开始使用 Claude Code

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

bash 复制代码

claude

如果想了解更多命令，可执行 claude --help 查看说明。

五、常见问题排查

问题：启动后提示「Unable to connect to Anthropic services」

症状：启动 Claude Code 后显示无法连接服务。

原因：首次启动引导未完成。

解决：在用户根目录创建 .claude.json 文件跳过引导：

终端执行以下命令创建文件：

bash 复制代码

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

验证文件是否创建成功：

bash 复制代码

cat ~/.claude.json

看到输出 {"hasCompletedOnboarding": true} 说明成功，重启 Claude Code 即可。

💡 调试小技巧：如果配置后仍无法连接，先检查网络、重启终端/IDE，再确认 API Key 和 ANTHROPIC_BASE_URL 是否配置正确。

总结

这篇教程覆盖了 macOS 下 Claude Code 从环境准备到 API 配置的全流程，核心解决了国内直连和环境配置的麻烦。只要跟着步骤走，安装 Node.js、配置 API 密钥，基本能一次跑通。

如果遇到问题，先检查配置文件路径和内容，或者参考「常见问题」部分。如果还有其他坑点，欢迎在评论区交流，一起完善这个教程～