别再被环境配置卡壳！Mac版Claude Code安装与API对接保姆级指南（附常见报错解决）

前言

最近想体验Claude Code的本地代码辅助功能，却被各种环境配置和API调用问题折腾得够呛——不是Node版本不对，就是海外接口连不上，找了好几篇教程都不完整。作为Mac用户，我特别理解这种"看着简单但实操一堆坑"的感受。

所以今天把自己从安装到成功运行的全过程整理出来，包含Node.js安装、Claude Code部署、88api接口配置（国内直连，不用海外账户），甚至连常见报错的解决方法都附上了。亲测每一步都能跑通，希望能帮同样在Mac上折腾的朋友少走弯路。

正文

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

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

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

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

方法二：Homebrew安装（推荐，命令行更高效）

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

brewinstallnode

验证安装是否成功

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

node--version# 应显示v18.x或更高npm--version# 通常会随Node一起安装

二、安装Claude Code

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

npminstall-g@anthropic-ai/claude-code

验证安装是否成功

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

claude--version# 应显示当前安装的版本号

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

要让Claude Code正常工作，需要配置API密钥和接口地址。这里用的是88api（https://api.88api.shop）作为中转接口（国内直连，不用翻墙和海外账户），大家也可以用自己熟悉的接口方案。

推荐大家可以试试，或者大家用自己的也可以，下面以88 API 为例。

第一步：获取API Key

获取Key的步骤：

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

2. 点击“添加令牌”
   

3. 选择分组

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

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

第二步：配置连接信息（推荐用配置文件）

通过配置文件统一管理API信息，比环境变量更方便维护。

配置文件路径：

~/.claude/settings.json

配置内容：

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

创建步骤：
在终端依次执行以下命令：

# 创建.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 Code后显示无法连接服务。
原因：首次启动引导流程未完成。
解决方法：在用户根目录创建.claude.json文件跳过引导：

文件路径：

~/.claude.json

文件内容：

{"hasCompletedOnboarding":true}

创建命令：

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

创建后验证文件是否存在：

cat~/.claude.json# 应显示上述内容

重启Claude Code即可。

💡调试小技巧：若仍无法连接，先检查网络、重启终端/IDE，再确认API Key和接口地址是否配置正确（重点核对settings.json或环境变量）。

总结

整个流程走下来，其实核心就三步：装Node.js、装Claude Code、配API连接。最容易踩坑的是API配置和首次启动的引导问题，按文中步骤操作基本能避开。

如果你也是Mac用户，想在本地用Claude Code辅助开发，希望这篇教程能帮你少折腾环境，直接聚焦在功能体验上。如果遇到其他问题，欢迎在评论区交流，我会尽量回复~