Claude Code
用 Claude 分组的密钥,把 Claude Code 命令行连到 peroai。
2026-11-15 用 Claude Code 2.1.325 实测:
claude-kiro和claude-ccmax两个分组都能正常对话,ANTHROPIC_AUTH_TOKEN和ANTHROPIC_API_KEY两种写法都可以。
准备密钥和模型
- 在「API 密钥」创建密钥,分组选
claude-kiro或claude-ccmax(区别见分组说明)。 - 在模型广场确认模型 ID,例如
claude-sonnet-5-5、claude-opus-5-5。
Base URL 是 https://api.peroai.cc,不带 /v1,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 官方网关接入文档。