Cursor の独自 API キーとカスタム Base URL ガイド
2026-10-07 時点で、Cursor に自分の API キーを入れる場所は Cursor Settings → Models で、OpenAI、Anthropic、Google、Azure、AWS Bedrock にそれぞれ欄があります。Cursor の公式ドキュメントで確認できた Base URL override（スイッチと専用の入力欄）は OpenAI の欄だけで、Anthropic の欄のアドレスを変えられるという記述は見つかっていません。独自キーはチャットモデルにだけ使われ、Tab 補完は Cursor の内蔵モデルのままです。QCode につなぐ場合は OpenAI の欄に cr_ キー、Base URL に https://api.qcode.cc/openai/v1 を入れて GPT と中国系モデルを使い、Claude は Cursor の統合ターミナルで Claude Code を使います。
更新日 2026-10-08
先に押さえる 4 つの事実
独自キーを入れられるプロバイダー
公式ヘルプセンターが挙げるのは OpenAI、Anthropic、Google、Azure、AWS Bedrock です。手順は 4 つだけで、Cursor Settings → Models を開き、プロバイダーを探し、テキスト欄にキーを貼り、Save を押します。
Base URL override が公式に記載された欄
Agents Window 3.20 のリリースノート（2026-09-10）によると、各プロバイダーに専用の API Key 欄と Use API Key スイッチがあり、OpenAI にはさらに Base URL override スイッチと専用の入力欄が付きます。2026-10-07 時点で、Anthropic の欄の Base URL を変えられるという記述は Cursor の公式ドキュメントで見つかっていません。
独自キーが使われる範囲
公式の原文は Custom API keys only work with chat models. Tab completion continues using Cursor's built-in models. です。Tab 補完があなたのキーを使うことはありません。
Teams / Enterprise、100 万トークンあたり
この 2 プランでは、独自キーを使ったサードパーティモデルのリクエストにも Cursor Token Rate（100 万トークンあたり $0.25、入力・出力・キャッシュすべて）がかかります。Pro、Pro+、Ultra の個人プランでは、こうしたリクエストは含まれる利用枠を消費しません。
Cursor の「独自キー」とは
2026-10-07 時点で、Cursor では Cursor Settings → Models に自分の API キーを入れると、そのプロバイダーのモデルがあなたのキーで動き、モデル料金はプロバイダーに直接支払います。Base URL を別の宛先に向けられると公式ドキュメントに書かれているのは OpenAI の欄です。公式ヘルプセンターによれば、キーは Cursor のサーバーには保存されませんが、すべてのリクエストは最終的なプロンプト組み立てのために Cursor のサーバーを経由するため、リクエストのたびに Cursor のバックエンドへ送られます。つまり独自キーを使っても、エディターがモデルサービスへ直接つながるわけではありません。また独自キー利用時は Cursor の Zero Data Retention ポリシーは適用されず、データの扱いは選んだプロバイダーのプライバシーポリシーに従います。
最近の公式な変更 2 点
Cursor 側では、Agents Window 3.20（公式リリースノートのフィードで 2026-09-10 付）が OpenAI、Anthropic、Google のキー設定を整理しました。各プロバイダーにラベル付きの API Key 欄があり、キーを保存すると Use API Key スイッチが現れ、OpenAI にはさらに Base URL override スイッチと専用の入力欄があります。キーは欄から離れるか Enter を押すと保存され、欄を空にすると削除されます。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 への OpenAI モデル提供契約を終える意向と、今後のモデルは Cursor に提供しない方針が示されています。この声明はユーザーの独自キーには触れていません。
タイムライン
OpenAI が声明を発表：Cursor への OpenAI モデル提供契約を終える意向で、停止予定日は 2026-11-12、今後のモデルは Cursor に提供しないとしています。
Cursor の Agents Window 3.20 がリリース：Settings → Models で各プロバイダーに専用の API Key 欄と Use API Key スイッチ、OpenAI の欄に Base URL override スイッチと専用の入力欄が付きました。
OpenAI の声明にある停止予定日（proposed shutoff date）。2026-10-07 時点で、Cursor の公式ドキュメントに対応する説明は見つかっていません。
確認済み vs 公式に書かれていないこと
確認済み（公式ページで原文どおり確認可能）
次の点は Cursor の公式ヘルプセンター、ドキュメント、リリースノートと OpenAI の声明で原文どおり確認できます。独自キーは Cursor Settings → Models に入れる。対応プロバイダーは OpenAI、Anthropic、Google、Azure、AWS Bedrock。OpenAI の欄は "Standard, non-reasoning chat models"、Anthropic の欄は Anthropic API で使える全 Claude モデルと説明されている。独自キーはチャットモデルだけで、Tab は内蔵モデルのまま。キーが無効またはプロバイダーに拒否されると、そのプロバイダーを使うリクエストはキーを更新か削除するまで失敗する。OpenAI の欄には Base URL override スイッチと専用の入力欄がある。リクエストはプロンプト組み立てのため Cursor のサーバーを通る。Zero Data Retention は適用されない。Enterprise はメンバーの独自キー利用を禁止できる。Teams と Enterprise の Cursor Token Rate は 100 万トークンあたり $0.25。
公式に書かれていないこと（推測はしません）
次の 4 点は公式に明記されていないので、推測で設定しないでください。① Anthropic の欄で Base URL を変えられるか。2026-10-07 時点で Cursor の公式ドキュメントとリリースノートにその記述は見つかっていないため、本ページは Cursor 内蔵チャットでカスタムアドレス経由で Claude を呼ぶ方法を、使える手順として扱いません。② override 経由でつないだ他のモデルに、標準の非推論チャットモデルという制限がかかるか。③ Tab 以外の Inline edit や Cloud Agents などで独自キーが使われるか。Cloud Agents のページは厳選したモデルを使うとしか書いていません。④ OpenAI の提供終了の方針が独自キーやカスタム Base URL に影響するか。OpenAI も Cursor も触れていません。
Cursor で QCode を使う 2 つの方法
Cursor 内蔵チャット + OpenAI 欄の override
OpenAI の欄に cr_ キー、Base URL に https://api.qcode.cc/openai/v1 を入れ、GPT と DeepSeek・GLM・Kimi・Qwen のモデルを使います。リクエストはまず Cursor のサーバーでプロンプトが組み立てられてから送られ、Tab はこの設定を使いません。Teams と Enterprise では Cursor Token Rate もかかります。Claude はこの方法では使えません。QCode の OpenAI 互換エンドポイントは claude- で始まるモデルを model_not_available_on_endpoint で拒否します。
Cursor の統合ターミナルで Claude Code
Cursor の統合ターミナルで ANTHROPIC_BASE_URL=https://api.qcode.cc/api と ANTHROPIC_AUTH_TOKEN（あなたの cr_ キー）を設定してから claude を実行します。これは QCode の Anthropic エンドポイントを使う方法で、Claude モデルはこちらを使います。QCode のドキュメントによれば、両者は別々に認証されますが、同じキーを使えば利用枠を共有します。
Cursor で QCode を設定する手順
① Cursor Settings → Models を開き、OpenAI の欄を探します。② API Key 欄に、コンソールで作成した cr_ キーを貼ります（全文、前後の空白なし）。キーは欄から離れるか Enter を押すと保存され、保存後に Use API Key スイッチが現れるので、オンになっていることを確認します。③ 同じ欄の Base URL override スイッチをオンにし、https://api.qcode.cc/openai/v1 を入力します。末尾にスラッシュを付けず、/v1 も省かないでください。④ Models のモデル一覧に使いたいモデル ID を追加してチェックを入れます（例：gpt-6.1-sol、gpt-5.6-terra、deepseek-v4.1-flash、glm-5.3）。ID は大文字と小文字を区別し、変更後に Cursor を一度再起動すると一覧が更新されます。⑤ コマンドラインで確認します。Authorization: Bearer とキーを付けて https://api.qcode.cc/openai/v1/models にリクエストし、JSON の一覧が返ればアドレスもキーも正しい状態です。⑥ Claude を使う場合は claude- の ID をここに追加せず、統合ターミナルで Claude Code を実行します（前の節を参照）。
QCode では
QCode では 1 本の cr_ キーがプロトコルを問わず使え、どのプロトコルになるかはリクエストのパスで決まります。Cursor の OpenAI 欄に入れる https://api.qcode.cc/openai/v1 は OpenAI 互換エンドポイントで、GPT 系（gpt-6.1-sol、gpt-6-sol、gpt-5.6-terra など）と DeepSeek・GLM・Kimi・Qwen のモデル（deepseek-v4.1-flash、glm-5.3、kimi-k3、qwen3.8-max など）に使います。Claude モデルは Anthropic エンドポイント https://api.qcode.cc/api だけを使うため、Cursor の中では統合ターミナルの Claude Code で claude-sonnet-5-5 や claude-opus-5-5 を指定してください。料金はトークン単位で、各モデルの単価は /models をご覧ください。
よくある質問
Cursor でカスタム Base URL は設定できますか？どこに入れますか？
できます。ただし 2026-10-07 時点で Cursor の公式ドキュメントに記載が見つかったのは OpenAI の欄だけです。Cursor Settings → Models を開くと、OpenAI の欄に Base URL override スイッチと専用の入力欄があります（Agents Window 3.20 リリースノートの記述）。Anthropic や Google など他の欄については、アドレスを変えられるという公式の記述は見つかっておらず、API キーの入力だけが書かれています。Cursor のプライバシー文書も、この使い方を OpenAI 互換の base URL override 経由のカスタムモデルと呼んでいます。
自分の API キーを使うと、使えない機能はどれですか？
Tab 補完はあなたのキーを使いません。公式の原文は "Custom API keys only work with chat models. Tab completion continues using Cursor's built-in models." です。それ以外の機能は一つずつ挙げられていません。Cloud Agents のページは厳選したモデルを使うとだけ書き、独自キーが使えるかには触れていません。また Enterprise の管理者は、チーム設定でメンバーの独自キー利用を禁止できます。
Cursor で自分の Claude API キーは使えますか？QCode 経由の Claude は？
Anthropic の公式キーなら使えます。Anthropic の欄に入れれば、公式の説明では Anthropic API で使えるすべての Claude モデルが対象です。QCode 経由の Claude は OpenAI の欄では使えません。QCode の Claude は Anthropic エンドポイントだけで、OpenAI 互換エンドポイントは model_not_available_on_endpoint を返します（このエラーはプロトコルの選び間違いで、キーの誤りではありません。キーが誤っていれば Invalid API key が返ります）。Cursor の中で QCode の Claude を使うには、統合ターミナルで ANTHROPIC_BASE_URL を https://api.qcode.cc/api にして Claude Code を実行します。
独自キーでも Cursor の利用枠や料金はかかりますか？
個人プランではかかりませんが、Teams と Enterprise ではかかります。Pro、Pro+、Ultra の個人プランではかかりません。モデル料金はプロバイダーに支払い、これらのリクエストは含まれる利用枠を消費しません。Teams と Enterprise ではかかります。独自キーのリクエストを含むすべてのサードパーティモデルのリクエストに Cursor Token Rate（100 万トークンあたり $0.25、入力・出力・キャッシュ）がかかり、Other Models に計上されます。Grok や Composer など Cursor 自社のモデルは対象外です。
独自キーを使えば、リクエストはモデルサービスに直接届きますか？
いいえ。公式ヘルプセンターによると、キーは Cursor のサーバーに保存されませんが、すべてのリクエストは最終的なプロンプト組み立てのために Cursor のサーバーを経由するので、リクエストのたびに Cursor のバックエンドへ送られ、リクエスト完了後は保持されません。独自キーでは Zero Data Retention は適用されず、Enterprise の米国データレジデンシーも BYOK には対応しません。OpenAI 互換の base URL override 経由のカスタムモデルは、そのゲートウェイやモデルのリージョンに従います。
OpenAI が Cursor へのモデル提供をやめると、独自キーにも影響しますか？
公式な説明はありません。OpenAI の 2026-08-28 の声明が述べているのは、Cursor への OpenAI モデル提供契約を終える意向、停止予定日 2026-11-12、今後のモデルを Cursor に提供しないことだけで、ユーザーの独自キーやカスタム Base URL には触れていません。2026-10-07 時点で Cursor の公式ドキュメントにも対応する説明は見つかっていないため、その時期には両社の公式発表を確認してください。
情報源
Cursor：公式ヘルプセンターの Bring your own API key と Cursor Token Rate のページ、公式ドキュメントのエンタープライズ向けプライバシーとデータガバナンス、モデルと連携の管理、Cloud Agents の各ページ、Agents Window のリリースノートとリリースノートの RSS フィード（3.20、2026-09-10）、さらに cursor.com/llms.txt に載っている全公式ドキュメントページの検索結果。いずれも 2026-10-07 に取得。OpenAI：openai.com の声明「Our decision on Cursor following its acquisition by SpaceX」（2026-08-28）。直接のアクセスが遮断されたため、Internet Archive の 2026-08-29 と 2026-09-13 の保存版（本文は同一）で原文を読み、2026-10-07 に確認。QCode：QCode ドキュメントの Cursor 接続ページとエンドポイントと API パスのページ（いずれも 2026-09-25 更新）、同日に取得。
関連記事
Cursor の 2 つの利用枠プール解説
Cursor Models プールと Other Models プールの違いとリセット規則。
Cursor Auto の課金変更で確認すること
課金の定義を確認する手順と、コストが読める代替案。
Claude Code vs Cursor 徹底比較
AI モデル、コンテキストウィンドウ、実行モード、価格、エージェント機能を全面比較。
本ページの手順と引用は 2026-10-07 に、Cursor の公式ドキュメント、リリースノート、OpenAI の公式声明で照合したものです。上流の変更は予告なく行われることがあります。Cursor の設定画面はバージョンによって変わるため、表記はお手元の版に従ってください。モデルの提供状況は /models が優先です。