- このページで分かること
- 原因候補
- Codexに確認だけ頼む流れ
- Codex指示文例
- 修正前に止める条件
- Codex自体が404を返した時の確認
- 404 / 500チェックリスト
- 関連ページ
このページで分かること
404はページが見つからない状態、500はサーバー側で処理に失敗している状態として扱います。どちらも公開前に見つけたい重要なエラーですが、原因を決めつけてすぐ修正すると別の問題を増やすことがあります。
原因候補
- URLの打ち間違い
- ファイル未配置
- ディレクトリ名の違い
- rewrite設定の影響
- PHP構文エラー
- 内部リンク切れ
- sitemapに未作成URLを入れている
- canonicalとリンク先の不一致
- アップロード漏れ
Codexに確認だけ頼む流れ
HTTPステータスを見る
対象URLが200、404、500のどれか確認します。
関連ファイルを探す
想定ではなく実ファイルを確認します。
リンク元を見る
どこからそのURLへリンクしているか見ます。
sitemapを見る
未作成URLが掲載されていないか確認します。
修正前に止める
原因候補を報告してから次へ進みます。
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 にありません。
| 手当て | 公式の説明 | 向く場面(編集部の目安) |
|---|---|---|
.worktreeinclude | Git で除外しているセットアップ用のファイルを 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応答の確認を同じ結果として扱えるかは、この記録だけでは判断できません。
