Cursor の Agent Mode で DeepSeek を使う方法

CometAPI
AnnaJan 26, 2026
Cursor の Agent Mode で DeepSeek を使う方法

DeepSeek は、Cursor が指し向けられる OpenAI 互換の API（または CometAPI のようなゲートウェイ経由）を公開しています。モデル名の調整、埋め込みの検証、セキュリティレビューを丁寧に行えば、コード生成、リファクタリング、テスト駆動のワークフローにおいて、DeepSeek モデルに対して Cursor の Agent Mode を動かすことができます。

DeepSeek とは？

DeepSeek は、推論重視の LLM と、テキスト・埋め込み・エージェントワークフロー向けの関連 API を提供する商用 AI モデルプラットフォームおよびモデルファミリーです。DeepSeek は、検索/アシスタント/エージェント体験の構築を目的に、モデルとチーム（“DeepSeek-V3.2” のようなバージョンやプラットフォームエンドポイント）への Web および API アクセスを公開しています。API は OpenAI 互換として提供されており、カスタムの base_url と API キーを指定できるツールやクライアントであれば、最小限の変更で動作することが多いです。

DeepSeek-R1: 推論エンジン

登場以来、DeepSeek-R1 は「Agentic」ワークフローにおいてゲームチェンジャーとなっています。すぐに答えに飛びつく標準的なチャットモデルと異なり、R1 は OpenAI の o1 シリーズに似た「Chain of Thought（CoT）」プロセスを用います。Cursor の Agent Mode では、これは極めて重要です。エージェントが「認証ミドルウェアをリファクタリングして、依存するすべてのテストを更新して」と依頼されたとき、実行に移る前に計画が必要になります。R1 は自らのロジックを検証できるため、架空のファイルパスや誤った API 呼び出しの発生率を抑え、Agent Mode の自律性を大きく高めます。

Deepseek V3.2 におけるブレークスルー

2025 年 12 月 1 日にリリースされた DeepSeek V3.2 は、2 つの画期的な技術を導入しました。

  1. DeepSeek Sparse Attention (DSA): 従来のトランスフォーマーがすべてのトークンに注意を向けて計算を浪費してしまうのに対し、DSA は動的に最も関連性の高い情報のみを選択します。これにより、長いコンテキスト（最大 128k トークン）の忠実度を維持しつつ、推論コストを約 40% 削減します。これはリポジトリ全体を「読む」必要があるコーディングエージェントにとって極めて重要です。
  2. ネイティブな「思考」モード: 以前のモデルが「思考過程を示す」ためのプロンプトを必要としていたのに対し、V3.2 は CoT プロセスをアーキテクチャに直接統合しています。コードを出力する前に自らのロジックを検証することで、ライブラリインポートや API 呼び出しの「幻覚率」を大幅に低減します。

迫り来る DeepSeek-V4 の到来

業界関係者の間では、DeepSeek-V4 の 2026 年 2 月中旬のリリースが差し迫っているとの噂で持ちきりです。流出情報によれば、このモデルは 100 万トークンを超えるコンテキストウィンドウや、リポジトリ全体を一度に取り込むために設計された「長大コンテキストコーディング」機能を備えるとされています。今のうちに DeepSeek–Cursor パイプラインをセットアップするアーリーアダプターは、次の飛躍に向けたインフラ準備を進めていることになります。

Cursor Agent Mode とは？

DeepSeek V3.2 が「頭脳」だとすれば、Cursor Agent Mode は「身体」です。2026 年の「IDE」の定義は変わりました。Cursor はもはや単なるテキストエディタではなく、エージェント的な環境です。

オートコンプリートのその先へ

従来の AI コーディングツール（旧 Copilot のような）は受動的で、入力中の行を補完するだけでした。Agent Mode は能動的です。自律的なループとして動作します。

  1. 計画: エージェントがユーザーのリクエスト（例: 「認証モジュールを OAuth2 に置き換えてリファクタリング」）を分析します。
  2. コンテキスト取得: ファイルシステムを自律的にスキャンし、関連するファイル（auth.ts、user_model.go、config.yaml）のみを読み込みます。
  3. 実行: 複数ファイルにまたがる編集を同時に適用します。
  4. 検証: 特筆すべき点として、Agent Mode はターミナルコマンドを実行できます。npm test や cargo build を実行し、エラーログを解析して、テストが通るまで自己修正します。

この「ループ」機能こそ、コストが効いてくるところです。単一のタスクで 50 回の API 呼び出しが必要になることもあります。高価なモデルでこれを行うのは負担ですが、DeepSeek ならわずかなコストで済みます。

なぜ DeepSeek を Cursor Agent Mode と統合するのか？

利点

  1. 自分に合ったモデルで自律コーディング: DeepSeek のモデルがコスト/レイテンシ/品質の要件に合うなら、Cursor のエージェントを用いて、複数ファイルのリファクタリング、テスト生成、CI 風の修正に活用できます。
  2. 関数呼び出し + ツール: DeepSeek は関数呼び出しをサポートしており、テストの実行、リンターの呼び出し、プログラム的なファイル作成など、ツールのオーケストレーションが必要なエージェントに役立ちます。
  3. ゲートウェイによる柔軟性: DeepSeek の前段にゲートウェイ（CometAPI など）を挟むことで、ルーティング、ポリシー制御、モデルの多重化が可能です。プロバイダを切り替えても Cursor 側の設定を変更したくないチームに有用です。

リスクと注意点

  • プライバシーとコンプライアンス: DeepSeek はデータ/テレメトリに関する懸念で各国機関や研究者から指摘を受けています。DeepSeek（や他の第三者）へ機密コードを転送する前に、法務/情報セキュリティレビューを実施し、オンプレミスやプライベートゲートウェイの選択肢も検討してください。
  • Cursor における埋め込みと検索の注意点: Cursor の機能（コード検索、クロール、埋め込み）が、非標準の埋め込みエンドポイントやモデルの埋め込み次元の不一致で、動作不良や予期せぬ挙動を示す可能性があります。base_url を上書きした際に埋め込みで問題が発生したという報告があります。十分にテストしてください。
  • モデル名とツールサポート: Cursor は特定のモデル名や機能（例: ツールサポート）を期待する場合があります。Cursor が期待する正確な名前で DeepSeek モデルを提示するか、カスタムモードを設定する必要があるかもしれません。

ステップバイステップガイド: DeepSeek を Cursor Agent Mode で動かす方法

以下は現実的な手順で、2 つのデプロイオプションがあります: (A) 直接 — Cursor を DeepSeek の OpenAI 互換エンドポイントに直接接続する; (B) ゲートウェイ — DeepSeek の前段に CometAPI（または独自の軽量プロキシ）を置いて、ルーティング、ポリシー、可観測性を一元化する。

前提条件: Cursor のインストール（デスクトップまたはクラウド）、DeepSeek API キー（DeepSeek アカウントから取得）、（ゲートウェイオプションの場合）CometAPI アカウントまたは自前のゲートウェイ。必ず使い捨てのリポジトリでテストしてください—セキュリティレビューが完了するまで、秘密情報や本番専用コードを送らないこと。

オプション A — 直接統合（最も手早い）

1) curl で DeepSeek API アクセスを検証

DSEEK_KEY と MODEL_NAME を自分の値に置き換えます。このステップで、DeepSeek が OpenAI 互換エンドポイントとして応答することを確認します。

# Chat completion style test (DeepSeek OpenAI-compatible)
export DSEEK_KEY="sk-...your_key..."
curl -s -X POST "https://api.deepseek.com/v1/chat/completions" \
  -H "Authorization: Bearer $DSEEK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"deepseek-code-1.0",
    "messages":[{"role":"system","content":"You are a helpful code assistant."},
                {"role":"user","content":"Write a one-file Node.js Express hello world"}]
  }' | jq

有効な JSON の choices 応答が得られれば、次に進みます。DeepSeek のドキュメントにはベース URL とサンプル呼び出しが記載されています。

2) Cursor に DeepSeek をカスタムモデルとして追加

Cursor: Settings → Models → Add OpenAI API Key（または相当）で以下を設定します。

  • API キー: DeepSeek の API キーを貼り付けます。
  • OpenAI base URL を上書き: 有効化して https://api.deepseek.com/v1（またはドキュメントの推奨に応じて https://api.deepseek.com）を設定します。
  • モデル名の追加: DeepSeek が公開している正確なモデル名（例: deepseek-code-1.0 またはダッシュボードに表示のモデル）を追加します。

注記:

  • Cursor の一部バージョンでは、有効化のために有効な OpenAI キーとプロバイダキーの両方が必要な場合があります—検証フローに従ってください。ユーザーから、検証ステップで UI の癖が報告されています。curl が成功したのに検証が失敗する場合は、Cursor のログやフォーラムを確認してください。

3) DeepSeek に最適化した Cursor の Custom Mode を作成（推奨）

Cursor の Custom Mode を使って、DeepSeek バックエンドのエージェント向けに、的を絞ったインストラクションとツール設定を保持します。以下は Custom Mode の UI に貼り付けられるサンプルのシステムプロンプトとルールセットです。

System prompt (example):
You are an autonomous code agent. Use concise diffs when editing files and produce unit tests when you modify functionality. Always run the project's test suite after changes; do not commit failing tests. Ask before changing database migrations. Limit external network requests. Use the provided tooling (file edits, run tests, lint) and explain major design decisions in a short follow-up message.

Rules:
- Tests first: always add or update tests for code changes.
- No secrets: do not output or exfiltrate API keys or secrets.
- Small commits: prefer multiple small commits over a single huge change.

これはエージェントを制約し、モデル固有の挙動差を補うのに役立ちます。Cursor のドキュメントは、エージェント実行時の計画、指示、検証可能な目標を強調しています。

4) 簡単なタスクで Agent Mode をテスト

Agent Mode で Cursor にこう依頼します: 「ログインエンドポイントが未認証リクエストに対して 401 を返すことを検証するユニットテストを追加し、そのテストが通る最小限の実装を行ってください。」 エージェントが計画を立て、編集を行い、テストを実行し、反復する様子を観察します。途中で停止したり許可待ちになったりする場合は、システムルールを調整するか、Custom Mode のオプションでエージェントの自律性を高めてください。

5) 埋め込みとコード検索をトラブルシュート

Cursor のコードベース検索、クロール、@docs 機能が base URL の切替で動作しない、または予期せぬ挙動を示す場合、埋め込みエンドポイントの相違（次元不一致や API 挙動の違い）が原因の可能性があります。チェックリスト:

  • DeepSeek の埋め込みエンドポイントで埋め込みを生成し、ベクトル長を確認する。
  • 次元が Cursor の期待と異なる場合は、ゲートウェイで埋め込みを正規化するか、ポリシー上許されるなら埋め込みは OpenAI を維持しつつ、補完のみ DeepSeek を使うことを検討する。base_url 上書き時の埋め込み関連の障害。

オプション B — CometAPI 経由での統合（チームに推奨）

CometAPI はモデルゲートウェイとして機能し、DeepSeek のような基盤プロバイダへルーティングしつつ、単一の安定したエンドポイント（および一貫したモデル名）を提供します。これにより、可観測性、請求の一元化、ポリシーフック、プロバイダ切替の容易化が実現します。

1) なぜゲートウェイを使うのか？

  • 資格情報と監査ログの集中管理。
  • モデルバージョンの固定とトラフィックルーティング（複数モデルの A/B テスト）。
  • ポリシー適用（PII の除去、秘密情報のマスキング）およびキャッシュ。
  • Cursor の設定が簡単に—一度 CometAPI に向ければ、後のプロバイダ切替はサーバー側設定のみで完結。

2) CometAPI -> DeepSeek ルーティングの例（概念）

CometAPI のコンソールで、DeepSeek のモデルエンドポイントにプロキシするモデルエイリアス（例: deepseek/production）を作成します。ゲートウェイは API キーと、https://api.cometapi.com/v1. のような base_url を提供する場合があります。

3) Cursor を CometAPI に向けて設定

  • Cursor: Settings → Models → Add OpenAI API Key — CometAPI のキーを使用します。
  • base URL の上書き: https://api.cometapi.com/v1.
  • ゲートウェイのモデル名（例: deepseek/production または作成したエイリアス）を追加します。

4) DeepSeek にルーティングする CometAPI 経由の curl サンプル

# Request to CometAPI, which routes to DeepSeek under the hood
export COMET_KEY="sk-comet-..."
curl -s -X POST "https://api.cometapi.com/v1/chat/completions" \
  -H "Authorization: Bearer $COMET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"deepseek/production",
    "messages":[{"role":"system","content":"You are a careful code assistant."},
                {"role":"user","content":"Refactor function X to improve readability and add tests."}]
  }' | jq

この単一の base_url により Cursor の設定が簡素化され、CometAPI はリクエストスロットリング、可観測性、コスト管理などの追加オプションも提供できます。

CometAPI はここでどんな役割を果たせるか？

短い答え

CometAPI は Cursor と DeepSeek の間のモデル集約ゲートウェイとして機能できます。認証、ルーティング、コスト制御、フェイルオーバーを一元化し、複数ベンダーのモデルが混在していても、OpenAI 風の単一 REST インターフェースを提供します。

CometAPI が提供できる実用的な役割

  1. 統一エンドポイント: Cursor やサーバーは 1 つのゲートウェイエンドポイントだけを知っていればよくなります。deepseek-v3.2 にルーティングしたり、DeepSeek が利用不能な場合に別プロバイダへフォールバックできます。
  2. 課金とクオータ: CometAPI はモデル横断の利用状況を集約し、課金とポリシーを管理—チーム横断のコスト配賦に役立ちます。
  3. モデルの A/B テスト: ルーティングルールを更新するだけで、Cursor の設定を変えずにモデルターゲットを切替可能です。
  4. レイテンシと冗長性: プロバイダの障害や地域規制に備えてフォールバックプロバイダを構成できます。
  5. 認証の簡素化: ベンダーキーを Comet に保存し、Cursor はゲートウェイキー（プロキシからの短命トークン）だけを使用。露出を減らせます。

例: CometAPI を呼び出して DeepSeek にルーティング（Python）

import requests
COMET_KEY = "sk-xxxxxxxx"
url = "https://api.cometapi.com/v1/chat/completions"

payload = {
  "model": "deepseek-v3.2",   # instruct gateway which model to run
  "messages": [{"role":"user","content":"Refactor this function to be more testable:"}],
  "max_tokens": 1024,
  "stream": False
}

resp = requests.post(url, json=payload, headers={"Authorization": f"Bearer {COMET_KEY}"})
print(resp.json())

CometAPI’s docs を参照して、正確なパラメータ名とモデル識別子を確認してください—多くのモデルをサポートし、利用分析を提供します。

ツール呼び出しはどのように機能し、Cursor 経由で DeepSeek を使う際の注意点

DeepSeek は関数呼び出しと構造化 JSON 出力をサポートし、Cursor はツール（ファイル編集、ターミナル実行、HTTP）を公開しています。モデルが関数呼び出しを出力すると、Cursor のエージェントハーネスがツールの実行をオーケストレーションします。重要な実装ポイントが 2 つあります。

  1. 関数呼び出しスキーマをエージェントハーネスに合わせる — DeepSeek の関数呼び出しペイロードは、Cursor のツール名と引数形状にマッピングされる必要があります。DeepSeek が JSON の関数呼び出しを生成し、ゲートウェイ（または Cursor）が対応ツールへ解析転送する小さなループでテストしてください。
  2. 思考モードと最終回答の扱い — DeepSeek の「思考」（Chain-of-Thought）モードは推論内容と最終回答を返します。Cursor のエージェントハーネスは「推論」内容をユーザーに表示するか非表示にするかを選択できますが、ツール呼び出しでは通常、実行前にモデルが引数を確定する必要があります。reasoning_content の取り扱いについては DeepSeek のドキュメントを参照してください。

例: 関数呼び出しをトリガーするリクエスト

{
  "model":"deepseek-reasoner",
  "messages":[{"role":"system","content":"You are an autonomous coding agent. Use tools only when necessary."},
              {"role":"user","content":"Run tests and fix failing assertions in tests/test_utils.py"}],
  "functions":[
    {"name":"run_shell","description":"execute shell command","parameters":{"type":"object","properties":{"cmd":{"type":"string"}},"required":["cmd"]}}
  ],
  "function_call":"auto"
}

DeepSeek が {"name":"run_shell","arguments":"{\"cmd\":\"pytest tests/test_utils.py\"}"} を返した場合、Cursor（またはゲートウェイ）はそれを実行時のシェルツールにルーティングし、stdout/stderr を取得して結果を観測値としてモデルに返す必要があります。

トラブルシューティング & FAQ

Q: DeepSeek キーを使うと Cursor に「403 please check the api-key」と表示されるのはなぜ？

A: Cursor が Cursor 提供モデルを使用する際、一部のモデルリクエストを自社バックエンド経由にしている、または下位プランでエージェントレベルの BYOK を許可していない可能性があります。対処法は 2 つ: (1) Cursor の Add Model UI を使い、正確な base URL とキーのセマンティクスを検証する; (2) Cursor が呼び出せるプロキシをホストし（オプション B 参照）、プロキシへの直接リクエストで検証する。コミュニティスレッドには両方の挙動が記録されています。

Q: 関数呼び出しが実行されない、または引数が不正です。

A: DeepSeek の関数スキーマを確認し、ゲートウェイまたは Cursor のツールマッピングが期待される JSON 型に一致していることを確認してください。さらに、DeepSeek が最終的な関数引数ではなく reasoning_content（思考トレース）のみを返したかどうかも確認します—必要に応じて、最終確定内容を新しいモデルターンとして渡してください。

Q: エージェントの実行コストが高い。どうやって上限を設ける？

A: ゲートウェイ側で厳格なトークン/利用クオータを設定し、N 回の反復後に人間のレビューを必須とする、あるいはオフピークに実行をスケジューリングします。Comet のログでトークン使用量を監視し、しきい値超過時にアラートを出すようにしてください。

結論: 変化は恒久的

DeepSeek と Cursor Agent Mode の統合は単なる新機能ではなく、高度な AI コーディングの民主化です。参入コストを下げ（コスト）、能力の上限を引き上げる（推論）ことで、DeepSeek は個々の開発者に小規模チーム並みの生産性をもたらしました。

まだこの組み合わせを使っていない方は、Cursor クライアントを更新し、DeepSeek/ CometAPI の API キーを取得して、Agent Mode をオンにしてみてください。コーディングの未来はすでにここにあり、驚くほど効率的です。

開発者は、今すぐ CometAPI 経由で deepseek v3.2 にアクセスできます。まずは CometAPI のモデル機能を Playground で試し、詳細な手順は API ガイドを参照してください。アクセス前に、CometAPI にログインし、API キーを取得していることを確認してください。CometAPI は公式価格よりもはるかに低い価格を提供し、統合を支援します。

準備はいいですか？→ Free trial of Deepseek v3.2!

トップモデルを 低コストで利用

もっと読む