CursorとGeminiの使い方とAPI設定手順

CursorはGeminiのモデル選択やGoogle APIキー追加、Gemini Code Assistの拡張機能など、使い方がいくつかに分かれます。Gemini 2.5 Flashの無料枠を使いたいのか、Gemini CLIをCursor上で使いたいのかで、見るべき設定も少し変わりますよ。

特に迷いやすいのは、CursorにGemini APIキーを入れる方法、APIエラーが出たときの確認、Claude Codeとの使い分けあたりかなと思います。無料枠やモデル名は変わることがあるので、ここでは始める前に押さえたい流れと注意点を中心に整理します。

CursorとGeminiの基本

CursorとGeminiを組み合わせたいときは、まず「Cursorは開発エディタ」「GeminiはAIモデルや支援機能」と分けて考えると整理しやすいです。Cursor単体でもAI支援は使えますが、Gemini APIキーやGemini Code Assist、Gemini CLIを組み合わせることで、使い方の幅が広がります。

ただし、無料枠、使えるモデル、APIキーの扱いは変わりやすい部分です。最初から細かい設定に入るより、どの機能をどの目的で使うのかを見ておく方が、あとで迷いにくいかなと思います。

Cursorでできること

Cursorは、コードを書く作業にAIを組み込んだエディタです。見た目や操作感はVS Codeに近く、既存の設定や拡張機能を移しやすいのが特徴として紹介されています。エディタ内でコードを書くだけでなく、チャット、コード修正、コードベース参照などをまとめて扱えるのがポイントです。

特に便利なのは、ファイルやコードベースを文脈としてAIに渡せることです。ブラウザのAIチャットへコードを貼り付けて、返ってきた内容をまたエディタに戻す流れより、作業の移動が少なくなります。小さな修正でも、この差はけっこう効きますよ。

Cursorで使える主な機能

Cursor公式でも、エージェント、自動補完、コードベース理解、CLIなどが大きな特徴として出ています。単なるチャットツールではなく、開発作業の中にAIを入れるためのエディタと見ると分かりやすいです。

一方で、すべてをCursorだけで完結させる必要はありません。軽い質問はCursorのチャット、まとまった自動作業はAgent、別のAIモデルを使いたいときはGeminiやClaude系を選ぶ、というように分けて使うのが現実的です。

Geminiを使うメリット

CursorでGeminiを使うメリットは、モデルの選択肢が増えることです。CursorはOpenAI、Anthropic、Geminiなど複数のモデルを選べる方向で展開されており、作業内容に合わせて使い分けやすくなっています。特定のAIだけに寄せない働き方ができるのは、開発者にとって大きいです。

Gemini系は、長い文脈の処理、情報整理、コードの読み取り、マルチモーダル対応などで注目されることが多いです。もちろんモデルごとの差はありますが、既存コードを読ませて「この処理は何をしているのか」を確認したい場面では、選択肢として見ておく価値があります。

Geminiを使うと変わること

私が整理するなら、Geminiは読む・整理する・比較する作業で候補に入れたいAIです。たとえば、知らないライブラリの概要をつかむ、古いコードの意図を読み解く、仕様と実装のズレを探す、といった場面ですね。

ただし、Geminiに限らずAIの回答はそのまま正解扱いにしない方が安全です。コードの実行結果、テスト、公式ドキュメントと照らし合わせる前提で使うと、仕事や副業の開発でもリスクを下げやすくなります。

無料版で使える範囲

CursorとGeminiの組み合わせで気になるのが、無料でどこまで使えるかです。調べた範囲では、Cursor側の無料枠、Gemini API側の無料枠、Gemini Code Assistの利用条件などが別々に存在します。つまり、Cursorが無料だからGeminiも無制限、という意味ではありません。

Cursorの無料版では、AI機能に回数やモデルの制限がある場合があります。GeminiをAPIキーで使う場合も、Google AI Studio側の無料枠やレート制限が関係します。ここは時期によって変わるので、正確な情報は公式サイトをご確認ください。

無料利用で確認したい項目

無料枠を使う場合に特に注意したいのは、仕事のコードや顧客情報をそのまま入れないことです。無料プランでは入力データがサービス改善に使われる可能性が説明されることもあります。個人開発の学習用途なら使いやすいですが、業務利用では社内ルールの確認が先です。

「無料で試す」なら、まずはサンプルコードや個人プロジェクトで動作を確認するのが無難です。APIキーの設定、モデル選択、チャットの挙動、エラー時の表示を見てから、本格利用に進む方が安心ですよ。

Gemini 2.5 Flashの目安

Gemini 2.5 Flashは、Gemini系の中でも軽めの応答や日常的な開発補助に向いたモデルとして紹介されることが多いです。CursorでGeminiを使う場合も、まず候補に入りやすいモデル名です。速度やコストを重視するなら、Flash系から見ると分かりやすいかなと思います。

公開されている解説では、Gemini 2.5 Flashの無料枠について、1分あたりのリクエスト数や1日あたりのリクエスト数に触れているものがあります。ただし、これは時期によって変わりやすい情報です。2026年6月時点で使うなら、Google AI Studioの公式表示で最新条件を確認してください。

Gemini 2.5 Flashを見る目安

たとえば、エラー文の意味を知りたい、関数を短く整理したい、READMEを要約したい、といった作業ならFlash系でも足りる場面があります。一方で、プロジェクト全体の設計変更や、複数ファイルをまたぐ重めの検討では、Pro系や他モデルを比べた方がよい場合もあります。

ここで大事なのは、最初から高性能モデルだけを使うことではありません。軽い作業は軽いモデル、重い判断は上位モデルや人の確認という分け方です。AI利用のコストを抑えたい人ほど、この切り替えを意識すると使いやすくなります。

Claude Codeとの違い

CursorとGeminiを調べていると、Claude CodeやCursorとClaudeの組み合わせも目に入ります。ざっくり言うと、Cursorはエディタ中心、Claude CodeはCLI中心、Geminiはモデルや拡張機能として組み合わせる対象、という違いで見ると整理しやすいです。

Claude Codeは、ターミナルから開発作業を進めるタイプのAIエージェントとして使われることが多いです。一方、Cursorはエディタ上でファイルを開きながらAIに指示できるので、画面を見ながら細かく修正したい人に向いています。どちらが絶対に上というより、作業スタイルの違いですね。

⚖️ Cursor、Gemini、Claude Codeの比較

文章化や抽象的な設計はClaude系が扱いやすいと言われることがあり、既存コードの読み解きや情報整理ではGeminiが候補に入ります。実装速度や編集体験はCursor側の機能にも左右されます。だから、モデル名だけで決めず、どの画面で、どんな作業をしたいかから選ぶ方が実用的です。

あなたが初めて試すなら、まずはCursor上でGeminiを使う流れを作り、その後にClaude CodeやGemini CLIを比べる順番で十分です。いきなり全部を入れると、エラーの原因がCursor側なのかAPIキー側なのか、拡張機能側なのか分かりにくくなります。まずは小さく試す、ここが大事です。

CursorとGeminiの設定手順

CursorとGeminiを使う流れは、大きく分けると「Cursorを入れる」「Gemini APIキーを用意する」「Cursor側で有効化する」「エラー時に原因を切り分ける」の順番です。Gemini Code AssistやGemini CLIを使う場合は、APIキー設定とは別ルートになることもあります。

いきなり全部を入れようとすると、どこで詰まっているのか分かりにくくなります。まずはCursor本体でGeminiモデルを選べる状態にして、必要に応じてAPIキーや拡張機能を追加するのが進めやすいですよ。

Cursorのダウンロード

Cursorは公式サイトからダウンロードして使うAIエディタです。macOSやWindowsなど、使っている環境に合うインストーラーを選ぶ流れになります。検索結果から非公式サイトへ進むと余計なソフトが混ざるリスクもあるので、ダウンロードは必ずCursor公式からが基本です。

インストール後は、Cursorアカウントでのログインが必要になる場合があります。VS Codeを使っていた人は、設定や拡張機能をインポートできることもあります。普段の開発環境を大きく変えずにAI機能を試しやすいのは、Cursorの入りやすいところですね。

Cursor導入時の確認ポイント

インストールできたら、まずは何か小さなフォルダを開いて、チャットやコード補完が動くか確認します。いきなり仕事用の大事なリポジトリで試すより、サンプルプロジェクトで動作確認した方が安心です。

Cursorは更新頻度が高く、画面名やメニューの位置が変わることがあります。設定画面が手元と少し違っても、焦らずに「Settings」「Models」「Account」あたりを探すと近い項目にたどり着きやすいです。

Gemini APIキーの取得

Gemini APIキーは、Google AI Studioから取得する流れが一般的です。Googleアカウントでログインし、APIキー作成画面からキーを発行します。発行したキーはCursor側に登録するために使いますが、パスワードに近いものとして扱った方がよいです。

APIキーは、画面を閉じると再表示できない場合があります。コピーしたら、他人が見られない場所に保管してください。チャット、SNS、公開リポジトリ、スクリーンショットに載せるのは避けたいところです。うっかり公開すると、意図しない利用につながる可能性があります。

APIキー取得前の確認ポイント

無料枠で試す場合も、利用条件や回数制限は確認しておきたいです。無料で使える範囲は時期やモデルによって変わることがあります。費用や契約に関わる部分なので、正確な情報は公式サイトをご確認ください。

仕事用コードや顧客情報を扱う場合は、APIキーの保管場所や入力データの扱いを個人判断だけで決めない方が安全です。会社や案件のルールがあるなら、それに従うのが前提です。判断に迷うときは、最終的な判断は専門家にご相談ください。

CursorへAPIキーを追加

CursorでGemini APIキーを追加する場合は、設定画面からModels系の項目を開き、Google API Keyの入力欄に貼り付けてVerifyする流れがよく紹介されています。認証できると、利用可能なGeminiモデルを選べるようになります。

その後、チャット画面やモデル選択のメニューでGeminiを選びます。Autoが有効になっていると自動選択になる場合があるので、Geminiを明示的に試したいときは、モデルを手動で選ぶと確認しやすいです。ここ、地味に見落としがちです。

Cursor側での設定の流れ

一部の環境では、Cursor内のGeminiモデルがAPIキーなしで使えるように見えるケースも紹介されています。逆に、APIキーを入れたのにエラーになるケースもあります。ここはCursor側の仕様変更やプラン、Google側の条件に左右されるため、手元の画面を基準に確認するのが大事です。

うまくいかない場合は、APIキーを入れ直す前にCursorの再起動、ログイン状態、モデルのチェック、無料枠の残りを見ます。いきなり複数の設定を同時に変えると原因が追いにくくなるので、ひとつずつ確認するのがおすすめです。

APIエラー時の確認

CursorでGemini APIを使おうとしてエラーが出る場合、まずはAPIキーそのものを確認します。コピー時に前後へ空白が入っていたり、古いキーを貼っていたり、Google AI Studio側でキーが無効になっていたりすると、認証に失敗することがあります。

次に見るのは、Cursor側のモデル設定です。Geminiモデルにチェックが入っていない、選択しているモデルが現在使えない、無料枠やレート制限に当たっている、というケースも考えられます。エラー文が出ているなら、全文を見て原因を切り分けた方が早いです。

Gemini APIエラー時の切り分け表

環境変数 GEMINI_API_KEY を設定すると改善するケースも紹介されています。Windowsならユーザー環境変数に GEMINI_API_KEY を追加し、値にAPIキーを入れる流れです。Macの場合は使っているシェルによって設定ファイルが変わるため、.zshrc や .bashrc など、自分の環境に合わせて確認します。

ただし、Cursorの画面設定と環境変数の両方を触ると、どちらが効いているのか分かりにくくなります。まずCursorの設定だけで試し、だめなら環境変数、という順番が無難です。設定を変えた後は、Cursorやターミナルを再起動してから確認してください。

Gemini CLI連携の方法

Gemini CLIをCursorで使いたい場合、方法は大きく2つあります。ひとつはCursorのターミナルからCLIを使う方法、もうひとつはGemini Code Assistのような拡張機能を使って、CursorのサイドバーからGeminiに相談する方法です。

Gemini Code Assistを使う場合は、Cursorの拡張機能検索でインストールし、Googleアカウントでログインして使う流れが紹介されています。サイドバーにGeminiのチャットが表示され、開いているファイルや選択したコードを文脈として扱える場合があります。ターミナル操作が苦手な人には、この方が入りやすいかもです。

Gemini連携方法の違い

Gemini CLIという名前だけを見るとターミナル前提に感じますが、Cursor上でターミナルを開けば、エディタと並べて使えます。さらに拡張機能を使えば、チャット画面に近い形でGeminiを扱える場合もあります。あなたがどちらに慣れているかで選んで大丈夫です。

注意点として、APIキー設定、Googleログイン、拡張機能、CLIはそれぞれ認証経路が違うことがあります。CursorのGeminiモデルが動くからGemini CLIも動く、とは限りません。詰まったら「今どの方法でGeminiを呼んでいるのか」を先に確認しましょう。

CursorとGeminiのまとめ

CursorとGeminiは、コード作業を効率化したい人にとって相性のよい組み合わせです。ただし、設定方法が複数あるため、最初は「Cursor本体」「Gemini APIキー」「Gemini Code Assist」「Gemini CLI」を分けて考えると迷いにくくなります。

CursorとGeminiの要点まとめ

1. CursorはAI支援付きの開発エディタとして使える
2. Geminiはモデル選択やAPI連携でCursorに組み込める
3. Gemini APIキーはGoogle AI Studioで取得する流れが基本
4. APIキーはパスワードに近い情報として安全に保管する
5. CursorではModels設定からGoogle API Keyを追加する
6. Verifyできない場合はキー、モデル、無料枠、再起動を確認する
7. 環境変数 GEMINI_API_KEY で改善するケースもある
8. Gemini Code Assistなら拡張機能として使える場合がある
9. Gemini CLIはターミナル操作に慣れた人向き
10. 無料枠や対応モデルは変わりやすいため公式確認が必要

初めてなら、まずはCursorを入れて、サンプルの小さなプロジェクトでAI Chatやモデル選択を確認するのがよいです。その後、必要に応じてGemini APIキーやGemini Code Assistを追加していくと、設定ミスの原因を追いやすくなります。

無料枠やモデル名、使える機能は今後も変わる可能性があります。作業効率アップを狙うなら、軽い質問はGemini 2.5 Flash系、重い設計や長い文脈は上位モデルや別モデルも比較する、という使い分けが現実的です。正確な情報は公式サイトをご確認ください。

記事作成にあたり参考にさせて頂いたサイト

• biz.moneyforward.comの記事
• Cursorを導入してGeminiを利用するための設定（追記あり）｜penchi
• Cursor の無料版を使い続ける場合の設定 – Qiita
• Gemini 3 Pro × Cursor が最強な理由 – izanami
• 【ターミナル不要】Gemini CLIをCursorで使う方法【簡単】
• Cursor: AI coding agent
• Gemini APIの設定手順（Cursor）
• youtube.comの記事
• Reddit – Please wait for verification
• 開発期間2日（実働10時間）！個人開発でもここまで作れる。Cursor × Gemini Canvas で挑んだ「爆速 PoC」開発ログ – ENGINEERING BLOG ドコモ開発者ブログ

当サイトについて

当サイトでは、インターネット上に散らばるさまざまな情報を収集し、AIを活用しながら要約・編集を行い、独自の切り口で見解を交えながらわかりやすい形でお届けしています。 情報の整理・編集にあたっては、読者やオリジナル記事の筆者へご迷惑をおかけしないよう、細心の注意を払って運営しておりますが、万が一、掲載内容に問題がある場合や修正・削除のご要望がございましたら、どうぞお気軽にお問い合わせください。 迅速に対応をさせていただきます。 その際には、該当記事の URLやタイトルをあわせてお知らせいただけますと、より速やかに対応 することができますのでそちらもご協力いただけますと大変幸いでございます。 今後とも当サイトをよろしくお願いいたします。