メインコンテンツへスキップ

Claude CodeでOpenRouterとDeepSeekを使う:経路、設定、初回エラー対応

OpenRouter経由ならOpenRouterのキーとモデルID、DeepSeek直結ならDeepSeekのキーとモデル名を使います。二つの設定例と、認証・モデル・ツールの初回エラーを切り分ける手順を確認できます。

LaoZhang AI Team公開更新 24 分で読めます
目次
Claude CodeからOpenRouter経由またはDeepSeek直結でモデルを利用する接続の概念図

Claude CodeでDeepSeekを使う方法には、OpenRouterを通す方法と、DeepSeekのAnthropic互換APIへ直接接続する方法があります。どちらも提供元の現在の手順ではローカルプロキシを必須としていません。接続先のURLだけを変えず、キーの発行元とモデル名も同じサービスにそろえて設定します。OpenRouterの接続手順、DeepSeekのClaude Code設定

2026年10月6日時点で、OpenRouter経由の現行FlashモデルIDはdeepseek/deepseek-v4.1-flashです。DeepSeek直結ではdeepseek-flashがDeepSeek-V4.1-Flashに対応し、公式のClaude Code例は主モデルにdeepseek-flash[1m]を指定しています。同じDeepSeekでも、二つの名前はそのまま交換できません。OpenRouterの公開モデル一覧、DeepSeekのモデルと料金

OpenRouter経由とDeepSeek直結、どちらを選ぶか

既にOpenRouterの残高やモデル切り替えを使っているなら、OpenRouter経由から始めると管理をまとめられます。DeepSeekだけに直接接続したいなら、DeepSeek直結の設定を使います。課金と利用履歴も、選んだサービス側で確認します。

確認項目OpenRouter経由DeepSeek直結
Claude Codeのbase URLhttps://openrouter.ai/apihttps://api.deepseek.com/anthropic
Bearerトークンに渡すキーOpenRouterが発行したキーDeepSeekが発行したキー
今回のFlash指定deepseek/deepseek-v4.1-flashdeepseek-flash[1m]
モデルと利用条件の確認先OpenRouterのモデル情報・利用履歴DeepSeekのAPI文書・利用状況
選ぶ理由他社モデルも同じ窓口で扱いたいDeepSeekのAPIへ直接送りたい

OpenRouterのキーをDeepSeekのURLへ渡す、またはDeepSeek直結用の短いモデル名をOpenRouterへ渡すと、意図した設定になりません。モデルIDの存在だけで、自分のアカウントから利用できることやClaude Codeの全機能が動くことも確定しません。

この二つはAPIの従量利用です。Claudeのサブスクリプションを持っていることだけでは、OpenRouterやDeepSeekの料金は支払われません。接続前に選んだサービスの残高と利用条件を確認してください。DeepSeek直結の料金にはキャッシュや時間帯による区分があり、OpenRouter経由とは料金表を別々に確認する必要があります。OpenRouterの設定とクレジット、DeepSeekの料金条件

設定前に確認すること

以下の例は、Claude Codeをインストール済みで、利用するサービスのAPIキーを持っている人向けのBash用の一時設定です。macOSの標準シェルがZshなら、まずbashを開き、その中で一方の例だけを使います。キーは画面に表示せず入力し、コマンドに直接書き込みません。

接続先を切り替える前に、現在の設定を控えます。ただしキーの値をログやスクリーンショットへ残す必要はありません。元の接続先、認証方式、主モデル、役割別モデルの指定と、設定した場所が分かれば戻す手掛かりになります。

シェル以外にsettings.jsonのenvで同じ変数を指定していると、設定ファイル側の値が適用されます。/statusのSetting Sourcesで読み込まれた設定を確認できますが、その表示だけで各変数の最終的な値は特定できません。管理対象の端末、クラウドプロバイダーを選択した環境、SSOでClaude apps gatewayにログインしたセッションでは、以下の通常のBearer設定より別の条件が優先する場合があります。組織ポリシーによる拒否なら、設定を重ねず管理者へ確認します。環境変数と設定ファイル、認証の優先順位

認証方法や保存先全般を整理したい場合は、Claude CodeのAPIキーとsettings.jsonの設定手順も参照してください。ここではOpenRouterとDeepSeekの具体的な接続に絞ります。

OpenRouter経由でDeepSeekを設定する

OpenRouterが公開している現在の接続方法は、https://openrouter.ai/apiとBearerトークンを使い、ANTHROPIC_API_KEYを空にする形です。OpenAI形式のURLである/api/v1を、このbase URLへ独自に付け足さないでください。公式のClaude Code接続例

次の例は、主モデルと既存のOpus・Sonnet・Haikuの役割、サブエージェントに同じFlashモデルを指定します。キーを先に入力してから、ANTHROPIC_AUTH_TOKENへ渡す順序です。

bash
read -r -s -p 'OpenRouter API key: ' OPENROUTER_API_KEY
printf '\n'
export OPENROUTER_API_KEY
export ANTHROPIC_BASE_URL='https://openrouter.ai/api'
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY=''
export ANTHROPIC_MODEL='deepseek/deepseek-v4.1-flash'
export ANTHROPIC_DEFAULT_OPUS_MODEL='deepseek/deepseek-v4.1-flash'
export ANTHROPIC_DEFAULT_SONNET_MODEL='deepseek/deepseek-v4.1-flash'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='deepseek/deepseek-v4.1-flash'
export CLAUDE_CODE_SUBAGENT_MODEL='deepseek/deepseek-v4.1-flash'
claude

これはそのBashと、そこから起動したClaude Codeへ渡す設定です。標準の.envファイルがインストールだけで自動的に読み込まれる、と考えてはいけません。別のターミナルやDockから起動したアプリにも自動では引き継がれません。

起動後は/statusでbase URLと認証の表示を確認し、後述の「初回の動作確認」へ進みます。以前のAnthropicログインが表示され続ける場合、まずトークンがそのプロセスへ渡っているか、settingsやgateway設定に競合がないかを確認します。OpenRouterは過去のログインが残る場合の/logoutを案内していますが、この操作は現在の認証情報を削除・失効させます。必要性と戻る方法を確認してから使い、Keychainや履歴をまとめて削除しないでください。OpenRouterの認証切り替え、Claude Codeのログアウト動作

モデル一覧にDeepSeekが出ない場合

一覧に出ないだけなら、現行IDを直接指定して試せます。OpenRouterのモデル探索を使いたい場合は、次の変数を設定したうえでClaude Codeを再起動します。

bash
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

この機能は明示的に有効化する方式です。OpenRouterの全モデルが一覧へ出るわけではなく、選ばれた一部が返され、一覧は起動時に更新されます。探索が利用できない場合には、Claude CodeのANTHROPIC_CUSTOM_MODEL_OPTIONで一つのカスタム候補を追加する方法もあります。ただし、候補を表示したことはモデルの利用権限や互換性の保証ではありません。組織のavailableModels制限も確認してください。OpenRouterのモデル探索、Claude Codeのカスタムモデル

[1m]をモデル名の末尾に付ける場合、OpenRouterはその印を取り除いて転送します。印はClaude Code側のコンテキスト長の扱いを変えるもので、実際のサーバー容量を増やすものではありません。今回の公開一覧ではFlashのコンテキスト長は1,048,576ですが、実際に使うモデルと提供元の条件を確認してから長い入力へ進みます。

DeepSeekへ直接接続する

直結ではDeepSeekのキーを、DeepSeekのAnthropic互換エンドポイントへ渡します。現在の公式例では、主モデルとOpus・Sonnetの役割をdeepseek-flash[1m]、Haikuとサブエージェントをdeepseek-flashに設定しています。DeepSeekのClaude Code手順

bash
read -r -s -p 'DeepSeek API key: ' DEEPSEEK_API_KEY
printf '\n'
export DEEPSEEK_API_KEY
export ANTHROPIC_BASE_URL='https://api.deepseek.com/anthropic'
export ANTHROPIC_AUTH_TOKEN="$DEEPSEEK_API_KEY"
unset ANTHROPIC_API_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'
claude

角括弧を含むモデル名は引用符で囲みます。DeepSeekの公式例にはeffortや自動圧縮の調整もありますが、それらをすべての環境で必須の値とは扱いません。まずキー・URL・モデルをそろえ、応答を確認してから用途に応じて調整してください。

「動いたのに指定モデルと違う」を避ける

直結のモデル対応には、失敗せず別モデルへ進む場合があります。2026年10月6日時点のDeepSeek文書では、未対応のモデル名はFlashへ自動的に置き換えられます。claude-opus系の名前はdeepseek-v4-pro、Haiku・Sonnet系はFlashへ対応します。Proへの対応はProの料金になります。Anthropic互換APIのモデル対応

また、古いdeepseek-v4-flashやdeepseek-v4-flash-vision-expは受け付けられますが、現在はV4.1-Flashで処理され、Flashの料金で請求されます。この直結側の対応規則を、同名に見えるOpenRouter側のIDへ当てはめてはいけません。DeepSeekの旧モデル名の扱い

そのため、エラーがないことや、モデルに「あなたは何のモデルですか」と尋ねた答えだけでは、希望したモデルで処理されたと判断できません。明示的な現行名を使い、返されたモデル情報や提供元の記録も照合します。

主モデル以外の指定と、設定の保存先

接続先のURL、キーの発行元、モデル指定を同じサービスにそろえる設定の概念図

ANTHROPIC_MODELは主モデルの指定です。ANTHROPIC_DEFAULT_OPUS_MODELなどは役割別の別名に対応する指定、CLAUDE_CODE_SUBAGENT_MODELはサブエージェント用です。主モデルだけを変えた状態では、ほかの役割に以前の指定が残っている可能性があります。上の例は文書で案内されている役割をそろえたもので、将来追加される役割やすべてのリクエストの行き先を保証する一覧ではありません。Claude Codeの役割別モデル設定

モデル選択にも保存の影響があります。現行版で/model <名前>を使う、またはモデル選択でEnterを押すと、ユーザーの既定値として保存されます。そのセッションだけ試すなら、選択画面のsを使います。以前保存した別名が接続先変更後も残ることがあるため、切り替え直後は新規セッションで明示的なモデル指定を確認してください。モデル選択と保存

主モデルの選択順は、セッションの/model、起動時の--model、ANTHROPIC_MODEL、設定ファイルのmodel、ANTHROPIC_DEFAULT_MODELです。シェルで主モデルを指定しても、起動時のフラグやセッション中の選択が優先する点に注意します。モデルの指定順

繰り返し使う場合は、ユーザー設定または個人用のローカル設定へ、接続先とモデルの項目を保存できます。次はキーを含めないDeepSeek直結の設定例です。既存ファイルを丸ごと置き換えず、必要な項目を追加します。認証情報は引き続き起動するシェルなどから渡す必要があります。

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_MODEL": "deepseek-flash[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-flash[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-flash[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-flash"
  }
}

JSONに"ANTHROPIC_AUTH_TOKEN": "$DEEPSEEK_API_KEY"と書いても、その文字列を有効なキーとは扱えません。JSONはシェルのスクリプトではなく、シェルと同じ変数展開を前提にできないためです。秘密の保存が必要なら、組織の保管ルールに従って個人設定や配布されたhelperを選びます。共有する.claude/settings.jsonへキーを入れないでください。手作業で作る.claude/settings.local.jsonは自分でGitの除外も確認します。ゲートウェイの設定ファイルと認証情報

初回の動作確認:応答、モデル、ツールを分ける

新しいセッションで、まずファイルを変更しない短い質問を送ります。確認用のリクエストにもAPI料金が発生することがあります。返事が来たら、次の順で確かめます。

  1. /statusで接続先、認証とモデルの表示が意図に合うか確認します。これはクライアントが認識する設定です。
  2. OpenRouter経由ならOpenRouterの利用履歴を、直結ならDeepSeek側の利用状況や取得できるリクエスト記録を確認します。時刻、モデル、リクエストIDなど、照合できる項目を合わせます。
  3. 次に、許可した範囲で小さなファイルの読み取りなどを試します。文章の返事が来ることと、Claude Codeからツールを使えることは別に確認します。

モデルが自分で名乗った名前は接続の証拠になりません。/statusも実際に処理したサーバーの証明ではありません。また、利用画面にまだ記録がないことだけで「リクエストが届いていない」と断定せず、表示対象のアカウント・キー・時間範囲、取得できるログも確認してください。記録がモデル単位まで分かれない場合は、その範囲を超えて正確なモデルを断定できません。OpenRouterの確認手順、ゲートウェイの動作確認

DeepSeekのAnthropic互換APIはツール定義やtool_use・tool_resultに対応していますが、すべてのAnthropic機能が同じように処理されるわけではありません。たとえばcache_controlやthinkingのbudget、disable_parallel_tool_useは無視され、対応しないコンテンツ種別もあります。WebSearchは対応する一方、要約に追加のモデル処理と料金が発生します。OpenRouterのモデル一覧にtoolsとあることも、実際のツール品質の保証ではありません。DeepSeekの互換範囲

初回エラーでは、まず何を直すか

OpenRouterとDeepSeek直結で、認証・モデル・ツール・利用履歴の症状ごとに最初の確認を選ぶ図

エラーが出たら、キー・URL・モデルの三つを一度に入れ替えず、症状から確認項目を選びます。以下は原因を断定する表ではなく、最初に切り分ける手順です。

症状最初に確認すること次の動作
401・403など認証や権限のエラーキーの発行元とURL、トークンの受け渡し、有効期限や権限、組織設定正しいサービスのキーを同じ起動環境へ渡す。ポリシー拒否なら管理者へ確認する
404・model not foundbase URLと現在のモデルID、選択可能なモデル制限接続先に合う現行IDへ直す。直結の自動対応も確認する
設定したものと違うモデルが表示される/modelで保存した既定値、起動フラグ、settingsのenv、役割別指定指定元を修正して新規セッションで確認する
利用画面に記録がないアカウント・キー・時間範囲、クライアントの接続先、利用できるログ画面が静かなことだけで原因を決めず、同じリクエストの記録を探す
返事は来るがツールが失敗する・止まるエラー本文、対応パラメーター、ツールの応答形式、利用したモデルと提供元小さな読み取りで再現条件を絞る。HTTP成功だけで作業を続けない
予想外のサービス側へ料金が出る実際の認証・接続先と利用履歴追加リクエストを止め、設定元を確認して元へ戻す

DeepSeek直結の未知のモデル名はFlashへ対応するため、間違えた名前が必ず404になるわけではありません。逆に404が返っただけで認証が成功したとも判断できません。応答の内容と、使った接続先の仕様を確認します。DeepSeekのモデル対応、公式ゲートウェイの確認方法

元の接続先へ戻す

上の一時設定だけを追加し、それ以前に同じ変数を使っていなかった場合は、Claude Codeを終了して次の変数を外します。探索を有効化した場合は、その変数も含めます。

bash
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_API_KEY
unset ANTHROPIC_MODEL ANTHROPIC_DEFAULT_OPUS_MODEL
unset ANTHROPIC_DEFAULT_SONNET_MODEL ANTHROPIC_DEFAULT_HAIKU_MODEL
unset CLAUDE_CODE_SUBAGENT_MODEL CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY
unset OPENROUTER_API_KEY DEEPSEEK_API_KEY

以前から値があった変数は、単に消すのではなく元の設定へ戻します。settings.jsonやシェルの起動設定へ追加した値も、その場所で元に戻す必要があります。/modelで既定値を保存したなら、そのモデル設定も戻してください。シェルの変数を消すだけでは、設定ファイルや保存したモデルは変更されません。

元の接続方式で新規セッションを起動し、/statusと小さな応答で確認します。/logoutを使った場合は元の方式で再認証が必要になることがあります。ログインやKeychainを削除すること自体を、復旧の標準手順にはしません。

よくある質問

Claude CodeでDeepSeekを使うにはCCRが必要ですか?

現在のOpenRouterとDeepSeekの公式接続手順では必要ありません。どちらもClaude Codeへ直接設定するAnthropic形式の接続先を提供しています。Claude Code Router(CCR)などは、別途ルーティングや変換が必要な場合の選択肢です。導入すると確認対象が増えるため、この二つの直接設定で足りるなら先にそちらを使います。OpenRouterの直接接続、DeepSeekの直接接続

DeepSeekへ切り替えれば無料になりますか?

切り替えだけでは無料になりません。APIの料金と利用可能な残高は、選んだサービスの条件に従います。今回確認したOpenRouterのDeepSeek一覧には:freeの行はありませんでしたが、将来の無料枠や全サービスの条件を否定する情報ではありません。無料・無制限という古い説明を、この設定の料金保証にしないでください。OpenRouterの現行一覧、DeepSeekの料金

同じ設定をVS CodeやClaude Desktopでも使えますか?

ターミナルのexportだけで全部のアプリに適用されるわけではありません。VS Code拡張には認証の事前確認用のclaudeCode.environmentVariablesがあり、子プロセスのsettings環境変数とは範囲が違います。Claude Desktopの第三者接続には専用のThird-party inference設定が必要です。通常のクラウドセッションもこのCLIの変数で切り替わりません。各環境のゲートウェイ設定

この記事の設定は2026年10月6日の公式文書と公開モデル情報に基づいています。例の構文はローカルで確認していますが、実際のキーによる接続やツール実行、課金結果の試験は行っていません。

参考資料8

本文で参照している外部ページを、登場順に並べています。最終更新日:2026年10月7日。

  1. 1.OpenRouterの接続手順openrouter.ai/docs/cookbook/coding-agents/claude-code-integration
  2. 2.DeepSeekのClaude Code設定api-docs.deepseek.com/quick_start/agent_integrations/claude_code
  3. 3.OpenRouterの公開モデル一覧openrouter.ai/api/v1/models
  4. 4.DeepSeekのモデルと料金api-docs.deepseek.com/quick_start/pricing
  5. 5.環境変数と設定ファイルcode.claude.com/docs/en/llm-gateway-connect
  6. 6.認証の優先順位code.claude.com/docs/en/authentication
  7. 7.Claude Codeのカスタムモデルcode.claude.com/docs/en/model-config
  8. 8.Anthropic互換APIのモデル対応api-docs.deepseek.com/guides/anthropic_api
さらに読む: Claude Code
Claude Codeのインストール方法 2026年版 Mac Windows Linux完全ガイド
Claude Code

Claude Codeのインストール方法【2026年版】Mac・Windows・Linux完全ガイド

Claude Codeは、ネイティブCLIインストーラーを使用して、macOS、Linux、Windowsに依存関係ゼロで2分以内にインストールできます。本ガイドでは、ネイティブ、Homebrew、WinGet、npm、Windows CMD、WSLの6つのインストール方法を網羅。Claudeプランの選び方、認証設定、CLAUDE.mdの構成、よくあるエラーの解決方法、ターミナルでのAIコーディング開始までを詳しく解説します。

54 分
Claude Codeの流出事実と公開されているモデル・アカウント契約を並べて示す図
Claude Code

Claude Code ソース流出: BANリスク、現行モデル、アカウント構造を整理する (2026)

Claude Code では 2026 年 3 月に内部ソースコードの露出が実際に起きました。Anthropic は、これは外部侵害ではなくリリースのパッケージングミスであり、顧客データや認証情報は露出していないと説明しています。重要なのは、この事実を BAN の噂、古いモデル情報、Claude と Console の混同から切り分けることです。

15 分