| # 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-4`、`claude-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. **モデルをテスト**: ユースケースに最適なモデルを見つけるため、異なるモデルを試す |
|
|
