wehub-resource-sync
05fcd08057
Deploy GitBook to 9router.github.io / build-deploy (push) Failing after 2s
150 lines
5.5 KiB
Markdown
150 lines
5.5 KiB
Markdown
# 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. **モデルをテスト**: ユースケースに最適なモデルを見つけるため、異なるモデルを試す
|