DeepSeek

DeepSeek は自社のモデルを Anthropic 互換エンドポイントで提供します — shunt は Claude Code の Messages リクエストをそのまま転送し、DeepSeek の API キーを注入します。組み込みのプリセットはないため、 upstream で kind と base_url を明示的に宣言します。

クイックスタート

コーディングエージェントにセットアップを任せることもできます — 名前付きブループリントのないプロバイダーでは、 shunt add がドキュメント URL を汎用のリサーチガイドに差し込みます（オフラインかつ読み取り専用で、設定を 編集するのはエージェントです。このコマンド自体は編集しません）。

shunt add upstream https://api-docs.deepseek.com/guides/anthropic_api --print | claude

または、以下の手順に沿って手動で設定してください。

upstream を設定する

[[upstreams]]
name = "anthropic"
provider = "anthropic"   # ルーティングされないモデル（例 claude-*）のデフォルトとして Anthropic を残す

[[upstreams]]
name = "deepseek"
kind = "anthropic"
base_url = "https://api.deepseek.com/anthropic"
auth = { mode = "api_key", env = "DEEPSEEK_API_KEY" }

[[routes]]
model = "deepseek-v4-pro"
provider = "deepseek"

[[routes]]
model = "deepseek-v4-flash"
provider = "deepseek"

順序付きの [[upstreams]] は shunt の組み込みプロバイダーを置き換えるため、設定側でフォールバック先の anthropic デフォルトも宣言する必要があります（server.default_provider のデフォルトは anthropic）。

従来の [providers.deepseek] テーブル形式も引き続きサポートされます — ただし [[upstreams]] と [providers.*] を 1 つのファイルで混在させないでください。

認証情報

export DEEPSEEK_API_KEY='...'

キーを設定ファイルに書き込まないでください。shunt check は設定の構造を検証しますが、キーの値は読み取り ません — DEEPSEEK_API_KEY が未設定の場合、deepseek へルーティングされた最初のリクエストが認証エラーを 返します。

モデル

ルーティング済みの id は、Claude Code で ANTHROPIC_MODEL、ANTHROPIC_CUSTOM_MODEL_OPTION、または サブエージェントの model: フロントマターから選択します。代わりに /model ピッカーへエントリを出したい 場合は、[models.upstream_model] マップとともに claude プレフィックス付きのエイリアスを広告してください — Model Discovery を参照。

検証

shunt check    # -> config ok
shunt run
curl -sS http://127.0.0.1:3001/v1/messages \
  -H 'anthropic-version: 2023-06-01' \
  -H 'content-type: application/json' \
  -d '{"model":"deepseek-v4-flash","max_tokens":16,"messages":[{"role":"user","content":"Reply with OK."}]}'

レスポンスの x-gateway-upstream ヘッダーが deepseek を示すことを確認したら、 Claude Code を shunt へ向けてください。

サブエージェントプラグイン

shunt-deepseek プラグインは、 上記の各モデルにつき 1 つずつ、既製の Claude Code サブエージェントを出荷しています。

/plugin marketplace add pleaseai/shunt
/plugin install shunt-deepseek@shunt