macOS装Claude Code总卡环境？保姆级教程：从Node.js到API配置国内直连跑通

前言

最近想在macOS上试试Claude Code，结果找了好几篇教程不是缺步骤就是环境配置卡壳。尤其海外API调用要翻墙、注册账号，对国内用户太不友好。

这篇文章就把我亲测跑通的完整流程整理出来：从Node.js安装到api 配置，每个步骤都附命令和截图说明，尽量让像我一样的小白少踩坑。

正文

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

Claude Code要求Node.js版本至少18（建议LTS版），先确保环境满足。

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

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

方法二：Homebrew安装

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

brew install node

验证安装

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

node –version
# 输出示例：v20.11.0

npm –version
# 输出示例：10.2.4

二、安装Claude Code

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

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

验证安装

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

claude –version

能显示版本号即安装成功。

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

Claude Code需要API密钥才能使用，我自己最近用的是 88api（https://api.88api.shop）中转配置大模型（大家也可以用自己熟悉的API服务）。

获取API Key（以88api为例）

方法一：配置文件（推荐）

通过配置文件永久保存API信息，步骤如下：

配置文件路径：

~/.claude/settings.json

配置内容：

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

创建步骤： 打开终端，依次输入：

# 创建.claude目录（如已存在则跳过）
mkdir -p ~/.claude

# 创建并编辑配置文件
nano ~/.claude/settings.json

粘贴上述配置内容，替换“你的API密钥”，按Ctrl+O保存，Ctrl+X退出。

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

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

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

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

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

nano ~/.zshrc

添加以下内容并保存：

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

执行以下命令让配置生效：

source ~/.zshrc

⚠️ 注意：替换“你的API密钥”为实际获取的Key；配置后需重启终端，IDE集成终端需重启整个IDE才会生效。

VSCode插件配置（可选）

如果用VSCode的Claude插件，还需要额外创建config.json：

配置文件路径：

~/.claude/config.json

配置内容：

{
"primaryApiKey": "any"
}

创建步骤：

# 创建配置文件
nano ~/.claude/config.json

粘贴内容保存即可（这是插件专用配置，和命令行工具的settings.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即可。

调试小技巧

如果配置后仍无法连接，试试：

总结

这篇教程从Node.js安装到API配置，把macOS上跑通Claude Code的关键步骤都讲清楚了。核心是用API中转服务解决国内直连问题，省去海外账号和翻墙的麻烦。

如果按步骤操作还是遇到问题，欢迎在评论区留言，我会尽量回复。技术配置本来就容易踩坑，大家一起交流才能少走弯路～