【macOS保姆级】Claude Code从安装到API配置全流程：国内直连无需海外账号，亲测跑通

前言

最近所以整理了这篇针对macOS用户的Claude Code实操指南，从Node.js安装到API对接一步到位，用88api作为接口中转方案（支持国内直连，不用折腾海外账号），亲测能跑通，希望能帮大家少踩坑。

正文

一、安装Node.js

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

方法一：官网下载

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

方法二：Homebrew安装（推荐）

macOS用户推荐用Homebrew一键安装，终端执行：

brewinstallnode

验证安装

安装完成后，终端输入以下命令检查版本，确保Node.js和npm都已正确安装：

node--version# 输出v18.x.x或更高npm--version# 输出对应的npm版本

二、安装Claude Code

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

npminstall-g@anthropic-ai/claude-code

验证安装

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

claude--version

三、配置API连接

前提：获取API Key

使用Claude Code需要API Key，我最近用的是88api(https://api.88api.shop)作为接口中转方案（国内直连，不用配置海外网络，且一个Key可接入多个主流模型，方便本地统一管理）。

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

获取步骤如下（以88api为例）：
获取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密钥"# 替换为实际API Key

永久设置（全局生效）：
将环境变量写入shell配置文件（如~/.zshrc，根据你使用的shell调整）：

# 编辑配置文件nano~/.zshrc# 在文件末尾添加以下内容exportANTHROPIC_BASE_URL="https://api.88api.shop"exportANTHROPIC_AUTH_TOKEN="你的API密钥"# 替换为实际API Key# 使配置生效source~/.zshrc

⚠️注意：

• 请将"你的API密钥"替换为实际复制的API Key
• 配置后需重启终端，若在VS Code/Cursor等IDE的集成终端使用，需彻底重启IDE（仅重启终端可能不生效）

VSCode插件配置（可选）

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

配置文件路径：

~/.claude/config.json

配置内容：

{"primaryApiKey":"any"}

创建步骤：

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

粘贴上述内容保存退出即可。

⚠️注意：此文件（config.json）与Claude Code命令行工具的配置文件（settings.json）是两个独立文件，不要混淆。

四、开始使用

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

claude

首次启动可能需要确认协议，按提示操作即可。如需查看命令说明，可执行：

claude--help

五、常见问题排查

问题1：Unable to connect to Anthropic services

症状：启动后提示无法连接到Anthropic服务。
原因：首次启动引导未完成。
解决方案：创建~/.claude.json文件跳过引导：

配置文件路径：

~/.claude.json

配置内容：

{"hasCompletedOnboarding":true}

创建方法：
终端执行：

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

验证文件是否创建：

cat~/.claude.json

重启Claude Code即可。

调试小技巧：
若仍无法连接，可检查：

1. 网络连接是否正常
2. API Key是否正确配置（参考“配置API连接”章节）
3. 重启终端或IDE后重试

总结

这篇教程从Node.js安装到Claude Code配置，再到API对接和问题排查，覆盖了macOS环境下的完整流程。核心是用88api解决国内直连问题，避免海外账号和网络配置的麻烦。关键步骤在于配置文件路径（~/.claude/settings.json）和API Key的正确替换，遇到连接问题时记得检查~/.claude.json文件。如果操作中遇到其他问题，欢迎在评论区交流，一起完善这个流程~