OpenAI Codex やコーディングエージェントに初めて触れる方へ、このガイドはより早く良い結果を得るのに役立ちます。CLI、IDE 拡張機能、Codex アプリにおいて、プロンプティングや計画から検証、MCP、スキル、自動化に至るまで、Codex をより効果的にするための核となる習慣を網羅しています。
Codex は、一度きりのアシスタントとして扱うよりも、設定を重ねて改善していくチームメイトのように扱うと、最も効果的に機能します。
有用な考え方としては、適切なタスクコンテキストから始め、AGENTS.md で持続可能なガイダンスを提供し、作業フローに合わせて Codex を設定し、MCP で外部システムと接続し、繰り返し作業をスキルに変え、安定したワークフローを自動化することです。
1. 明確なコンテキストとプロンプティングで Codex を最初から強力にセットアップする
Codex は、プロンプトが完璧でなくても十分に強力で役立ちます。難しい問題を最小限の設定で渡しても、強い結果が得られることがよくあります。明確なプロンプティングは必須ではありませんが、特に大規模なコードベースや重要度の高いタスクでは、結果の信頼性が高まります。
大規模または複雑なリポジトリで作業する場合、最大の成果は通常、Codex に適切なタスクコンテキストと、実行してほしいことの明確な構造を与えることです。
良いデフォルトとして、プロンプトに次の 4 つを含めます。
- 目標: 何を変更または構築しようとしていますか？
- コンテキスト: このタスクに関連するファイル、フォルダ、ドキュメント、例、エラーはどれですか？特定のファイルを @ メンションでコンテキストとして指定できます。
- 制約: Codex が従うべき標準、アーキテクチャ、安全性要件、慣習は何ですか？
- 完了条件: タスクが完了したときに満たされるべき条件（テスト合格、動作変更、バグ修正など）は何ですか？
これにより、Codex の範囲が限定され、仮定が減り、レビューや検証が容易な成果物が得られます。
タスクの難易度に基づいて推論レベルを選択し、ワークフローに最適なものをテストしてください。ユーザーやタスクによって、異なる設定が効果的です。
- 低: 高速で範囲が明確なタスク向け
- 中または高: より複雑な変更やデバッグ向け
- 超高: 長時間の自律的で推論を多用するタスク向け
新規ユーザー向けのヒント
: ほとんどの人は、Codex にコードベースについて質問するなど、小さな成功体験から始めると、最も早く習熟できます。Codex アプリで音声入力を使うと、反復作業を高速化できるので強くお勧めします。
Codex の推論努力
2. 難しいタスクでは Codex にまず計画を立てさせることでミスを減らす
タスクが複雑、曖昧、または明確に説明するのが難しい場合は、コードを書き始める前に Codex に計画を立てさせてください。
これにはいくつかの良い方法があります。
計画モードを使用する: ほとんどのユーザーにとって、これが最も簡単で効果的なオプションです。計画モードでは、Codex がコンテキストを収集し、質問を明確にし、実装前に強力な計画を立てることができます。/plan または Shift+Tab で切り替えます。
Codex にインタビューを依頼する: やりたいことの大まかなアイデアはあるが、うまく説明する方法がわからない場合は、Codex にまず質問させるように依頼してください。自分の前提に挑戦し、曖昧なアイデアをコードを書く前に具体的なものに変換するように指示します。
PLANS.md テンプレートを使用する: より高度なワークフローの場合、長時間実行または複数ステップの作業に対して、Codex が PLANS.md または実行計画テンプレートに従うように設定できます。詳細については、実行計画ガイド をご覧ください。
計画モード
3. 成功したガイダンスを AGENTS.md で再利用可能にする
プロンプティングのパターンが確立されたら、次のステップはそれを手動で繰り返すのをやめることです。そこで登場するのが AGENTS.md です。
AGENTS.md は、エージェント向けの README と考えてください。これはシンプルでオープンな形式で、コンテキストに自動的に読み込まれ、リポジトリ内でどのように Codex を動作させたいか、あなたとあなたのチームの意図をコード化するのに最適な場所です。
優れた AGENTS.md は通常、以下をカバーします。
- リポジトリのレイアウトと重要なディレクトリ
- プロジェクトの実行方法
- ビルド、テスト、リンタのコマンド
- エンジニアリングの慣習と PR の期待事項
- 制約と禁止事項
- 「完了」の定義と作業の検証方法
CLI の /init スラッシュコマンドは、カレントディレクトリにスターター AGENTS.md を生成するクイックスタートコマンドです。素晴らしい出発点ですが、結果はチームが実際にコードをビルド、テスト、レビュー、出荷する方法に合わせて編集する必要があります。
AGENTS.md ファイルは複数のレベルで作成できます。~/.codex に置く個人のデフォルト用のグローバル AGENTS.md、共有標準用のリポジトリレベルのファイル、そしてローカルルール用のサブディレクトリ内のより具体的なファイルです。カレントディレクトリに近い、より具体的なファイルがある場合、そのガイダンスが優先されます。
実用的に保ちましょう。短く正確な AGENTS.md は、曖昧なルールばかりの長いファイルよりも有用です。基本から始め、繰り返しミスに気づいたときにのみ新しいルールを追加してください。
AGENTS.md が大きくなりすぎたら、メインファイルは簡潔に保ち、計画、コードレビュー、アーキテクチャなどについては、タスク固有のマークダウンファイルを参照するようにしてください。
ヒント
: Codex が同じミスを 2 回繰り返したら、レトロスペクティブを依頼し、AGENTS.md を更新しましょう。ガイダンスが実用的で、実際の摩擦に基づいたものになります。
AGENTS.md ウェブサイト
4. ワークフローに合わせて Codex を設定することで、より一貫した動作を得る
設定は、セッションやサーフェスをまたいで Codex の動作をより一貫させるための主要な方法の 1 つです。例えば、モデルの選択、推論の努力度、サンドボックスモード、承認ポリシー、プロファイル、MCP セットアップのデフォルトを設定できます。
良い開始パターンは次のとおりです。
- 個人のデフォルトは
~/.codex/config.tomlに保持する（Codex アプリの設定 → 設定 → config.toml を開く） - リポジトリ固有の動作は
.codex/config.tomlに保持する - コマンドラインのオーバーライドは、単発の状況（CLI を使用する場合）にのみ使用する
Config.toml では、MCP サーバー、プロファイル、マルチエージェントセットアップ、実験的機能などの永続的な設定を定義します。直接編集するか、Codex に更新を依頼できます。
Codex にはオペレーティングレベルのサンドボックス機能が組み込まれており、制御可能な 2 つの主要なつまみがあります。承認モードは、Codex がコマンドを実行する許可をいつ求めるかを決定し、サンドボックスモードは、Codex がディレクトリ内で読み取りまたは書き込みができるかどうか、およびエージェントがアクセスできるファイルを決定します。
コーディングエージェントが初めての場合は、デフォルトの権限で保守的に始めることをお勧めします。承認とサンドボックスはデフォルトで厳しくし、信頼できるリポジトリや特定のワークフローでのみ、必要性が明確になったら権限を緩めてください。
CLI、IDE、Codex アプリはすべて同じ設定レイヤーを共有します。詳細については、サンプル設定 のドキュメントページをご覧ください。
ヒント
: 実際の環境に合わせて Codex を早期に設定しましょう。品質の問題の多くは、実際にはセットアップの問題（誤った作業ディレクトリ、書き込み権限の欠如、誤ったモデルデフォルト、ツールやコネクタの欠如など）です。
5. Codex にテスト、検証、レビューをさせることで信頼性を向上させる
Codex に変更を依頼するだけで終わらせないでください。必要な場合はテストを作成し、関連するチェックを実行し、結果を検証し、作業を受け入れる前にレビューするように依頼してください。
Codex はこのループを自動で行えますが、それは「良い」状態がどのようなものかを知っている場合に限ります。そのガイダンスは、プロンプトまたは AGENTS.md から提供できます。
これには以下が含まれます。
- 変更に対するテストの作成または更新
- 適切なテストスイートの実行
- リンタ、フォーマット、型チェックの実行
- 最終的な動作がリクエストと一致していることを確認
- バグ、リグレッション、リスクのあるパターンについて差分をレビュー
ヒント:
Codex アプリの差分パネルを切り替えて、ローカルで直接
変更をレビュー できます。特定の行をクリックすると、次の Codex ターンのコンテキストとしてフィードバックを提供できます。
ここで便利なのがスラッシュコマンド /review です。これにより、コードをレビューするいくつかの方法が提供されます。
- ベースブランチに対して PR 形式でレビュー
- 未コミットの変更をレビュー
- コミットをレビュー
- カスタムレビュー指示を使用
あなたとあなたのチームが AGENTS.md で参照している code_review.md ファイルを持っている場合、Codex はレビュー時にもそのガイダンスに従うことができます。これは、リポジトリやコントリビューター間でレビュー動作を一貫させたいチームにとって強力なパターンです。
Codex はコードを生成するだけではありません。適切な指示があれば、テスト、検証、レビュー の支援も行えます。
GitHub Cloud を使用している場合、PR のコードレビューを実行する ように Codex を簡単に設定できます。OpenAI では、すべての PR を Codex でレビューしています。自動レビューを有効にするか、@Codex でリアクティブにレビューを依頼するかを選択できます。
Codex CLI の /review
6. MCP で外部ツールとライブコンテキストを Codex に取り込む
Codex が必要とするコンテキストがリポジトリの外部にある場合は、MCP を使用します。MCP を使用すると、Codex が既に使用しているツールやシステムに接続できるため、ライブ情報をプロンプトにコピー＆ペーストし続ける必要がなくなります。
Model Context Protocol（MCP）は、Codex を外部ツールやシステムに接続するためのオープン標準です。
MCP を使用するのは次のような場合です。
- 必要なコンテキストがリポジトリの外部にある
- データが頻繁に変更される
- ペーストされた指示に頼るのではなく、Codex にツールを使用させたい
- ユーザーやプロジェクト間で再現可能な統合が必要
Codex は STDIO と OAuth を使用した Streamable HTTP サーバーの両方をサポートしています。
Codex アプリで、設定 → MCP サーバーに移動して、カスタムサーバーと推奨サーバーを確認します。多くの場合、Codex が必要なサーバーのインストールを支援できます。質問するだけで大丈夫です。また、CLI で codex mcp add コマンドを使用して、名前、URL、追加情報を指定してカスタムサーバーを追加することもできます。
ヒント
: 実際のワークフローをアンロックするツールのみを追加しましょう。最初からすべてのツールを接続しようとしないでください。既に頻繁に行っている手動ループを明確に削減できる 1 つか 2 つのツールから始め、そこから拡張してください。
MCP サーバー管理
7. 繰り返しワークフローを再利用可能なスキルに変える
ワークフローが繰り返し可能になったら、長いプロンプトや繰り返しのやり取りに頼るのをやめましょう。スキル を使用して、SKILL.md ファイル、コンテキスト、Codex が一貫して適用すべきロジックをパッケージ化します。スキルは CLI、IDE 拡張機能、Codex アプリで動作します。
各スキルは 1 つのジョブに厳密にスコープを絞ってください。2 ～ 3 つの具体的なユースケースから始め、明確な入力と出力を定義し、説明はスキルが何をするか、いつ使用するかを明確に述べるように記述します。ユーザーが実際に言いそうなトリガーフレーズの種類を含めてください。
すべてのエッジケースを最初からカバーしようとしないでください。代表的なタスクを 1 つ選び、それをうまく動作させ、そのワークフローをスキルに変え、そこから改善していきます。信頼性を有意義に向上させる場合にのみ、スクリプトや追加のアセットを含めてください。
経験則として、同じプロンプトを再利用したり、同じワークフローを修正し続けている場合は、おそらくスキルにするべきです。
スキルは特に次のような繰り返しジョブに役立ちます。
- ログのトリアージ
- リリースノートの下書き
- チェックリストに基づく PR レビュー
- 移行計画
- テレメトリまたはインシデントのサマリー
- 標準的なデバッグフロー
$skill-creator スキルは、スキルの最初のバージョンをスキャフォールディングするのに最適な出発点であり、$skill-installer スキルを使用してローカルにインストールします。スキルの最も重要な部分の 1 つは説明です。スキルが何をするか、いつ使用するかを明確に述べる必要があります。
ヒント
: 個人のスキルは
$HOME /.agents/skills に保存され、チームで共有するスキルはリポジトリ内の .agents/skills にチェックインできます。これは特に新しいチームメイトのオンボーディングに役立ちます。
スキルの作成とインストール
Codex アプリのスキル UI
8. 自動化で繰り返し作業の時間を節約する
ワークフローが安定したら、Codex にバックグラウンドで実行するようスケジュールできます。Codex アプリでは、自動化 を使用して、繰り返しタスクのプロジェクト、プロンプト、実行頻度、実行環境を選択できます。
繰り返し作業になったら、Codex アプリの「自動化」タブで簡単に自動化を作成できます。実行するプロジェクト、実行するプロンプト（スキルを呼び出すことも可能）、実行頻度を選択できます。また、自動化を専用の git worktree で実行するか、ローカル環境で実行するかを選択できます。詳細については、git worktrees をご覧ください。
良い候補としては以下があります。
- 最近のコミットの要約
- バグの可能性のスキャン
- リリースノートの下書き
- CI 障害の確認
- スタンドアップサマリーの作成
- スケジュールに基づく繰り返し分析ワークフローの実行
有用なルールとして、スキルが方法を定義し、自動化がスケジュールを定義します。ワークフローにまだ多くの指示が必要な場合は、まずスキルに変換します。予測可能になったら、自動化が力の増幅器になります。
ヒント
: 自動化は実行だけでなく、振り返りとメンテナンスにも使用しましょう。最近のセッションをレビューし、繰り返し発生する摩擦を要約し、プロンプト、指示、ワークフロー設定を時間をかけて改善してください。
Codex アプリの自動化作成
9. セッションコントロールで長時間の作業を整理する
Codex のセッションは単なるチャット履歴ではありません。時間の経過とともにコンテキスト、決定、アクションを蓄積する作業スレッドです。そのため、適切に管理することが品質に大きな影響を与えます。
複数のスレッドを管理する最も簡単な方法は、Codex アプリ UI でスレッドをピン留めし、worktree を作成することです。CLI を使用している場合は、これらのスラッシュコマンド が特に便利です。
- /experimental 実験的機能を切り替え、config.toml に追加する
- /resume 保存された会話を再開する
- /fork 元のトランスクリプトを保持しながら新しいスレッドを作成する
- /compact スレッドが長くなってきたときに、以前のコンテキストの要約版を取得する。Codex は自動的に会話を圧縮することに注意してください。
- /agent 複数のエージェントを実行しているときに、アクティブなエージェントスレッドを切り替える
- /theme シンタックスハイライトテーマを選択する
- /apps Codex 内で ChatGPT アプリを直接使用する
- /status 現在のセッション状態を確認する
1 つの作業単位につき 1 つのスレッドを維持してください。まだ同じ問題の一部である場合は、同じスレッドに留まる方が推論のトレイルが保持されるため、多くの場合良い選択です。作業が真に分岐する場合にのみフォークしてください。
ヒント
:
Codex の
マルチエージェント ワークフローを使用して、メインスレッドから範囲の限定された作業をオフロードしましょう。メインエージェントはコアの問題に集中させ、サブエージェントは探索、テスト、トリアージなどのタスクに使用します。
10. 避けるべきよくある間違い
Codex を初めて使用する際に避けるべきよくある間違いをいくつか紹介します。
- 永続的なルールを AGENTS.md やスキルに移行せずにプロンプトに詰め込みすぎる
- ビルドやテストコマンドの最適な実行方法に関する詳細を提供せず、エージェントに自分の作業を見せない
- マルチステップや複雑なタスクで計画をスキップする
- ワークフローが理解される前に、Codex にコンピュータへの完全な権限を与える
- git worktree を使用せずに、同じファイルに対して複数のライブスレッドを実行する
- 手動で信頼性が確認される前に、繰り返しタスクを自動化に変換する
- Codex をステップバイステップで監視する必要があるものとして扱う代わりに、自分の作業と並行して使用する
開始のためのチェックリスト
- Codex に適切な目標、コンテキスト、制約、完了条件を与える
- 難しいタスクでは、まず Codex に計画を依頼する
- スターター AGENTS.md を作成する
- Codex にビルド、テスト、検証、レビューの方法を指示する
- ワークフローに一致する設定デフォルトを設定する
- 価値の高い外部ツールに MCP を追加する
- 繰り返しワークフローをスキルに変換する
- ワークフローが安定したら自動化を使用する
ワークフロー、標準、コンテキストを Codex が使用できるものに変換すればするほど、エージェントの真の力を実感できるでしょう。今すぐ始めましょう！
