Mac用户专属：Claude Code完整安装+88api对接教程，亲测有效少踩坑

前言

把自己在Macos上从安装到跑通的Claude Code安装全过程整理出来，包括Node.js环境准备、用API中转服务实现国内直连。

步骤尽量写细，命令直接复制可用，希望能帮你少踩些坑。 小白也可直接复现。

正文

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

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

方法一：官网下载（适合不熟悉命令行的同学）

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

方法二：Homebrew安装（推荐，命令行一步到位）

如果你平时用Homebrew管理软件，直接在终端执行：

brewinstallnode

验证安装是否成功

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

node--version# 查看Node.js版本npm--version# 查看npm版本

二、安装Claude Code

Node.js环境就绪后，用npm全局安装Claude Code：

npminstall-g@anthropic-ai/claude-code

验证安装是否成功

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

claude--version

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

Claude Code需要API密钥才能调用服务。这里需要先获取API Key，再通过配置文件或环境变量让工具识别。

1. 获取API Key（以88api为例）

我这次用的是88api（https://api.88api.shop）作为接口中转，主要是为了省去海外账号注册和翻墙的麻烦，国内可直连，且一个Key能管理多个模型调用，配置起来更省心。

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

获取步骤：

1. 注册并登录后，点击侧边栏“API令牌”。
   

2. 点击“添加令牌”
   

3. 选择分组

   1. 根据需要调用的模型选择分组
      a. claude 模型建议使用 calude code 分组、
      b. gpt 模型建议使用 codex分组
   2. 可通过平台的模型广场查看不同模型支持的分组
   3. 若在使用中出现上游分组饱和，请切换分组使用
      

4. 点击提交
   

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

2. 配置连接（推荐用配置文件，一劳永逸）

在用户目录下创建配置文件，让Claude Code能读取API信息。

配置文件路径：

~/.claude/settings.json

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

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

创建步骤（终端执行）：

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

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

3. 备选方案：环境变量配置（临时或特殊场景）

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

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

exportANTHROPIC_BASE_URL="https://api.88api.shop"exportANTHROPIC_AUTH_TOKEN="你的API密钥"

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

exportANTHROPIC_BASE_URL="https://api.88api.shop"exportANTHROPIC_AUTH_TOKEN="你的API密钥"

保存后执行source ~/.zshrc（或对应配置文件）让设置生效。

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

4. VSCode插件配置（可选，如果你用Claude插件）

如果同时使用VSCode的Claude插件，需要额外创建插件专用配置文件：

配置文件路径：

~/.claude/config.json

配置内容：

{"primaryApiKey":"any"}

创建步骤（终端执行）：

mkdir-p~/.claude# 确保目录存在nano~/.claude/config.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即可。

💡调试小技巧：如果仍无法连接，先检查网络、重启终端/IDE，再确认API Key是否正确配置（参考“配置API连接”步骤）。

总结

这篇教程从Node.js环境准备到Claude Code安装，再到API连接配置，基本覆盖了Mac用户上手的全流程。核心解决了两个痛点：一是提供了清晰的步骤，避免“卡壳”；二是通过API中转实现国内直连，省去海外账号和翻墙的麻烦。

如果按步骤操作仍遇到问题，欢迎在评论区留言，我会尽量回复。技术配置难免有细节差异，多交流才能少走弯路～