社内システムの不具合対応は、開発部門の時間を読めない形で奪う仕事の代表です。「画面で保存したのに反映されない」「月末だけ集計がずれる」といった報告が届くたびに、担当者は再現を試し、原因の場所を探し、直し、ほかを壊していないか確かめます。
Codex はこの一連の作業を手伝えますが、頼み方しだいで結果が大きく変わります。この記事では、不具合の切り分けと修正案づくりを Codex に任せるときの頼み方と、チームで回すときの決めごとを手順の順番に整理します。製品の動きに関わる内容は、2026年11月2日に OpenAI の公式ドキュメント(Prompting・Best practices・Automate bug triage)で確かめた範囲に絞りました。
結論: 不具合を頼むときは「あるべき動き」「再現の手順」「変えてはいけないこと」「直ったことの確かめ方」の4つを渡します。1回に1件に絞り、Codex に再現→最小の修正→同じ手順での再確認まで回させ、人はその証拠を見てから受け入れます。届いた報告の仕分けは、手作業で型が固まってから定期実行に移します。
なぜ「頼み方」で結果が変わるのか
公式ドキュメントでは、役に立つ Codex への指示を「望む動きを示し、関係するコードか再現の手順を指し、守るべき制約を残し、どう確かめるかを言うもの」と説明しています。さらに、不具合の修正では大まかな説明よりも、利用者が渡す再現の手順と制約のほうが重要で、コマンドの出力や呼び出し箇所、エラーの記録は Codex 自身が集めるとされています。(出典: Prompting)
つまり人がやるべきことは原因の推理ではなく、Codex が自分で確かめられる材料を渡すことです。「保存ボタンがおかしい」だけでは、Codex は何をもって直ったとするかを決められません。手順と確かめ方があれば、Codex は不具合を自分で起こし、直し、もう一度起こらないことを確かめられます。
| 渡すもの | 中身の例 | ないと起きること |
|---|---|---|
| あるべき動き | 保存したら一覧に新しい値が出る | 何を直すのかがぶれる |
| 再現の手順 | 1. 編集画面を開く 2. 金額を変える 3. 保存を押す 4. 一覧に戻る | Codex が不具合を起こせず推測で直す |
| 変えてはいけないこと | API の形を変えない・画面の文言を変えない | 直ったが別の所が変わる |
| 確かめ方 | 同じ手順をやり直す・関係するテストと lint を実行して結果を報告する | 直ったかどうかを人が全部見直すことになる |
| 怪しい場所(分かれば) | 保存処理のファイル名 | 調べる範囲が広がり時間がかかる |
手順1: 不具合を1件に絞って報告を整える
最初に決めるのは「今回はどの1件を直すか」です。公式ドキュメントの事例でも、1回の作業では1つの不具合に絞り、再現・修正・確認を1周終えてから隣の問題に広げるよう案内されています。(出典: Debug in iOS simulator)
社内から届く報告は「いくつか変な所がある」とまとまって来ることが多いので、Codex に渡す前に人が1件ずつに分けます。このとき、報告者に次の3つを聞いておくと手順2がすぐに書けます。
- どの画面で何をしたか(操作の順番)
- 何が起きたか・本来はどうなるはずだったか
- いつから起きているか・毎回起きるか
「毎回は起きない」不具合は、そのまま Codex に渡しても再現できないことがあります。その場合の進め方は手順4で説明します。
手順2: 4つをそろえた指示を書く
公式ドキュメントには、保存ボタンを押すと「保存しました」と出るのに実際には保存されていない、という不具合を例にした指示が載っています。番号つきの再現手順と「API の形を変えない」といった制約を書き、できれば再発を防ぐテストを添えた最小の修正を求め、まず手元で不具合を再現するところから始めさせる内容です。(出典: Prompting)
この型を社内向けに書き直すと、次のようになります。
不具合: 経費精算の編集画面で金額を変えて保存すると「保存しました」と出るが一覧の金額が変わらない。
本来は保存後に一覧へ新しい金額が出る。
再現手順:
1. 開発環境で経費精算の一覧を開く
2. 任意の1件の編集画面を開く
3. 金額を変えて保存を押す
4. 一覧に戻り金額を見る
制約:
- API の入出力の形は変えない
- 画面の文言は変えない
- 修正は最小限にする
進め方:
- まず上の手順で不具合が起きることを確かめる
- 原因の場所と理由を短く説明してから直す
- できれば再発を防ぐテストを1つ足す
- 直したあと同じ再現手順をやり直し、関係するテストと lint を実行して、実行したコマンドと結果を報告する
公式ドキュメントでも、修正のあと Codex に再現の手順をやり直させること、lint と関係する最小のテストを実行して、実行したコマンドと結果を報告させることが例として示されています。(出典: Prompting)この「報告させる」部分が、あとで人が確かめる手間を大きく左右します。
修正が大きくなりそうなときは先に計画を立てさせる
原因が複数のファイルにまたがりそうなときは、いきなり直させずに計画を出させます。公式ドキュメントでは、多くの利用者にとって Plan mode が最も簡単で効果的な方法とされ、実装の前に Codex が情報を集め、分からない点を質問し、計画を固められると説明されています。CLI などでは /plan か Shift+Tab で切り替えます。(出典: Best practices)
計画を見て「そこまで広く変えなくてよい」と分かれば、指示の制約に足してから進めさせます。
手順3: 出てきた修正案を確かめて受け入れる
Codex の作業が終わったら、人が確かめるのは次の順番です。
- 再現できていたか: 修正の前に不具合が起きたことが報告に書かれているか
- 原因の説明が筋の通るものか: 「なぜ起きていたか」が短く説明されているか
- 変更が最小か: 制約に書いたこと(API の形・文言など)に触れていないか
- 確かめた証拠があるか: 再現手順のやり直しの結果と、実行したテスト・lint のコマンドと結果が書かれているか
- 社内のレビューに回す: 普段の変更と同じ手順でレビューを通す
公式ドキュメントでも、必要に応じてテストを作らせ、関係する検査を実行させ、結果を確かめ、受け入れる前に作業内容を見直すよう勧められています。(出典: Best practices)Codex が「直りました」と書いていても、証拠が報告にないものは受け入れずに、確かめ方を指示に足してやり直させます。
GitHub の Pull Request でレビューしている会社なら、Codex のレビュー機能と人のレビューの分担を決めておくと流れが安定します。分担の決め方はCodex のコードレビューをチームで使う記事で解説しています。
手順4: 「毎回は起きない」不具合の進め方
「たまに数字がずれる」「ある人の画面だけおかしい」といった不具合は、再現の手順が書けません。このときは、いきなり直させずに手がかりを増やすところまでを頼みます。
公式ドキュメントの事例(Mac アプリに記録を足す例)には、何が起きたか分からない不具合に対して、Codex に要点を押さえた記録(ログ)を数か所だけ足させ、同じ操作をやり直し、記録から期待した処理が動いたかを確かめさせる進め方が紹介されています。(出典: Add Mac telemetry)
社内向けには、次の2段階に分けると混乱が少なくなります。
| 段階 | Codex に頼むこと | 人が決めること |
|---|---|---|
| 1. 手がかりを集める | 怪しい処理の前後に記録を足す案を出す・既存のエラー記録を読んで共通点をまとめる | 記録を本番に足してよいか・足す期間 |
| 2. 直す | 集まった記録から再現の手順を組み立て、手順2の型で直す | 修正を受け入れるか |
すでにあるテストの失敗やエラーの記録がある場合は、CLI の非対話モード(codex exec)に記録を渡して原因の要約を出させる使い方も公式ドキュメントで紹介されています。(出典: Non-interactive mode)本番の記録には個人情報やお客様の情報が入っていることがあるため、渡してよい範囲を社内のルールで先に決めておいてください。ルールの作り方は社内利用ガイドラインの記事にまとめています。
手順5: 届いた報告の仕分けを定期実行に移す
1件ずつの修正に慣れたら、次は「毎日届く報告を仕分けて優先度をつける」作業です。公式ドキュメントの Automate bug triage では、その日の不具合報告を優先度つきの一覧にまとめる使い方が紹介されています。進め方は次の3段階です。
- まず1つのチャットで仕分けを手作業として回す
- 出てきた一覧が役に立つことを確かめる
- 固まった手順を Codex に繰り返し使える指示にまとめさせ、定期実行に移す
一覧の出来ばえの目安として、同じ不具合の重複した報告を1件にまとめること、不具合ごとに根拠へのリンクを添えること、不具合ごとに短い「次にやること」を添えることが挙げられています。(出典: Automate bug triage)
法人で大事なのは、手作業の段階を飛ばさないことです。仕分けの基準(何を「急ぎ」とするか)は会社ごとに違うため、最初の数回は担当者が一覧を見て基準を直し、その基準を指示に書き足していきます。定期実行の設定のしかたは定期タスクの設定手順の記事で解説しています。
チームで回すときに決めておくこと
不具合対応を個人の工夫に任せると、人によって頼み方も確かめ方もばらばらになります。試験導入の段階で次の4つを決めておくと、部署に広げやすくなります。
- 指示の型を共有する: 手順2の型を社内の手順書に載せ、報告の受付票の項目もそろえる
- 繰り返し書くことは AGENTS.md に移す: テストと lint の実行コマンドなど、毎回書く内容はリポジトリの
AGENTS.mdに書きます。公式ドキュメントでは、AGENTS.mdは自動で読み込まれ、チームが Codex にどう働いてほしいかを書く場所とされ、短く正確なほうが役に立つとされています(出典: Best practices)。書き方はAGENTS.md の書き方の記事を参考にしてください - Codex に許す操作の範囲を決める: 開発環境でのコマンド実行をどこまで承認なしで許すかは、サンドボックスと承認の設定で決まります。考え方はサンドボックスと承認ポリシーの記事にまとめています
- 記録を残す: 1件ごとに「頼んだ時刻・受け入れた時刻・やり直した回数」を残しておくと、導入の効果を説明しやすくなります。記録のしかたは導入効果の測り方の記事で紹介しています
まとめ
Codex に不具合を任せるときは、原因を推理して伝えるより「あるべき動き・再現の手順・変えてはいけないこと・確かめ方」の4つを渡すほうが結果が安定します。1回に1件に絞り、Codex に再現から再確認までを回させ、人は報告に書かれた証拠を見てからレビューに回します。毎回は起きない不具合はまず手がかりを集めることから始め、届いた報告の仕分けは手作業で基準が固まってから定期実行に移します。
この記事の内容は、2026年11月2日時点の OpenAI 公式ドキュメントの記載に基づいています。機能の名前や画面の操作は変わることがあるため、使う前に最新の記載をご確認ください。デジライズでは、社内システムの不具合対応の流れに Codex を組み込む手順づくりから、指示の型・社内ルール・現場向けの研修までを含めた Codex の法人導入支援のご相談を承っています。「まず1つのシステムの不具合対応で試したい」という段階からでもお問い合わせください。
- https://developers.openai.com/codex/prompting
- https://developers.openai.com/codex/learn/best-practices
- https://developers.openai.com/codex/use-cases/automation-bug-triage
- https://developers.openai.com/codex/use-cases/ios-simulator-bug-debugging
- https://developers.openai.com/codex/noninteractive
- https://developers.openai.com/codex/use-cases/macos-telemetry-logs
確認日:2026年11月2日。提供条件・機能・料金は変更されるため、最新情報は各公式ページをご確認ください。
デジライズの実績はデジライズ全体の社内集計値です。Codex の機能・対応環境・料金・提供条件は記事の公開・更新時点の OpenAI 公式情報に基づき、変更される場合があります。導入効果は企業や業務によって異なります。



