Cursor エディタ接続設定
Cursor IDE でカスタム Anthropic / OpenAI エンドポイントを通じて QCode.cc に接続し、Cursor v3 の Agents Window と Design Mode をサポートする
Cursor エディタ接続設定¶
Cursor は VS Code をベースにした AI-native エディタです。Cursor v3（2026-04 リリース）は Agents Window（複数 agent 協調）、Design Mode（ビジュアルデザインとコードの連携）、CLI agents（ターミナル内のサブ agent）の 3 つの新機能を導入しました。本ガイドでは、QCode.cc を Cursor の上流モデルソースとして設定する方法を紹介します。
Cursor を使う理由¶
- Agents Window（v3 新機能）：サイドバーで複数の AI agent を並列実行し、互いに干渉しません
- Cursor Composer：複数ファイル編集とコンテキスト認識リファクタリング、Cursor Chat より大規模変更に適しています
- Inline Edit (Cmd+K)：コードを選択して直接指示、最速のイテレーション方法
- VS Code ベース：すべての VS Code 拡張エコシステムを継承可能（Claude Code の VS Code 拡張を含む）
前提条件¶
設定手順¶
Cursor には 2 つの接続パスがあり、シナリオに応じて選択してください。
パス A：Custom OpenAI-compatible endpoint（推奨）¶
OpenAI プロトコル経由で QCode の /openai/v1 パスに接続し、GPT-5.5 / GPT-5.4 / Gemini など複数のモデルを利用できます。
- Cursor 設定を開く：
Cmd + ,（macOS）/Ctrl + ,（Windows/Linux） - Models → 一番下までスクロール Override OpenAI Base URL
- 以下のように入力：
| フィールド | 値 |
|---|---|
| OpenAI API Key | あなたの QCode.cc API Key（cr_ で始まる） |
| Override OpenAI Base URL | http://103.236.53.153/openai/v1 |
- Models リストで有効化したいモデル（
gpt-5.5、gpt-5.4-codexなど）にチェックを入れます。リストにないものは + Add model をクリックして手動で model id を追加できます - Verify をクリックして接続性をテスト。通過すれば Cursor Chat / Composer で使用可能
パス B：Custom Anthropic endpoint（Claude に接続）¶
⚠️ 既知の制限：Cursor の Anthropic 統合は Agent モードで OpenAI Responses API スタイルを使用しており、QCode の Anthropic プロトコルパスとは一部のシナリオで互換性がありません（一部のツール呼び出し schema 変換失敗として表れます）。優先的にパス A の OpenAI プロトコルを使用することを推奨します。Claude モデルを使用する場合は、パス A 内で
claude-opus-4-7などの model id を追加してください（QCode は OpenAI プロトコル層でパススルーします）。
フォールバックエンドポイント¶
| エンドポイント | OpenAI Base URL | Anthropic Base URL |
|---|---|---|
| 深圳ダイレクト（CN ユーザー推奨；probe.qcode.cc でクエリ可能） | http://103.236.53.153/openai/v1 |
http://103.236.53.153/api |
| 国際 CDN（海外ユーザー推奨） | https://api.qcode.cc/openai/v1 |
https://api.qcode.cc/api |
完全なエンドポイント一覧（北米 / 欧州 / アジアのフォールバックを含む）は 接続点と API 形式 を参照してください。
Claude Code との併用¶
Cursor 内蔵 AI と独立した Claude Code CLI は競合しません——両方を同じ Cursor ウィンドウで使用できます：
- Cursor の Chat / Composer：エディタ内の AI、Cursor 設定で構成したエンドポイントを経由
- Claude Code CLI：Cursor 統合ターミナル（
Ctrl + `）でclaudeを実行、CLI 自身のANTHROPIC_BASE_URL環境変数を経由
2 つのパスは独立して認証されますが、同じ QCode API Key を使用すればクォータを共有します（詳細は 請求について を参照）。
制限と注意¶
- Privacy Mode：Cursor はデフォルトでコードスニペットを設定されたエンドポイントに送信します。Cursor 設定で Privacy Mode を有効にしている場合、API Key 設定後も QCode に接続できることを確認してください。Privacy Mode は外向きトラフィックには影響せず、Cursor 自身が prompt を保存することを防ぐだけです
- Cursor Pro サブスクリプション と QCode API Key は独立した 2 セットです——Cursor Pro は Cursor 内蔵クォータ（Cursor 自身の GPT-4 プールを経由）を提供し、QCode API Key は当社の中継プールを経由します。両方を使用している場合、Cursor 設定の優先順位に従ってルーティングされます
- Cursor v3 Agents Window は現在、OpenAI / Anthropic プロトコルの互換性が最も安定しています。非主流の provider（自前の OSS モデルなど）のサポートはばらつきがあります
よくある質問¶
Cursor が "API key not valid" と表示する¶
- API Key が完全で
cr_で始まり、前後に空白がないことを確認 - Cursor 設定で Verify をクリックして具体的なエラーを確認
- コマンドラインで接続性をテスト：
bash curl -H "Authorization: Bearer YOUR_KEY" \ http://103.236.53.153/openai/v1/modelsJSON リストが返れば、エンドポイントと API Key の両方が OK
Composer で Claude モデルが使えない¶
Cursor v2 から Composer はデフォルトで OpenAI プロトコルを経由します。Claude を選択する場合は、Models リストで claude-opus-4-7 などの 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 エンドポイントを使うようにチェックすることもできます。
次のステップ¶
- VS Code 統合 — 同源エディタ、共通の設定思想
- 接続点と API 形式 — QCode.cc 3 プロトコル 4 接続ドメイン全表
- Claude Code 完全チュートリアル — CLI ワークフローのリファレンス
- 請求について — 共有クォータのルール