Claude Code 配置 GrooRoute Pro:ANTHROPIC_BASE_URL 与模型环境变量写法
Claude Code 会自己在地址后面拼上 /v1/messages,所以接入 GrooRoute Pro 时,ANTHROPIC_BASE_URL 填不带 /v1 的根地址 https://grooroute.com,ANTHROPIC_AUTH_TOKEN 填你的 GrooRoute Pro API Key,再把默认模型环境变量指向平台发布的 Claude 模型 ID。
当前可用的 Claude 模型
下面是平台已发布、并且当前有供给、ID 以小写 claude 加连字符开头的 Claude 模型。右边一列是这个模型的供给声明支持的接口,Claude Code 调用的是 POST /v1/messages:
| 模型 ID | 支持的接口 |
|---|---|
claude-opus-5-5 | POST /v1/chat/completions、POST /v1/messages、POST /v1/responses |
claude-opus-4-8 | POST /v1/chat/completions、POST /v1/messages、POST /v1/responses |
claude-sonnet-5-5 | POST /v1/chat/completions、POST /v1/messages、POST /v1/responses |
claude-fable-5-2 | POST /v1/chat/completions、POST /v1/messages、POST /v1/responses |
这份清单随平台发布的目录更新。接口一列合并了公开可用档位的声明,以接入文档页为准。每个模型在各档位的价格见模型页。
下面的示例用的 claude-opus-5-5 是清单里第一个声明了 Messages 协议的 Claude 模型,可以换成清单里其他声明了 POST /v1/messages 的 Claude 模型。
第一步:准备 API Key
登录控制台,在「API 密钥」页创建一把命名密钥,按需要设置额度、有效期和档位。也可以打开接入文档页,选中这把 Key 和要用的 Claude 模型,页面会按这把 Key 所在档位生成对应的 Shell 配置片段。
第二步:设置环境变量并启动
在运行 Claude Code 的同一个终端里执行(把 <your key> 换成你的 GrooRoute Pro API Key):
export ANTHROPIC_BASE_URL='https://grooroute.com'
export ANTHROPIC_AUTH_TOKEN='<your key>'
export ANTHROPIC_MODEL='claude-opus-5-5'
export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-5-5'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-opus-5-5'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-opus-5-5'
claude --model 'claude-opus-5-5'
ANTHROPIC_BASE_URL:填根地址https://grooroute.com,不要带/v1。Claude Code 自己会补/v1/messages。ANTHROPIC_AUTH_TOKEN:填你的 GrooRoute Pro API Key,不写进项目的代码仓库。ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL:Claude Code 内部的子代理或快捷档位可能读取这三个默认模型变量,一起指向同一个已发布模型 ID 可以避免落到未发布的模型名上。
第三步:在会话里确认连接
启动一个新的 Claude Code 会话,输入 /status 和 /model 核对当前连接的地址与模型。恢复的旧会话或子代理可能沿用之前保存的模型名,发请求前先检查一遍;发完请求后也可以到控制台「用量明细」核对「模型 / 密钥」一列。
如果不想直接用 Claude Code,而是想在 Codex 里调用 Claude 模型,写法见在 Codex 里使用 Claude;遇到 401、403 或 404 报错时按常见报错排查核对。
常见问题
ANTHROPIC_BASE_URL 要不要带 /v1?
不要。Claude Code 会在地址后面自己拼上 /v1/messages,所以 ANTHROPIC_BASE_URL 只填不带 /v1 的根地址。
不小心在 ANTHROPIC_BASE_URL 里多写了 /v1 会怎样?
请求路径会变成 /v1/v1/messages。网关会对 POST /v1/v1/messages 去掉一层 /v1 照常处理,并在响应头返回 X-GrooRoute-Notice: base_url has a duplicated /v1; use /v1/messages。仍然建议把地址改回不带 /v1 的根地址。
为什么把 OPUS、SONNET、HAIKU 三个默认变量也一起设上?
Claude Code 的子代理或默认档位切换会读取这三个环境变量,一起指向同一个已发布的 Claude 模型 ID,可以避免请求落到未发布的模型名上。
启动后怎么确认用的是指定的模型?
启动新的 Claude Code 会话后输入 /status 和 /model 查看;恢复旧会话时可能沿用之前保存的模型名。发完请求后也可在控制台「用量明细」查看实际请求的模型 ID。
最后更新: