Astra 账户控制台
开发者

接入文档 Docs

CLI 客户端配置 · 模型用法

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 已经存在,只合并 modelenv 里的字段,别整文件覆盖。

推荐配置(用 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 时,把 modelANTHROPIC_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 变了。