CursorでGemini 2.5 Proを無料で使用する方法（2026年版）

CursorでGemini 2.5 Proを無料で利用する方法 (2026年版)

CursorにはデフォルトでClaudeやGPTモデルが搭載されていますが、これらは月間のリクエスト枠をすぐに消費してしまいます。多くの開発者が気づいていないのは、無料のGoogle AI Studio APIキーを使用してGemini 2.5 ProをCursorに接続できることです。これにより、実質無制限の無料枠で利用可能な、最高峰のコーディングモデルを手に入れることができます。

このガイドでは、無料APIキーの生成からCursorの設定、ワークフローの最適化まで、セットアッププロセス全体を詳しく解説します。

なぜCursorでGemini 2.5 Proを使うのか？

設定を始める前に、Gemini 2.5 ProをCursorの構成に追加する価値がある理由を説明します。

機能	Gemini 2.5 Pro	Claude Sonnet (Cursor デフォルト)	GPT-4o (Cursor デフォルト)
コンテキストウィンドウ	1,000,000 トークン	200,000 トークン	128,000 トークン
無料APIティア	あり (5 RPM)	なし	なし
コーディング性能	トップクラス	トップクラス	高性能
マルチモーダル入力	テキスト、画像、動画	テキスト、画像	テキスト、画像
Cursor経由のコスト	$0 (自身のキー)	Cursorの枠を消費	Cursorの枠を消費

最大のメリットは、独自のAPIキーを使用して行われたGemini 2.5 Proへのリクエストは、Cursor Proや無料枠の制限としてカウントされない点です。ClaudeやGPT用の500回（Pro）または50回（無料）のプレミアムリクエストを温存しつつ、Googleの無料レート制限の範囲内でGemini 2.5 Proを無制限に使用できます。

ステップ 1：無料のGoogle AI Studio APIキーを取得する

1. aistudio.google.com/apikey にアクセスします。
2. Googleアカウントでサインインします。
3. Create API Key をクリックします。
4. 既存のGoogle Cloudプロジェクトを選択するか、新規作成します。
5. 生成されたキーをコピーし、安全な場所に保存します。

このAPIキーは完全に無料です。クレジットカードの登録は不要で、試用期間もありません。レート制限の範囲内であれば無期限に無料で使用できます。

無料ティアのレート制限

制限項目	制限値
1分あたりのリクエスト数 (RPM)	5
1分あたりのトークン数	250,000
1日あたりのリクエスト数	100
コンテキストウィンドウ	1,000,000 トークン

Cursorでの一般的な開発ワークフローにおいて、1分間に5リクエスト、1日に100リクエストあれば十分です。より高い制限が必要な場合は、Google Cloudプロジェクトに課金設定を追加し、トークンごとに支払うことも可能です。

ステップ 2：CursorでGemini 2.5 Proを設定する

Cursorは、OpenAI互換のAPI設定を介してカスタムモデルをサポートしています。GoogleはGeminiモデル向けにOpenAI互換のエンドポイントを提供しているため、統合は非常に簡単です。

方法 A：Cursor設定UIから設定

1. Cursorを開きます。
2. Settings（歯車アイコン） > Models に移動します。
3. OpenAI API Key または Custom Models セクションまでスクロールします。
4. Add Model または Add Custom Endpoint をクリックします。
5. 以下を入力します：
   • Model Name: gemini-2.5-pro
   • Base URL: https://generativelanguage.googleapis.com/v1beta/openai
   • API Key: 取得したGoogle AI Studio APIキー
6. Save をクリックし、モデルセレクターに表示されることを確認します。

方法 B：Cursor設定ファイルから設定

Cursorの settings.json で直接設定することもできます。コマンドパレット（Cmd+Shift+P / Ctrl+Shift+P）を開き、"Open Settings JSON" を検索してください。

{
  "cursor.aiModels": {
    "custom": [
      {
        "name": "gemini-2.5-pro",
        "baseUrl": "https://generativelanguage.googleapis.com/v1beta/openai",
        "apiKey": "YOUR_GOOGLE_AI_STUDIO_KEY",
        "model": "gemini-2.5-pro",
        "contextLength": 1000000
      }
    ]
  }
}

ステップ 3：接続を確認する

設定後、Gemini 2.5 Proが動作するかテストします。

1. 新しいCursorチャットパネルを開きます（Cmd+L / Ctrl+L）。
2. 上部のモデルプルダウンから gemini-2.5-pro を選択します。
3. テストプロンプトを入力します：「フィボナッチ数を計算するPython関数を書いてください」
4. 回答が返ってくることを確認します。

エラーが表示される場合は、以下を再確認してください：

• APIキーが正しく、有効であること。
• Base URLが /openai で終わっていること（/v1beta だけで終わっていないか）。
• 無料のレート制限を超えていないこと。

ステップ 4：Cursorの各モードでGemini 2.5 Proを使用する

チャットモード

Gemini 2.5 ProはCursorのチャットパネルでシームレスに動作します。モデルプルダウンから選択し、以下の用途に活用してください。

• コードの解説
• エラーのデバッグ
• ボイラープレートの生成
• アーキテクチャに関する質問

Composer / Agent モード

Agentモードでは、Gemini 2.5 Proを使用して複数ファイルにわたる編集が可能です。100万トークンのコンテキストウィンドウは、コードベース全体をコンテキストに含めることができるため、このモードで特に威力を発揮します。

@codebase 認証モジュールをリファクタリングして、
セッションベースの認証の代わりにJWTトークンを使用するようにしてください。
関連するすべてのファイルを更新してください。

100万トークンのコンテキストにより、Gemini 2.5 Proは一回のターンでClaudeやGPT-4oよりもはるかに多くのコードを推論に含めることができます。

インライン編集

インライン編集（Cmd+K / Ctrl+K）において、Gemini 2.5 Proは既存モデルの代替としてそのまま機能します。コードをハイライトし、ショートカットを押して編集指示を入力してください。モデルがインラインで変更を提案します。

ステップ 5：ワークフローを最適化する

大規模コンテキストはGemini、精度はClaudeを使い分ける

実用的な戦略として、両方のモデルを使い分けるのが得策です。

タスク	最適なモデル	理由
複数ファイルのリファクタリング	Gemini 2.5 Pro	100万のコンテキストでリポジトリ全体を把握可能
複雑なデバッグ	Claude Sonnet	推論能力が非常に高い
ボイラープレート生成	Gemini 2.5 Pro	無料で高速
アーキテクチャの決定	どちらでも	両者とも強力
短い1行のコード	Gemini 2.5 Flash	最速、かつ無料

Cursorのチャットパネルにあるプルダウンでモデルを切り替えましょう。日常的なタスクにGeminiを使用することで、ClaudeやGPTが特別に必要な時のためにCursorのプレミアムリクエストを温存できます。

Gemini 2.5 Flashも追加する

カスタムモデルを追加する際に、軽量で高速なタスク用にGemini 2.5 Flashも追加することをお勧めします。

{
  "name": "gemini-2.5-flash",
  "baseUrl": "https://generativelanguage.googleapis.com/v1beta/openai",
  "apiKey": "YOUR_GOOGLE_AI_STUDIO_KEY",
  "model": "gemini-2.5-flash",
  "contextLength": 1000000
}

Gemini 2.5 Flashは、より寛容な無料枠（15 RPM、1日500リクエスト）を持ち、レスポンスも高速です。オートコンプリートのようなタスクにはFlashを使い、複雑な推論にはProを使用しましょう。

システムプロンプト

Cursorでは、.cursorrules や設定からモデルごとにカスタムシステムプロンプトを設定できます。コーディングにおけるGemini 2.5 Pro向けの優れたシステムプロンプトの例を紹介します。

あなたはシニアソフトウェアエンジニアです。クリーンでプロダクションレディなコードを書いてください。
プロジェクト内の既存のコード規約に従ってください。シンプルな解決策を優先してください。
コードを書く前に、必ずその推論を簡潔に説明してください。
リクエストが曖昧な場合は、推測せずに説明を求めてください。

よくある問題のトラブルシューティング

"Model not found" エラー モデル名が正確に gemini-2.5-pro であることを確認してください（gemini-2.5-pro-latest や他のバリアントではないこと）。最新のモデルIDについては Google AI Studio docs を確認してください。

レスポンスが遅い 無料ティアには 5 RPM の制限があります。制限に達した場合は、リクエストの間隔を空けるか、より高速なレスポンスが必要な場合はGemini 2.5 Flashに切り替えてください。

回答が途中で途切れる Cursorのモデル設定で max output tokens を増やしてください。Gemini 2.5 Proは最大 65,536 出力トークンをサポートしています。

APIキーが機能しない Google Cloud Consoleではなく、aistudio.google.com/apikey で生成したキーであることを確認してください。AI Studioのキーは直接機能しますが、Cloud Consoleのキーは追加のOAuth設定が必要になる場合があります。

Cursorのプルダウンにモデルが表示されない カスタムモデルを追加した後は、Cursorを再起動してください。それでも表示されない場合は、設定JSONが有効であるか（末尾のカンマの有無や構造が正しいか）を確認してください。

よくある質問 (FAQ)

独自のAPIキーを使用することはCursorの利用規約に違反しますか？ いいえ。Cursorは公式にカスタムAPIキーとカスタムモデルエンドポイントをサポートしています。これは公式にサポートされている機能です。

Google AI StudioのAPIキーは本当にずっと無料ですか？ Googleはレート制限付きの無料ティアを提供しており、Geminiのリリース以来これを維持しています。試用期間やクレジットカードの登録は不要です。Googleが今後制限を調整する可能性はありますが、これまで一貫して無料アクセスが提供されています。

Cursorの無料（Hobby）プランでも使用できますか？ はい。このセットアップは無料プランを含むすべてのCursorプランで機能します。Geminiのリクエストは、Cursorのサブスクリプション枠とは完全に独立しています。

遅延（レイテンシ）はCursor内蔵モデルと比較してどうですか？ Gemini 2.5 Proのレスポンスは、中程度の長さの出力で通常2〜5秒です。これはCursorのサーバー経由のClaude Sonnetと同等です。Gemini 2.5 Flashは1〜2秒と顕著に高速です。

まとめ

Gemini 2.5 ProをCursorに追加することで、現在利用可能な最大のコンテキストウィンドウを持つ高品質なコーディングモデルを無料で手に入れることができます。セットアップは5分もかからず、すぐに無料レート制限の範囲内で無制限のアクセスが可能になります。Cursorのサブスクリプション枠には一切影響しません。

AI生成メディアを活用したアプリケーションを構築している開発者の方は、Hypereal AI もぜひチェックしてください。画像生成、動画生成、トーキングアバターのための統合APIを提供しています。クレジットカード不要で無料でサインアップして始められます。