Claude Code 配置

Claude Code 是 Anthropic 官方的 AI 编程助手 CLI 工具。本页介绍 macOS / Windows 下接入 API 码头的完整流程。

Claude Code 需要在 v2.1.68 或以上版本 才能正常接入中转节点，安装完成后请确认版本满足要求。

macOS 安装教程

安装 Homebrew

如已安装 Homebrew 可跳过本步。

curl -o- https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh | bash

安装 Node.js

通过 Homebrew 安装 Node.js：

brew install node

验证安装：

node -v
npm -v

能输出版本号即可。

安装 Claude Code CLI

通过 npm 全局安装 Claude Code CLI：

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

若 npm 下载缓慢，可临时切换到淘宝镜像：

npm config set registry https://registry.npmmirror.com

验证安装：

claude --version

运行健康检查：

claude doctor

claude doctor 会输出环境自检报告。

配置 AUTH_TOKEN & BASE_URL

请先在 API 码头控制台 创建 API Key（参考 创建令牌）。

方式一：环境变量（推荐）

打开（或新建）~/.zshrc，追加以下两行：

# API 码头 - Claude Code 加速配置
export ANTHROPIC_BASE_URL="https://apimatou.cc"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"

让配置生效：

source ~/.zshrc

验证：

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

输出与配置一致即说明写入成功。

方式二：交互式登录

直接在任意目录运行：

claude

首次启动会进入登录流程，按提示输入：

• API Key：粘贴 API 码头的 sk-你的Key
• Base URL：填写 https://apimatou.cc（不带 /v1）

API Key 请妥善保管，切勿提交到代码仓库或泄露给第三方；如怀疑泄露，请在控制台吊销。

验证连接

在终端运行：

claude "你好，请用一句话介绍你自己"

能正常返回回复即说明接入 API 码头成功。

Windows 安装教程

系统要求：Windows 10 1809（build 17763）及以上版本。更低版本可能无法使用 Chocolatey 与新版 PowerShell 模块。

安装 Chocolatey 与 Node.js

以 管理员身份 打开 PowerShell，安装 Chocolatey：

Set-ExecutionPolicy Bypass -Scope Process -Force
irm https://community.chocolatey.org/install.ps1 | iex

完成后，在同一管理员 PowerShell 中安装 Node.js：

choco install nodejs --version="24.13.0" -y

安装完成后 关闭并重新打开 PowerShell，验证：

node -v
npm -v

安装 Claude Code CLI

通过 npm 全局安装 Claude Code CLI：

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

若 npm 下载缓慢，可临时切换到淘宝镜像：

npm config set registry https://registry.npmmirror.com

验证安装：

claude --version

运行健康检查：

claude doctor

claude doctor 会输出环境自检报告。

配置 AUTH_TOKEN & BASE_URL

请先在 API 码头控制台 创建 API Key（参考 创建令牌）。

方式一：PowerShell Profile（推荐）

先定位 Profile 文件路径：

echo $PROFILE

如文件或目录不存在，可在 PowerShell 中直接创建：

if (!(Test-Path -Path (Split-Path -Parent $PROFILE))) {
  New-Item -ItemType Directory -Path (Split-Path -Parent $PROFILE) -Force
}
if (!(Test-Path -Path $PROFILE)) {
  New-Item -ItemType File -Path $PROFILE -Force
}

用记事本（或 VS Code）打开：

notepad $PROFILE

在文件中追加：

# API 码头 - Claude Code 加速配置
$env:ANTHROPIC_BASE_URL = "https://apimatou.cc"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的Key"

保存后重载 Profile：

. $PROFILE

验证：

$env:ANTHROPIC_BASE_URL
$env:ANTHROPIC_AUTH_TOKEN

输出与配置一致即说明写入成功。

方式二：系统环境变量（GUI）

1. 打开 设置 → 系统 → 关于 → 高级系统设置 → 环境变量。

2. 在「用户变量」中新建以下两条：

   变量名	变量值
   ANTHROPIC_BASE_URL	https://apimatou.cc
   ANTHROPIC_AUTH_TOKEN	sk-你的Key

3. 关闭并重新打开所有 PowerShell / 终端窗口，新窗口才会读取到新变量。

API Key 请妥善保管，切勿提交到代码仓库或泄露给第三方；如怀疑泄露，请在控制台吊销。

验证连接

在终端运行：

claude "你好，请用一句话介绍你自己"

能正常返回回复即说明接入 API 码头成功。

settings.json 配置（可选）

除了环境变量，Claude Code 还支持通过 ~/.claude/settings.json 持久化配置。

打开（或新建）~/.claude/settings.json（Windows 下路径为 %USERPROFILE%\.claude\settings.json），写入：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://apimatou.cc",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
  }
}

保存后重启 Claude Code 即可生效。

适用场景：

• 不想改 shell 配置：避免污染 ~/.zshrc / PowerShell Profile
• 多账号 / 多用户机器：把 Key 隔离在用户级目录内，不影响他人
• VS Code 插件读取兜底：插件在未读到系统环境变量时会回退读取该文件

优先级说明：若 shell 中已 export 过同名变量，环境变量优先级更高，settings.json 的取值会被覆盖。如需让 settings.json 生效，请确保启动 Claude Code 的终端中未设置 ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN。

常见问题

• 报 command not found: claude：检查 Node.js 与全局 npm bin 目录是否在 PATH 中。可用 npm config get prefix 查看全局安装目录。
• 报 401 / invalid_api_key：检查 API Key 是否完整（包括 sk- 前缀），是否在控制台已启用、是否已过期或被吊销。
• 报连接超时：检查 ANTHROPIC_BASE_URL 是否为 https://apimatou.cc，末尾不要多加 / 或 /v1；确认本机网络通畅。
• VS Code 插件无法登录：插件未读到环境变量会走官方登录。可编辑 ~/.claude/settings.json 写入 env 字段，或从已 export 变量的终端启动 VS Code，修改后重启。