macOS下Claude Code安装配置保姆级教程：从Node.js到API直连，新手10分钟跑通

原创于 2026-06-29 12:05:11 发布 · 159 阅读

1 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#macos #node.js #claudecode #claude #88api

前言

最近想在macOS上体验Claude Code，但翻了不少教程，要么步骤零散，要么默认海外环境，配置时总卡在API调用或网络问题上。

作为非专业开发者，最怕跟着教程做还失败。这篇文章记录我在macOS上从安装依赖到成功启动的全过程，用了API中转服务减少环境配置麻烦，亲测能跑通，希望帮到同样想尝试的朋友。

正文

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

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

方法一：官网下载（推荐）

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

方法二：Homebrew安装

如果习惯命令行，可通过Homebrew安装：

brew install node

验证安装

安装完成后，打开终端输入以下命令，出现版本号即成功：

node --version
# 输出示例：v20.11.0

npm --version
# 输出示例：10.2.4

二、安装Claude Code

Node.js就绪后，通过npm全局安装Claude Code：

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

验证安装

安装完成后，检查版本确认是否成功：

claude --version

三、配置API连接

获取API Key

使用Claude Code需要API Key，我最近用了88api中转服务（网址：https://api.88api.shop），主要是省去海外账户注册和网络配置的麻烦，推荐大家可以试试，或者大家也可以用自己的。获取步骤如下：

注册登录以后，点击侧边栏的 “API 令牌”

点击"添加令牌"

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

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

点击"知道了"，在令牌列表中可以点击"复制"按钮获取 API Key

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

通过配置文件永久保存API信息，路径为用户目录下的.claude/settings.json：

配置内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://api.88api.shop"
  }
}

创建步骤：

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

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

粘贴上述配置内容，按Ctrl+O保存，Ctrl+X退出编辑器。

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

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

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

export ANTHROPIC_BASE_URL="https://api.88api.shop"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

永久设置（全局生效）：
将以下内容写入~/.zshrc（或你的shell配置文件，如.bashrc）：

export ANTHROPIC_BASE_URL="https://api.88api.shop"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

保存后执行source ~/.zshrc使配置生效。

⚠️ 注意：请将"你的API密钥"替换为实际生成的Key；配置后需重启终端，若在VS Code等IDE中使用，需彻底重启IDE才能生效。

VSCode插件配置（可选）

如果使用VSCode的Claude插件，需额外创建~/.claude/config.json：

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤：

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

粘贴内容保存即可（此文件与命令行工具的settings.json是两个独立文件）。

四、开始使用Claude Code

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

claude

如需查看命令说明，可运行claude --help。

五、常见问题排查

问题1：Unable to connect to Anthropic services

症状：启动后提示无法连接服务。
解决方案：创建~/.claude.json跳过引导流程：

配置内容：

{
  "hasCompletedOnboarding": true
}

创建方法：

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

验证文件是否创建：

cat ~/.claude.json

重启Claude Code即可。

💡 调试技巧：若仍无法连接，检查网络、重启终端/IDE，或确认API Key和Base URL配置是否正确。

总结

这篇教程覆盖了macOS上Claude Code从依赖安装到API配置的完整流程，核心是注意Node.js版本≥18、配置文件路径正确，以及妥善保管API Key。遇到连接问题时，创建.claude.json跳过引导是关键解决办法。整个过程不算复杂，跟着步骤走基本能顺利运行，有其他问题欢迎留言交流~