简短答案
Base URL 要跟工具协议匹配。Claude Code 通常使用 Anthropic-compatible 根地址;Codex、Cursor、Cline、OpenCode、OpenClaw 等外部工具通常使用 OpenAI-compatible/v1 地址。
在 BetterToken 中:
不要自己猜路径。API Key、Base URL 和 Model ID 必须来自同一个 provider / gateway。
为什么会有不同 Base URL
不同 SDK 对路径拼接方式不同。
同一个模型名不代表可以使用同一个 Base URL。真正需要匹配的是:工具协议、Base URL、API Key、Key group 和 Model ID。
推荐速查
常见错误
推荐排查顺序
- 先确认工具要求 OpenAI-compatible 还是 Anthropic-compatible。
- 检查 Base URL 是否和工具协议匹配。
- 检查 API Key 是否来自同一个服务。
- 检查 Model ID 是否来自模型广场,并属于当前 Key group。
- 发送一个最小请求测试,例如只问一句
hello。
代码示例
OpenAI-compatible 工具通常使用/v1 地址:
关于 BetterToken
BetterToken 同时提供 Anthropic-compatible 和 OpenAI-compatible 的接入方式。你可以在同一个 dashboard 管理 API Key、余额和用量记录,但每个客户端仍然要填写它实际支持的协议地址。 简单记法:Claude Code 看https://www.bettertoken.ai;Codex、Cursor、Cline、OpenCode、OpenClaw 看 https://www.bettertoken.ai/v1。