前言

Claude Code的安装使用大多是Windows系统的，macOS用户想找个适配的完整步骤还真不容易。要么是命令不兼容，要么是配置路径不一样，折腾半天还报错。

其实AI工具的环境配置对非技术背景的朋友来说挺劝退的——版本不对、路径写错、API连不上，随便一个小问题就能卡半天。所以我整理了这篇 macOS专属 的实操指南，从Node.js安装到API配置再到常见问题解决，每一步都尽量写清楚，亲测能跑通，希望能帮大家少踩点坑。

正文

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

Claude Code要求Node.js版本至少18（建议LTS版），先确保环境满足这个基础要求。

方法一：官网下载安装

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

方法二：Homebrew安装（推荐）

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

brew install node

验证安装是否成功

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

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

二、安装Claude Code

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

npm install -g @anthropic-ai/claude-code

验证安装结果

安装完成后，输入以下命令检查是否安装成功：

claude --version

如果能显示版本号，说明Claude Code已经安装好了。

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

要让Claude Code正常工作，需要配置API连接。这里我使用88api作为中转接口（官网：https://api.88api.shop），它支持国内直连，无需海外账号，还能统一管理多个模型的API Key，减少环境配置的麻烦。
大家用自己的也可以。

1. 获取API Key

获取Key的步骤：

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

2. 点击“添加令牌”
   

3. 选择分组

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

4. 点击提交
   

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

2. 配置方式选择

有两种配置方式，推荐使用配置文件（更持久）。

方法一：配置文件（推荐）

在用户目录下创建.claude文件夹和settings.json配置文件：

配置文件路径：

~/.claude/settings.json

配置内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "<https://aicode.cat>"
  }
}

创建步骤：

# 创建.claude目录（如已存在可跳过）
mkdir -p ~/.claude

# 创建并编辑配置文件
nano ~/.claude/settings.json

将上述JSON内容粘贴进去，把"你的API密钥"替换为实际获取的API Key，按Ctrl+O保存，Ctrl+X退出编辑器。

方法二：环境变量（临时或永久）

如果不想用配置文件，也可以通过环境变量配置：

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

export ANTHROPIC_BASE_URL="<https://aicode.cat>"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

永久设置（推荐）：
将以下内容写入你的shell配置文件（如~/.zshrc或~/.bashrc）：

export ANTHROPIC_BASE_URL="<https://aicode.cat>"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

保存后执行以下命令使配置生效：

source ~/.zshrc  # 如果你用的是zsh；bash用户用source ~/.bashrc

⚠️ 注意：替换"你的API密钥"为实际的API Key，配置完成后需重启终端（如果在VS Code等IDE的集成终端使用，需要彻底重启IDE）才能生效。

3. VSCode插件配置（可选）

如果使用VSCode的Claude插件，还需要额外创建config.json文件：

配置文件路径：

~/.claude/config.json

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤：

# 创建.claude目录（如已存在可跳过）
mkdir -p ~/.claude

# 创建并编辑配置文件
nano ~/.claude/config.json

粘贴上述内容并保存即可。注意这是插件专用配置文件，与命令行工具的settings.json是两个文件。

四、开始使用Claude Code

配置完成后，在终端输入以下命令启动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是否正确配置（参考步骤3）。

总结

其实Claude Code在macOS上的配置没那么复杂，关键是Node.js环境和API连接这两步。本文从安装到调用，把每个细节都拆解开了，连常见的连接问题也给了解决方案，跟着做基本能一次跑通。

如果你在操作中遇到其他问题，欢迎在评论区留言，我们一起交流解决。技术学习就是这样，把复杂的步骤拆成小模块，一步步来，总能搞定。