3行でいうと
- 公式に用意されているのは、API(OpenAI形式とAnthropic形式。同じ api.deepseek.com)、OpenAIのResponses API形式、Search/Fetch API、Files API、デスクトップとWeb UIの「DeepSeek Harness」(プレビュー版)、Hugging Faceのオープンウェイトです。
- Claude Code、Codex、OpenCode、OpenClaw、Hermes、Reasonix、WorkBuddy/CodeBuddy、Qoderは、DeepSeekの文書が「DeepSeekにつなぐ設定」を案内している他社のツールです。ツールそのものは第三者のものです。
- Anthropic形式では、公式の対応表は、mcp_servers を無視、mcp_tool_use と mcp_tool_result を非対応としています(僕らの言い換え)。MCPの扱いは、使うツールの側(Claude Codeなど)の話と分けて考える必要があります。
- ツールを通してDeepSeekのAPIを使うと、送った内容は api.deepseek.com に届きます。保存先と学習の扱いは、DeepSeekのプライバシーポリシーと規約が決めます(04)。
この記事は、公式の資料を2026年10月23日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。運営者はDeepSeekを入れていますが、使い心地はこの記事には書いていません。コマンド、環境変数、設定のキーの名前は、公式の表記を写しています。公式のページは要約の形で取得したため、「書かれていない」と言い切らず「読んだ範囲では見つからなかった」と書いています。
先に結論
- まず「公式か第三者か」を見分ける。 DeepSeek自身が運営し、公式の文書に仕様が載るもの(API、Search/Fetch、Files、Harness、モデルの重み)が公式のつなぎ方です。他社のツールの設定ページが公式サイトにあっても、そのツールの運営はDeepSeekではありません。
- 自分のプログラムから呼ぶなら、API。 OpenAIのSDKかAnthropicのSDKで、base_urlを変えるだけで呼べる、と公式の文書にあります。モデル名は「deepseek-flash」か「deepseek-v4-pro」です。
- コーディングのツールは、設定の文書がある。 Claude Code、Codex、OpenCodeの手順が公式にあります。設定のファイルにAPIキーを直接書く形の例(Codex)もあるので、扱いに注意が要ります(僕らの見立て)。
- MCPは、公式のAPIの側では対応が限られる。 Harnessの規約は、MCPサーバー、スキル、フックを第三者のものとして扱い、責任を負わない、と書いています。
- 自分のパソコンで動かす道もある。 モデルカードがMITライセンスと、実行のツール(vLLM、SGLangなど)を書いています。ただし規模が大きいので、動かせる環境は限られます(これは僕らの見立てです)。
前提:用語をそろえる
- base_url:プログラムがAIに話しかける先のアドレスです。DeepSeekは https://api.deepseek.com(OpenAI形式)と https://api.deepseek.com/anthropic(Anthropic形式)です。
- OpenAI互換・Anthropic互換:他社のSDKやツールが使う「話し方」に合わせてある、という意味です。つなぎ先を差し替えるだけで使えます。
- Responses API:OpenAIが作った、新しい形式のAPIです。DeepSeekは、2026年7月31日の変更履歴で対応を書いています。
- MCP(Model Context Protocol):AIに外のツールをつなぐ共通の決まりです。
- スキル・フック:Harnessの規約が、第三者の部品として挙げています。スキルは作業の手順、フックは出来事に反応して動く仕掛けです。
- プラグイン:Harnessの機能を足す部品です。公式のページは、すべてがプラグインの作りと書いています。
- オープンウェイト:重みが公開されていて、自分で動かせる形です。
- 第三者(サードパーティ):DeepSeek以外の会社や個人のことです。
たとえ話:「コンセントの形」と「延長コード」
APIは、DeepSeekの「コンセント」です。OpenAI互換とAnthropic互換は、ほかのツールのプラグの形に合わせてあるという意味です。ツールの設定ページは「このプラグなら、こう挿すと動く」という説明書です。ただし、挿す家電(Claude Codeなど)は他人が作ったものです。家電が何を外に送るかは、家電の作り手が決めます。これは僕らのたとえで、公式の表現ではありません。
公式のもの:DeepSeekが用意しているつなぎ方
| つなぎ方 | 公式の資料に書かれていること | データの流れ | 確かさ |
|---|---|---|---|
| API(OpenAI形式) | base_url は https://api.deepseek.com。エンドポイントの例は /chat/completions。Bearerトークン。モデル名は deepseek-flash か deepseek-v4-pro | リクエストは api.deepseek.com に送られる | 書かれている |
| API(Anthropic形式) | base_url は https://api.deepseek.com/anthropic。x-api-key に対応。モデル名の対応は下の節 | 同上 | 書かれている |
| Responses API | 2026年7月31日にV4-Flashが対応、8月13日にAPIとしてネイティブ対応(Codex向けに調整)と変更履歴にある。Codexの設定が wire_api = "responses" | 同上 | 書かれている |
| Search API / Fetch API | POST https://api.deepseek.com/v1/tools/search と /v1/tools/fetch。クエリ、またはURLを送る | クエリ(と任意の元の質問、IPアドレス)やURLがDeepSeekに送られる。保管期間は、ガイドに書かれていなかった | 書かれている |
| Files API | /files。画像をアップロードして file_id で参照 | ファイルはアカウントに紐づく。期限を付けない限り保存が続く | 書かれている |
| コンテキストのキャッシュ | 既定でオン。ディスクに保存される | キャッシュは、数時間から数日で自動で消える、と書かれている | 書かれている |
| DeepSeek Harness | デスクトップ(macOS、Windows)、Web UI(npx @deepseek-ai/dsh web)、ソースから。MITライセンス。プレビュー版 | 公式モデルのサービスは、DeepSeekのサーバーで処理。カスタムは直接提供元へ(下の節) | 書かれている |
| オープンウェイト | Hugging Faceで公開。MITライセンス。vLLM、SGLang、Docker、Transformersなど | 自分で動かす場合の流れは、公式には書かれていない | 書かれている |
APIで押さえる点(公式の文書より)
- 最初の一歩。 公式の最初のページは、curlの例で、モデルに deepseek-flash、thinkingを有効、reasoning_effortを high、streamを false にした呼び出しを載せています。PythonとNode.jsの例のタブもあります。
- モデル名の対応。 Anthropic形式では、claude-opus で始まる名前は deepseek-v4-pro に、claude-haiku と claude-sonnet は deepseek-flash につながり、それ以外の claude で始まる名前も deepseek-flash につながります。claude で始まらず、認識されない名前は400エラーです。claude-opusの扱いはV4 Proの料金で請求されます。
- Anthropic形式の対応表(抜粋)。 anthropic-version は無視、anthropic-beta は /messages では無視されるが、ファイルを使う画像とFiles APIには必要。mcp_servers は無視。ドキュメント(document)、search_result、redacted_thinking、mcp_tool_use、mcp_tool_result などは対応しない。thinking は budget_tokens が無視される。
- 同時接続の上限。 アカウント単位で、deepseek-flash は2,500、deepseek-v4-pro は500。超えると429。拡張は、チケットでの申請(追加の料金なし)。
- Search/Fetchの制限。 Searchは100 QPS(1秒あたりの呼び出し回数)、Fetchは25 QPSとドメインごとの上限。超えると、呼びすぎを表すHTTPのエラー番号429が返ります。失敗や空の結果は課金されません。
DeepSeek Harness(公式、プレビュー版)
- 何か。 公式のページは、DeepSeekが開源したharnessで、Cordisのプラグインの仕組みの上に作られている、と書いています。「面向全球开放测试并同步开源」と、世界に向けて公開テスト中で、同時にオープンソースと書いています。
- 入り方。 デスクトップはmacOS(Apple 芯片)とWindows(64ビット)。Web UIは、Node.jsを入れて
npx @deepseek-ai/dsh webで起動し、http://127.0.0.1:3080 で開きます(公式のリポジトリ)。ソースからも動かせます。 - モデルのつなぎ方。 公式のクイックスタートは、設定の「Models」にDeepSeekのAPIキーを入れて保存する手順を書いています。ほかのプロバイダーと自前のエンドポイントは、別のガイド(providers)で扱われていて、そのガイドも読みました。DeepSeekのほか、同梱のカタログに anthropic、openai、moonshotai(Kimi)、zai(GLM)などの提供元があること、「設定 → モデル」の「添加模型提供商」(Add model provider)から「自定义模型 API」に切り替え、プロバイダーID、base URL、プロトコル(OpenAI Chat Completions、OpenAI Responses、Anthropic Messages)、認証情報、モデルを入れて自前のエンドポイントを足せることが書かれています。APIキーは
$DSH_HOME/.credentials.yamlに保存され、画面側には伏せ字の情報だけが返る、とあります。他社の提供元や自前のエンドポイントはDeepSeekのものではなく、モデルへの要求は各プロバイダーのbase URL(自前の場合は入力した値)に送られます。 - プラグイン・MCP・スキル・フック。 クイックスタートがリンクする、プラグインの市場のガイドとメモリのMCPのガイドも読みました。プラグインの市場は、インストールできる部品の一覧(JSONの索引ファイル)を自分で足して探す仕組みで、DeepSeekは市場の索引を同梱せず、誰でも索引を公開でき、題名や作者の表示の正しさはDeepSeekが確かめない、と書いています(信頼できる索引だけを足し、インストール前の確認画面で入手元を見るよう案内)。メモリのMCPは、第三者の記憶用の仕組み(Memorix、MCP Reference Memory、Engram)をつなぐ参考設定で、初めはオフです。DeepSeekはこれらを推薦も提携もせず、サポートも約束しない、と書いています。保存先は手元のフォルダ(~/.memorix/data など)です。Harnessの規約は、プラグイン、MCPサーバー、スキル、フックを第三者のものと位置づけ、DeepSeekは責任を負わない、と書いています。
- 作業の範囲。
dshは、起動したフォルダを既定の作業場所にします。Web UIでは、作業場所(ワークスペース)を選ぶまで入力ができません。エージェントは、ファイルの読み書き、コマンドの実行、作業の委任、計画の管理をします。権限の方針が承認を求める操作は、Web UIが先に聞く、とあります。 - 公式の警告。 リポジトリは、安全の注意書き(SAFETY.md)を実行前に読むよう求めていますが、その中身は読めていません。
公式の文書が設定を案内している他社のツール
DeepSeekのAPI文書の「Agent tool integrations」には、次のツールの設定ページが並んでいます(確認日10月23日)。これらは第三者の製品で、DeepSeekが運営するものではありません。Claude Code、Codex、OpenCodeは設定ページを読みました。OpenClaw、Hermes、Reasonix、WorkBuddy/CodeBuddy、Qoderは、題名とリンクだけで、中身は読めていません。
| ツール | 公式の設定ページに書かれていること(要約) | 注意点 |
|---|---|---|
| Claude Code | Node.js 18以上。npm install -g @anthropic-ai/claude-code。環境変数で、ANTHROPIC_BASE_URL に https://api.deepseek.com/anthropic、ANTHROPIC_AUTH_TOKEN にDeepSeekのAPIキー、ANTHROPIC_MODEL などに deepseek-flash[1m] を設定。CLAUDE_CODE_SUBAGENT_MODEL は deepseek-flash |
モデル名の [1m] の付け方は、ページの表示のとおりにする。Web検索はネイティブ対応で、検索結果の要約に追加のトークンがかかる |
| Codex | ~/.codex/config.toml に model_provider = "deepseek" と、[model_providers.deepseek] の base_url、wire_api = "responses"、experimental_bearer_token(APIキー)を書く。~/.codex/models.json も作る | APIキーが設定ファイルに平文で入る形。Web検索はdeepseek-v4-proのときだけ使え(web_search = "live")、公式の一括設定スクリプトは既定で無効にする。一括設定スクリプトは、curlで取った内容をそのままシェルで実行する形で案内されている(実行前に中身を確かめたい。これは僕らの見立て)。DeepSeekに切り替えると、ChatGPTのログインで作ったセッションが見えなくなる、とページにある |
| OpenCode | opencode upgrade で1.18.30以上。起動して /connect、deepseek を選び、APIキーを入れる。モデルは DeepSeek-V4-Flash を選ぶ |
設定ファイルの手動編集は、ページに書かれていなかった |
- Claude Codeの検索。 ページは、Web Searchの要求は、DeepSeekのAPIを通じて呼ばれ、Search APIの料金の規則で課金される、と書いています。
- Claude Desktop。 公式のAnthropic形式のガイドは、新しいClaude Desktopの開発者モードで、base_urlとAPIキーだけ変えればDeepSeekのモデルが使える、と書いています。
- 「公式パートナー」。 2026年9月10日の発表は、WorkBuddy(CodeBuddyを含む)とOpenCodeを、V4.1 Flashに完全対応する公式のパートナーとしています。
- Anthropicや各社の側の扱い。 これらのツールの運営元が、DeepSeekとの接続をサポートしているかどうかは、DeepSeekの文書には書かれておらず、各社の文書は今回読んでいません。
第三者・コミュニティのもの
- コミュニティのHarnessプラグイン。 Harnessの公式のリポジトリは、プラグインを作る人にGitHubのトピック「dsh-plugin」を付けるよう呼びかけています(見つけてもらうため)。そうしたプラグインは第三者のものです。第三者のプラグインについて、DeepSeekは責任を負わない、とHarnessの規約が書いています。
- 公式の組織のリポジトリにある統合の一覧。 DeepSeekのAPI文書は、「Practical integrations」(awesome-deepseek-integration)と「Contribute your agent integration」(awesome-deepseek-agent)へのリンクを載せています。リポジトリはDeepSeekのGitHub組織にありますが、中身は寄せられたもので、僕らは取得できず(ロボット除外)、読めていません。
- 量子化版や実行アプリ。 Hugging Faceのモデルカードは、llama.cpp、Ollama、LM Studioで使える量子化版がある、と書いています。これらのアプリは第三者の製品で、量子化版を誰が作ったかは、カードの要約からは確認できていません。
- 非公式のAPI互換サービス。 WebSearchの結果には、公式でない、「APIキーなしで使える」とうたうコミュニティのリポジトリや、紹介サイトが出ました。題名だけを見て、中身は読んでいません。公式のAPIではなく、規約やデータの扱いも別です(これは僕らの見立てです)。
データはどこへ流れるか
| つなぎ方 | データの行き先 | 公式の資料での確かさ |
|---|---|---|
| アプリ・Web版 | DeepSeekのサービス。保存先は中華人民共和国と書かれている | 書かれている(プライバシーポリシー) |
| API(直接、またはツール経由) | api.deepseek.com。保存期間や学習への利用は、プラットフォームの規約が自社の学習への利用を直接書かず、プライバシーポリシーを参照するよう書いている | 一部確認できず |
| Search/Fetch | クエリやURLがDeepSeekへ。ガイドは保管期間を書いていない | 一部確認できず |
| Files API | アカウントに紐づいてDeepSeek側に保存。期限を付けなければ、保存が続く | 書かれている |
| Harness(公式モデルのサービス) | DeepSeekのサーバーで処理(プライバシーポリシー) | 書かれている |
| Harness(カスタムモデル) | 入出力は、選んだ提供元に直接送られ、DeepSeekはサーバー側で保存も処理もしない、と書かれている | 書かれている |
| Harnessのプラグイン・MCP・スキル・フック | 第三者が直接収集・処理する、と書かれている | 書かれている |
| オープンウェイトを自分で動かす | 公式には書かれていない | 書かれていない |
誤解されやすい点と、今日からできること
誤解されやすい点
- 「公式サイトに設定ページがあるツールは、公式の製品」ではない。 Claude CodeやCodexは他社の製品です。DeepSeekの文書は、そこにDeepSeekをつなぐ手順を書いています。
- 「OpenAI互換なら、MCPも同じように動く」とは限らない。 Anthropic形式の対応表は、MCP関連の項目を「無視」か「非対応」としています。
- 「オープンウェイトを使えば、公式のデータの扱いと関係ない」わけではない。 自分のマシンで動かせば、DeepSeekのAPIは通りませんが、その場合の安全性(実行するツールの入手元など)は、別の話です。
今日からできること、避けたいこと
- できること。 ①まず、公式の「首次调用 API」の例を、小さな質問で試す。②コーディングのツールにつなぐなら、設定の文書を最初から最後まで読み、キーを環境変数に置けるか確かめる。③Harnessは、練習用のフォルダで、最小限の権限から始める。
- 避けたいこと。 ①APIキーを、共有のリポジトリに入る設定ファイルに書く(僕らの見立て)。②第三者のプラグインやMCPサーバーを、中身を確かめずに入れる。③機密のコードや文書を、保存先を確かめずに送る。
気をつけること
- この記事は、実際に使って確かめた記録ではありません。運営者はDeepSeekを入れていますが、使い心地はこの記事には書いていません。コマンドと設定名は公式の記載を写しただけで、動作確認はしていません。
- 取得したのは、ページの要約です。モデル名や設定は、数週間で変わっています(変更履歴は2026年7月31日から10月17日まで頻繁に更新されています)。最新の記載は公式で確かめてください。
- OpenClaw、Hermes、Reasonix、WorkBuddy/CodeBuddy、Qoderの設定ページ、SAFETY.md(取得に失敗)、awesome系のリポジトリは、読めていません。
- DeepSeekのAPIが、これらのツールからのリクエストに何を付けて送るか、ツール側のテレメトリは、公式の資料では確認できていません。
出典
- 首次调用 API(DeepSeek API Docs、確認日 2026-10-23)
- 模型与定价(DeepSeek API Docs、確認日 2026-10-23)
- 速率限制 Rate Limit(DeepSeek API Docs、確認日 2026-10-23)
- 更新日志(DeepSeek API Docs、確認日 2026-10-23)
- 使用 Anthropic API(DeepSeek API Docs、確認日 2026-10-23)
- 网页搜索与抓取(DeepSeek API Docs、確認日 2026-10-23)
- Files API(DeepSeek API Docs、確認日 2026-10-23)
- 上下文硬盘缓存(DeepSeek API Docs、確認日 2026-10-23)
- Claude Code 接入(DeepSeek API Docs、確認日 2026-10-23)
- Codex 接入(DeepSeek API Docs、確認日 2026-10-23)
- OpenCode 接入(DeepSeek API Docs、確認日 2026-10-23)
- DeepSeek Harness(DeepSeek、確認日 2026-10-23)
- deepseek-harness README(GitHub、DeepSeek、確認日 2026-10-23)
- Harness クイックスタート(DeepSeek Harness docs、確認日 2026-10-23)
- DeepSeek Harness Privacy Policy(DeepSeek、更新日表示 2026-09-20、確認日 2026-10-23)
- DeepSeek Harness Terms of Use(DeepSeek、更新日表示 2026-09-20、確認日 2026-10-23)
- DeepSeek V4.1 Flash(DeepSeek、2026-09-10、確認日 2026-10-23)
- DeepSeek-V4.1-Flash(Hugging Face、DeepSeek、確認日 2026-10-23)
- DeepSeek-V4-Pro(Hugging Face、DeepSeek、確認日 2026-10-23)
- DeepSeek Open Platform Terms of Service(DeepSeek、2026-04-22公開、確認日 2026-10-23)
- DeepSeek Privacy Policy(DeepSeek、en-US、更新日表示 2026-02-10、確認日 2026-10-23)