「macOS专用」Claude Code从安装到API配置全流程：国内直连不折腾，小白也能照着跑（亲测教程）

前言

作为macOS用户，我踩了不少坑才跑通整个流程，索性整理成这篇实操文。从Node.js安装到API连接，每个步骤都附命令和配置示例，用接口中转方案解决国内直连问题，新手跟着做基本能一次成功。

正文

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

Claude Code运行依赖Node.js环境，最低要求Node.js ≥18（建议安装LTS稳定版）。

方法一：官网下载安装

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

方法二：Homebrew安装（推荐）

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

brew install node

验证安装是否成功

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

node –version # 输出Node.js版本，如v20.10.0
npm –version # 输出npm版本，如10.2.3

能正常显示版本号说明安装成功。

二、安装Claude Code

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

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

验证安装是否成功

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

claude –version

输出类似0.1.0的版本号即表示安装成功。

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

使用Claude Code需要API密钥，这里我用88api作为接口中转（官网：https://api.88api.shop），主要是为了省去海外账户注册和网络代理的麻烦，国内环境可直接调用，且支持多模型统一管理。

有额度推荐大家试试，或者大家也可以用自己的。

1. 获取API Key

若在使用中出现上游分组饱和，请切换分组使用

2. 配置方式（二选一）

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

在用户目录下创建.claude文件夹和settings.json配置文件：

配置文件路径：

~/.claude/settings.json

配置内容：

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

创建步骤：

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

# 用nano编辑配置文件
nano ~/.claude/settings.json

粘贴上述配置内容，按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（或对应配置文件）使生效。

⚠️ 注意事项

• 务必将"你的API密钥"替换为实际复制的API Key，否则无法连接。
• 配置后需重启终端，若在VS Code/Cursor等IDE的集成终端使用，需重启整个IDE（仅重启终端可能不生效）。

3. VSCode插件配置（可选）

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

配置文件路径：

~/.claude/config.json

配置内容：

{
"primaryApiKey": "any"
}

创建步骤：

# 创建文件（已存在.claude目录可直接编辑）
nano ~/.claude/config.json

粘贴内容后保存退出。注意：此文件与命令行工具的settings.json是两个独立文件，不要混淆。

四、开始使用Claude Code

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

claude

首次启动可能需要简单交互，按提示操作即可。如需查看命令说明，可执行：

claude –help

五、常见问题排查

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

症状：启动Claude Code后显示无法连接服务。 原因：首次启动引导流程未完成。 解决方案：在用户根目录创建.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 Key配置和.claude.json文件是否创建。有其他问题欢迎在评论区交流，一起完善这份实操指南~