Codex safety practical guide

Codexで404・500エラーを確認する方法

404や500が出た時に、すぐ修正へ進まず原因候補と停止条件を整理するためのページです。

当サイトはOpenAI、Google、GitHubの運営サイトではありません。Codexを実務で安全に使うためのガイドです。
機能、料金、利用条件、連携条件は変わる可能性があります。最新情報が必要な場合は、各提供元が公開している情報を確認してください。
目次
  1. このページで分かること
  2. 原因候補
  3. Codexに確認だけ頼む流れ
  4. Codex指示文例
  5. 修正前に止める条件
  6. Codex自体が404を返した時の確認
  7. 404 / 500チェックリスト
  8. 関連ページ

このページで分かること

404はページが見つからない状態、500はサーバー側で処理に失敗している状態として扱います。どちらも公開前に見つけたい重要なエラーですが、原因を決めつけてすぐ修正すると別の問題を増やすことがあります。

原因候補

  • URLの打ち間違い
  • ファイル未配置
  • ディレクトリ名の違い
  • rewrite設定の影響
  • PHP構文エラー
  • 内部リンク切れ
  • sitemapに未作成URLを入れている
  • canonicalとリンク先の不一致
  • アップロード漏れ

Codexに確認だけ頼む流れ

1

HTTPステータスを見る

対象URLが200、404、500のどれか確認します。

2

関連ファイルを探す

想定ではなく実ファイルを確認します。

3

リンク元を見る

どこからそのURLへリンクしているか見ます。

4

sitemapを見る

未作成URLが掲載されていないか確認します。

5

修正前に止める

原因候補を報告してから次へ進みます。

Codex指示文例

対象URLのHTTPステータスを確認してください。404または500が出る場合は、修正はまだ行わず、原因候補、確認すべきファイル、触ってはいけないファイル、停止条件を整理して報告してください。

修正前に止める条件

  • 原因ファイルが特定できない
  • rewriteや.htaccess変更が必要そう
  • PHPエラーの範囲が広い
  • DBやcronに関係しそう
  • 未作成URLを作るか削除するか判断が必要
  • 共通部品へ影響しそう

404と500で対応の順番が違う理由

同じ「ページが見られない」でも、404と500では切り分けの入口が逆になります。404は「そのURLに対応するファイルが無い」状態なので、疑う順番はURL→ファイル配置→リンク元です。一方500は「ファイルはあるが処理中に失敗した」状態なので、疑う順番は直前の変更→PHP構文→設定ファイルになります。

404の典型原因500の典型原因
いちばん多いURLの綴り・大文字小文字の違い直前に編集したPHPの構文エラー
次に多いアップロード漏れ・別ディレクトリへの配置.htaccessの記述ミス(1文字でも全体が落ちる)
見落としがちリンク元だけ直してリンク先を作っていないPHPのconstを条件ブロック内に書くなど文法上は珍しい書き方
影響範囲そのURLだけのことが多いサイト全体が落ちることがある(緊急度が高い)

特に500がサイト全体で出ている場合は、直前に触ったファイルを元に戻すことを最優先にし、原因調査は復旧後に行います。404が1ページだけなら、慌てて直す必要はなく、リンク元とファイル配置を落ち着いて確認してからで間に合います。

404 / 500チェックリスト

  • 対象URLを確認した
  • HTTPステータスを確認した
  • リンク元を確認した
  • sitemap掲載を確認した
  • 実ファイルを確認した
  • 原因候補を整理した
  • 修正前に停止条件を見た

公開フォルダだけの確かめの決まりを置く

404 や 500 の確認は、公開するファイルのある場所でだけ厳しくしたい決まりです。公式の説明では、Codex はリポジトリの根から今いるフォルダまでの AGENTS.md を順につなげ、近いフォルダのものほど後ろに付けて優先します。同じフォルダに AGENTS.override.md があると、そのフォルダでは AGENTS.md の代わりにそちらを読みます。

置く場所書くこと(例)
リポジトリの根の AGENTS.md変更したら、変更したファイルと確認結果を報告する
公開フォルダ(例:public/)の AGENTS.md公開URLを開いて 200 か確かめる。404・500 が出たら直さずに止めて報告する
一時的に厳しくしたいとき:同じフォルダの AGENTS.override.md公開前の週だけ「.htaccess と設定ファイルには触らない」を足す。終わったら消して元に戻す

公式の説明では、Codex は今いるフォルダまでしか探しません。公開フォルダの決まりを効かせたいときは、そのフォルダで Codex を始めます(例:codex --cd public)。読まれた決まりは、公式の例と同じく「読み込んだ指示の出どころを挙げて」と頼むと、根のファイル・公開フォルダのファイルの順に挙がることで確かめられます。

出典:OpenAI 公式「Custom instructions with AGENTS.md」(2026年11月6日に確認)。画面やコマンドは変わることがあるため、使う前に公式のページをご確認ください。

公開URLの確認を頼む前に、ネットワークの既定を知っておく

404 や 500 の確認は、公開URLに実際にアクセスして状態を見る作業です。ところが公式の説明では、ChatGPTデスクトップアプリ・CLI・IDE 拡張の既定の workspace-write では、ネットワークが切られています。アクセスが必要なコマンドは、Codex が承認を求めます。

選び方中身注意
その場で承認する求められたコマンドを見て通す何のアクセスかを読んでから通す。範囲は、作業を続けられる最も狭いものを選ぶ
設定でオンにする[sandbox_workspace_write] の network_access = true公式は注意を促している。取りに行った先の文章に従って動くおそれがある
範囲を絞るnetwork_proxy の機能で、行き先を許可・拒否するネットワークがオフのままなら何も変わらない
自分で確認する自分の端末で状態を調べ、結果を Codex に伝える(編集部の目安)設定を変えずに済む

確認だけを頼む回は、/permissions で読み取り専用に切り替えておくのも一つです。ネットワークが切られていて確認できなかったときは、「確認できなかった」と報告させます。取れていないのに200と書かれると、判断を誤ります。

出典:OpenAI 公式「Agent approvals & security」(2026年11月6日に確認)。

worktree で確かめるときに抜けやすいファイル

本番では動くのに、Codex が worktree で確かめると動かないことがあります。公式の説明では、worktree は別のフォルダに作られ、既定では Git に登録したファイルだけを引き継ぎます。Git に入れていない設定ファイルは、そのままでは worktree にありません。

手当て公式の説明向く場面(編集部の目安)
.worktreeincludeGit で除外しているセットアップ用のファイルを worktree に写す手元だけに置いている設定ファイルが要るとき
local environment のセットアップスクリプトworktree でセットアップの手順を流す依存ファイルの取り込みなど、毎回同じ準備が要るとき
いつものプロジェクトで変更を確かめるworktree の変更を、普段のフォルダに持ってきて確かめる準備に手間がかかり、1回だけ見たいとき

worktree での確認結果が本番と食い違うときは、500 の原因を探す前に、確かめた場所が worktree かどうかを報告させます。設定ファイルの有る無しで結果が変わっていることがあります。

出典:OpenAI 公式「Troubleshooting」(2026年11月6日に確認)。右端の列と最後の段落は当サイトの目安です。

編集部がファイル確認で切り分けた範囲

2026年11月8日、編集部はCodex CLI 0.167.0を使い、ほかのAIによるウェブページの校正指摘がサイトのファイル内に実在するかを調べました。Codexには対象ファイルを開かせ、指摘の有無を判定させました。その判定をもとに、21の会場ページで出典の会場名が事実と合わない文を見つけて修正しました。実行環境には、読むだけのread-onlyと、--cdで決めた作業フォルダだけを書き換えられるworkspace-writeを使い分けました。

この記録で確認できるのは、ローカルのファイルを開いた照合と、21ページの文の修正です。対象URLのHTTP状態、404または500の発生件数、サーバー側のログ、公開後の応答は記録にないため不明です。また、21ページの判定をどちらの実行環境で行ったか、その配分も不明です。ファイルの存在確認とHTTP応答の確認を同じ結果として扱えるかは、この記録だけでは判断できません。

関連ページ

この場合は止める

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

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

次に読むページ

EDITED & REVIEWED

編集・検証情報

編集責任
運営者 ちんあなご編集部
書き方の基準
編集・検証方針
最終確認
(本文を最後に直した日)
更新履歴
(本文を書き足した・直した日。新しい順)

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