Cursor + DeepSeek API 完全ガイド：カスタムモデル設定、コスト確認、失敗対策

2026-06-08 更新：DeepSeek は V4（deepseek-v4-flash / deepseek-v4-pro）へ移行しました。旧名 deepseek-chat / deepseek-reasoner は別名として残りますが、公式は 2026-07-24 に廃止予定です。本記事は DeepSeek API ドキュメントと Cursor 公式ドキュメント／Pricing に合わせて、モデル名・料金の目安・切り分けチェックを更新しています。

先月末、クレジットカードの利用明細を見て思わず手が止まりました。Cursor Pro の月額料金として再び20ドルが引き落とされていたからです。3ヶ月で、このツールだけで60ドルも費やしたことになります。

Cursor 自体は非常に優秀で、AI支援によるコーディング体験を知ってしまうと、もう手放せません。しかし、請求書を見るたびに「本当にこの金額に見合っているのだろうか」と疑問が頭をよぎります。特に月額200ドルの Ultra プランともなると、個人開発者にとっては極めて高額な出費です。

そんな中、技術コミュニティで「Cursor に DeepSeek の API を直接連携できる」という話を耳にしました。最初に聞いたときは、「本当に実用的なのか」「設定が面倒なのではないか」「コードの品質は十分なのか」といった疑問が次々と浮かびました。

実際に試してみると、その懸念は良い意味で裏切られ、驚くほど快適で手放せなくなりました。

設定にかかった時間はわずか5分。最初の1ヶ月を使い終えて、かかったコストは日本円でわずか数十円（約3元）でした。気になるコードの品質ですが、Claude 3.5 Sonnet と比べると確かに一部で及ばない部分はあるものの、日常的なコーディングには十分な実力を持っています。さらに、特定の処理においては期待以上の回答を返してくれることもありました。

本記事では、Cursor に DeepSeek API を連携するための具体的設定手順を、ステップバイステップで詳しく解説します。また、公式ドキュメントには載っていない注意点や機能制限など、実際に使ってみて分かったリアルなポイントも包み隠さず共有します。

なぜ DeepSeek API なのか？

まずはお金の話をしましょう。

Cursor Pro は月額20ドル（約3,000円）。個人開発者が趣味や学習で使うには、決して安くありません。

一方、DeepSeek API はどうでしょうか。価格表を見てみましょう（公式はドル建て、円は概算）：

• deepseek-v4-flash（日常推奨）：入力 $0.14/百万トークン（キャッシュヒット時は $0.0028）、出力 $0.28/百万トークン（おおよそ ¥1／¥2 相当）
• deepseek-v4-pro（複雑な推論向け）：入力 約 $1.74/百万、出力 約 $3.48/百万トークン、コンテキスト 1M
• 旧名 deepseek-chat/deepseek-reasoner は V4-Flash の非思考/思考モードへの別名として残りますが、2026-07-24 に廃止予定です。新規設定は v4 名を直接使ってください

これだけだと実感が湧かないかもしれません。実際のシナリオで計算してみましょう。私が月に100〜150回 AI と対話し、毎回数百行のコードをやり取りしたとします。その場合の月額コストは、およそ50円〜100円程度です。

間違いありません。ドルではなく、円です。

コスト比較表：

プラン	月額費用	年額費用	節約率
Cursor Pro	$20 (約¥3,000)	$240 (約¥36,000)	-
Cursor Pro+	$60 (約¥9,000)	$720 (約¥108,000)	-
Cursor Ultra	$200 (約¥30,000)	$2400 (約¥360,000)	-
DeepSeek API	¥50〜¥150	¥600〜¥1,800	95%以上

次に品質について。

DeepSeek-V3 はオープンソースモデルの中でトップクラスの性能を誇ります。実際に使ってみた感想として、一般的な業務コードの記述、リファクタリング、ロジック解説などは非常に優秀です。Claude 3.5 Sonnet と比べれば多少の差はありますが、日常利用で困ることはありません。

さらに嬉しい驚きだったのが、DeepSeek-R1 の推論能力です。複雑なアルゴリズムや多段推論が必要な問題では、期待以上の回答をしてくれることがあります。

こんな人におすすめ：

1. 個人/独立開発者 - 予算は抑えたいが、AI の恩恵は受けたい
2. 学生 - 月3,000円のサブスクは痛い
3. 小規模チーム - 全員分の Pro ライセンスを買うのは厳しい
4. ライトユーザー - 毎日使うわけではない

逆に、一日中 AI とペアプログラミングをするようなヘビーユーザーや、Tab 補完、Composer 機能をフル活用したい方は、素直に Cursor Pro を契約することをお勧めします。DeepSeek API ではそれらの機能が使えないからです。

準備（所要時間5分）

始める前に必要なものは以下の通りです。

DeepSeek API Key の取得

まず DeepSeek オープンプラットフォームでアカウントを作成し、API Key を発行します。

1. DeepSeek Open Platform にアクセス
2. 登録してログイン（電話番号、メール、GitHub アカウント等）
3. コンソールに入り、“API Keys” を選択
4. “Create API Key” をクリックし、名前を付ける（“cursor-use” など）
5. 生成された API Key をコピーして保存（一度しか表示されません！）

※利用にはチャージが必要です。Alipay や WeChat Pay などが対応していますが、クレジットカードが使える場合もあります。

Cursor の2つのモードを理解する

ここは混同しやすいポイントです。Cursor で DeepSeek を使う方法は2つあります。

1. 内蔵モデルモード
Cursor Pro 会員が使える機能で、メニューから deepseek-r1 などを選ぶだけです。これは Cursor の契約に含まれます。

2. カスタム API モード（今回解説する方法）
自分で API Key を設定し、自分の API 枠を使います。Pro 契約は不要で、使った分だけ支払います。

今回設定するのは、この「2. カスタム API モード」です。

必要な情報まとめ

設定時に以下の3つ使います：

• API Key: 先ほど取得した sk- から始まる文字列

• Base URL: https://api.deepseek.com

• モデル名（2026 の V4 命名、これを直接入力）:

  • deepseek-v4-flash - 非思考/思考の両対応、日常コーディングの第一候補。高速で安価
  • deepseek-v4-pro - フラッグシップ推論。難しいアルゴリズムや設計判断のとき

  旧名 deepseek-chat / deepseek-reasoner は今も V4-Flash の非思考/思考モードへの別名として動きますが、公式は 2026-07-24 に廃止します。新規設定は v4 名を使ってください。

基本は deepseek-v4-flash で十分です。高速で安価です。

ステップバイステップ設定ガイド

では設定していきましょう。

ステップ1：Cursor 設定を開く

以下のいずれかで開きます：

• ショートカット: Mac Cmd + , / Windows Ctrl + ,
• アイコン: 右上の歯車アイコン ⚙️ をクリックし “Settings” を選択

設定画面に入ったら、左側のメニューから “Models” を選択します。

ステップ2：カスタムモデルを追加

Models ページにある “Add model” ボタンをクリックします。

モデル名の入力欄が表示されます。ここにモデル名を入力します：

• deepseek-v4-flash
• deepseek-v4-pro

まずは deepseek-v4-flash を追加して確認することをお勧めします。入力したら「Add」をクリックします。

ステップ3：Base URL の設定

このステップが特に重要です。多くの人がここでつまずきます。

モデルを追加すると、そのモデルの設定画面が表示されます。“Override OpenAI Base URL” の項目を見つけて展開してください。

入力欄に以下のアドレスを入力します：

https://api.deepseek.com

※ /v1 を末尾につけた https://api.deepseek.com/v1 でも動作する場合がありますが、まずはシンプルに上記を試してください。余計なスペースが入らないように注意してください。

ステップ4：API Key の入力

同じ設定ページを下にスクロールすると、“API Key” の入力欄があります。

ここに先ほど取得した DeepSeek の API Key を貼り付けます。

重要:

• 完全な文字列を貼り付ける（欠けがないように）
• 前後にスペースが入っていないか確認
• 改行が含まれていないか確認

ステップ5：保存と検証

入力が完了したら、ページ下部の “Save” ボタンをクリックします。

Cursor が自動的に接続テストを行います。数秒後に緑色のチェックマーク ✓ や “Verified” の表示が出れば成功です！

もし赤色のエラーが出る場合は、後述の「トラブルシューティング」セクションを確認してください。

ステップ6：使用開始

設定が完了したら、実際に使ってみましょう。

Chat 画面（Cmd/Ctrl + L）を開き、モデル選択のドロップダウンメニューを開きます。リストの中に、先ほど追加した deepseek-v4-flash があるはずです。

それを選択して会話を始めてみてください。「Python でフィボナッチ数列を書いて」など簡単な指示でテストしてみましょう。

重要な制限事項（必ず読んでください）

設定おめでとうございます！…と言いたいところですが、いくつか重要な制限があります。これらを知らずに使い始めるとガッカリするかもしれません。

Chat モード専用である

これが最大の制限です。

カスタム API で設定した DeepSeek は、Chat 画面（右サイドバー）でのみ動作します。会話したり、コードを生成させたり、解説させたりは可能です。

できないこと:

• Pro 版のような「Apply（適用）」ボタンでの直接ファイル書き換え
• Composer モード（Cmd+I）での利用
• プロジェクト全体を見通したコード生成

生成されたコードは、自分でコピーしてエディタに貼り付ける必要があります。「チャットはできるが、手は動かせない」アシスタントだと考えてください。

Tab 補完は使えない

Cursor のキラー機能である Tab 補完（ゴーストテキスト）は、カスタム API では動作しません。

Tab 補完は Cursor 独自のモデルとインフラに依存しているため、Pro 契約がない場合、この機能は無効になります（または非常に制限されます）。

互換性の制限

Cursor のカスタム API 設定は、OpenAI 互換フォーマットのみサポートしています。

DeepSeek はこれに準拠しているので使えますが、OpenAI の最新推論モデル（o1 等）や、特殊なローカルモデルなどは、フォーマットが異なると使えない場合があります。

セキュリティについて

カスタム API Key を使用するということは、リクエストのたびに Key が Cursor のサーバーを経由して DeepSeek に送られることを意味します。

Cursor は「Key をサーバーに保存しない」としていますが、経路上を通過します。

• 定期的に Key をローテートする
• DeepSeek 側で利用上限額を設定する
  などの自衛策をお勧めします。

実際の使用感とコスト分析

1ヶ月ほど人柱として使ってみた結果を報告します。

日常的な使用シーン

私は主に以下のような用途で使っています：

1. コードレビュー & 最適化: 書いたコードを貼り付けて「もっと良くできる？」と聞く。鋭い指摘をしてくれます。
2. エラーログの解析: 謎のエラーが出た時、ログを貼り付けて原因を聞く。解決率は7〜8割です。
3. スニペット生成: 「日付フォーマット変換の関数書いて」のような、調べるのが面倒な処理を書いてもらう。
4. ロジックの壁打ち: deepseek-v4-pro を使って、アルゴリズムや設計の相談をする。

リアルなコスト

私はフロントエンドエンジニアで、平日は毎日5〜10回程度質問し、週末も趣味開発で使います。

初月の実績データ：

• 総対話数: 約 120 回
• トークン量: 入力 96k / 出力 60k
• コスト計算: deepseek-v4-flash（$0.14/$0.28 per 1M）で (96k×¥1/百万) + (60k×¥2/百万) ≈ ¥0.22 相当

日本円にして、わずか数円です。

はい、数円です。3,000円ではありません。V4-Flash は前世代よりさらに安くなりました。

もちろん、もっとヘビーに使う人でも、月額100円〜200円程度に収まるでしょう。Cursor Pro の3,000円と比べれば、誤差のような金額です。

使いこなしのコツ

1. コンテキストを絞る: ファイル全体を投げず、関係ある部分だけ貼ることでトークンを節約し、精度も上げられます。
2. Flash と Pro の使い分け: deepseek-v4-flash は速くて安いので日常使いに。deepseek-v4-pro は高いので、本当に難しい時だけ使うのが賢い方法です。
3. 分割して聞く: 複雑なタスクは小分けにして聞いたほうが、AI の回答精度が上がります。

トラブルシューティング

よくあるエラーと対処法をまとめました。

接続エラーになる

症状: Save をクリックすると赤いバツ印が出る。

対策:

1. API Key チェック: 前後にスペースが入っていないか再確認。
2. 残高確認: DeepSeek のウォレットに残高があるか確認（最低金額等の制限に注意）。
3. URL 形式: Base URL に /v1 を付けてみる（https://api.deepseek.com/v1）。
4. ネットワーク: プロキシやVPNの設定を確認。

モデルが見つからない

症状: 設定できたはずなのに、Chat 画面のプルダウンに deepseek-chat がない。

対策:

1. 設定画面に戻り、モデル名が正しく追加されているか確認。
2. Chat 画面のプルダウンの下の方に「More…」がないか確認。
3. Cursor を再起動する。

応答が遅い

症状: なかなか返事が来ない。

対策:

1. deepseek-v4-flash を使っているか確認（deepseek-v4-pro の思考モードは時間が長い）。
2. 一度に送るコード量を減らす。
3. DeepSeek 側のサービスステータスを確認。

結論

DeepSeek API を Cursor に連携するのは、コストを劇的に下げる素晴らしい選択肢です。5分の設定で、月額3,000円の固定費を、使った分だけの数十円〜数百円に変えられます。

機能制限（Tab 補完や Composer がない）は確かに痛いですが、Chat 機能だけで十分というユーザーにとっては、これ以上ないコストパフォーマンスです。

まとめると：

• ✅ 超低コスト: 月額数十円レベル
• ✅ 品質十分: 日常開発には十分な性能
• ⚠️ 機能制限: Chat のみ。自動化機能は弱い

まずは100円分だけでもチャージして、試してみることを強くお勧めします。失うものはほとんどありません。もし合わなければ、その時また Pro を検討すればいいのです。

浮いたお金で、美味しいコーヒーでも飲みましょう！

2026年、設定前の判断表

目的	推奨	向かないケース
低コストで Chat ベースのコーディング	DeepSeek API + Cursor カスタムモデル	Tab 補完や Composer をフル活用したい
高頻度の AI ペアプログラミング	Cursor Pro/Ultra の内蔵モデル	token 単価だけを最適化する
企業プロキシ環境	Cursor ネットワークを先に直す	プロキシ/証明書を確認せず DeepSeek の問題にする
コスト重視の小規模チーム	カスタム API + 月次 token 予算	Key 管理や利用監視がない

関連記事：Cursor 設定とネットワーク対策

• Cursor 企業プロキシ設定ガイド
• Cursor ネットワーク問題の完全対処
• AI コーディングツール全景 2026