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-5POST /v1/chat/completions、POST /v1/messages、POST /v1/responses
claude-opus-4-8POST /v1/chat/completions、POST /v1/messages、POST /v1/responses
claude-sonnet-5-5POST /v1/chat/completions、POST /v1/messages、POST /v1/responses
claude-fable-5-2POST /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'

第三步:在会话里确认连接

启动一个新的 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。

最后更新:

相关教程

注册 GrooRoute Pro 账户 · 接入文档 · 模型与价格 · 条款与隐私