DeepSeekガイド
DeepSeekをClaude Code・Codexなど開発ツールで使う方法
DeepSeek APIはOpenAIのResponses API形式とAnthropic形式に対応しているため、Claude CodeやCodexなどのコーディング支援ツールの裏側のモデルとして使えます。公式の連携ガイド(2026年11月11日確認)の内容を、日本語で整理しました。
公式が連携ガイドを載せているツール
公式ドキュメントの「Agent Integrations」には、次のツールの手順が載っています。
- DeepSeek Harness(開発者向けプレビュー)
- Claude Code(ターミナルで動くAIコーディング支援)
- Codex(OpenAIのコーディング支援。CLI、デスクトップアプリ、VS Code拡張で設定を共有)
- OpenCode、OpenClaw、Hermes、Reasonix、WorkBuddy/CodeBuddy、Qoder
ここでは日本の開発者に利用者が多いClaude CodeとCodexを説明します。
Claude Codeで使う(Anthropic形式)
公式の手順では、環境変数でClaude Codeの接続先をDeepSeekのAnthropic形式のURLに向けます。以下は公式の例(Linux/Mac)から主な項目を抜き出したものです。
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<DeepSeekのAPIキー>
export ANTHROPIC_MODEL=deepseek-flash[1m]
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-flash公式のページには、ほかにモデル名の割り当て(OPUS・SONNET・HAIKU)や、自動圧縮の設定(CLAUDE_CODE_AUTO_COMPACT_WINDOW)などの例も載っています。実際に設定するときは、公式の最新の例を丸ごと確認してください。Windows(PowerShell)では $env:ANTHROPIC_BASE_URL="..." の形で設定します。
Codexで使う(Responses API)
CodexはResponses APIでモデルと通信します。DeepSeek APIはこれに対応しているため、設定ファイル(~/.codex/config.toml)にDeepSeekをモデル提供元として登録します。公式は一括設定スクリプトを用意しており、メニューで次を選べます。
| 選択肢 | 内容 |
|---|---|
| 1 | deepseek-flashを使う設定(画像入力も可) |
| 2 | deepseek-v4-proを使う設定 |
| 9 | Codexの標準の設定に戻す(DeepSeek関連の設定を削除) |
- スクリプトは実行前に既存の設定(config.toml)を ~/.codex/backup-deepseek/ にバックアップします(公式の説明)。
- 公式のスクリプト(1.5.0)はCodex 0.164以降が必要で、検索機能(Alpha Search)が既定で有効になります。
- ネットからスクリプトを取って実行する形式なので、実行前に中身を読み、公式のドメイン(cdn.deepseek.com)のものか確認してください。
料金で気をつけること
- 検索(Search)と取得(Fetch)は別料金で、1,000回あたり$0.75です。公式の2026年10月17日のお知らせでは、DeepSeek Harness・Claude Code・Codexのサーバー側ツールから呼ぶ分は「当面無料」とされ、課金は2026年10月31日16:00(UTC)からと案内されていました。
- コーディング支援ツールは、プロジェクトのファイルを何度も読み込みます。コンテキストキャッシュが効くと入力が大幅に安くなるため、料金のページの「キャッシュあり」の単価を確認してください。
- 夜間・週末(通常時間)に長い作業を回すと、単価が半分になります。
AIが書いた変更を受け入れる前の確認
- 差分を読む。変更されたファイルと行を、自分の言葉で説明できるか確かめます。
- テストを動かす。テストが無いときは、動作確認の手順を先に書かせます。
- 秘密情報が混ざっていないか見る。.env、キー、本番のURL、顧客データがコミットに入っていないか確認します。
- 小さい単位でコミットする。1つの変更を1コミットにすると、戻すのが簡単です。
- 他のAIにも差分を読ませる。書いたモデルと別のモデルでレビューすると、見落としが減ります。
確認した公式資料
- DeepSeek API Docs「Integrate with Claude Code」
- DeepSeek API Docs「Integrate with Codex」
- DeepSeek-V4.1-Flash-1017 Update(2026年10月17日)
上の資料は2026年11月11日に確認しました。内容は予告なく変わるため、使う前に公式のページで最新の表示を確かめてください。
あわせて読むページ
よくある質問
Claude Codeの裏側をDeepSeekにすると何が変わりますか?
回答を作るモデルがDeepSeekになり、料金はDeepSeek APIの従量課金になります。Claude Codeの操作そのものは変わりません。
Codexの設定を元に戻せますか?
公式の設定スクリプトのメニュー9で、標準の設定に戻せます。実行前の設定は ~/.codex/backup-deepseek/ にバックアップされます。