Claude Code · 接入
Claude Code 用 Anthropic Messages API。前置准备见 接入前准备,本文只讲 Claude Code 专属配置。
Claude Code 接入地址 https://api.637274.xyz(不要带 /v1 —— Anthropic 协议根域名直接拼 /v1/messages)。
重要使用约束
不同模型族的客户端策略不同,接入前先看清楚:
| 模型族 | 允许的客户端 | 备注 |
|---|---|---|
claude-haiku-4-5 / claude-sonnet-4-6 / claude-opus-4-7 |
只接受真实的 Claude Code CLI 调用 | raw curl / Anthropic SDK / Cursor / Continue 等其他客户端打到 /v1/messages 调 Claude 模型会被拒:503 no upstream endpoint configured |
gpt-5.5 / gpt-5.4 / gpt-5.4-mini / gpt-5.3-codex |
任何 Anthropic 兼容客户端 | 按 OpenAI 后端正常计费 |
gemini-* |
任何 Anthropic 兼容客户端 | 按 Gemini 后端正常计费 |
如果你想用 raw curl 或 Anthropic SDK 调 Claude 模型,这条路通不了(设计如此),换用 GPT/Gemini 模型或装真实 Claude Code CLI。
模型选择
控制台首页「可用模型与价格」里能看到三类可调用模型:
| 模型族 | 实际后端 | 适用场景 |
|---|---|---|
claude-haiku-4-5 / claude-sonnet-4-6 / claude-opus-4-7 |
Claude 官方(Pro/Max OAuth 通道) | 推荐 —— Claude Code 客户端的原生模型,prompt cache 命中率最好 |
gpt-5.5 / gpt-5.4 / gpt-5.4-mini / gpt-5.3-codex |
OpenAI(API key 通道) | 想用 Claude Code 客户端跑 GPT 系列 |
gemini-* |
Gemini(如该模型在你等级开启) | 类似上面 |
只要当前用户等级开启了该模型,就可以填到 settings.json 里。模型名以首页显示为准。
配置文件
| 系统 | 配置目录 | 需要修改的文件 |
|---|---|---|
| Windows | %userprofile%\.claude |
settings.json |
| macOS / Linux | ~/.claude |
settings.json |
如果 settings.json 已经存在,只合并 model 和 env 里的字段,别整文件覆盖。
推荐配置(用 Claude 原生模型)
{
"model": "claude-sonnet-4-6",
"env": {
"ANTHROPIC_BASE_URL": "https://api.637274.xyz",
"ANTHROPIC_AUTH_TOKEN": "sk-xxx",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"CLAUDE_CODE_DISABLE_TERMINAL_TITLE": "1"
}
}
只需要 model 字段,因为 Claude Code 默认调用的 sonnet / haiku / opus 本身就是 Claude 模型,会被网关直连 Anthropic。ANTHROPIC_DEFAULT_SONNET_MODEL 这类 env 仅在「想强制把 Claude Code 切到 GPT/Gemini」时才用得上。
替代配置(用 GPT / Gemini 等其他模型)
Claude Code 走 Anthropic Messages API,但模型名不限制为 Claude。当你想让 Claude Code 内部所有 sonnet/haiku 调用都改走 GPT 时,把 model 和 ANTHROPIC_DEFAULT_*_MODEL 都填成首页显示的启用模型,例如:
{
"model": "gpt-5.4-mini",
"env": {
"ANTHROPIC_BASE_URL": "https://api.637274.xyz",
"ANTHROPIC_AUTH_TOKEN": "sk-xxx",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.4-mini",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5.4-mini",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"CLAUDE_CODE_DISABLE_TERMINAL_TITLE": "1"
}
}
切到 GPT/Gemini 后强烈建议加上 CLAUDE_CODE_ATTRIBUTION_HEADER=0,否则 prompt cache 会持续 miss,input token 全价计费、TTFT 也变慢。
非 Claude 模型走 OpenAI / Gemini 后端,按 API key 模式计费。
测试
启动 Claude Code:
claude
检查模型列表:
curl https://api.637274.xyz/v1/models \
-H "x-api-key: sk-xxx"
常见错误
通用错误(401/403/404 等)见 故障排查。下表只列 Claude Code 特有的:
| 现象 | 处理 |
|---|---|
503 no upstream endpoint configured(调 Claude 模型) |
网关识别到你不是真实的 Claude Code CLI 调用。常见原因:用的是 curl / Anthropic SDK / Cursor / Continue 等其他客户端 —— Claude 模型受策略限制只接受 Claude Code CLI,改用 GPT/Gemini 模型或换成 claude 命令。 |
503(用 Claude Code 调 Claude 模型也出现) |
通道整体不可用 / 全部账号已限流。当前架构没有 fallback 到普通 Anthropic API key 通道(按设计)。先短暂等冷却,长时间不恢复联系后台扩容账号池。 |
| Prompt cache 命中率突然降低 | 切到 GPT/Gemini 时缺 CLAUDE_CODE_ATTRIBUTION_HEADER=0;或 Claude Code 升级后 system prompt 变了。 |