Codex safety practical guide

Codex作業で失敗しやすいパターン

Codex作業で起きやすい失敗を先に知り、止める条件と安全な頼み方を作るためのページです。

当サイトはOpenAI、Google、GitHubの運営サイトではありません。Codexを実務で安全に使うためのガイドです。
機能、料金、利用条件、連携条件は変わる可能性があります。最新情報が必要な場合は、各提供元が公開している情報を確認してください。
目次
  1. このページで分かること
  2. 失敗しやすいパターン
  3. 止める条件の作り方
  4. 安全な指示文例
  5. やってはいけないこと
  6. 失敗防止チェックリスト
  7. 関連ページ

このページで分かること

Codex作業の失敗は、AIの能力不足だけでなく、依頼文の曖昧さや確認不足から起きることがあります。対象ファイルを間違える、共通パーツを広く触る、SEOタグを変える、存在しないURLへリンクする、といったパターンを先に知ると、停止条件を作りやすくなります。

失敗しやすいパターン

  • 対象ファイルを間違える
  • 共通パーツを広く触りすぎる
  • SEOタグを意図せず変える
  • 存在しないURLへリンクする
  • sitemapに未作成URLを入れる
  • robotsやcanonicalを勝手に変える
  • .htaccessを触って壊す
  • データベースやcronに関わる作業へ広げる
  • 秘密情報を公開してしまう
  • 修正範囲が大きすぎる
  • 報告書が薄い

止める条件の作り方

停止条件は、Codexが判断できない時に勝手に進まないためのブレーキです。「対象ファイルが特定できない」「既存SEOタグ変更が必要」「設定ファイル変更が必要」「内部リンク先が未作成」など、作業を止める条件を依頼文に入れます。

安全な指示文例

対象ページの本文だけを修正してください。対象ファイルが特定できない、既存SEOタグ変更が必要、設定ファイル変更が必要、内部リンク先が未作成、共通部品へ影響しそうな場合は作業を止めて報告してください。

やってはいけないこと

  • 停止条件なしで依頼する
  • 全部任せる
  • 設定ファイルを気軽に変更する
  • リンク先確認なしで内部リンクを増やす
  • 報告書を読まずに次へ進む
  • AIの確認だけで公開判断する

失敗防止チェックリスト

  • 対象ファイルを確認した
  • 変更範囲を限定した
  • 禁止範囲を書いた
  • SEOタグ維持を書いた
  • 内部リンク先を確認した
  • sitemap掲載を確認した
  • 停止条件を書いた
  • 報告書形式を指定した

点検の道具そのものが間違っていることがある

作業の失敗より見つけにくいのが、確認に使っている道具が嘘の数字を返している場合です。数字が出ている分、間違いだと気づけません。実際に踏んだものを挙げます。

  • 取れなかったものを0として返す。本文を抜き出す処理が想定した囲みを見つけられず、「本文0字」と報告しました。実際には1万字あるページでした。取れなかったのか、本当に無いのかを区別して返さないと、健全なページを薄いと判定します
  • 文書全体に条件を当ててしまう。「特定の語を含むページを除外する」処理を文書全体に対して書いたため、その語を解説しているだけのページまで除外されました。対象は本来メタ情報の一行だけでした
  • 見出しだけを見て中身を判断する。複数ページの見出しが似ていたので「内容が重複している」と考えましたが、本文を文単位で測ると重なりは5%以下でした

共通しているのは、いずれもエラーを出さずに、それらしい数字を返したことです。だから検算するまで気づけません。直す判断の根拠にする数字は、少数の実例を手で確かめてから使ってください。1件でも突き合わせれば、この3つはすべて見つかります。

手元のファイルが本番より古いことがある

手元で直して上げる作業では、手元のほうが新しいという前提が崩れていることがあります。別の経路で本番だけが直されていると、上げた瞬間に元へ戻ります。

  • 上げる前に、対象ファイルを本番から取って突き合わせる。1ファイルでも差があれば、そこで止めます
  • 差の中身を見る。改行コードだけの差なのか、文章が違うのかで意味がまったく変わります
  • 測ってから上げるまでに間が空いたら、上げる直前にもう一度測る。数分の間に状況が変わることがあります

実際に、手元にだけ古い表記が残っていて、本番はすでに直っていたということがありました。突き合わせをせずに上げていれば、直っているものを壊すところでした。「自分が最後に触ったのだから手元が新しいはず」は前提にできません。

失敗に気づいた後に使うCodex CLIの操作

失敗に気づいた時は、直す前にまず状況を確かめます。Codex CLIには、そのための操作が用意されています。知りたいことごとに、使う操作を並べました。

知りたいこと使う操作公式の説明
何が変わったか/diffステージ済みの変更、まだの変更、Gitが追跡していないファイルを表示します。
今の権限と書き込める場所/status使用中のモデル、承認ポリシー、書き込める場所(writable roots)、トークン使用量を表示します。
これ以上変更させたくない/permissions承認の設定を切り替えます。変更を加えずに相談や計画をしたい時は、読み取り専用(read-only)にします。
別のやり方を試したい/fork今の会話を新しい会話にコピーします。元の記録は変わりません。
会話が長くなり、前提がぼやけた/compactそれまでのやり取りを要約して、空きを作ります。
第二の目で確認したい/review作業ツリーの変更をCodexにレビューさせます。

おすすめの順番は、/statusで権限を見て、/diffで変更範囲を見て、必要なら/reviewを足す流れです。変更が想定より広いと分かったら、そこで作業を止め、報告を求めます。

なお、標準の書き込み設定(workspace-write)でも、書き込める場所の中の.git、.agents、.codex、.awsは読み取り専用として保護されます。履歴や設定を巻き込む失敗は、この仕組みで一部防がれます。ただし、これ以外のファイルは書き換えられるため、上げる前の差分確認は省けません。

出典:OpenAI Developers: Codex CLI reference、Agent approvals & security(2026年11月6日に確認)。操作名や表示は変わることがあるため、使う前に自分の画面で確認してください。

チャットが止まって見えるとき:確かめる順番

失敗なのか、ただ待っているだけなのか分からない場面があります。公式のトラブルシューティングにある、止まったように見えるときの手順です。

  1. Codexが承認を待っていないか確認します。
  2. ターミナルを開き、git status のような基本のコマンドを実行します。
  3. 改めて、より小さく絞った依頼で新しいチャットを始めます。

ターミナルが止まったときは、パネルを閉じて開き直し、pwd か git status を実行します。動きがおかしければ、まず今いるフォルダとブランチを見ます。作業ツリーを作る途中で取り消して依頼文が消えた場合は、入力欄で上矢印を押すと取り戻せます。

実行先(Local、Worktree、Cloud)を間違えて始めたときも同じです。実行を取り消し、入力欄で上矢印を押すと、直前の依頼文を取り戻せます。

アプリのレビュー画面に、Codexが触っていないファイルが出ることもあります。公式によると、画面はGitの状態をそのまま映すためです。直前の1回分だけを見たいときは、差分の表示を「Last turn」にします。

出典:OpenAI Codex ドキュメント Troubleshooting(2026年11月6日に確認)。

関連ページ

この場合は止める

判断が必要な状態になったら、そのまま実装へ進めず、確認結果と停止理由を報告してもらいます。

  • 対象ファイルが分からない
  • HTTP 500が出た
  • HTTP 404が出た
  • SEOタグ変更が必要になった
  • .htaccess変更が必要になった
  • DB変更が必要になった
  • 秘密情報が関係しそう
  • 共通パーツを大きく変える必要がある
  • 未作成URLへリンクしそう

次に読むページ

EDITED & REVIEWED

編集・検証情報

編集責任
運営者 ちんあなご編集部
書き方の基準
編集・検証方針
最終確認

公式情報、実際の操作で確かめたこと、運営者の判断を区別して記載しています。サービスの画面、料金、利用上限、提供地域は変わる場合があるため、重要な操作の前に公式資料と現在の画面を確認してください。