Cursor エディタ接続設定

Cursor IDE でカスタム Anthropic / OpenAI Base URL + API Key を通じて QCode.cc に接続。モデル設定、カスタムエンドポイントの制限、トラブルシューティングを含む

Cursor エディタ接続設定¶

Cursor は VS Code をベースにした AI-native エディタです。Cursor v3（2026-04 リリース）は Agents Window（複数 agent 協調）、Design Mode（ビジュアルデザインとコードの連携）、CLI agents（ターミナル内のサブ agent）の 3 つの新機能を導入しました。本ガイドでは、QCode.cc を Cursor の上流モデルソースとして設定する方法を紹介します。要点は、Cursor の設定にカスタム Base URL とあなたの QCode API Key を入力することです。

Cursor を使う理由¶

• Agents Window（v3 新機能）：サイドバーで複数の AI agent を並列実行し、互いに干渉しません
• Cursor Composer：複数ファイル編集とコンテキスト認識リファクタリング、Cursor Chat より大規模変更に適しています
• Inline Edit (Cmd+K)：コードを選択して直接指示、最速のイテレーション方法
• VS Code ベース：すべての VS Code 拡張エコシステムを継承可能（Claude Code の VS Code 拡張を含む）

前提条件¶

• Cursor がインストール済み（macOS / Windows / Linux）
• QCode.cc API Key（cr_ で始まる）を保有、ダッシュボード で取得
• 同じ API Key が QCode の全プロトコルと 4 つの接続ドメイン（api / asia / us / eu）で共通。中国本土のユーザーは asia.qcode.cc を推奨

利用可能なモデル¶

QCode は同じ Key で 3 つのプロトコルのモデルを提供します。Cursor のカスタムエンドポイントは OpenAI プロトコル経由が最も安定しており、model id は下表の値をそのまま入力できます：

Gemini 系列は QCode では ×2 で課金されます。完全な価格表は qcode.cc/pricing を参照してください。

設定手順¶

Cursor には 2 つの接続パスがあり、シナリオに応じて選択してください。パス A（OpenAI プロトコル）が最も互換性が高く、強く推奨します。

パス A：Custom OpenAI-compatible endpoint（推奨）¶

OpenAI プロトコル経由で QCode の /openai/v1 パスに接続し、GPT-5.5 / GPT-5.4 / Gemini およびパススルーされた Claude など複数のモデルを利用できます。

1. Cursor 設定を開く：Cmd + ,（macOS）/ Ctrl + ,（Windows/Linux）
2. Models → 一番下までスクロール Override OpenAI Base URL
3. 以下のように入力：

1. Models リストで有効化したいモデル（gpt-5.5、gpt-5.4、gpt-5.6-terra など）にチェックを入れます。リストにないものは + Add model をクリックして手動で model id を追加できます
2. Verify をクリックして接続性をテスト。通過すれば Cursor Chat / Composer で使用可能

Base URL の末尾にスラッシュを付けないでください。 QCode の自己チェックリクエストが 401 を返すのは、パスが正しく認証だけが欠けている状態を意味します——これは正常で、エンドポイントに到達できている証拠です。

各プロトコルの Base URL 対照（同じ Key がすべてで共通）：

パス B：Custom Anthropic endpoint（Claude のネイティブプロトコルに接続）¶

Claude モデルの Anthropic ネイティブプロトコルを使いたい場合、QCode の Anthropic Base URL は https://api.qcode.cc/api です（SDK が自動で /v1/messages を追加します）。

⚠️ 既知の制限：Cursor のカスタム Anthropic エンドポイント対応はバージョンによって変化し、Agent モードでは一部機能が OpenAI Responses API スタイルを使用するため、QCode の Anthropic プロトコルパスとは一部のシナリオで互換性がありません（典型的には一部のツール呼び出しで schema 変換失敗として表れます）。パス A の OpenAI プロトコルを優先することを推奨します。 Claude モデルを使用する場合は、パス A 内で claude-opus-4-8 / claude-opus-4-7 などの model id を追加してください（QCode は OpenAI プロトコル層でパススルーします）。Cursor のエンドポイント切り替えは随時変わるため、詳細は Cursor 公式ドキュメントを参照してください。

カスタムエンドポイントで使える機能¶

Cursor は AI 機能をいくつかのカテゴリに分けており、カスタム OpenAI エンドポイントがそれらをカバーする度合いは異なります。下表は現在の観察に基づく実用的な判断です。Cursor は頻繁にアップデートされるため、最終的には Cursor 公式を基準としてください：

要するに：Chat / Composer / Inline Edit の三点セットが QCode エンドポイントで最も確実です。高度にマネージドな機能（Tab 補完、一部 agent フロー）は Cursor 自前のモデルに残る可能性があります。Cursor がある agent 機能でカスタムエンドポイントを開放するタイミングは公式アナウンスを基準としてください。

典型的なワークフロー¶

エンドポイント設定後、Composer の日常的な使い方はおおむね次の通りです：

1. Composer でモデルを選択（例：日常は claude-sonnet-4-6、大規模変更は claude-opus-4-8）
2. Cmd + I で Composer を開き、編集対象のファイルをコンテキスト領域にドラッグ
3. 目標を自然言語で記述、例「このコンポーネントの状態管理を useState から useReducer に移行し、既存の props は変えないで」
4. diff を確認し、ブロック単位で Accept / Reject
5. 素早い局所修正には Inline Edit（Cmd + K）を使い、毎回 Composer を開かない

このフローはすべて設定した QCode エンドポイント上で動き、クォータは 請求について のルールで統一精算されます。

フォールバックエンドポイント¶

4 つのドメインは同一サービスの異なる入口で、同じ API Key が共通です。完全な説明は 接続点と API 形式 を参照してください。

画像入力と画像生成¶

• 画像入力（モデルに「画像を見せる」）：Cursor はスクリーンショットやデザイン稿を会話に貼り付け / ドラッグして、ビジョン対応モデルに読み取らせることができます——例えば UI ラフからコンポーネントを書く、エラースクリーンショットからバグを調査するなど。QCode 上のビジョン対応モデルには Claude Opus 4.8 / Sonnet 4.6 と GPT-5.x が含まれます。
• 画像生成（モデルに「描かせる」）：これは別物です。画像生成には QCode の gpt-image-2 モデルを専用画像エンドポイント経由で使い、Cursor エディタのフロー内ではありません。詳細は gpt-image-2 画像生成 を参照してください。

Claude Code との併用¶

Cursor 内蔵 AI と独立した Claude Code CLI は競合しません——両方を同じ Cursor ウィンドウで使用できます：

• Cursor の Chat / Composer：エディタ内の AI、Cursor 設定で構成したエンドポイントを経由
• Claude Code CLI：Cursor 統合ターミナル（Ctrl + `）で claude を実行、CLI 自身の ANTHROPIC_BASE_URL 環境変数を経由

統合ターミナルで Claude Code を QCode（Anthropic プロトコル）に向ける：

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_あなたのKey"
claude

2 つのパスは独立して認証されますが、同じ QCode API Key を使用すればクォータを共有します（詳細は 請求について を参照）。Claude Code の サブエージェント と 自動化と CI/CD はどちらもこのターミナルで直接使えます。

制限と注意¶

• Privacy Mode：Cursor はデフォルトでコードスニペットを設定されたエンドポイントに送信します。Cursor 設定で Privacy Mode を有効にしている場合、API Key 設定後も QCode に接続できることを確認してください。Privacy Mode は外向きトラフィックには影響せず、Cursor 自身が prompt を保存することを防ぐだけです
• Cursor Pro サブスクリプション と QCode API Key は独立した 2 セットです——Cursor Pro は Cursor 内蔵クォータ（Cursor 自身のモデルプールを経由）を提供し、QCode API Key は当社の中継プールを経由します。両方を使用している場合、Cursor 設定の優先順位に従ってルーティングされます
• Cursor v3 Agents Window は現在、OpenAI / Anthropic プロトコルの互換性が最も安定しています。非主流の provider（自前の OSS モデルなど）のサポートはばらつきがあります
• オーバーライドはグローバルスイッチ：Override OpenAI Base URL を入力すると、Cursor 内でデフォルトに OpenAI プロトコルを経由するリクエストはすべて QCode に切り替わります。一時的に Cursor デフォルトに戻すには、このフィールドを空にしてください

実用的なヒント¶

• タスクごとにモデルを選ぶ：日常編集は claude-sonnet-4-6 がコスパ最良。大規模リファクタ / 長コンテキストは claude-opus-4-8。純粋なコード補完は gpt-5.6-terra を試す
• 長コンテキストは 1M ティア優先：claude-opus-4-8 / gpt-5.5 などの 1M コンテキストモデルは、リポジトリ全体を入れる Composer の大規模変更に向く
• 節約：Composer のデフォルトを中ティアにし、難題のときだけ手動で旗艦に切り替える
• 近いエンドポイントを使う：中国本土では Base URL を https://asia.qcode.cc/openai/v1 に変えると通常より速い
• 挙動がおかしいときはまず Verify：Cursor のアップデート後にエンドポイント挙動が変わることがあるため、他を調べる前に一度 Verify を押す

よくある質問¶

Cursor が "API key not valid" と表示する¶

1. API Key が完全で cr_ で始まり、前後に空白がないことを確認
2. Cursor 設定で Verify をクリックして具体的なエラーを確認
3. コマンドラインで接続性をテスト： bash curl -H "Authorization: Bearer YOUR_KEY" \ https://api.qcode.cc/openai/v1/models JSON リストが返れば、エンドポイントと API Key の両方が OK

Verify は失敗するが curl は通る¶

多くの場合、Base URL の末尾にスラッシュが余分か、/v1 のないパスになっています。https://api.qcode.cc/openai/v1（OpenAI プロトコル）で末尾に / がないことを確認してください。注意：base パスを直接叩いて 401 が返るのは正常（パスは正しく認証が欠けている）であり、設定ミスではありません。

Composer で Claude モデルが使えない¶

Cursor v2 から Composer はデフォルトで OpenAI プロトコルを経由します。Claude を選択する場合は、Models リストで claude-opus-4-8 などの model id を手動で追加する必要があります（QCode が OpenAI プロトコルで Claude モデルをパススルーしていても、Cursor は model id を認識しないとドロップダウンに表示できません）。

Inline Edit (Cmd+K) が遅い¶

Cursor の Cmd+K はデフォルトで Cursor 自前の fast model を使用します。QCode に切り替えた後は設定された base URL を経由するため、初回レイテンシは Cursor 内蔵よりやや高くなります（中継が一段増えるため）。設定で Cursor Tab は Cursor デフォルトを、Chat / Composer は QCode エンドポイントを使うようにチェックすることもできます。

Agents Window / バックグラウンド agent がエラーになる、または QCode を経由しない¶

一部の agent サブ機能はモデルソースに要件があり、カスタムエンドポイントではなく Cursor 内蔵モデルの使用を強制する場合があります。これは Cursor 側の設計でバージョンによって変化するため、Cursor 公式ドキュメントを基準としてください。まず Chat / Composer を QCode に切り替えて使い、agent フローは Cursor デフォルトのままにできます。

追加した model id がドロップダウンに表示されない¶

Models リストでそのモデルにチェックを入れたことと、+ Add model から id を正しく入力したこと（大文字小文字を区別、余分な空白なし）の両方を確認してください。変更後、Cursor を一度再起動してリストを更新します。

次のステップ¶

• VS Code 統合 — 同源エディタ、共通の設定思想
• 接続点と API 形式 — QCode.cc 3 プロトコル 4 接続ドメイン全表
• gpt-image-2 画像生成 — 画像生成専用エンドポイント
• サブエージェント — Claude Code サブエージェントの使い方
• 自動化と CI/CD — headless ワークフロー
• Claude Code 完全チュートリアル — CLI ワークフローのリファレンス
• 請求について — 共有クォータのルール

まだ API Key がありませんか？ qcode.cc/pricing でプランを選べば、1 つの Key が Cursor、Claude Code、そしてカスタムエンドポイントに対応するすべてのツールで共通に使えます。