9router/gitbook/content/ja/integration/cursor.md
2026-05-11 11:50:24 +07:00

5.5 KiB

Cursor統合

9RouterをCursor IDEと統合し、AIリクエストを9Routerのインテリジェントルーティングシステム経由でルーティングします。

前提条件

  • Cursor IDEがインストール済み
  • Cursor Proアカウント (カスタムAPIエンドポイントに必要)
  • 9Routerクラウドエンドポイントが設定済み
  • 9RouterダッシュボードからのAPIキー

⚠️ 重要な注意点

クラウドエンドポイントが必要: Cursorは独自のサーバー経由でリクエストをルーティングし、localhostエンドポイントをサポートしません。9Routerクラウドエンドポイント https://9router.com を使用する必要があります。

Cursor Proが必要: この機能はカスタムAPIエンドポイントを使用するためにCursor Proアカウントが必要です。

セットアップ

1. Cursor設定を開く

  1. Cursor IDEを開く
  2. Settings へ移動 (Cmd/Ctrl + ,)
  3. Models セクションへ移動

2. OpenAI APIを有効化

  1. OpenAI API key オプションを見つける
  2. トグルを有効にしてカスタムAPI設定を有効化

3. Base URLを設定

Base URLを9Routerクラウドエンドポイントに設定:

https://9router.com

手順:

  1. Models設定で Base URL フィールドを見つける
  2. 入力: https://9router.com
  3. Save をクリック

4. APIキーを追加

  1. API Key フィールドに9Router APIキーを入力
  2. APIキーは9Routerダッシュボードの Settings → API Keys で確認できます
  3. Save をクリック

5. カスタムモデルを追加

  1. View All Models ボタンをクリック
  2. Add Custom Model をクリック
  3. 9Router設定からモデル名を入力 (例: gpt-4claude-opus-4-5 など)
  4. Add をクリック

6. モデルを選択

  1. Cursorチャットインターフェイスでモデルセレクタードロップダウンをクリック
  2. リストからカスタムモデルを選択
  3. Cursorで9Routerを使い始める!

設定例

Cursor設定は次のようになります:

OpenAI API: ✓ Enabled
Base URL: https://9router.com
API Key: sk-9router-xxxxxxxxxxxxx
Custom Models: gpt-4, claude-opus-4-5, gemini-2.0-flash

利用可能なモデル

9Routerダッシュボードで設定されたモデルを使用できます。一般的な例:

モデル名 プロバイダー 説明
gpt-4 OpenAI GPT-4 Turbo
gpt-4o OpenAI GPT-4 Optimized
claude-opus-4-5 Anthropic Claude Opus 4.5
claude-sonnet-4-5 Anthropic Claude Sonnet 4.5
gemini-2.0-flash Google Gemini 2.0 Flash

使用法

チャットインターフェイス

  1. Cursorチャットを開く (Cmd/Ctrl + L)
  2. ドロップダウンからモデルを選択
  3. 9Router経由でAIとチャット開始

インラインコード生成

  1. エディタでコードを選択
  2. Cmd/Ctrl + Kを押す
  3. プロンプトを入力
  4. Cursorは9Routerを使用してコードを生成

コード説明

  1. エディタでコードを選択
  2. Cmd/Ctrl + Lを押す
  3. 「Explain this code」と質問
  4. 9Router経由でAIによる説明を取得

トラブルシューティング

「Invalid API Key」エラー

  1. 9RouterダッシュボードでAPIキーを確認
  2. sk-9router- プレフィックスを含むキー全体をコピーしたか確認
  3. APIキーが期限切れでないか確認
  4. 新しいAPIキーを再生成してみる

「Model Not Found」エラー

  1. モデル名が9Router設定と正確に一致するか確認
  2. 9Routerダッシュボードでプロバイダー接続がアクティブか確認
  3. 接続されたプロバイダーでモデルが利用可能か確認
  4. フルモデル名を使用してみる (例: gpt-4 の代わりに openai/gpt-4)

接続の問題

  1. クラウドエンドポイントを使用しているか確認: https://9router.com
  2. インターネット接続を確認
  3. 9Routerクラウドサービスが運用中か確認
  4. VPNまたはプロキシが有効な場合は無効化してみる

Localhostが動作しない

覚えておいてください: Cursorはlocalhostエンドポイントをサポートしません。クラウドエンドポイント https://9router.com を使用する必要があります。ローカル9Routerインスタンスを使用したい場合は、ngrokなどのトンネリングサービスを検討してローカルエンドポイントを公開してください。

クラウドエンドポイントのセットアップ

ローカルで9Routerを実行し、Cursorで使用したい場合:

  1. 9Router設定でクラウドエンドポイントを有効化
  2. 9RouterダッシュボードでクラウドエンドポイントURLを設定
  3. Cursor設定でクラウドURLを使用
  4. ローカル9Routerインスタンスがインターネットからアクセス可能か確認

ベストプラクティス

  1. モデルエイリアスを使用: 9Routerで頻繁に使うモデル用のショートエイリアスを作成
  2. 使用量をモニター: 9Routerダッシュボードで使用統計とコストを確認
  3. APIキーをローテーション: セキュリティのためAPIキーを定期的にローテーション
  4. モデルをテスト: ユースケースに最適なモデルを見つけるため、異なるモデルを試す