简短答案
OpenAI-compatible API 和 Anthropic-compatible API 是两套不同的接口兼容层。它们都可以用于模型请求,但请求格式、字段、工具协议和客户端预期不同。 一般来说,Codex CLI、Cursor、Cline、OpenCode、OpenClaw 等工具常走 OpenAI-compatible endpoint;Claude Code 和部分 Claude Desktop Gateway 场景走 Anthropic-compatible endpoint。 不要只看模型名字。配置时要同时确认工具需要哪种协议、Base URL 是哪个、API Key 属于哪个 provider、Model ID 是否属于当前分组。什么时候需要区分它们
- 你看到两个 Base URL,不知道该填哪一个
- Claude Code 能用,但 Codex 或 Cursor 不能用
- Codex 能用,但 Claude Code 报 endpoint 或认证错误
- 你把同一个 API Key 同时用于多个工具
- 你在配置 API gateway、模型路由或本地代理
核心概念
推荐判断方式
先看工具,而不是先看模型:
如果工具文档要求 OpenAI-style API,就不要填 Claude Code 的 Anthropic Base URL。如果工具文档要求 Anthropic-style API,就不要填 OpenAI-compatible 的
/v1 地址。
常见误区
- 以为同一个模型名可以在所有协议里直接复用。
- 把 OpenAI-compatible Base URL 填进 Claude Code。
- 把 Anthropic-compatible Base URL 填进 Codex、Cursor 或 Cline。
- 把 Claude.ai / ChatGPT 订阅当成 API Key。
- 只改 API Key,不改 Base URL 和 Model ID。
关于 BetterToken
BetterToken 同时提供 Anthropic-compatible 和 OpenAI-compatible 的接入方式。你可以在同一个 dashboard 管理 API Key、余额和用量记录,但每个客户端仍然要填写它实际支持的协议地址。 简单记法:Claude Code 看 Anthropic-compatible;Codex、Cursor、Cline、OpenCode、OpenClaw 这类外部工具优先看 OpenAI-compatible。Related docs
- Claude Code 接入 BetterToken 指南
- Codex 接入 BetterToken 指南
- Cursor 接入 BetterToken 指南
- 如何在 Claude Code 中配置 API Key 和 Base URL?