macOS下Claude Code从安装到API配置全流程，小白也能照着做
前言
最近想试试Claude Code，作为非专业开发，最怕的就是环境配置这关——Node版本不对、API密钥放错位置、终端配置不生效，每个小问题都能让人劝退。
所以整理了这篇实操文，从Node.js安装到API接口对接，再到常见报错解决，全程在macOS下亲测跑通。如果你也想在国内环境下用上Claude Code，跟着步骤走应该能少踩不少坑。
正文
一、准备工作：安装Node.js
Claude Code依赖Node.js环境，最低要求Node.js ≥18（建议LTS版本，稳定性更好）。
方法一：官网下载（推荐）
访问Node.js官网，下载LTS版本安装包，双击后按向导完成安装即可。
方法二：Homebrew安装
如果习惯命令行，也可以用Homebrew安装：
brewinstallnode验证安装
安装完成后，打开终端输入以下命令，出现版本号即成功：
node--version# 输出示例：v20.11.0（版本号可能因安装版本不同略有差异）npm--version# 输出示例：10.2.4二、安装Claude Code
Node.js准备好后，通过npm全局安装Claude Code：
npminstall-g@anthropic-ai/claude-code验证安装
安装完成后，输入以下命令检查是否安装成功：
claude--version# 输出示例：1.0.0（版本号以实际安装为准）三、核心配置：API连接
Claude Code需要API密钥才能调用模型服务。我这里使用88api作为中转接口，主要是为了省去海外账号注册和网络配置的麻烦。 推荐大家可以试试，或者大家可以用自己的。
1. 获取API Key
- 首先访问 88api (https://api.88api.shop)，注册登录，点击侧边栏的 “API 令牌”
- 点击"添加令牌"
- 创建令牌，名称随意，直接提交
- 获取 API Key，注意妥善保管，不要公开或分享。
- 点击"知道了"，在令牌列表中可以点击"复制"按钮获取 API Key
2. 配置API连接（两种方式，选一种即可）
方法一：配置文件（推荐，永久生效）
在用户目录下创建.claude文件夹和settings.json配置文件，路径为：
~/.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退出编辑器。
方法二：环境变量（临时或永久）
如果不想用配置文件，可通过环境变量设置：
临时设置（仅当前终端生效）：
exportANTHROPIC_BASE_URL="https://api.88api.shop"exportANTHROPIC_AUTH_TOKEN="你的API密钥"永久设置（需编辑shell配置文件，如
~/.zshrc）：# 打开配置文件nano~/.zshrc# 在文件末尾添加以下内容（替换你的API密钥）exportANTHROPIC_BASE_URL="https://api.88api.shop"exportANTHROPIC_AUTH_TOKEN="你的API密钥"# 保存退出后，执行以下命令生效source~/.zshrc
⚠️ 注意：配置完成后需重启终端，如果在VS Code/Cursor等IDE的集成终端中使用，需重启整个IDE（仅重启终端可能不生效）。
3. VSCode插件配置（可选）
如果使用VSCode的Claude插件，需额外创建config.json文件（路径~/.claude/config.json）：
{"primaryApiKey":"any"}创建步骤：
# 创建配置文件nano~/.claude/config.json粘贴上述内容保存即可。
⚠️ 注意：此文件（
config.json）与Claude Code命令行工具的配置文件（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即可。
💡 调试技巧：若仍无法连接，可检查网络、重启终端/IDE，或重新核对API Key是否配置正确。
总结
Claude Code的配置核心其实就三步：装Node.js、装工具本身、配API接口。国内环境下用中转接口能省不少事，关键是配置文件路径和API Key别填错。
如果按步骤操作还是遇到问题，建议优先检查终端是否重启、配置文件路径是否正确（尤其是隐藏文件夹.claude是否创建）。有其他问题欢迎在评论区交流，一起避坑～