Codex

Codex 入門

Codex を使用するには、サポートされている認証方法のいずれかを使用してインストールおよびアクティベートする必要があります。 手順については、以下を参照してください。

• JetBrains AI サブスクリプション

• API キー

• ChatGPT アカウント

設定後、 AI チャット で Codex を選択して使用を開始してください。

IDE コンテキストを収集

Codex は現在の編集セッションに関するコンテキストを自動的に受け取ることができるため、毎回プロンプトに手動で添付する必要はありません。 自動コンテキストが有効な場合、送信する各リクエストには以下が含まれます：

• エディターで現在開いているファイル。

• そのファイルで選択しているテキスト（ある場合）。

チャット入力フィールドのインジケーターは、自動コンテキストの現在の状態を示します。 クリックすると、ふたつの状態を切り替えられます：

• IDE コンテキストは有効です – アクティブなファイル名および選択テキストが各プロンプトに添付されます。

• IDE コンテキストは無効です – エディターコンテキストは自動的には添付されません。

コンテキスト使用状況をモニター

各言語モデルにはコンテキストウィンドウがあり、一度に処理できる情報量の上限が決まっています。 Codex とメッセージをやり取りするにつれて、プロンプト、添付されたコンテキスト、エージェントの応答がこのウィンドウを埋めていきます。 ウィンドウがいっぱいになると、エージェントはセッションの前半部分を把握できなくなる場合があります。

コンテキスト使用状況をモニターするため、AI アシスタント はどれだけコンテキストウィンドウが使われているかを示すインジケーターを表示します。

インジケーターには、現在のセッションで使用されているコンテキストウィンドウの割合と対応するトークン数が表示されます。 これは最初の応答後に表示され、セッションが進行するごとに更新され、セッションを再度開いたときに最後の値を保持します。

動作モードを選択

Codex にはいくつかの動作モードがあります：

• 読み取り専用 - Codex がファイルを編集してインターネットにアクセスするには承認が必要です。

• ワークスペースアクセス - Codex はプロジェクトワークスペース内のファイルを変更できますが、プロジェクト外で変更を加えたりネットワークにアクセスしたりする前に確認を求めます。

• 自動レビュー - Codex は潜在的に安全でないアクションについてのみ承認を求めます。

• フルアクセス - Codex はマシン上の任意の場所にあるファイルを変更でき、インターネットに制限なくアクセスできます。

動作モードを選択するには、 をクリックし、リストからモードを選択してください。

コラボレーションモードを選択

コラボレーションモード セレクターは、Codex がタスクに取り組む方法を制御します:

• デフォルト設定 - Codex は選択した 操作モード に従ってタスクに取り組みます。

• プラン - Codex はタスクを分析し、変更を加えずに実装プランを提案するため、Codex が進める前にレビューできます。

コラボレーションモードを選択するには、操作モードの横にある をクリックし、リストからモードを選択してください。

モデルと推論レベルを選択してください

Codex がリクエストを処理するモデルを選択するには、 をクリックし、リストからモデルを選択します。

モデルの 推論 レベルも選択できます。 モデルの推論とは、複数ステップの分析や複雑なタスクの解決力を指します。 より高いレベルでは、モデルが応答する前に多くの推論を行うため、複雑または重要なタスクでより高品質な結果が得られる可能性がありますが、時間がかかる場合があります。

応答を高速化する

対話作業中に素早い応答が必要な場合は、 高速モード を有効化してください。 より小型で限定されたモデルに切り替えることなく、モデルの出力生成を高速化します。

高速モードをオンまたはオフにするには、操作モードセレクターの横にある 高速モード トグルを使用してください。

操作を承認

読み取り専用 モードでは、Codex は提案された bash コマンドの実行、変更の導入、ファイル操作、または 外部ツール の使用について許可を求めます。 この場合、操作を承認または拒否できます。

• 一度だけ許可－ Codex が今回のみコマンドを実行することを許可します。 後で同じコマンドが要求された場合、再度確認されます。

• セッション中は許可－ このセッション内では再確認なしでこのコマンドの実行を許可します。

• 次で始まるコマンドを許可 – 指定したプレフィックスで始まるコマンドを、再度確認せずに Codex が実行できるようにします。 これにより、同じ先頭テキストを持つ関連するコマンドのグループが承認され、毎回個別に確認する必要がなくなります。

• 拒否－ このコマンドの実行を Codex に許可しません。

エージェントが実行したアクションの詳細を確認するには:

• 提案されたファイル変更については、変更されたファイルをクリックして、エージェントが加えた変更を確認します。

  

• 提案されたコマンドについては、ウィジェットの右上隅にある エディターで開く をクリックして、エージェントが実行した完全なコマンドを確認します。

  

ロールバック操作

Codex によって行われた変更が合わない場合は、元に戻すことができます。 そのためには以下の手順に従います。

/commands を使用する

Codex は、セッションステータスの確認、現在のセッションの管理、エージェント構成の表示などのアクションを実行するために、チャットで直接入力できる /commands のサブセットに対応しています。

現在のセッションで利用可能なコマンドを確認するには、チャット入力欄に / を入力し、リストからコマンドを選択します。

特定のコマンドの詳細については、 Codex の公式ドキュメントを参照してください。

Codex スキルを使用する

スキルは Codex に特定タスクや構造化ワークフロー処理のための追加機能を与えます。 各スキルは、手順、サポートリソース、エージェント実行方式を定義するスクリプトで構成されています。

スキルは次の方法で追加できます：

• キュレート済みスキルをインストール‐ openai/skills などの公開リポジトリからインストールします。 $skill-installer スキルを呼び出して Codex 環境に追加することで、インストールできます。

• カスタムスキルを作成するには、 $skill-creator スキルを使用し、必要な機能を記述してください。

インストールまたは作成後、スキルは呼び出せます：

• スキルが説明したタスクに関連している場合は自動的に呼び出されます。

• プロンプトで $ プレフィックス付きで特定スキルを参照することで明示的に呼び出せます。

現在 Codex で利用可能なスキルを表示するには、 /skills コマンドを使用します。

外部ツールの使用を有効化

Codex が設定済みの Model Context Protocol（MCP）サーバーが提供するツールを使用できるようにすることで、より幅広いタスクを実行できる機能を拡張できます。 利用可能なツールは、エージェントが必要と判断した場合、自動的に呼び出されることも、リクエストを作成する際に手動で呼び出すこともできます。

Codex がツールを使用できるようにするには：

Codex でデータベース固有のツールを使用する

利用可能： DataGrip および データベースツールおよび SQL プラグイン搭載 IDE

現在、Codex が データベース専用ツールと連携するには、以下の構成が必要です：

指示を追加

指示によって、エージェントに永続的で再利用可能なコンテキストを提供できます。 Codex は作業するすべてのタスクにこのコンテキストを追加するため、各プロンプトでプロジェクト固有の指示を繰り返す必要はありません。

Codex はプロジェクトのルートディレクトリにある AGENTS.md ファイルから指示を読み取るため、バージョン管理の下で管理し、プロジェクト全体で再利用できます。

指示ファイルおよびそのフォーマットに関する詳細は、 エージェントへの指示 を参照してください。