RubyMineでCodexを使う方法・料金・制限を初心者向けに整理

RubyMineでCodexを使える理由

RubyMineでCodexを使う場合、OpenAIがVS CodeやCursor向けに配布しているIDE拡張をRubyMineへ無理に入れるわけではありません。JetBrains AI AssistantをRubyMineに追加し、そのAI ChatでCodexを選ぶ構成です。JetBrainsの公式説明では、Codexは機能の設計と実装、不具合の修正、コードについての質問、レビューなどを支援するコーディングエージェントとされています。RubyMineのエディタ、プロジェクト、選択範囲を起点に、RubyやRailsのコードを調査してから変更案を出せる点が、単純な入力補完との違いです（出典: https://www.jetbrains.com/help/ai-assistant/codex-agent.html）。

この構成なら、RubyMineのコード解析やテスト実行の環境を保ったまま、Codexに調査や修正を相談できます。ただし、RubyMineを購入しただけでOpenAIの利用枠まで付くとは限りません。AI Assistantをどの方法で有効にしたかによって、利用できる機能、請求先、残りの利用枠の表示場所が変わります。まず「どの画面からCodexを選ぶか」と「どのアカウントで利用するか」を別の問題として切り分けると、設定をやり直すときも迷いません。

VS Code向け拡張との違い

OpenAIの公式記事では、CodexのIDE拡張はVS Code、Cursor、その他のVS Code互換エディタに対応し、開いているファイルや選択中のコードを文脈として利用できると説明されています。一方、RubyMineはJetBrainsのプラットフォーム上で動くため、AI AssistantがCodexとの接点になります。つまり、RubyMineで「Codexの拡張が見つからない」ときは、配布先を探し続けるより、JetBrains MarketplaceのAI Assistantを確認する方が正しい順序です（出典: https://openai.com/index/introducing-upgrades-to-codex/）。

2026年8月に確認する理由

この検索語が今も確認対象になるのは、JetBrainsのAI Assistant 2026.2の案内でCodexが統合エージェントとして整理され、RubyMineを含む複数のJetBrains IDEでAI Chatを使える状態が明記されたためです。以前の解説にある「VS Code系の拡張を入れる」という説明だけでは、RubyMine利用者の入口を誤りやすくなります。公式ページの更新日や対応IDEを確認してから導入するのが、現在の環境に合った判断です（出典: https://www.jetbrains.com/help/ai-assistant/feature-set.html）。

導入前に確認すること

導入前に確認したいのは、RubyMineの版、AI Assistantの有無、プロジェクトの場所、そして利用するアカウントです。JetBrainsのインストール案内では、AI AssistantはJetBrains IDEに標準で組み込まれている機能ではなく、必要に応じてプラグインを追加するとされています。対応IDEの条件もあるため、古いRubyMineを使っている場合は、先にIDEとプラグインの組み合わせを確認してください。RubyMineの作業を止めたくない場合は、更新前にプロジェクトの状態を保存しておくと安心です。

また、RubyMineのプロジェクトが正しく開かれていることも重要です。単一ファイルだけを開いた状態では、Gemfile、ルーティング、テスト、設定ファイルの関係を十分に説明できないことがあります。反対に、関係のないフォルダーまで同じプロジェクトに入れると、Codexが読む範囲が広がり、回答の焦点がぼやけます。最初は対象のRuby/Railsプロジェクトを一つ開き、依頼の中で調査してほしいディレクトリやファイルを指定すると、結果を確認しやすくなります。

RubyMineとAI Assistantの対応

JetBrainsの公式インストール案内では、AI Assistantの導入経路としてAI Chatのインストールボタン、JetBrains AIウィジェット、SettingsのPlugins画面が案内されています。Marketplaceで「AI Assistant」を検索してInstallを選ぶ方法が最も分かりやすいでしょう。プラグインが見えない場合は、RubyMineの版が古い、組織の設定でAI機能が無効、またはIDEを再起動していない可能性があります（出典: https://www.jetbrains.com/help/ai-assistant/installation-guide-ai-assistant.html）。

利用元と請求先を切り分ける

Codexの初回起動時には、JetBrains AIの契約を使うか、OpenAIのAPIキーを使うか、ChatGPTアカウントを使うかを選びます。ここで大切なのは、利用方法を混ぜて考えないことです。JetBrains AIを選んだならJetBrainsの契約画面と利用枠を確認し、ChatGPTアカウントを選んだならOpenAIのCodex利用画面を確認します。APIキーを選ぶ場合は、OpenAIが直接発行したキーが必要だとJetBrains公式に記載されています。第三者が提供する互換サービスのキーを入力しても、同じ連携として扱われるとは限りません（出典: https://www.jetbrains.com/help/ai-assistant/activate-agents.html）。

RubyMineでCodexを導入する手順

1. RubyMineの版を確認し、対象のRuby/Railsプロジェクトを開きます。更新が必要な場合は、プロジェクトの保存状態と使用中のRuby SDKを確認してからIDEを更新します。
2. AI Assistantをまだ入れていなければ、SettingsのPluginsからMarketplaceを開き、「AI Assistant」を検索してInstallを選びます。導入後にRubyMineを再起動するよう求められた場合は、指示に従います。
3. AI Chatを開き、エージェントの選択欄からCodexを選びます。最初のメッセージを送ると、Install and Continueの確認が表示されるため、内容を読んで進めます。
4. JetBrains AI、APIキー、ChatGPTアカウントのいずれかを選びます。普段のCodex利用元とそろえたい場合は、選択したアカウントと利用枠の表示場所をその場で確認します。
5. 最初のセッションでは読み取り専用モードを選び、「このプロジェクトの構成、起動方法、テストの場所、変更時に注意すべきファイルを説明してください」と依頼します。
6. 説明が正しいことを確認したら、対象を一つに絞った小さな修正を依頼します。Codexが提示した変更をRubyMineの差分表示で読み、テストを実行して結果を確認します。

この順番なら、プラグインの導入、Codexの有効化、利用元の選択、プロジェクトの理解を一つずつ確認できます。最初からAgent（full access）を選んで権限の問題を切り分けようとすると、どの設定が影響したのか分かりにくくなります。読み取り専用でプロジェクトの見え方を確かめ、必要な作業だけ段階的に許可する方が、RubyMineの既存環境を守りやすい方法です。

導入が終わったら、AI Chatに表示されたモデル名、推論レベル、現在の操作モードも確認してください。選べるモデルや項目は、接続方法、プラン、AI Assistantの版、Codex側の更新によって変わる場合があります。公式の案内と手元の画面が一致しないときは、表示されない項目を無理に再現しようとせず、まずプラグインとRubyMineを更新し、現在の画面を基準に設定を記録します。

RubyMineで使うCodexの料金と利用上限

料金を調べるときに注意したいのは、「RubyMineの料金」「JetBrains AIの料金」「Codexの料金」が別のものだという点です。RubyMineのライセンスを持っていても、AI Assistantの契約やCodexの利用枠が自動的に同じになるとは限りません。JetBrains AIの契約でCodexを使う場合はJetBrains側のプランとクレジットを確認し、ChatGPTアカウントで使う場合はOpenAI側のプランとCodex利用枠を確認します。APIキーを使う場合は、OpenAI APIの利用として請求を考えます。

OpenAIのCodex rate cardは、2026年4月2日以降、従来のメッセージ単位の目安から、入力、キャッシュされた入力、出力のトークン数を基準にした料金へ整理されています。2026年8月17日時点の公式表では、たとえば次のような単位で示されています。これはOpenAI側のプランやクレジットでCodexを使う場合の確認材料であり、JetBrains AIの契約料金表をそのまま置き換えるものではありません（出典: https://help.openai.com/en/articles/20001106-codex-rate-card）。

RubyMineからの一回の依頼がどの程度になるかは、モデル名だけでは決まりません。開いているファイルの量、プロジェクト全体を調査するか、返答や変更案がどれだけ長いか、推論レベルをどこに置くかで消費量は変わります。大きなRailsプロジェクトで最初から全体調査を頼むより、対象の機能、関連するテスト、期待する完了条件を限定した方が、料金と結果の両方を把握しやすくなります。

ChatGPTアカウントで使う場合

OpenAIのヘルプでは、CodexはChatGPT Plus、Pro、Business、Enterprise/Eduのプランに含まれ、期間限定でFreeとGoにも含まれると説明されています。プランによって利用上限は異なり、短い修正と大きなコードベースの調査では一回の依頼の消費量も異なります。RubyMineでChatGPTアカウントを選ぶ場合は、契約名だけで判断せず、CodexのUsage画面や上限表示を確認してください（出典: https://help.openai.com/en/articles/11369540/）。

特に、RubyMineのAI Chatを開いているからといって、JetBrains AIの枠を使っているとは限りません。Codexの設定画面に表示されるアカウントと、ChatGPTのプラン画面に表示される利用状況を突き合わせると、想定外の消費を見つけやすくなります。組織で使う場合は、個人の設定だけでなく、管理者が決めた利用枠や追加クレジットの扱いも確認しましょう。

APIキーで使う場合

APIキーを選ぶと、使ったモデルとトークン量に応じてOpenAI API側の請求を考える必要があります。JetBrains公式はCodex連携のBYOKでOpenAIが直接発行したAPIキーを要求し、第三者のキーには対応していないと案内しています。キーの文字列をAI Chatの入力欄や依頼文へ貼り付けることはせず、RubyMineの設定画面にある所定の入力欄だけを使ってください。

料金を抑えたいときは、単純な説明や小さな修正に軽いモデルを使い、設計変更や複数ファイルの調査だけ推論レベルを上げます。毎回同じ大きなフォルダーを添付するのではなく、まず関連ファイルを特定してから依頼するだけでも入力量を減らせます。安さだけを優先して確認を省くと、後で修正に時間がかかるため、消費量と差分の読みやすさを同時に見てください。

RubyMineの操作モードを選ぶ

JetBrainsのCodex案内には、Read-only、Agent、Agent（full access）の三つの操作モードが示されています。モードはモデルの賢さを変えるためのものではなく、ファイル変更やコマンド実行をどこまで許可するかを決める枠です。RubyMineでは、作業の種類と対象範囲を先に決めてからモードを選ぶと、確認すべき点がはっきりします。

Read-only

Read-onlyは、コードベースを読んで説明を求めたり、原因候補を挙げてもらったりする段階に向きます。ファイルの変更やコマンドの実行を許可する前に、RubyMineのプロジェクトがどのように見えているかを確認できます。初回はこのモードでGemfile、ルーティング、主要なモデル、テストの配置を説明してもらい、実際の構成と一致するかを確認してください。

Agent

Agentは、プロジェクトの範囲でファイルを変更し、必要な操作について確認を求める標準的なモードです。たとえば一つのコントローラーと関連テストを修正する、モデルのバリデーションを追加する、といった作業に使いやすいでしょう。依頼文に「変更するファイル」「変更しない場所」「実行してよい確認」を書いておくと、提示された差分を読みやすくなります。

Agent（full access）

Agent（full access）は、プロジェクトの外側を含む広い範囲への変更や操作を許可するモードです。OS設定や複数の開発環境にまたがる調査など、対象が明確なときだけ検討します。RubyMineで通常のRuby/Rails修正を行うだけなら、最初からこのモードを選ぶ必要はありません。変更前の差分、操作の目的、元に戻せる方法を確認してから、必要なセッションだけで使うのが安全です。

RubyMineで最初に頼む内容

Codexに最初から「この機能を全部作って」と依頼するより、RubyMineのプロジェクトを理解するための短い依頼から始めます。RubyMineはコード補完、テスト、デバッガー、データベース表示などの機能が一つにまとまっているため、Codexには担当させる調査と、RubyMineで人が確認する作業を分けて伝えると効果的です。

1. 「このRuby/Railsプロジェクトの主要なディレクトリ、起動方法、テストの場所、依存関係を読み取り専用で説明してください」と依頼します。
2. 「ユーザー登録の処理がどのモデル、コントローラー、ルーティング、テストに分かれているかを、ファイル名と関係が分かる形で示してください」と範囲を絞ります。
3. 「変更はまだ行わず、入力値の検証に不足している可能性と、確認すべきテストを優先順位付きで示してください」と原因調査を頼みます。
4. 「変更対象はこのファイルと対応するテストだけに限定し、変更前に計画を示してください」と編集範囲を指定します。
5. 変更後は「実行した確認、通過したテスト、残っている不確実な点を分けて説明してください」と結果を整理させます。

このように、理解、調査、計画、変更、確認の順に依頼すると、RubyMineの画面で差分を追いやすくなります。Codexの回答だけを完成の証拠にせず、RubyMineでテスト結果、警告、型や構文の問題、関連画面の動作を確認してください。特にRailsでは、モデルの変更がマイグレーション、ルーティング、ビュー、リクエストテストに広がることがあるため、変更範囲を小さく区切ることが重要です。

Ruby/Railsプロジェクトで失敗を減らすコツ

GemfileとRubyの版を先に伝える

Rubyの版やRailsの版が違うと、同じコードでも使える構文、依存パッケージ、テストの書き方が変わります。Codexに修正を頼む前に、Gemfile、Gemfile.lock、.ruby-version、使用しているRuby SDKを確認し、必要なら依頼文で対象の版を明記します。Codexが古い慣習でコードを書かないように、既存ファイルにある書式や採用済みのライブラリを基準にするよう頼むと、差分が小さくなります。

ルーティングとテストを一緒に見る

Railsの不具合は、コントローラーだけを直して終わるとは限りません。ルーティング、認可、モデルのバリデーション、ビュー、リクエストテストが連動している場合があります。Codexには、変更前に関係するファイルを列挙させ、変更後にどのテストを実行したかを記録させましょう。RubyMineのテストランナーで失敗箇所を再実行し、Codexの説明と実際の結果が一致するかを確認すると、思い込みによる修正を減らせます。

AGENTS.mdを説明書として使う

プロジェクト固有の命名規則、テストの実行方法、変更してはいけない場所は、依頼のたびに長く書くよりAGENTS.mdにまとめると再利用しやすくなります。JetBrainsの公式Codex案内は、CodexがAGENTS.mdをプロジェクトの指示として扱うと説明しています。ただし、指示ファイルだけでレビューを省けるわけではありません。Codexが読んだ前提と実際のプロジェクト構成を照らし、必要な指示が反映されているかを毎回確認してください。

うまくいかないときの確認順

AI ChatにCodexが出ない

まずAI Assistantがインストール済みか、RubyMineを再起動したか、AI Chatのエージェント選択欄を開いているかを確認します。AI Assistantのインストール案内では、SettingsのPluginsから追加する方法が示されています。組織で利用している場合は、JetBrains AIの利用が管理側で許可されているかも確認が必要です。Codexだけの問題と決めつけず、プラグイン、IDE版、組織設定の順に切り分けます。

Codexは出るが作業対象がずれる

現在開いているファイルや選択範囲だけを前提にしている可能性があります。依頼文に対象ファイル、関連テスト、変更してはいけない場所を明記し、必要なファイルをRubyMineから選択して追加します。プロジェクト全体を読んでいると思い込まず、「今回参照したファイルを列挙してください」と確認するのも有効です。JetBrains公式は、Codex連携では.aiignoreの機能が反映されず、そこに書いたファイルが処理される可能性があると注意しています（出典: https://www.jetbrains.com/help/ai-assistant/codex-agent.html）。

変更が許可されない

Read-onlyを選んでいる場合、変更できないのは正常です。変更が必要なら、対象範囲を確認したうえでAgentへ切り替え、表示された確認を一件ずつ読みます。Agentでも対象外の場所を変更しようとする場合は、依頼を止めて範囲を狭めます。モードを強くする前に、依頼文の不足、プロジェクトの開き方、RubyMineの権限を確認する方が原因を見つけやすいでしょう。

利用上限に達した

OpenAIのCodex利用では、契約プラン、モデル、入力と出力の量、作業の長さによって消費が変わります。まずCodexのUsage画面で残りの枠を確認し、RubyMine側で選んでいるアカウントと一致するかを確かめます。大きな依頼を小さく分割し、不要なファイルを参照させず、説明だけの作業に高いモデルを使わないようにすると、原因の切り分けと利用量の管理を同時に進められます。

安全に使うための確認ポイント

RubyMineのAI Chatからコードを扱うときは、便利さより先に、何を読み、何を変更し、どの利用元へ送るかを確認します。APIキー、パスワード、個人情報、顧客データなどを依頼文へ貼り付けないことは基本です。実際の値が必要な処理を調べる場合は、値を伏せたサンプルやテスト用データへ置き換え、Codexが参照したファイルを確認します。

.aiignoreだけを保護手段として扱えない点も重要です。JetBrainsのCodex公式ページが示すとおり、AI Assistantの.aiignore機能はCodex連携には反映されません。機密性の高いファイルをプロジェクトに置いたまま読み取り専用にするだけでは、参照範囲を意図どおりに絞れない可能性があります。不要なファイルを開かない、対象プロジェクトを分ける、テスト用の値を使う、といった運用を組み合わせてください。

変更を許可した後は、RubyMineの差分表示でファイルごとの変更を確認し、テストを実行します。Codexが「問題ありません」と述べても、認証、権限、入力値、エラー処理、ログ出力など、人が判断すべき点は残ります。Agent（full access）を使う場合は、作業前に対象範囲と元に戻す方法を決め、終了後に実行した操作と生成されたファイルを一覧にします。確認できない変更を残さないことが、AIコーディングエージェントを長く使うための最も実用的な基準です。

まとめ

RubyMineでCodexを使うときは、OpenAIのVS Code向け拡張を探すのではなく、JetBrains AI AssistantからCodexを選びます。2026年7月に案内されたAI Assistant 2026.2でRubyMineを含む対応IDEと操作モードが整理され、導入経路を確認しやすくなりました。料金はJetBrains AI、ChatGPTアカウント、APIキーのどれを使うかで確認先が変わり、OpenAI側ではトークン基準の料金表が公開されています。

最初は読み取り専用でRubyMineのプロジェクト構成を説明させ、対象ファイルとテストを絞ってからAgentへ進みます。差分、テスト結果、参照ファイル、利用枠を確認すれば、RubyMineの編集体験を保ちながらCodexの調査力を活かせます。導入前後は公式情報を確認し、JetBrainsのCodex案内（https://www.jetbrains.com/help/ai-assistant/codex-agent.html）とOpenAIの料金表（https://help.openai.com/en/articles/20001106-codex-rate-card）を基準に、手元の画面と契約状態を照合してください。