Claude Code + DeepSeek V4 Flash: 接続方法とタスク単価

DeepSeekにはAnthropic形式のエンドポイント — https://api.deepseek.com/anthropic — があり、Claude Code向けの公式ガイドも用意されています。キーはDeepSeekの管理画面（platform.deepseek.com）で作成し、残高は事前にチャージしておきます。2026年11月2日時点のDeepSeekのガイドに載っている環境変数は次のとおりです：

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-your-deepseek-key
export ANTHROPIC_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-flash
export CLAUDE_CODE_EFFORT_LEVEL=max
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=786432
claude

初回起動の前に知っておきたいこと：

• モデル名。2026年9月10日以降、deepseek-flashはV4.1 Flashを指し、10月17日からは同じ価格のままアップデート版1017になっています。旧名のdeepseek-v4-flashもDeepSeekはまだ受け付けていますが、返ってくるのは同じV4.1 Flashです。接尾辞[1m]はモデルのコンテキストウィンドウが100万トークンであることをClaude Codeに伝え、CLAUDE_CODE_AUTO_COMPACT_WINDOWは履歴をどの容量で圧縮するかを指定します。
• Claudeの名前。Claude CodeでClaudeという名前のモデルを指定すると、DeepSeekが自社モデルに差し替えます。claude-opus系の名前はV4 Proに振り分けられてV4 Proの価格で課金され、それ以外はdeepseek-flashに送られます。そのためガイドではすべてのエイリアスを明示的に固定しています。
• ピーク時間帯。2026年8月16日以降、DeepSeekは平日のUTC 01:00〜04:00と06:00〜10:00（中国の祝日を除く）に倍額を適用します。北京時間ではほぼ一日の勤務時間全体、ヨーロッパでは朝、アメリカでは夕方から夜にかけてにあたります。
• ウェブ検索。Claude Codeが組み込みツールでインターネットを検索するとき、検索を実行するのはDeepSeek自身です。2026年10月31日からこれは有料になり、成功した1,000リクエストあたり$0.75、加えてモデルが検索結果を読むために消費するトークンもかかります。

GonkaネットワークではDeepSeek V4 Flashのバージョン0731が稼働しています — MITライセンスのオープンウェイトです。ゲートウェイはClaude CodeのリクエストをAnthropic形式（/v1/messages）でそのまま受け付けるので、間に中間層は不要です。

ステップ1. キー。JoinGonka Gatewayに登録すると — 新規アカウントには3Mの無料トークンが付与されます — 管理画面でjg-…キーを作成します。

ステップ2. インストーラー。

npx @joingonka/setup --tool claude-code --model deepseek

インストーラーはキーを尋ね、~/.claude/settings.jsonのコピーを保存し、envブロックに自分の変数だけを書き込みます：ゲートウェイのアドレスとキー、現在および新規セッション用のモデル、エイリアスopus、sonnet、fableおよびサブエージェント用のモデル、Claude Codeがバックグラウンドタスクを維持するエイリアスhaiku用のMiniMax M2.7、モデルの実際の上限 — 380,000トークンのウィンドウと最大32,768の応答。その他の設定には触れず、キーのファイルには600権限を設定します。最後にインストーラーは実際のリクエストでキーを検証します。同じインストーラーは他のプログラムも設定できます — すでに25あり、Codex CLIやOpenCodeも含まれます。

ステップ3. 確認。claudeを起動し/statusを開きます：ゲートウェイのアドレスを含むAnthropic base URL行と、ANTHROPIC_AUTH_TOKENを含むAuth token行があるはずです。次にコードに関するタスクを渡します。例えばRead calc.py and tell me in one sentence whether it has a bug.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gate.joingonka.ai",
    "ANTHROPIC_AUTH_TOKEN": "jg-your-key",
    "ANTHROPIC_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMaxAI/MiniMax-M2.7",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "380000",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32768"
  }
}

Windowsや単一プロジェクトのみの設定を含むすべての設定方法は、Claude Codeガイドにあります。

実務ではこういう意味になります：

• モデルバージョン。 V4.1 Flashのほうが新しく、DeepSeek自身のテストでも高性能です。Terminal-Bench 2.1ではV4.1 Flashが90.6、V4 Flash 0731が82.7（9月10日と7月31日リリースのデータによる）。画像、100万トークンのウィンドウ、最新バージョンが必要なら、公式API DeepSeekを選びましょう。大量処理のコストと時間帯を問わない均一価格を重視するなら、ゲートウェイ経由のV4 Flashをご自身のタスクで比較してみてください。無料トークンで始められます。
• 長時間セッション。 380,000トークンのウィンドウには100万トークンより入る履歴が少なくなります。通常業務なら十分です。2026年10月の当社ゲートウェイ経由でのDeepSeek V4 FlashへのClaude Codeの平均リクエストは約96,000トークンです。

モデル自体の詳細はGonkaネットワークのDeepSeek V4 Flashに関する記事をご覧ください。

まず、2026年11月2日時点の100万トークンあたりの価格です — DeepSeekの価格ページとOpenRouter APIによるものです。DeepSeekの隣には、OpenRouterの最安プロバイダーにおける同じV4 Flash 0731を並べています：

通常の入力は当社ではDeepSeekより24〜49倍安く、出力は32〜65倍です。ただし、DeepSeekのキャッシュ読み取りはピーク時にはほぼ当社の入力と同程度、それ以外の時間帯では当社の半額となり、Claude Codeはほぼ常に同じもの — システムプロンプト、ツール定義、セッション履歴 — を読み直します。そのため、トークン単価ではなくタスク全体で比較する必要があります。

タスク。モデルへの30回の呼び出しからなるタスクを考えましょう — 例えば、バグを見つけ、コードを修正し、テストを実行する場合です。2026年10月の当社ゲートウェイのデータによると、DeepSeek V4 FlashへのClaude Codeのリクエストは平均で入力約96,000トークン、出力0.9千トークンです。合計で、タスクは入力290万トークン、出力27,500トークンとなります。Claude Codeは各ステップでセッションを再送信し、そのほとんどが前回のリクエストと重複するため、DeepSeekとOpenRouterでは入力の95%がキャッシュから読み取られると仮定します。

金額は2026年11月2日時点の価格で計算されています。このページの当社のトークン単価はリアルタイムでGNKレートとともに変動します。このタスクでは、ゲートウェイはDeepSeekのピーク時より約5倍、それ以外の時間帯より2.5倍、OpenRouterの同じモデルの最安プロバイダーより2.3倍安くなります。

差はキャッシュ次第です。入力の98%がキャッシュから読み取られる場合、DeepSeekはピーク外で当社より約1.8倍、ピーク時で3.7倍高くなります。90%の場合 — 3.7倍と7.4倍です。当社ではキャッシュ比率は金額に影響しません：入力はすべて同一価格です。月次計算、GLM-5.3 Flashのケース、参考としてのClaude自身の価格は「Claude Codeを安く」の記事をご覧ください。

Claude Code Router（CCR）はMITライセンスのオープンソースプロジェクトです。お使いのコンピュータ上で動作するローカルゲートウェイで、デフォルトはhttp://127.0.0.1:3456です。Claude Codeやその他のエージェントがリクエストを送ると、CCRが選択されたプロバイダーへ転送します。リクエストをフォーマット間（Anthropic Messages、OpenAI Chat、Responses、Gemini）で変換し、ルールに基づいてタスクをモデルごとに振り分け、障害時には代替モデルへ切り替え、トークン数とコスト見積もり付きのリクエストログを記録します。macOS、Windows、Linux用のアプリとして、またはnpm install -g @musistudio/claude-code-routerコマンドでインストールできます（Node.js 22以上が必要）。

DeepSeek一社だけならCCRは不要です。DeepSeekにはAnthropicフォーマットの専用エンドポイントがあり、JoinGonka GatewayもClaude Codeのリクエストを直接受け付けます。CCRが役立つのは次のような場合です：

• 複数のプロバイダーを登録し、どのタスクをどこへ送るかのルールを管理したい；
• メインモデルが応答しないときに自動で代替モデルへ切り替えたい；
• リクエスト、トークン、コストのログを一か所で確認したい；
• OpenAIフォーマットしか理解しないプロバイダーを接続したい。

CCRはカスタムエンドポイントをAnthropic MessagesまたはOpenAI Chatプロトコルで接続でき、当ゲートウェイは両方に対応しています。ベースアドレスはAnthropic用がhttps://gate.joingonka.ai、OpenAI用がhttps://gate.joingonka.ai/v1です。詳細はGonka APIドキュメントのAnthropic Messagesセクションをご覧ください。

Claude CodeはサードパーティAPIのキーを次の2つの変数のいずれかから取得します：

• ANTHROPIC_AUTH_TOKEN — キーはAuthorization: Bearerヘッダーで送信され、すぐに有効になります。DeepSeekのガイドも当社のインストーラーもこの方式です。
• ANTHROPIC_API_KEY — キーはx-api-keyヘッダーで送信されます。対話モードではClaude Codeが一度だけ使用するか確認します。

DeepSeekもJoinGonkaも両方のヘッダーを受け付けます。キーの変数が設定されている間は、claude.aiのサブスクリプションは消費されません。Claude Codeはあなたのログイン情報を記憶していますが送信はせず、リクエストはそのキーの残高から支払われます。キーなしでアドレスだけを設定すると、Claude Codeは新しいアドレスにclaude.aiのログイン情報を送信し、リクエストは失敗します。

キーは~/.claude/settings.jsonまたはプロジェクトの.claude/settings.local.jsonに保存してください。リポジトリの共有.claude/settings.jsonには保存しないでください。通常コミットされてしまいます。--scope localフラグ付きのインストーラーはsettings.local.jsonに書き込み、自動的に.gitignoreに追加します。

Claudeに戻るには、envブロックからDeepSeekやゲートウェイを指す行を削除し、Claude Codeを再起動します。すると再びclaude.aiのログイン情報が使われます。