从0到1：Claude Code在macOS的安装+ api 模型配置，国内用户友好版

前言

最近尝试用Claude Code辅助写代码时，发现直接连接Anthropic服务总是碰壁------要么需要翻墙，要么注册海外账户太繁琐。

这篇文章把我在macOS上安装 Claude Code 并配置 api 的全过程分享给大家，亲测跑通，帮你少踩坑。

正文

一、安装Node.js

最低要求：Node.js >=18（建议LTS版本）

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

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

方法二：Homebrew安装

bash 复制代码

brew install node

验证安装

出现版本号即成功：

bash 复制代码

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

二、安装Claude Code

执行以下命令全局安装：

bash 复制代码

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

验证安装

bash 复制代码

claude --version

三、配置API连接

获取API KEY

这里使用88api中转服务（官网：https://api.88api.shop），推荐大家可以试试，或者大家也可以用自己的。步骤如下：

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

点击"添加令牌"

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

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

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

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

创建.claude目录及settings.json配置文件：

路径：~/.claude/settings.json

内容：

json 复制代码

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

创建步骤：

bash 复制代码

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

粘贴内容后按Ctrl+O保存，Ctrl+X退出。

方法二：环境变量

临时设置（当前终端）

bash 复制代码

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

永久设置

写入~/.zshrc（或对应shell配置文件）：

bash 复制代码

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

保存后执行：

bash 复制代码

source ~/.zshrc

⚠️ 提示：替换"你的API密钥"为实际值；配置后需重启终端或IDE生效（集成终端需重启整个IDE）。

VSCode插件配置（可选）

若使用VSCode Claude插件，需创建config.json：

路径：~/.claude/config.json

内容：

json 复制代码

{
  "primaryApiKey": "any"
}

创建步骤：

bash 复制代码

mkdir -p ~/.claude  
nano ~/.claude/config.json

保存退出即可。

⚠️ 注意：config.json是VSCode插件专用，与命令行工具的settings.json不同。

四、开始使用

执行以下命令启动Claude Code：

bash 复制代码

claude

可通过claude --help查看命令说明。

五、常见问题排查

问题1：Unable to connect to Anthropic services

症状：启动后提示无法连接服务。

解决方案 ：创建.claude.json跳过引导流程：

路径：~/.claude.json

内容：

json 复制代码

{
  "hasCompletedOnboarding": true
}

创建命令：

bash 复制代码

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

验证文件：

bash 复制代码

cat ~/.claude.json

重启Claude Code即可。
| 💡 调试技巧：若仍无法连接，检查网络、重启终端/IDE、确认API配置正确。

总结

这篇教程覆盖了Claude Code在macOS上的安装到88api配置的全过程，解决了国内用户连接Anthropic服务的核心痛点。关键在于正确配置API base URL和密钥，以及处理首次启动的引导问题。如果遇到连接问题，优先检查配置文件或环境变量是否正确。希望这篇教程能帮你快速用上Claude Code，有任何问题欢迎在评论区交流！