Cursor 設定

1. Cursor とは何か、開始前に必要なもの

Cursor は VS Code ベースの AI IDE です。エディタ内でチャット、コード生成、修正、説明などの一般的な開発操作を行えます。

RouteAPI 経由で Cursor に接続する前に、次の準備を推奨します。

Cursor 公式サイトからデスクトップ版アプリをインストールし、Cursor アカウントでログインします。

Cursor で設定ページを開き、Models に移動します。

Models ページで OpenAI 関連の設定項目を探します。Cursor のバージョンによってフィールド名が少し異なる場合がありますが、入力が必要な中心情報は次のとおりです。

入力後、Verify をクリックします。

検証が通ったら、Cursor のモデルセレクタを開き、RouteAPI から返された利用可能な OpenAI-compatible モデルを選択します。

より確実な選び方は次のとおりです。

RouteAPI コンソールで OpenAI プロトコル対応、かつチャットやコーディングに適している標準モデルを優先します。
reasoning モデルは優先しないでください。Cursor 公式ドキュメントでは、OpenAI カスタム API key は標準の非 reasoning チャットモデルのみ対応すると明記されています。

設定が完了すると、Cursor の Chat または Composer で RouteAPI が提供するモデルを直接使用できます。

カスタム API key 方式は主に Chat / Composer などの標準チャットモデル機能に影響し、Cursor のすべての内蔵機能を置き換えるものではありません。
Tab Completion、一部 Agent 機能、その他専用モデルを必要とする機能を有効にしている場合は、引き続き Cursor の内蔵モデルが使われることがあります。
Cursor 公式 FAQ によると、API key は保存されませんが、各リクエストは引き続き Cursor のサーバーへ送信され、そこで最終的な prompt が組み立てられます。

Verify が失敗する場合は、API key が正しいか、アドレスが https://www.routeapi.ai/v1 になっているかを確認してください。
モデル一覧に期待するモデルが表示されない場合は、そのモデルが OpenAI プロトコルに対応しており、reasoning モデルではなく標準チャットモデルであることを確認してください。
key やアドレスを更新しても Cursor が古い状態を表示する場合は、Cursor を閉じて開き直し、再度 Verify してください。
ターミナル内のコーディングエージェント接続方式が必要な場合は、Codex 設定ドキュメント、Claude 設定ドキュメント、OpenCode 設定ドキュメントも参照してください。