文档 / 接入指南

Claude Code

用 Claude 分组的密钥,把 Claude Code 命令行连到 peroai。

2026-11-15 用 Claude Code 2.1.325 实测:claude-kiro 和 claude-ccmax 两个分组都能正常对话,ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY 两种写法都可以。

准备密钥和模型

  1. 在「API 密钥」创建密钥,分组选 claude-kiro 或 claude-ccmax(区别见分组说明)。
  2. 在模型广场确认模型 ID,例如 claude-sonnet-5-5、claude-opus-5-5。

Base URL 是 https://api.peroai.cc,不带 /v1,Claude Code 会自己追加接口路径。

安装

按 Claude Code 官方安装说明:

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

也可以用 npm install -g @anthropic-ai/claude-code。新版 npm 默认会拦截它的安装脚本,装完运行 claude --version 提示 claude native binary not installed 的,手动执行一次安装脚本:

node "$(npm root -g)/@anthropic-ai/claude-code/install.cjs"

在终端配置

macOS / Linux(Bash 或 Zsh):

export ANTHROPIC_BASE_URL='https://api.peroai.cc'
export ANTHROPIC_AUTH_TOKEN='sk-你的密钥'
export ANTHROPIC_MODEL='claude-sonnet-5-5'
claude

Windows PowerShell:

$env:ANTHROPIC_BASE_URL = 'https://api.peroai.cc'
$env:ANTHROPIC_AUTH_TOKEN = 'sk-你的密钥'
$env:ANTHROPIC_MODEL = 'claude-sonnet-5-5'
claude

在同一个终端里启动 Claude Code。电脑上配过别的服务商的,先检查有没有冲突的 ANTHROPIC_API_KEY 等变量或配置文件,避免用到旧密钥。

长期保存配置

临时环境变量关掉终端就没了。想长期使用,写进 Claude Code 的用户配置 ~/.claude/settings.json(Windows 为 %USERPROFILE%\.claude\settings.json):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.peroai.cc",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
  }
}

这个文件含有密钥,不要提交到 Git。也可以用 CC Switch 一键导入,免去手动编辑。

后台任务用的模型

Claude Code 除了主对话,还会用 Haiku 做标题生成等轻量后台任务,用 Opus / Sonnet 别名切换模型。可以用下面的变量指定它们实际用哪个模型:

变量 作用
ANTHROPIC_MODEL 主对话模型
ANTHROPIC_DEFAULT_HAIKU_MODEL haiku 别名和后台任务用的模型
ANTHROPIC_DEFAULT_SONNET_MODEL sonnet 别名对应的模型
ANTHROPIC_DEFAULT_OPUS_MODEL opus 别名对应的模型
CLAUDE_CODE_SUBAGENT_MODEL 子代理默认模型

使用 claude-ccmax 分组时,请把 ANTHROPIC_DEFAULT_HAIKU_MODEL 设成 claude-haiku-5-5。 这个分组的 claude-haiku-4-5 目前上游没有账号,后台任务会报 404。

所有模型都按实际调用的型号计费。指定的模型必须在这把密钥的分组里。

确认连接

进入 Claude Code 后用 /status 检查认证来源和 Base URL。发一条短消息,再到「使用日志」核对。

Claude Code 首次请求会写入约 2 万 token 的系统提示缓存,实测一句话的请求在 claude-ccmax 用 Sonnet 约 $0.09。之后的请求命中缓存,会便宜很多。

主对话能用、某些后台任务却报模型不可用时,检查那个任务实际请求的模型是否在当前分组里,按上一节指定。

常见问题

现象 先检查
404 Base URL 是否多加了 /v1;是否把 peroai.cc 填成了 API 地址
401 / 认证失败 是否用的本站密钥,而不是控制台密码或其它平台的密钥;是否有别的 ANTHROPIC_API_KEY 覆盖了设置
502(claude-ccmax 分组) 这个分组只接受 Claude Code 发出的请求。用其它客户端或 SDK 调用请换 claude-kiro
「分组 xxx 下模型 yyy 无可用渠道」 模型不在这把密钥的分组里;GPT 分组的密钥不能调 Claude
新开终端不生效 临时变量不会保存,按长期保存配置写入设置文件
编辑器插件没读到设置 从桌面启动的编辑器不一定继承终端变量,写进 settings.json 更可靠

VS Code 扩展、桌面应用等其它入口的配置方式,见 Claude Code 官方网关接入文档。

最后更新:2026-11-15。模型、价格和分组以控制台实时显示为准。