Claude Code はすべてのリクエストを Anthropic Messages API 形式で、ANTHROPIC_BASE_URL が指す先の /v1/messages に送ります。一方、BroadNet Inference を含むほとんどのオープンモデルのプロバイダーは OpenAI 形式を使います。そのため、2 つの形式を変換するプロキシか、Anthropic 形式のエンドポイントを自社で公開しているプロバイダーが必要です。この記事では両方を説明し、やる価値があるかを左右する制限も取り上げます。
Claude Code が OpenAI 互換 API を直接呼べないのはなぜですか?
Claude Code のゲートウェイ互換性ガイドには、ゲートウェイが公開すべき形式が書かれています。通常のベース URL の場合は Anthropic Messages で、/v1/messages(/v1/messages/count_tokens は任意)と、anthropic-beta および anthropic-version ヘッダーの転送です。OpenAI 互換 API は /v1/chat/completions を提供しており、リクエストとレスポンスの形が違います。Claude Code を直接向けると、リクエストは失敗します。
始める前に、もう 1 つ知っておくべきことがあります。Claude Code のドキュメント自体に、Anthropic は “doesn’t support routing Claude Code to non-Claude models through any gateway.”(訳:どのゲートウェイ経由でも、Claude Code を Claude 以外のモデルにルーティングすることはサポートしていません。)とあります。それでも多くの人が使っていますが、Anthropic の誰かがデバッグしてくれることはありません。
3 つの選択肢は何ですか?
| 経路 | 仕組み | 向いているケース | トレードオフ |
|---|---|---|---|
| 変換プロキシ(LiteLLM) | Claude Code はローカルのプロキシと Anthropic 形式で通信し、プロキシが OpenAI 互換プロバイダーを呼ぶ | BroadNet など特定の OpenAI 互換プロバイダーを使いたい | 起動・更新するプロセスが 1 つ増える。変換の抜けがある |
| Anthropic 形式のネイティブエンドポイント | プロバイダー自身が /v1/messages を受け付ける |
DeepSeek や GLM のモデルを開発元から使う | 各社が一部のフィールドを対応付けるか無視する |
| 別のエージェント | OpenAI 互換のベース URL を受け付けるエージェントを使う | Claude Code にこだわらない人 | Claude Code のインターフェースと機能を手放す |
LiteLLM 経由で Claude Code を動かすには?
Anthropic 以外のモデル向けの LiteLLM のチュートリアルは、次の流れです。プロキシをインストールし、config.yaml でモデルを定義して起動し、Claude Code 側で 2 つの変数を設定します。形式の変換は LiteLLM が行うので、Claude Code は Anthropic のリクエストを送り続けます。
BroadNet のモデルは、LiteLLM ガイドと同じように、openai/ 接頭辞と api_base で定義します。
model_list:
- model_name: glm
litellm_params:
model: openai/broadnet/glm-5.3
api_base: https://inference.broadnet.ai/v1
api_key: os.environ/BROADNET_API_KEY
rpm: 30
- model_name: qwen
litellm_params:
model: openai/broadnet/qwen3.8-27b
api_base: https://inference.broadnet.ai/v1
api_key: os.environ/BROADNET_API_KEY
rpm: 30
general_settings:
master_key: os.environ/LITELLM_MASTER_KEY
プロキシを起動します。
uv tool install 'litellm[proxy]'
export BROADNET_API_KEY='your-broadnet-key'
export LITELLM_MASTER_KEY='sk-any-local-secret'
litellm --config config.yaml # listens on http://0.0.0.0:4000
次に Claude Code をプロキシに向けます。ANTHROPIC_AUTH_TOKEN は Authorization: Bearer ヘッダーとして送られ、LiteLLM はこれを読み取ります。
export ANTHROPIC_BASE_URL=http://0.0.0.0:4000
export ANTHROPIC_AUTH_TOKEN="$LITELLM_MASTER_KEY"
export ANTHROPIC_MODEL=glm # main model
export ANTHROPIC_DEFAULT_HAIKU_MODEL=qwen # background tasks
export ANTHROPIC_DEFAULT_SONNET_MODEL=glm # the sonnet alias
export ANTHROPIC_DEFAULT_OPUS_MODEL=glm # the opus alias
export CLAUDE_CODE_SUBAGENT_MODEL=glm # subagents
claude
コード中の英語のコメントは、順にメインモデル、バックグラウンドタスク、sonnet エイリアス、opus エイリアス、サブエージェントを指します。Claude Code で /status を実行し、Anthropic base URL の行にプロキシのアドレスが表示されることを確認してください。
モデルの変数は重要です。LiteLLM の Claude Code のページには、設定で定義していない組み込みの Claude の名前を選ぶと “Invalid model name passed in”(訳:無効なモデル名が渡されました)で失敗すると注意書きがあります。Claude Code の環境変数リファレンスによると、ANTHROPIC_DEFAULT_HAIKU_MODEL はバックグラウンドの機能にも使われるので、これも対応付けてください。そうしないと、バックグラウンドのリクエストがプロキシの知らない Haiku の名前を要求します。CLAUDE_CODE_SUBAGENT_MODEL はサブエージェントのデフォルトモデルを設定しますが、Claude がサブエージェントを起動するときに渡すモデル(多くは sonnet や haiku のようなエイリアス)のほうが優先されます。sonnet と opus のエイリアスも対応付けておけば、そうしたリクエストもプロキシが知っているモデルに解決されます。BroadNet のキーはプロキシの環境に置き、プロジェクトでコミットする .claude/settings.json には絶対に書かないでください。
プロキシなしで使える DeepSeek と GLM のエンドポイントは?
2 つのモデル開発元が Anthropic 形式のベース URL を公開しています。
| プロバイダー | ベース URL | モデルの扱い(各社のドキュメントより、2026-11-15 確認) |
|---|---|---|
| DeepSeek | https://api.deepseek.com/anthropic |
claude-sonnet* と claude-haiku* の名前は deepseek-flash に、claude-opus* は deepseek-v4-pro に対応。claude で始まらない名前は 400 を返す |
| Z.ai(GLM Coding Plan) | https://api.z.ai/api/anthropic |
キーは ANTHROPIC_AUTH_TOKEN に設定。手動設定の例では Opus と Sonnet を glm-5.3[1m]、Haiku を glm-5.3-flash[1m] に対応付け |
DeepSeek の 2026 年 9 月 10 日のリリースノートによると、deepseek-flash は DeepSeek-V4.1-Flash を提供します。Anthropic API のページには、無視されるものも列挙されています。cache_control、budget_tokens、disable_parallel_tool_use、anthropic-version ヘッダーなどです。deepseek-flash では assistant メッセージ内の画像は 400 になり、deepseek-v4-pro は画像を “[Unsupported Image]” に置き換えます。
Claude Code で DeepSeek か GLM だけを使いたいなら、これらのネイティブエンドポイントが最短の経路です。両者の料金とプランの制限は Claude API の代替ページで比較しています。
Claude 以外のモデルでは何が壊れたり変わったりしますか?
変換によってリクエストは流れますが、Claude Code のいくつかの機能は、プロキシやほかのモデルが通さないかもしれないものに依存しています。Claude Code のドキュメントは次の点を挙げています。
- **プロンプトキャッシュ。**Claude Code は
systemとメッセージのブロックにcache_controlを付けます。ゲートウェイや上流がこれを落としてもエラーにはなりませんが、毎ターンがキャッシュなしの入力として課金されます。OpenAI 互換の上流では、キャッシュはそのプロバイダー自身のルールに従います。BroadNet は、usage ブロックがキャッシュヒットを報告した場合にキャッシュ入力を安い単価で課金します。ログでcached_tokensを確認してください。 - トークンのカウント。
/v1/messages/count_tokensがないと、Claude Code は文字数ベースの推定に切り替えるので、/contextは概算になります。 - **コンテキストウィンドウ。**Claude Code は、知らないモデル名には独自のデフォルトのウィンドウを適用します。
CLAUDE_CODE_AUTO_COMPACT_WINDOW(100,000〜1,000,000 トークン)をモデルに合わせて設定してください。コンテキストが 262,144 トークンの Qwen3.8 27B では、それより十分低く設定してください。 - 未知のフィールド。
Extra inputs are not permittedやanthropic-betaの値を示す400は、上流のどこかがプレリリースのフィールドを拒否したことを意味します。ドキュメントはCLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1を勧めています。 - 思考。
MAX_THINKING_TOKENSと適応型の思考は Claude の機能です。BroadNet では DeepSeek V4.1 Flash、GLM 5.3、Qwen3.8 27B が回答の前に推論し、その推論トークンはmax_tokensに算入されます。回答が空で返る場合は、出力の上限を上げるか、reasoning_effortを low にして送ってください。推論モデルが空の回答を返す理由をご覧ください。 - **画像。**BroadNet の GLM 5.3 はテキストのみです。スクリーンショットを貼るなら Qwen3.8 27B を使ってください。
頼る前に、ファイル編集、シェルコマンド、長いセッションを含む実際のタスクを端から端までテストしてください。
Claude Code の背後に置く BroadNet のモデルはどれですか?
Claude Code はツール呼び出しでファイルを読み、編集し、コマンドを実行します。BroadNet の API リファレンスでは、2 つのモデルについてツール、構造化出力、推論をドキュメント化しています。
| モデル | 100 万トークンあたりの入力 / 出力 | コンテキスト | 画像 | ツールのドキュメント |
|---|---|---|---|---|
| GLM 5.3 | $0.78 / $3.46 | 1,048,576 | なし | あり |
| Qwen3.8 27B | $0.175 / $2.17 | 262,144 | あり | あり |
| DeepSeek V4.1 Flash | $0.175 / $0.52 | 1,048,576 | あり | ドキュメントなし |
大きなリポジトリでは GLM 5.3 がメインモデルとして自然な選択です。Qwen3.8 27B は入力トークンあたりが安く、画像や軽いバックグラウンドの呼び出しに使えます。どちらもチャージが必要で、$5 の初回クレジットの対象外です。GLM 5.3 と Qwen3.8 27B の比較で並べて比べられます。
BroadNet の定額プランを Claude Code で使えますか?
ドキュメント上で想定された組み合わせではないので、購入前に知っておくのが得策です。Full Moon、Orbit、Meteor の各プランの対象は DeepSeek V4.1 Flash だけで、BroadNet はこのモデルのツール呼び出しをドキュメント化していません。また、各プランのセッションは同時に 1 リクエストを実行します。Claude Code はメインのループと並行してサブエージェントやバックグラウンドタスクを動かすことがあり、それらのリクエストは 1 つのセッションで順番待ちになります。
定額料金が目的なら、Aider のように BroadNet がプランとの組み合わせをドキュメント化しているエージェントを使ってください。Claude Code には従量課金の GLM 5.3 か Qwen3.8 27B を使ってください。キーごとに 1 分あたり 30 リクエスト、同時実行 4 件まで使えます。429 が出たらエラーとリトライのとおりにバックオフしてください。
別のエージェントのほうがよいのはどんなときですか?
Claude Code そのものが必要でなければ、プロキシは省きましょう。opencode、Cline、Roo Code、Continue、Aider は、どれも OpenAI 互換のベース URL、キー、モデル ID を直接受け付けます。各ツールのフィールド名はコーディングエージェントでオープンモデルを使うにあり、opencode と Cline の設定ガイドもあります。構成要素が少ないほど、変換のバグも減ります。この用途でモデルを比べるには、コーディングエージェントに最適なオープンモデルをご覧ください。
拡張思考、Anthropic のプロンプトキャッシュ、最新の Claude Code のベータ機能など、Claude 固有の機能に作業が依存しているなら、Claude のモデルを使い続けてください。その場合は、モデルを替えるよりClaude Code の中でコストを下げるほうが適しています。
BroadNet Inference の位置づけ
BroadNet Inference は OpenAI 互換 API なので、Claude Code からは LiteLLM のようなプロキシ経由でしか使えません。プロキシの背後では、GLM 5.3 と Qwen3.8 27B がツール呼び出しをドキュメント化した 2 モデルで、トークン単位で課金され、リクエスト後に内容は保持されません。Anthropic 形式のネイティブエンドポイントが欲しいなら、DeepSeek と Z.ai のほうがシンプルです。BroadNet の定額プランを使いたいなら、OpenAI 形式を使うエージェントと組み合わせてください。
