DeepSeek V4 + Claude Code エージェント統合ガイド 2026

Claude CodeをDeepSeek V4経由でルーティングし、1/35のコストでエージェントコーディングを実現。OpenRouterのセットアップ、AnyCap機能拡張、コスト最適化のヒントを網羅したステップバイステップガイド。

DeepSeek V4はClaude Code向けに最適化されています。 CNBCはリリース当日にそう報じました。公式ドキュメントもV4のエージェントコーディングベンチマークがオープンソースSOTAであることを確認しています。しかし、「このモデルはエージェントと動作する」と「具体的にどう設定するか」の間には大きな溝があります。このガイドはその溝を埋めます——実際のコマンドとともに、モデルルーティング、機能拡張、コスト最適化を段階的に解説します。

DeepSeek V4 + Claude Codeが優れたスタックである理由

DeepSeek V4 ProはエージェントコーディングベンチマークでGPT-5.5およびClaude Opus 4.7に匹敵しながら、コストはわずか：入力トークン100万あたり$0.28（GPT-5.5の$5/1Mと比較）。100万トークンのコンテキストウィンドウをサポートし、コードベース全体を一度に取り込めます。Apache 2.0ライセンスのため、使用制限なしにセルフホスト可能です。DeepSeek V4の機能と制限の詳細は、DeepSeek V4機能ガイドをご覧ください。

Claude CodeはAnthropicのターミナルネイティブな自律コーディングエージェントです。リポジトリを読み込み、複数ステップの変更を計画し、ファイルを編集し、テストを実行し、失敗を繰り返し改善します。MCP（モデルコンテキストプロトコル）をネイティブサポートしており、コード以外の機能に拡張できます。Claude Codeが初めての方は、インストールガイドとClaude Code vs Cursor比較から始めてください。

組み合わせは明快です：DeepSeek V4が推論とコード生成を担当。Claude Codeがエージェント実行（ファイル読み込み、コマンド実行、Git管理）を担当。AnyCap（またはMCPサーバー）がマルチモーダル機能（画像生成、動画、Web検索、ストレージ、公開）を担当します。

前提条件

開始前に以下を確認してください：

DeepSeek V4 APIアクセス — DeepSeekプラットフォーム（api.deepseek.com）、OpenRouter、またはセルフホスト経由。設定オプションはDeepSeek V4開発者ガイドをご覧ください。
Claude Codeのインストール — claude --versionがバージョン番号を返す必要があります。返らない場合：curl -fsSL https://claude.ai/install.sh | bash
Node.js 18+ — Claude CodeとnpmベースのツールのためにЛ
APIキーまたはOpenRouterキー — Claude CodeをDeepSeek V4経由でルーティングするため

ステップ1：Claude CodeをDeepSeek V4経由でルーティング

Claude CodeはデフォルトでAnthropicのClaudeモデルを使用します。DeepSeek V4を推論エンジンとして使用するには、Claude CodeエージェントプロトコルとDeepSeek V4 APIの両方をサポートするモデルプロバイダー経由でルーティングする必要があります。

オプションA：OpenRouter（素早いセットアップに推奨）

OpenRouterはAnthropicとDeepSeekモデルへの統合APIアクセスを提供します。openrouter.aiで登録してAPIキーを取得し、Claude Codeを設定します：

export OPENROUTER_API_KEY=sk-or-your-key-here
claude --model openrouter/deepseek/deepseek-v4-pro

Flashバリアント（より高速・低コスト、$0.14/1Mトークン）の場合：

claude --model openrouter/deepseek/deepseek-v4-flash

オプションB：DeepSeek APIダイレクト + カスタムエンドポイント

DeepSeek APIへの直接アクセスがある場合、カスタムエンドポイントを設定します。Claude Codeの設定または環境変数で：

export ANTHROPIC_BASE_URL=https://api.deepseek.com/v1
export ANTHROPIC_API_KEY=sk-your-deepseek-key
claude --model deepseek-v4-pro

注意：直接APIルーティングには互換性の違いがある場合があります。まずシンプルなプロンプトでテストしてください：「このプロジェクトのアーキテクチャを3文で説明してください。」

オプションC：DeepSeek V4セルフホスト

DeepSeek V4をローカルで実行している場合（llama.cpp、vLLMなど）、Claude Codeをローカルエンドポイントに向けます：

export ANTHROPIC_BASE_URL=http://localhost:8000/v1
claude

4ビット量子化されたDeepSeek V4 Flashはコンシューマー向け単一GPUで動作します。V4 ProはVRAMを多く必要としますが、ワークステーション級ハードウェアで実行可能です。

ルーティングの確認

Claude Codeセッションを開始し、アクティブなモデルを確認します：

> What model are you running on?

Claude Codeは設定されたルート経由でDeepSeek V4上で動作していることを示す応答をするはずです。

ステップ2：AnyCap でマルチモーダル機能を追加

DeepSeek V4はテキスト専用モデルです。画像生成、動画作成、Web検索、ファイル保存、コンテンツ公開はできません。Claude Codeはエージェント実行レイヤー（ファイル読み込み、コマンド実行、Git管理）を提供しますが、これらの機能も追加しません。

AnyCap がこのギャップを埋めます。MCPスキルとしてインストールします。MCP設定オプションの詳細は、MCPでClaude Codeに機能を追加するガイドをご覧ください：

npx -y skills add anycap-ai/anycap -a claude-code

一度認証します：

anycap login

これでDeepSeek V4 + Claude Codeエージェントが以下を実行できます：

機能	エージェントセッションでのコマンド
画像生成	`anycap image generate "説明"`
動画作成	`anycap video generate "説明"`
Web検索	`anycap search "クエリ"`
ファイル保存	`anycap drive upload ./パス`
ページ公開	`anycap page publish ./file.md`

ステップ3：プロジェクトコンテキストの設定

Claude Codeは各セッション開始時にCLAUDE.mdファイルを読み込んでプロジェクトの永続的なコンテキストとします。DeepSeek V4セットアップに合わせてカスタマイズしたファイルを作成します：

# CLAUDE.md

## モデル設定
- OpenRouter経由でDeepSeek V4 Proを使用
- 100万トークンのコンテキストウィンドウが利用可能
- テキスト専用モデル — マルチモーダルタスクにはAnyCap を使用

## 機能拡張
- 画像生成：anycap image generate
- 動画生成：anycap video generate
- Web検索：anycap search
- ファイルストレージ：anycap drive upload
- 公開：anycap page publish

Claude Code内で/initを使って初期バージョンを生成し、上記のセクションでカスタマイズします。Claude Codeの設定についての詳細は、高度な機能ガイドをご覧ください。

ステップ4：実際のワークフローをエンドツーエンドで実行

スタックのすべてのコンポーネントをテストする完全なワークフローです：

1. "AgentMetrics"というSaaS製品のランディングページを構築
   - 1つのエンドポイントを持つFastAPIバックエンド
   - シンプルなHTML/CSSフロントエンド
   - すべてのコード生成にDeepSeek V4を使用

2. ランディングページ用のヒーロー画像を生成
   - anycap image generate を使用

3. 生成したアセットを保存
   - anycap drive upload を使用

4. ランディングページを公開
   - anycap page publish を使用

推論にDeepSeek V4を使ったエージェントがランディングページを構築します。ヒーロー画像のためにAnyCap を呼び出します。アセットをDriveに保存します。結果を公開します。1つのセッション、3つのコンポーネントが連携します。

コスト最適化：V4 Flash vs V4 Pro

DeepSeek V4には2つのティアがあります。ワークフローに応じて選択してください：

バリアント	コスト（入力）	コスト（出力）	最適な用途
V4 Flash	$0.14/1Mトークン	$0.56/1Mトークン	素早い反復、シンプルなリファクタリング、コスト重視のワークフロー
V4 Pro	$0.28/1Mトークン	$1.12/1Mトークン	複雑なマルチファイルリファクタリング、アーキテクチャ設計、デバッグ

ほとんどのClaude Codeセッションでは、V4 Flashで十分です。モデルは高速で安価で、大半のコーディングタスクをうまく処理します。複雑な競合状態のデバッグ、新アーキテクチャの設計、20ファイル以上のリファクタリングなど、より深い推論が必要な場合はV4 Proに切り替えてください。

代替案とのコスト比較：

スタック	負荷の高いコーディングセッションあたりの概算コスト
Claude Code + Claude Opus 4.7	$5〜15（サブスクリプションまたはAPI）
Claude Code + GPT-5.5	$3〜10（APIトークン単価）
Claude Code + DeepSeek V4 Flash	$0.50〜2（APIトークン単価）
Claude Code + DeepSeek V4 Pro	$1〜4（APIトークン単価）

入力トークン$0.14/1MのDeepSeek V4 Flashは、Claude Opus 4.7の約1/35のコストです。毎日エージェントを使用する1ヶ月間で、その差は数百ドルになります。Claude Codeの料金プランの詳細はプラン比較をご覧ください。DeepSeek V4とGPT-5.5の直接比較は機能比較をご覧ください。

このスタックが優れている分野

大規模リファクタリング。 DeepSeek V4の100万トークンコンテキストウィンドウにより、Claude Codeはモノレポ全体を一度に取り込めます。50以上のファイルでのインターフェース名変更、インポートの更新、テストスイートの実行が単一の自律セッションで完了します。

予算に制約のあるエージェントワークフロー。 自律コーディングエージェントを求めているが月額$100〜200のClaude Maxは高額すぎるという場合、DeepSeek V4 Flash + Claude Code + AnyCap が同じエージェントアーキテクチャをわずかなコストで提供します。

セルフホスト・エアギャップ開発。 DeepSeek V4はApache 2.0ライセンスです。自分のハードウェアで実行できます。Claude Codeと組み合わせてエージェント実行を行います。インフラ内に留まる機能のためにAnyCap を追加します。データが環境外に出ません。

予算内でのマルチモーダルエージェントワークフロー。 DeepSeek V4が推論を担当します。AnyCap が画像、動画、検索、ストレージ、公開を担当します。マルチモーダルモデルへの支払いなしに完全なマルチモーダルエージェントが得られます。詳細はDeepSeek V4へのマルチモーダル機能追加ガイドをご覧ください。

よくある質問

DeepSeek V4はClaude Codeではなく Cursor でも動作しますか？

はい。同じルーティングパターンが適用されます。Cursorでは、設定 → モデル → カスタムモデルの追加からDeepSeek V4をモデルプロバイダーとして追加してください。AnyCap は同様にMCPスキルとしてインストールされます。エージェントシェルは互換性があります。

DeepSeek V4をOpenClawで使用できますか？

はい。CNBCはDeepSeek V4がOpenClaw向けに最適化されていると特別に報じました。セットアップパターンは似ています：OpenClawでモデルエンドポイントを設定し、機能のためにAnyCap をインストールします。

DeepSeek V4のエージェントコーディング性能は実際に競争力がありますか？

はい。V4 ProはSWE-bench Verifiedで81%を達成し、GPT-5.5とClaude Opus 4.7に匹敵します。エージェントコーディングベンチマークにおいて、DeepSeekはオープンソースSOTAを主張しています。価格差を考慮すると特に強力なパフォーマンスであることが、実際の開発者レポートによって確認されています。ベンチマークの詳細はDeepSeek V4開発者ガイドをご覧ください。

制限事項は何ですか？

DeepSeek V4はテキスト専用です——ネイティブのマルチモーダルはありません。Claude CodeのエージェントプロトコルはAnthropicモデル向けに設計されているため、一部のClaude固有の機能（拡張思考、特定の権限モデル）はDeepSeek V4ルーティングに完全に移植されない可能性があります。スタックを確定する前に、特定のワークフローをテストしてください。V4ができることとできないことの包括的な概要はDeepSeek V4機能ガイドをご覧ください。

Claude Opus 4.7を直接使用する場合との比較は？

Claude Opus 4.7 + Claude Codeは最も統合された体験です——すべてが一緒に動作するように設計されています。DeepSeek V4 + Claude Codeはより安価ですが、ルーティング設定が必要です。トレードオフはコスト対統合のスムーズさです。予算が制約でなければネイティブを使い続けてください。1/35のコストでフロンティアのエージェントコーディングが欲しければ、DeepSeek V4が選択肢です。

DeepSeek V4：完全な開発者ガイド — アーキテクチャ、ベンチマーク、API統合、セルフホスト、DeepSeek V4統合に必要なすべて。
DeepSeek V4 vs GPT-5.5：完全な機能比較 — ベンチマーク、料金、マルチモーダルのギャップ、デプロイの柔軟性を並べて比較。
DeepSeek V4エージェントへのマルチモーダル機能の追加方法 — 2分以内でDeepSeek V4エージェントに画像生成、動画、Web検索、クラウドストレージを追加。
Claude Code vs Cursor：2026年のAIコーディングエージェント対決 — ターミナルネイティブエージェント vs IDEフォーク。自律性、コンテキスト処理、料金、実際のタスクを比較。
MCPでClaude Codeにエージェント機能を追加する方法 — ステップバイステップのMCP設定ガイドとAnyCap のワンコマンド高速パス。

DeepSeek V4とClaude Codeのセットアップ：

# Claude CodeをDeepSeek V4経由でルーティング
export OPENROUTER_API_KEY=sk-or-your-key
claude --model openrouter/deepseek/deepseek-v4-pro

# マルチモーダル機能を追加
npx -y skills add anycap-ai/anycap -a claude-code

AnyCap をインストール · Claude Code セットアップガイド · DeepSeek V4 開発者ガイド

DeepSeek V4 × Claude Code：完全エージェント統合ガイド（2026年）