友人を招待して無料トークンを獲得！詳細を見る

🚀 CursorをCodingPlanXカスタムモデルに接続する

> はじめに：Cursorは、強力な大規模モデル機能を内蔵し、開発者に深く愛されているAIプログラミングツールです。しかし、時にはネットワークの制限、コストコントロール（サードパーティの中継APIやDeepSeekなどのより安価なモデルの使用）、または企業内ネットワークでの展開のニーズから、カスタムAPI URLとAPIキーを設定する必要があります。 > > 本チュートリアルでは、その設定を簡単に完了する方法をステップバイステップで説明します。

📋 準備

設定を開始する前に、以下の情報が準備できていることを確認してください：

  1. Cursorがインストールされていること：Cursorが最新バージョンであることを確認してください。
  2. API キー (API Key)：例 sk-xxxxxxxxxxxxxxxxxxxxxxxx。
  3. Base URL (インターフェースアドレス)：カスタムAPIプロキシのアドレス。
    • 注意：通常は /v1 で終わる必要があります。例：https://api.codingplanx.ai/v1。
  4. モデル名 (Model Name)：使用する予定のモデルの標準名（例：gpt-4o, claude-3-5-sonnet, deepseek-chat など）。

⚙️ 詳細な設定手順

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

  1. Cursorエディタを起動します。
  2. 右上の 歯車アイコン ⚙️ をクリックするか、ショートカットキーを使用して設定を開きます：
    • Windows / Linux: Ctrl + ,
    • macOS: Cmd + ,

ステップ2：Models（モデル）設定ページに入る

ポップアップした設定パネルの左側のナビゲーションバーで、Models（モデル）タブを見つけてクリックします。

ステップ3：APIキーを設定する

  1. Modelsページを下にスクロールし、OpenAI API Key セクションを見つけます。
  2. カスタム API キー を入力ボックスに貼り付けます。
  3. 右側の Verify（検証）ボタンをクリックします。（この時点で検証が失敗しても問題ありません。まだURLを設定していないためです）。
  4. ⚠️ 重要なヒント：上部にあるCursor公式の Cursor Tab や、その他の有料サブスクリプションが必要なスイッチが適切な状態になっていることを確認してください（サードパーティAPIを無料で使用する場合は、公式モデルのスイッチをオフにすることをお勧めします）。

ステップ4：Base URLを設定する（デフォルトインターフェースの上書き）

これは最も重要なステップであり、リクエストがどこに送信されるかを決定します：

  1. OpenAI API Key 入力ボックスの下にある、Override OpenAI Base URL（OpenAIベースURLを上書き）オプションを見つけます。
  2. このオプションを展開し、カスタムインターフェースアドレスをボックスに入力します。 > 💡 入力例： > - CodingplanX AI：https://api.codingplanx.ai/v1
  3. 入力が完了したら、必ずEnterキーを押して設定を保存してください。

ステップ5：カスタムモデル名を追加する（任意ですが推奨）

使用するモデルがCursorのデフォルトリストにない場合（例：deepseek-coder）、手動で追加する必要があります：

  1. Modelsページの一番上までスクロールし、Model Names セクションを見つけます。
  2. + Add Model（モデルを追加）をクリックします。
  3. モデル名（例：deepseek-chat）を正確に入力し、Enterキーを押して確認します。
  4. 追加したばかりのモデルの前のスイッチをオンにし、誤選択を防ぐために、使用しない他のモデルをオフにすることをお勧めします。

✅ テストと検証

設定が完了したら、有効になっているかテストする必要があります：

  1. コード編集画面に戻ります。
  2. Ctrl + L (Windows) または Cmd + L (macOS) を押して、右側の Chat チャットウィンドウ を呼び出します。
  3. チャットウィンドウの下部で、現在表示されているモデル名をクリックし、設定したばかりのモデル（例：gpt-4o または deepseek-chat）に切り替えます。
  4. 簡単な挨拶を送信します。例："あなたは誰ですか？あなたのモデルのバージョンを教えてください。"
  5. AIが正常かつ迅速に返答できれば、おめでとうございます！設定成功です！🎉

❓ よくある質問とトラブルシューティング (FAQ)

障害の現象考えられる原因解決方法
接続タイムアウト / 404 Not FoundBase URL の形式が間違っている。URL に /v1 サフィックスが欠けていないか、または /chat/completions が余分に追加されていないか確認してください。正しい形式は https://xxx.com/v1 です。
Model not found (モデルが見つかりません)リクエストしたモデル名がAPIチャネルでサポートされていない。Cursorで選択したモデル名が、APIプロバイダーがサポートしている名前と完全に一致しているか（大文字と小文字を区別）確認してください。
Authentication failed (認証失敗)APIキーの入力ミス、または残高不足。キーが完全にコピーされているか（余分なスペースがないか）確認し、APIプロバイダーのバックエンドに移動してアカウント残高を確認してください。
Cursor Tab (コード補完) が使用できないCursorのインラインコード補完(Copilot)は独立したモデルを使用している。サードパーティAPIはChatとCmd+K機能のみを引き継ぐことができます。Cursor Tabの補完機能は通常、引き続きCursorの公式サービスに依存するか、FIMをサポートするモデルの特別な設定が必要です。

> 📝 結語： > カスタムAPIの設定をマスターすれば、AI支援プログラミングのコストを大幅に削減できるだけでなく、様々な最先端の大規模モデルを自由に切り替えることができます。このチュートリアルが役に立ったと思ったら、ぜひ開発者の友人にシェアしてください！