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
  1. 首先访问 88api (https://api.88api.shop)，注册登录，点击侧边栏的 “API 令牌”

  1. 点击"添加令牌"

  1. 创建令牌，名称随意，直接提交

  1. 获取 API Key，注意妥善保管，不要公开或分享。

  1. 点击"知道了"，在令牌列表中可以点击"复制"按钮获取 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是否创建）。有其他问题欢迎在评论区交流，一起避坑～