Claude Code 配置

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

建议使用 Claude Code 最新版本。旧版本可能无法正确读取自定义 Base URL 或鉴权配置，安装完成后可通过 claude --version 确认当前版本。

macOS 安装教程

安装 Claude Code

在终端执行官方安装脚本：

curl -fsSL https://claude.ai/install.sh | bash

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

claude --version
claude doctor

claude doctor 会输出环境自检报告。若提示 command not found: claude，请重新打开终端，或检查安装脚本输出中提示的 PATH 配置。

配置 API 码头环境变量

请先在 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

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

Windows 安装教程（推荐）

系统要求：Windows 10 1809（build 17763）及以上版本。大多数 Windows 用户建议先按本节在 PowerShell 中安装；如果你的项目主要放在 WSL 里，再看下一节的 WSL 安装方式。

打开普通 PowerShell（不需要管理员权限），执行：

irm https://claude.ai/install.ps1 | iex

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

claude --version
claude doctor

如果安装阶段访问官方源较慢或失败，通常是网络问题；可临时使用代理后重试。安装完成后，日常调用走 API 码头中转地址。

不建议优先使用 Chocolatey + Node.js + npm 安装 Claude Code；这条路径更容易遇到全局 npm 权限、PATH 或可选依赖问题。

WinGet 安装（备选）

如果你习惯用 Windows 包管理器，也可以使用 WinGet：

winget install Anthropic.ClaudeCode

WinGet 安装通常不会像官方脚本一样自动后台更新。后续可定期执行：

winget upgrade Anthropic.ClaudeCode

Git for Windows（可选）

Claude Code 在原生 Windows 下可以直接使用 PowerShell 执行命令。安装 Git for Windows 后，Claude Code 也可以使用 Git Bash，对部分需要类 Unix 命令的项目更友好。

如果你已经安装 Git for Windows，但 Claude Code 找不到 Git Bash，可在 settings.json 里指定路径：

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

配置 API 码头环境变量

请先在 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 请妥善保管，切勿提交到代码仓库或泄露给第三方；如怀疑泄露，请在控制台吊销。

Windows + WSL 安装教程

如果你的项目主要放在 WSL 文件系统中，例如 /home/xxx/project，建议在 WSL 里安装并运行 Claude Code。

在 WSL 终端中执行：

curl -fsSL https://claude.ai/install.sh | bash

然后在 WSL 里配置环境变量：

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

建议把上面两行写入 WSL 内的 ~/.bashrc 或 ~/.zshrc，再执行：

source ~/.bashrc
claude --version
claude doctor

原生 Windows 和 WSL 是两套环境。你在 PowerShell 里配置的环境变量，WSL 里的 claude 不一定能读到；反过来也一样。请在实际运行 claude 的那个环境里配置 API 码头参数。

settings.json 配置（可选）

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

打开（或新建）~/.claude/settings.json（Windows 下路径为 %USERPROFILE%\.claude\settings.json，WSL 下是 WSL 用户目录内的 ~/.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 中已设置过同名变量，环境变量优先级更高，settings.json 的取值会被覆盖。如需让 settings.json 生效，请确保启动 Claude Code 的终端中未设置 ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN。

交互式配置（可选）

也可以直接运行：

claude

首次启动如进入登录或配置流程，按提示填写：

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

如果你已经通过环境变量或 settings.json 配好，通常不需要再走交互式配置。

验证连接

在终端运行：

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

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

常见问题

• 报 command not found: claude：关闭并重新打开终端；仍不行再检查安装脚本输出的 PATH 提示，或运行 claude doctor 查看诊断信息。
• PowerShell 报 irm 不识别：你可能在 CMD 里执行了 PowerShell 命令。请打开 PowerShell，或改用 WinGet。
• CMD 报 && 不是有效分隔符：你可能在 PowerShell 里执行了 CMD 命令。本文推荐直接使用 PowerShell 官方安装脚本。
• 报 401 / invalid_api_key：检查 API Key 是否完整（包括 sk- 前缀），是否在控制台已启用、是否已过期或被吊销。
• 报连接超时：检查 ANTHROPIC_BASE_URL 是否为 https://apimatou.cc，末尾不要多加 / 或 /v1；确认本机网络通畅。
• Windows 和 WSL 配置不生效：确认你在哪个环境运行 claude，就在对应环境里配置 ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN。
• VS Code 插件无法登录：插件未读到环境变量会走官方登录。可编辑 ~/.claude/settings.json 写入 env 字段，或从已设置变量的终端启动 VS Code，修改后重启。