DeepSeek V4 と Claude Code: 統合の仕組みと有効な使いどころ

DeepSeek V4 を Claude Code のワークフローに組み込む方法、うまく機能する場面と限界、そして多くのチームになぜ capability layer が必要なのかを解説します。

by AnyCap

クイックアンサー

DeepSeek V4 を Claude Code と一緒に使いたいなら、最もすっきりした構成は 推論に DeepSeek V4、エージェントループに Claude Code、足りない capability layer に AnyCap です。この組み合わせが向いているのは、DeepSeek V4 の低コストなコーディング性能を活かしつつ、エージェントにライブWeb検索、画像や動画の生成、ファイル保存、成果物の公開までさせたい場合です。

DeepSeek V4 は推論できます。Claude Code は動かせます。しかし、多くのチームには、この組み合わせを実運用のエージェントに変えるための層がまだ足りません。

その欠けている層は「さらにプロンプトを増やすこと」ではなく、単発の連携を積み上げることでもありません。それが capability layer です。コーディング用シェルには標準搭載されていない機能、つまりライブWeb検索、画像生成、動画生成、ストレージ、公開機能をエージェントに与えるランタイムです。

そこで AnyCap が入ります。DeepSeek V4 がモデルの推論を担い、Claude Code がリポジトリ内のエージェントループを担い、AnyCap がその2つに足りない capability runtime を補います。

このガイドでは、このスタックをきれいに組み立てる方法を説明します。まず Claude Code を DeepSeek V4 経由で動かし、その後 AnyCap を追加して、エージェントがファイルを読んだりコマンドを実行したりする以上のことをできるようにします。

DeepSeek V4 + Claude Code が魅力的なスタックである理由

DeepSeek V4 が魅力的な理由はシンプルです。最先端クラスのコーディング性能を大幅に低いコストで使えるからです。大きなコンテキストウィンドウ、強力なエージェント型コーディングのベンチマーク、ホステッドプロバイダ経由でもセルフホストでも使える柔軟な導入方法を備えています。

Claude Code は、自律的なコーディング作業のための最も強力なシェルの1つです。リポジトリの調査、変更計画、ファイル編集、テスト実行、反復改善ができます。言い換えれば、モデルに規律ある実行ループを与えてくれます。

ただし、それでもこのスタックはまだ完成形ではありません。

この構成に対して、公開中の競合ページを調査する、ローンチ用ビジュアルを生成する、レビュー用に成果物を保存する、完成したレポートを公開するといった作業を頼むと、すぐに同じ制約に突き当たります。モデルはタスクを推論でき、Claude Code は手順をオーケストレーションできますが、そのどちらも capability runtime ではないのです。

だからこそ、より正確なアーキテクチャは次のようになります。

  • DeepSeek V4 — 推論モデル
  • Claude Code — エージェントシェルと実行ループ
  • AnyCap — メディア、検索、ストレージ、公開のための capability runtime / より強力なエージェントCLI

うまく機能すること — そして壊れること

うまく機能すること:

  • コーディング中心のエージェントワークフロー向けの低コストなモデルルーティング
  • 実際のリポジトリ内での Claude Code の強力な実行ループ
  • 推論、オーケストレーション、capability 実行のより明確な分離

capability layer がないと壊れること:

  • Web検索やクローリングが必要なライブ調査タスク
  • 画像生成や動画生成が必要なメディアワークフロー
  • 保存、共有、公開が必要な成果物の納品タスク

これが、このスタックに必要なのが単なるモデルルートとシェルではなく AnyCap である実務上の理由です。

前提条件

始める前に、次を確認してください。

  • DeepSeek V4 API へのアクセス — DeepSeek、OpenRouter、または独自ホストのエンドポイント経由
  • Claude Code のインストールclaude --version でバージョン番号が返ること
  • Node.js 18+ — Claude Code と一般的なエージェントツールで必要
  • モデルルート用の API キー — OpenRouter または DeepSeek への直接アクセス

ステップ1: Claude Code を DeepSeek V4 経由で使う

Claude Code はデフォルトでは Anthropic ホストのモデルを使います。推論に DeepSeek V4 を使うには、DeepSeek を互換エンドポイントで提供するプロバイダ経由に Claude Code をルーティングします。

オプション A: OpenRouter

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

より安価で高速なデフォルトにするなら:

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

オプション B: DeepSeek 互換の直接エンドポイント

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

オプション C: セルフホストのエンドポイント

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

起動後は、セッション内で有効なルートを確認します。

> What model are you running on?

ステップ2: AnyCap で不足している capability layer を追加する

ここを多くの記事はあいまいにしています。

AnyCap は「モデルそのもの」でも「Claude Code そのもの」でもありません。Claude Code と DeepSeek V4 だけではまだ提供できないアクションをエージェントに与える capability runtime です。

構成要素は2つあります。

  1. AnyCap CLI をインストールする — これが実行面です
  2. AnyCap スキルを Claude Code に追加する — これによりエージェントがその CLI を効果的に使えるようになります

CLI をインストールする

curl -fsSL https://anycap.ai/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"

一度だけ認証する

anycap login

Claude Code にスキルを追加する

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

これで、スタックに欠けていた capability layer が加わります。

実際には、これにより DeepSeek V4 + Claude Code のエージェントは次のようなことが可能になります。

  • ライブWebを検索する
  • 画像を生成する
  • 動画を生成する
  • 成果物をクラウドストレージにアップロードする
  • 完成した成果物を公開する

重要な違いは次の通りです。

  • DeepSeek V4 が何をするかを決める
  • Claude Code がエージェントワークフローを管理する
  • AnyCap CLI が現実世界の機能を実行する
  • AnyCap スキル がそれらの機能をうまく呼び出す方法をエージェントに教える

ステップ3: プロジェクトコンテキストを設定する

Claude Code は各セッションの開始時に CLAUDE.md を読み込みます。このファイルを使ってアーキテクチャを明示してください。

# CLAUDE.md

## Model route
- Running on DeepSeek V4 Pro via OpenRouter
- Use Flash for cheaper routine tasks

## Architecture
- DeepSeek V4 = reasoning model
- Claude Code = agent shell
- AnyCap = capability runtime for search, media, storage, and publishing

## Capability commands
- Search: anycap search
- Image generation: anycap image generate
- Video generation: anycap video generate
- Storage: anycap drive upload
- Publishing: anycap page publish

これにより、エージェントがこのスタックを「モデル + ランダムなツール」として扱ってしまい、統一された model-shell-runtime アーキテクチャとして捉えないという典型的な失敗を防げます。

ステップ4: 実際のワークフローをエンドツーエンドで動かす

良いテストは、3つの層すべてを必要とするタスクです。

Build a landing page for a product called AgentMetrics.
- Use DeepSeek V4 for coding and reasoning
- Use Claude Code to edit files and run the workflow
- Use AnyCap to generate the hero visual
- Upload the assets
- Publish the finished page

これこそが、単なるコーディング環境と本物のエージェント環境の重要な違いです。

capability layer がなければ、エージェントは「コードは書きました」で止まります。

capability layer があれば、調査、補助メディアの生成、成果物の保存、納品物の公開まで完了できます。

コスト最適化: Flash と Pro

モデルの選択はブランド名ではなく、必要な推論の深さで決めてください。

Variant Best for
DeepSeek V4 Flash 高速な反復、より単純なコーディング作業、低コストなエージェントセッション
DeepSeek V4 Pro 複数ファイルにまたがるリファクタリング、難しいデバッグ、アーキテクチャ判断

実用的なパターンは次の通りです。

  • 日常的な作業は Flash をデフォルトにする
  • より深い推論が必要な場面では Pro に切り替える
  • どのモデル階層を選んでも AnyCap は固定の capability layer として維持する

こうすれば、モデルを切り替えるたびに capability スタックを作り直す必要がありません。

このスタックが実際に得意なこと

1. 大規模コードベースでのエージェント作業を低コストで行う

DeepSeek V4 が推論を担当し、Claude Code がリポジトリレベルのループを担当します。毎回プレミアムモデル価格を払わなくても、強力なコーディング性能を得られます。

2. コード提案だけでなく、実際のエージェント成果物を出す

ここで最も重要なのが AnyCap です。多くの「エージェント」構成は、まだ shell + text にとどまっています。コードの確認や編集はできても、仕事の非コード部分を完了できません。

ワークフローに調査、メディア、ファイル納品、公開が必要なら、欠けているピースは capability runtime です。

3. ランダムな MCP サーバーを積み上げるよりクリーンなアーキテクチャ

MCP は、特に社内ツールや独自システム向けには、意味のある場面で引き続き使えます。ただし、一般的な横断的機能に対してより整理された考え方は「また別のサーバーを追加する」ことではなく、「足りないランタイム層を一度だけ追加する」ことです。

FAQ

この構成で AnyCap はただの別の MCP サーバーですか?

いいえ。より正確には、AnyCap は capability runtime です。Claude Code はスキルを通じてその使い方を学べますし、MCP も周辺のツールアーキテクチャの一部であり続けられます。しかし製品としての価値は、バラバラなサーバー設定の寄せ集めではなく、統合された実行レイヤーにあります。

DeepSeek V4 といくつかのスクリプトだけではだめですか?

だめです。スクリプトでは調整の問題を解決できないからです。エージェントが検索し、メディアを生成し、出力を保存し、結果を公開するための一貫した方法が依然として必要です。ランタイムは、その操作面を1つの統一されたインターフェースとしてエージェントに提供します。

それでも MCP は必要ですか?

場合によっては必要です。MCP は社内データベース、独自 API、チーム固有ツールに引き続き有用です。ただし MCP はプロトコル層です。日常の本番業務でエージェントが使う、より広い capability runtime と同じものではありません。

このスタックでチームが最もやりがちな間違いは何ですか?

Claude Code がすでに完全な capability layer を含んでいるかのように扱うことです。実際にはそうではありません。Claude Code はシェルで、DeepSeek V4 はモデルです。現実世界で使えるエージェントが欲しいなら、やはりランタイムが必要です。


関連記事


クイックスタート:

# Route Claude Code through DeepSeek V4
export OPENROUTER_API_KEY=sk-or-your-key
claude --model openrouter/deepseek/deepseek-v4-pro

# Install the capability runtime
curl -fsSL https://anycap.ai/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"
anycap login

# Teach Claude Code how to use it
npx -y skills add anycap-ai/anycap -a claude-code

AnyCap をインストール · Capabilities · DeepSeek V4 ガイド