跳转到主要内容

简短答案

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。

References