Codex アプリの使い方 — タスク依頼から確認・修正まで

Codex アプリの画面構成と基本的な操作の流れ

タスク入力エリアとリポジトリ選択

Codex アプリにアクセスすると、最初に「どのリポジトリに対してタスクを行うか」を選択する画面が表示される。GitHub アカウントと連携したリポジトリ一覧から対象を選び、タスク入力欄に何をやってほしいかをテキストで書くのが最初のステップだ。リポジトリはあらかじめ Codex アプリ側で接続設定しておく必要があるが、一度行えば以後は選ぶだけで済む(出典: https://openai.com/codex )。

入力欄はシンプルなテキストボックスで、日本語でも英語でも入力できる。Codex はリポジトリの内容をサンドボックス環境に取り込んでから作業を始めるため、コードベースが大きいほど初回の読み込みに時間がかかることがある。タスクを投入すると、Codex の作業状況がリアルタイムで画面に表示される。作業中は、編集中のファイル名や実行しているコマンドなどが随時更新されていく。

タスク一覧と状態の確認

左サイドバーには、過去に依頼したタスクの一覧が時系列で表示される。各タスクには「作業中」「レビュー待ち」「完了」などの状態が付いており、複数のタスクを並行させている場合でも、それぞれがどの段階にあるかを把握できる仕組みになっている(出典: https://developers.openai.com/codex )。作業中のタスクを選ぶと、Codex がいまどのファイルを編集しているか、どのコマンドを実行しているかの詳細をリアルタイムで確認できる。タスクが「レビュー待ち」の状態になったら、差分とログを確認して承認するか、追加指示を出すかを判断する。

タスクの依頼方法 — 伝わる指示の書き方

具体的に書く：何を・なぜ・どこまで

Codex へのタスク指示は、具体的なほどよい結果につながりやすい。実用的な目安として、「何を修正・追加したいか」「なぜその変更が必要か」「どこまでの変更を期待するか」の三点を盛り込むと Codex が判断しやすくなる。たとえば、「src/utils/formatter.ts の formatDate 関数がタイムゾーンを無視している。UTC ベースで計算を統一し、呼び出し元のテストも更新してほしい」という形だ(出典: https://developers.openai.com/codex/guides/best-practices )。

曖昧な指示でも Codex はとりあえず動くが、意図とずれた変更をすることがある。修正の往復を少なくするためにも、依頼の段階で背景情報を添えることが効果的だ。特定のファイルやコマンドを明示したり、制約(「既存のインターフェースは変えないこと」や「新しいパッケージは追加しないこと」など)を書いたりすることで、Codex が取るべき方向性を絞りやすくなる。制約を明示しておくことで、意図せずインターフェースが変わったり、依存パッケージが増えたりするケースを防ぎやすくなる。

エラーメッセージをそのまま貼る

デバッグ系のタスクでは、エラーメッセージやスタックトレースをそのまま貼り付けるのが効果的だ。「テストが落ちている」という説明だけより、「以下のエラーが出てテストが落ちている：(エラーメッセージ)」という形のほうが、Codex が原因の絞り込みを正確に行いやすい。コピーして貼るだけで使えるため、手間も少なく、Codex が参照できる情報量を一気に増やせる。

実行環境の情報(Node.js のバージョン、OS の種類など)や、問題が再現する具体的な手順を添えるとさらに有効だ。Codex はサンドボックス内で実際にコードを実行しながら原因を探るため、環境に依存する問題ほど背景情報が役に立つ。ログやエラー出力を余すことなく貼り付ける習慣をつけると、Codex の診断精度が上がる。

大きなタスクは段階に分けて依頼する

一度の依頼で多くのことをやらせようとすると、Codex が見当違いの方向に進むことがある。「認証ミドルウェアを刷新する」のような大きな変更は、まず「現状の認証フローとコード構造をドキュメント化してほしい」と依頼し、内容を確認してから「認証関数のテストカバレッジを上げてほしい」と続けるように、段階的に進めると制御しやすい。それぞれの成果物を確認してから次のタスクを渡す形が、品質を保ちやすい運用になる(出典: https://developers.openai.com/codex/guides/best-practices )。

段階的な依頼は、Codex の作業範囲を自然に絞ることにもなる。一回のタスクで変更するファイルの数が少なければ、差分の確認もしやすく、問題があったときの影響範囲も限定できる。大きな変更を一気にやらせるより、小さな変更を積み重ねる方針のほうが、最終的にスムーズに進みやすい。

Codex の作業結果を確認する

差分(Diff)ビューの見方

タスクが完了すると、Codex は変更した全ファイルの差分をまとめて表示する。差分ビューでは、削除された行が赤、追加された行が緑で示される。変更ファイルが複数ある場合は、ファイルごとに切り替えて全体の変更内容を順に確認する必要がある。変更が依頼の意図と合っているか、想定外のファイルが変更されていないか、必要なテストが追加されているかを確認してから承認するのが基本だ(出典: https://developers.openai.com/codex/guides/how-codex-works )。

差分確認のポイントとして、追加されたテストの内容を丁寧に読むことも大切だ。テストが形式的に書かれているだけで、実際の問題をカバーしていないケースがある。コードの変更内容だけでなく、テストの質も含めて判断することで、マージ後に問題が残るリスクを減らせる。気になる変更箇所があれば、コメントを残してから追加指示を出すとよい。

実行ログの確認

Codex の実行ログには、タスク中に実行したコマンドとその出力が時系列で記録されている。テストの実行結果、インストールしたパッケージ、コンパイルエラーなどが残るため、Codex がどのような手順を踏んだかを後から追える(出典: https://developers.openai.com/codex )。特にテストが失敗している場合は、ログを見ればどの時点でどんなエラーが出たかを把握できる。

ログを確認することで、Codex が意図通りの手順を踏んでいるかも検証できる。「テストを書いてから実装する」という指示を出した場合、ログで実際にその順序で作業したかを確かめることができる。指示通りに動いていない場合は、次の追加指示でその点を明示するとよい。Codex の作業ログはそのまま引用できるため、「このコマンドの出力を見ると○○になっているが、これは意図通りか」という形で具体的なフィードバックを返せる。

修正・追加指示の出し方

「こう直してほしい」を具体的に伝える

タスク結果を確認して、変更の一部が意図と違う場合は追加指示を出せる。このとき、何がどう違うのかを明確に書くことが大切だ。「これは違う」だけより、「formatDate 関数の引数のシグネチャは変えないでほしかった。元のシグネチャを維持したまま内部実装だけを変えてほしい」という具体的な指摘のほうが、次の修正が的確になりやすい(出典: https://developers.openai.com/codex/guides/best-practices )。

追加指示は何度でも出せるが、指摘の積み重ねによってコードが複雑になることがある。特定の方向に修正を重ね続けた結果、全体の一貫性が失われるケースには注意が必要だ。複数回の追加指示を経た場合は、最新の差分とログ全体を改めて見直してから最終判断するのが安全だ。

変更を棄却して別の方向で頼む

タスクの変更内容が根本的に方向性がずれていると感じた場合は、変更を棄却して新しいタスクとして依頼し直すのが効率的な選択肢になる。追加指示を重ねるより、より明確な指示で白紙から依頼し直したほうが結果がよくなることも多い。特に変更ファイルが多い場合や、Codex の前提理解がずれている場合は、切り替えを検討したほうがよい。

白紙から依頼し直す際は、前回の試みで気づいた制約や追加情報を盛り込んで指示を書き直すと効果的だ。一度失敗したタスクは、「何がうまくいかなかったか」を学ぶ材料として次の指示の精度を上げるために活かせる。

複数タスクを並行させる運用

Codex アプリの大きな特徴のひとつは、複数のタスクを並行して走らせられる点だ。あるタスクが作業中の間に別のタスクを投入して同時進行させることができる。これにより、あるバグ修正を Codex に任せている間に、別のリファクタリングタスクを投入して並行させる、という使い方が可能だ(出典: https://openai.com/codex )。

ただし、同じファイルを複数のタスクが同時に編集する場合は、後でコンフリクトが起きることがある。関連するファイルを触るタスクを並行させるときは、完了の順序と変更の合流方法をあらかじめ考えておくと混乱が少なくなる。互いに影響しないファイルを対象にしたタスクなら、並行させることで作業全体のスループットを上げやすい。

タスクの数が増えると管理が煩雑になるので、サイドバーのタスク一覧を定期的に確認する習慣を持つことが重要だ。レビュー待ちのままになっているタスクを放置すると、その後の依頼と前の成果物の関係が分かりにくくなる。完了したタスクは承認か棄却かを早めに判断してから、次のタスクに進む流れにするとよい。

まとめ — Codex アプリを実際の開発に組み込む

Codex アプリを使いこなすには、タスクを具体的に書く・差分とログを確認する・追加指示を的確に出す、という一連の感覚を身につけることが重要だ。最初は戸惑うことも多いが、タスクの書き方が一定の型に落ち着いてくると、依頼→確認→承認のサイクルがスムーズになる。コードを自分で書く場面とエージェントに任せる場面を状況に応じて使い分ける感覚も、使い続ける中で自然と身についてくる。Codex の機能は継続的に更新されているため、最新の操作方法は開発者向けドキュメントで随時確認しておきたい(出典: https://developers.openai.com/codex )。