概念说明

OpenAI 与 Anthropic 兼容 API 区别

比较 OpenAI 与 Anthropic 兼容 API 的协议、Base URL、API Key 和 Model ID，了解 Claude Code、Codex、Cursor、Cline 应选择哪种接口。

简短答案

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 是哪个、选择了哪个 provider，以及 Model ID 是否由该 provider 提供。

什么时候需要区分它们

你看到两个 Base URL，不知道该填哪一个
Claude Code 能用，但 Codex 或 Cursor 不能用
Codex 能用，但 Claude Code 报 endpoint 或认证错误
你把同一个 API Key 同时用于多个工具
你在配置 API gateway、模型路由或本地代理

核心概念

概念	说明
OpenAI-compatible API	按 OpenAI 风格 endpoint 和请求格式工作的兼容接口
Anthropic-compatible API	按 Anthropic / Claude 风格请求格式工作的兼容接口
Base URL	客户端请求发往的 API 根地址
API Key	当前 provider 的认证凭证
Model ID	当前协议和 provider 下可用的模型标识
Gateway	在客户端和上游模型之间进行兼容、路由、计费或观测的一层

推荐判断方式

先看工具，而不是先看模型：

工具	常见协议方向	本仓库中的 Base URL
Claude Code	Anthropic-compatible	`https://bettertoken.ai`
Claude Desktop Gateway	Anthropic-compatible 或通过本地路由	按对应 Gateway 配置
Codex CLI	OpenAI-compatible / Responses	`https://bettertoken.ai/v1`
Cursor	OpenAI-compatible	`https://bettertoken.ai/v1`
Cline	OpenAI-compatible provider	`https://bettertoken.ai/v1`
OpenCode / OpenClaw	OpenAI-compatible	`https://bettertoken.ai/v1`

如果工具文档要求 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。