要点
OpenAI 互換 API と Anthropic 互換 API は、異なる互換レイヤーです。どちらもモデルへのリクエストに使えますが、リクエスト形式、フィールド、ツールの意味、クライアントが想定する動作は異なります。 Codex CLI、Cursor、Cline、OpenCode、OpenClaw は通常、OpenAI 互換エンドポイントを使います。Claude Code と一部の Claude Desktop Gateway ルートは Anthropic 互換エンドポイントを使います。 モデル名だけで選ばないでください。外部ツールが想定するプロトコルを選び、それに合う Base URL、API Key、Model ID を使います。この違いが重要になる場合
- 2 つの Base URL のどちらを使うべきか分からない
- Claude Code は動作するが、Codex または Cursor は失敗する
- Codex は動作するが、Claude Code でエンドポイントまたは認証エラーが表示される
- 1 つの API Key を複数の外部ツールで使いたい
- API gateway、モデルルーター、ローカルプロキシを設定している
主な概念
推奨される選び方
まず外部ツールを確認します。
外部ツールが OpenAI 形式の API を想定している場合は、Claude Code 用の Anthropic Base URL を使わないでください。Anthropic 形式の API を想定している場合は、OpenAI 互換の
/v1 エンドポイントを使わないでください。
よくある間違い
- 同じモデル名をすべてのプロトコルで変更せずに使えると考える。
- Claude Code に OpenAI 互換 Base URL を設定する。
- Codex、Cursor、Cline に Anthropic 互換 Base URL を設定する。
- Claude.ai または ChatGPT のサブスクリプションを API Key として扱う。
- API Key だけを変更し、Base URL と Model ID が一致していない状態にする。