> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mixroute.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor

> Cursorコードエディター連携ガイド

## はじめに

CursorはAI搭載のコードエディターです。MixRoute APIを連携すると、インテリジェントなコード生成、補完、説明、最適化など、コーディング中に強力なAI支援を利用できます。MixRouteは現在、CursorのAgent機能（Auto Apply / 複数ファイルの編集）に対応しています。

## クイック設定

<Warning>
  **重要**：現在、Cursorは、サードパーティのAPIキー（Mixroute Apiを含む）に対して、公式に次の制限を設けています。

  * Pro Plan（有料サブスクリプション）が必要です。Free PlanではサードパーティーのAPIキーを使用できません。
  * サードパーティのAPIサービスに接続するにはVPNまたはプロキシが必要です
  * これはCursorの公式ポリシーによる制限です。
</Warning>

### 1. 設定を開く

右上の歯車アイコン⚙️をクリックし、モデルの項目を選択してください。

### 2. APIの設定

* **OpenAI APIキー**：MixRouteのAPIキーを入力してください
* **OpenAIのベースURLを上書き**：チェックを入れ、`https://api.mixroute.ai/v1`を入力します
* **検証**をクリックして設定を確認します。

<Note>
  - GPTシリーズのモデルには`openai/`プレフィックスが必要です。たとえば、`gpt-5.5`には`openai/gpt-5.5`を使用します。ほかのチャネルでは元のモデルIDを使用します。
  - Mixroute APIはCursor Agent（Auto Apply）に対応しています。Agentを有効にするには、Agent対応モデルを使用してください。
</Note>

### 3. Agentモードのヒント

* Agent対応モデルを使用します（Claude、DeepSeek、Grok、`openai/`接頭辞付きのGPTシリーズ）
* ベースURLが`https://api.mixroute.ai/v1`であることを確認してください
* 初回は、Cursorのサイドバーで簡単な変更を行い、自動適用を確認します
* モデルがAgentに対応していない場合は、Chatモードを使用し、Applyで手動適用してください

### カスタムモデルの追加

Cursorの設定に追加します。

```text theme={null}
claude-sonnet-5
gpt-5.5
deepseek-v4-pro
gemini-3.5-flash
```

## 利用モード

### Chatモードのワークフロー

1. **コードの生成**: `Ctrl/Cmd + L`でチャットを開き、要件を説明します
2. **コードの適用**: 対象ファイルにコードをコピーするか、「Apply」ボタンを使用します
3. **反復修正**: 会話を続けて修正します

### 代替ツールの比較

| ツール | エージェントモード | 長所 | 短所 |
| - | - | - | - |
| Cursor | ❌ | 洗練されたUIと優れた補完機能 | Agentモードなし |
| Cline（VS Code） | ✅ | 完全なAgent機能 | VS Codeが必要 |
| RooCode (VS Code) | ✅ | 複数ファイルの編集 | 比較的新しく、進化の途上 |
| Continue（VS Code） | ✅ | オープンソース、カスタマイズ可能 | 設定が複雑 |

## 主な機能

### スマートなコード補完

* **Tab補完**：TabキーでAIの提案を適用
* **複数行補完**: 関数単位のコード生成
* **コンテキストの理解**: プロジェクト構造に基づく的確な提案

### AIチャット

* `Ctrl/Cmd + K`：コマンドパレットを開く
* `Ctrl/Cmd + L`：サイドバーのチャットを開く
* **コードの説明**：コードを選択してAIに質問

### コード編集

* **コード生成**：要件を説明するとAIが自動生成
* **リファクタリング**：コードの最適化に関する提案を取得
* **エラーの修正**: AIがエラーの特定と修正を支援します

## キーボードショートカット

| ショートカット | 機能 |
| - | - |
| `Ctrl/Cmd + K` | AIコマンドパレットを開く |
| `Ctrl/Cmd + L` | AIチャットのサイドバーを開く |
| `Tab` | コードの提案を受け入れる |
| `Esc` | 現在の提案をキャンセル |

## ヒント

### 明確なコンテキストを提供

```javascript theme={null}
// @context: React component for user authentication
// @requirements: Need OAuth2 login support
// @constraints: Compatible with NextJS 13+
```

### プロンプトの最適化

* **悪い例**: `"Fix this function"`
* **良い例**：`"Fix floating-point precision issue in calculateTotal function, ensure amount calculation is accurate to two decimal places"`

## トラブルシューティング

<AccordionGroup>
  <Accordion title="接続タイムアウト">
    * ネットワーク接続を確認します
    * API URLが`https://api.mixroute.ai/v1`であることを確認します
    * APIキーが有効であることを確認してください
  </Accordion>

  <Accordion title="モデルが応答しない">
    * アカウント残高を確認してください
    * 別のモデルへの切り替えを試してください
    * Cursorクライアントを再起動します
  </Accordion>

  <Accordion title="提案の品質が低い">
    * プロジェクトのコンテキストをより詳しく提供してください
    * より具体的なプロンプトを使用してください
    * より高性能なモデルに切り替える
  </Accordion>
</AccordionGroup>

## ベストプラクティス

### プロジェクト単位の設定

プロジェクトのルートに`.cursor-settings.json`を作成してください。

```json theme={null}
{
  "model": "gpt-5.5",
  "temperature": 0.7,
  "contextFiles": ["README.md", "package.json"],
  "rules": [
    "Use TypeScript strict mode",
    "Follow ESLint standards",
    "Add appropriate comments"
  ]
}
```

### コードレビュー

```text theme={null}
Please review this code, focusing on:
1. Performance issues
2. Security vulnerabilities
3. Code standards
4. Best practices
```

## Agentモードについて

AIによる複数ファイルの自動編集や複雑なリファクタリングには、次を検討してください。

* **Cline**: 完全なAgent機能を備えたVS Codeプラグイン
* **RooCode**: 新しいVS Code向けAIエージェントプラグイン


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.