小白也能照着做：macOS Claude Code安装+88api配置一步到位，少踩90%的坑

前言

作为一名macOS用户，我踩过不少坑后终于整理出这套 Claude Code 完整流程。本文从Node.js安装到API对接，再到常见问题排查，全程手把手带练，尤其适合国内用户，用API中转服务直连，省掉账号和网络的麻烦，亲测现在还能跑通。

正文

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

Claude Code运行依赖Node.js，最低要求Node.js ≥18（建议LTS版本），以下是两种安装方法：

方法一：官网下载

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

方法二：Homebrew安装（推荐）

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

brew install node

验证安装

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

node –version # 示例输出：v20.10.0
npm –version # 示例输出：10.2.3

二、安装Claude Code

Node.js就绪后，通过npm全局安装Claude Code：

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

验证安装

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

claude –version # 示例输出：0.1.0

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

1. 获取API Key

使用Claude Code需要API密钥，我这次用的是88api中转服务（官网：https://api.88api.shop），国内直连无需翻墙，一个Key还能管理多个模型，省掉切换账号的麻烦。

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

获取步骤如下： 1.注册并登录后，点击侧边栏“API令牌”。 2. 点击“添加令牌”

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

4.点击提交 5. 点击复制按钮复制API令牌，也就是API KEY

2. 配置方式（二选一）

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

在用户目录下创建配置文件，步骤如下： 配置文件路径：~/.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）：nano ~/.zshrc # 根据你的shell选择文件
  粘贴上述两行环境变量，保存退出后执行：source ~/.zshrc # 使配置生效

⚠️ 注意：

• 务必将"你的API密钥"替换为实际复制的Key；
• 配置后需重启终端，若在VS Code等IDE中使用，需彻底重启IDE才能生效。

3. VSCode插件配置（可选）

如果使用VSCode的Claude插件，需额外创建插件专用配置文件： 配置文件路径：~/.claude/config.json 配置内容：

{
"primaryApiKey": "any"
}

创建步骤：

# 确保.claude目录存在
mkdir -p ~/.claude

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

粘贴内容后保存退出（同上，Ctrl+O保存，Ctrl+X退出）。

四、开始使用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即可。

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

总结

本文从Node.js安装到API对接，完整覆盖了macOS下Claude Code的配置流程，尤其解决了国内用户的海外账号和网络问题。核心在于用API中转服务简化调用，配置文件或环境变量二选一，遇到连接问题记得检查~/.claude.json文件。按步骤操作基本能一次跑通，有其他问题欢迎在评论区交流，一起少踩坑～