BroadRouter
始める

Claude Code でオープンモデルを使う:プロキシ、ネイティブエンドポイント、制限

BroadNet Inference チーム · 約 6 分で読めます · 公開日

Claude Code は Anthropic Messages API のリクエストを ANTHROPIC_BASE_URL に送ります。OpenAI 互換のプロバイダーを使うには、LiteLLM などの変換プロキシを起動して Claude Code を向けるか、DeepSeek や Z.ai のように Anthropic 形式のエンドポイントを持つプロバイダーを選びます。Anthropic は Claude 以外のモデルをサポートしないので、ツール、キャッシュ、コンテキスト上限は自分でテストしてください。

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 形式を使うエージェントと組み合わせてください。

よくある質問

Claude Code で DeepSeek を使えますか?

はい、2 つの方法があります。DeepSeek は Anthropic 形式のベース URL https://api.deepseek.com/anthropic を公開しており、claude-sonnet と claude-haiku の名前を deepseek-flash に、claude-opus の名前を deepseek-v4-pro に対応付けます。または、DeepSeek のモデルを提供している任意の OpenAI 互換ホストの前に、LiteLLM のような変換プロキシを置きます。

Claude Code は OpenAI 互換 API で動きますか?

直接は動きません。Claude Code は Anthropic Messages API のリクエストを /v1/messages に送ります。LiteLLM のようなプロキシがそのリクエストを受け取り、OpenAI 形式の /chat/completions エンドポイントに転送し、応答を変換して返します。

Claude Code でほかのモデルを使うことを Anthropic はサポートしていますか?

いいえ。Claude Code のゲートウェイのドキュメントには、どのゲートウェイ経由でも Claude Code を Claude 以外のモデルにルーティングすることは Anthropic としてサポートしないとあります。実際には多くの人が使えていますが、その経路のバグは自分で調べることになります。

Claude Code の背後には BroadNet のどのモデルを使うべきですか?

GLM 5.3 か Qwen3.8 27B です。BroadNet がツール呼び出しをドキュメント化しているのはこの 2 つだけで、Claude Code はファイルの編集やコマンドの実行をツールで行います。GLM 5.3 のコンテキストは 1,048,576 トークン、Qwen3.8 27B は 262,144 トークンで画像も受け付けます。

BroadNet の無制限プランで Claude Code を動かせますか?

ドキュメント上で想定された組み合わせではありません。定額プランの対象は DeepSeek V4.1 Flash だけで、BroadNet はこのモデルのツール呼び出しをドキュメント化していません。また、プランのセッションは同時に 1 リクエストしか実行しませんが、Claude Code はサブエージェントを並列で動かすことがあります。

LiteLLM 経由で Claude Code が Invalid model name と表示するのはなぜですか?

Claude Code が config.yaml に定義されていないモデル名を要求したためです。多いのは、組み込みの Claude のエイリアスか、バックグラウンドで使う Haiku モデルです。ANTHROPIC_MODEL と ANTHROPIC_DEFAULT_HAIKU_MODEL を model_list の名前に設定してください。

Markdown で読むChatGPT に聞くClaude に聞くPerplexity に聞く