Cursor エディタ接続設定

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

最終確認：2026-09-18 · 📄 公式ドキュメント準拠（Cursor 3.21（公式ダウンロードページ golden チャンネル、2026-09 確認）。Override 欄は 2026-08-11 の公式フォーラムでの Cursor スタッフ回答が根拠）

概要¶

欄の場所と既知の不具合¶

アドレスを入れるのは Settings → Models → API Keys です。 公式ヘルプセンターの BYOK ページ（cursor.com/help/models-and-usage/api-keys）は 4 ステップのみ：Cursor Settings → Models を開く → プロバイダ（OpenAI、Anthropic、Google、Azure、AWS Bedrock）を選ぶ → API キーをテキストボックスに貼り付ける → Save。Override 欄の項目立ての記述はありません。ただし欄自体は実在します。Cursor 公式スタッフの deanrie がフォーラムで名指しで確認しています：

"The fix for the OpenAI API Key and Override OpenAI Base URL fields, and other provider key fields, that didn't focus on mouse click has been merged and will ship in an upcoming 3.15 update. It's not in 3.15.6 yet. Once you update to a version newer than 3.15.6, please try again."（2026-08-11、スレッド原文）

実務上のポイントは 3 つ：

• 欄名は Override OpenAI Base URL（OpenAI 側）と Override Anthropic Base URL（Anthropic 側）で、それぞれ有効化 toggle が併設されています。
• 3.15.6 には既知の不具合があり、マウスでは入力欄にフォーカス当たりません。公式の回避策は、Settings → Models で該当 toggle を ON にしてから Tab でフォーカスを欄へ移す方法で、以降は入力も Ctrl+V の貼り付けも動きます。3.14.27 への一時巻き戻しも可。修正は 3.15 の後続版で配布され、3.15.6 では未反映です。まず 3.15.6 より新しい版に上げてから再試行してください。
• 同じページに逐語で「Your API key is not stored on our servers. It is sent to our backend with every request because all requests are routed through Cursor's servers for final prompt building」とあります。自前キーでもリクエストは Cursor バックエンドを通って prompt が組まれ、エディタがモデル供給元へ直接つながるわけではありません。

制限 3 つと時効リスク 1 つ：

• Teams / Enterprise プランでは自前キーでも Cursor Token Rate が課金され続けます。OpenAI キー添付の公式説明は "Standard, non-reasoning chat models"（標準・非推論の対話モデル）に限定されています。
• 流量を完全に Cursor バックエンドの外へ出したいなら、カスタム Base URL 対応のクライアントへ：Claude Code、Codex CLI、Cline、Zed など。
• 時間的なリスク：OpenAI は 2026-08-28 の公式声明で「we intend to wind down our contract providing OpenAI models to Cursor, with a proposed shutoff date of November 12, 2026」と述べています（2026-11-12 に Cursor へのモデル提供を終了する予定、まだ発効せず）。Cursor 側からは 2026-09-18 時点で対応の発表なし。出典：openai.com。

Cursor は VS Code をベースにした AI-native エディタです。公式の changelog はバージョン番号で編成されていないため、「バージョン X で機能 Y が追加」といった記述は本ページでは避けました。確認できているのは、ダウンロード時点で golden 配信が 3.21 だという点です。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 がインストール済み（macOS / Windows / Linux）
• QCode.cc API Key（cr_ で始まる）を保有、ダッシュボード で取得
• 同じ API Key が QCode の全プロトコルと 4 つの接続ドメイン（api / asia / us / eu）で共通。中国本土のユーザーは asia.qcode.cc を推奨

利用可能なモデル¶

下表は QCode 側でよく使うモデル id で、そのまま Cursor に入力します。欄の場所と 3.15.6 の入力不具合は上の「欄の場所と既知の不具合」を参照してください。

Gemini の単価とプラン倍率の有無は qcode.cc/models に従い、口頭の「×2」を使い回さないでください。上表は現行の推奨です。claude-sonnet-4-6 / claude-opus-4-8 / claude-opus-4-7 などの 4.x は引き続き販売中です。

設定手順¶

以下の 2 とおりの経路は前述の 2 つの Override 欄に対応します。パス A（OpenAI プロトコル）が最も互換性が高いです。入力欄にフォーカスが当たらない場合は、上の Tab 回避か 3.15.6 より新しい版への更新を使ってください。

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

OpenAI プロトコル経由で QCode の /openai/v1 パスに接続します。このレッグで使えるのは GPT 系と中国系 4 ファミリー（GLM / Kimi / DeepSeek / Qwen）です。

🔴 このレッグでは Claude も Gemini も使えません。 QCode の OpenAI エンドポイントは上記 2 群のみを受け付け、claude-… や gemini-… を指定すると model_not_available_on_endpoint が返ります。Claude は下記のパス B を使ってください。対応表は エンドポイントと API パス。

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 の設定で Models → Anthropic API を開き、QCode のキーを入力し、Override Anthropic Base URL をオンにして上記アドレスを入れます。

🔴 2 つの override は互いに干渉します。 ユーザー報告によると、Override OpenAI Base URL を設定すると Cursor は Claude のトラフィックもその OpenAI エンドポイントへ送るため、Claude モデルが 422 で失敗します。ただし 公式ドキュメントにこの挙動の記載はなく、コミュニティ報告ベースです。Claude を使うなら Anthropic 側の override だけを設定し、OpenAI 側は空にしてください。 両方必要なら Cursor のプロファイルを分けるか、都度切り替えてください。

⚠️ Agent モードでは一部機能が OpenAI Responses API スタイルを使うため、Anthropic プロトコルパスとは一部シナリオで非互換です（典型的にはツール呼び出しの schema 変換失敗）。Cursor のエンドポイント切り替えは随時変わるため、詳細は Cursor 公式ドキュメントを参照してください。

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

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

要するに：Chat / Composer / Inline Edit の三点セットが QCode エンドポイントで最も確実です。高度にマネージドな機能（Tab 補完や agent 処理の一部）は Cursor 自社モデルに固定されたままのことがあります。この節全体は公式文書ではなく観察に基づく記述なので、必ず公式の発表を正としてください。

典型的なワークフロー¶

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

1. Composer でモデルを選択（例：日常は claude-sonnet-5、大規模変更は claude-opus-5）
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 5 / Sonnet 5 と 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 設定の優先順位に従ってルーティングされます
• Agents Window とバックグラウンド agent は主流プロバイダ（OpenAI / Anthropic プロトコル）で最も安定します。自社構築の OSS モデル系は対応状況にばらつきがあります
• Override はグローバルスイッチ：Override OpenAI Base URL を入力すると、Cursor 内で既定が OpenAI プロトコルであるリクエストは QCode を向きます。空にすれば既定に戻ります。ただし公式の表記どおり、リクエストは prompt 組み立てのために Cursor バックエンドを通ります。「トラフィックだけ移って他は変わらない」という理解は成り立ちません

実用的なヒント¶

• タスクごとにモデルを選ぶ：パス B（Anthropic、https://api.qcode.cc/api）では日常編集に claude-sonnet-5、大規模リファクタに claude-opus-5。パス A（OpenAI）では純粋なコード補完に gpt-5.6-terra、汎用に gpt-5.5
• 長コンテキストは 1M ティア優先：claude-opus-5 / 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 モデルが使えない¶

Composer は既定で OpenAI プロトコルを使いますが、QCode の OpenAI エンドポイントは Claude モデルを受け付けません。claude-opus-5 を Models に追加しても無駄で、リクエストは model_not_available_on_endpoint で拒否されます。

正しい方法はパス B です。Models → Anthropic API に QCode キーを入れ、Override Anthropic Base URL をオンにして https://api.qcode.cc/api を指定し、Override OpenAI Base URL は空にしてください（さもないと Cursor は Claude を OpenAI エンドポイントへ送り 422 になります）。

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、そしてカスタムエンドポイントに対応するすべてのツールで共通に使えます。