Claude Code国内配置总失败？macOS保姆级安装教程：从Node.js到API直连，10分钟跑通

前言

最近想上手Claude Code的朋友不少，但总被环境配置卡住——要么Node.js版本不对，要么API调用要海外账户，国内直连总失败。网上教程要么步骤零散，要么忽略关键配置，跟着做还容易报错。

这篇文章整理了macOS下从安装到可用的完整流程，用API中转解决国内直连问题，每个步骤都标了细节，帮你少踩坑。

正文

一、安装Node.js（基础环境）

Claude Code要求Node.js版本≥18（建议LTS版），先确保环境达标。

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

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

方法二：Homebrew安装

如果习惯命令行，也可以用Homebrew安装：

brewinstallnode
验证安装

安装完成后，打开终端输入以下命令，出现版本号即成功：

node--version# 输出示例：v20.11.0（版本≥18即可）npm--version# 输出示例：10.2.4

二、安装Claude Code

基础环境就绪后，用npm全局安装Claude Code：

npminstall-g@anthropic-ai/claude-code
验证安装

安装完成后，输入以下命令检查版本：

claude--version# 出现版本号即安装成功

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

Claude Code需要API密钥才能使用，这里用API中转方案解决国内直连问题。我这次用88api（网址：https://api.88api.shop），有额度可以试用。

获取API Key

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

2.点击添加令牌

3. 创建令牌

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

  1. 获取 API KEY

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

  1. 点击“知道了”，可以看到我们刚才创建的，在这里也同样可以点击 复制 按钮去获取 API Key。
方法一：配置文件（推荐）

通过配置文件永久保存API信息，避免每次启动都要设置。

配置文件路径：

~/.claude/settings.json

配置内容：

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

创建步骤：
打开终端，依次输入以下命令：

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

粘贴上述配置内容，按Ctrl+O保存，Ctrl+X退出编辑器。

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

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

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

exportANTHROPIC_BASE_URL="https://api.88api.shop"exportANTHROPIC_AUTH_TOKEN="你的API密钥"// 替换为实际Key

永久设置（所有终端生效）：
将以下内容写入shell配置文件（如~/.zshrc或~/.bash_profile）：

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"}

创建步骤：

# 创建.claude目录（如已存在跳过）mkdir-p~/.claude# 编辑配置文件nano~/.claude/config.json

粘贴内容后保存退出即可。

四、开始使用Claude Code

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

claude

首次启动可能需要简单交互，按提示操作即可。想了解更多命令，可输入claude --help查看说明。

五、常见问题排查

问题1：提示“Unable to connect to Anthropic services”

症状：启动后无法连接服务，大概率是首次引导未完成。
解决：在用户根目录创建.claude.json文件跳过引导：

配置文件路径：

~/.claude.json

配置内容：

{"hasCompletedOnboarding":true}

创建方法：
终端输入：

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

验证文件是否创建：

cat~/.claude.json# 输出上述内容即成功

重启Claude Code即可。

💡 调试技巧：若仍无法连接，检查网络、重启终端/IDE，或确认API Key和配置文件路径是否正确。

总结

到这里，macOS下Claude Code的安装和API配置就完成了。核心步骤是：准备Node.js环境→安装Claude Code→通过配置文件/环境变量对接API中转→解决首次启动引导问题。国内用户重点注意API中转地址和配置文件路径，按步骤操作基本能一次跑通。如果遇到其他问题，欢迎评论区交流，一起完善这个流程~