Practical log guide

Codexでトップページの404内部リンクを整理した実践ログ

トップページに404内部リンクが残っていると、読者の導線だけでなくサイト全体の管理品質にも影響します。この実践ログ型ガイドでは、代替URLの有無や文脈を見ながら、残すリンクと消すリンクを判断した流れを一般化してまとめます。

当サイトはOpenAI公式サイトではありません。Codexの使い方を実体験ベースで整理する非公式ガイドです。最新の仕様・料金・対応プランはOpenAI公式情報をご確認ください。

この記事は2026年5月時点の情報をもとに整理しています。Codex、ChatGPT、GitHub、Google関連サービスの仕様は変更される可能性があります。

今回やった作業

公開中サイトのトップページ内に残っていた404内部リンクを確認し、代替URLの有無や文脈を見ながら削除・維持を判断しました。過去に作る予定だったページへのリンクが残っている場合、公開後に404のまま残ることがあります。

作業前の状態

トップページに、過去に作る予定だったページへの内部リンクが残っていました。確認すると、それらのURLは404でした。一方で、同じ系統の総合ページは200 OKで存在していたため、全部を消すのではなく、残すリンクと消すリンクを分ける必要がありました。

作業前に問題だったこと

トップページはサイト内で重要な入口になりやすいページです。そこに404リンクが残っていると、ユーザーが迷うだけでなく、サイト全体の管理品質が低く見える可能性があります。

ただし、404リンクを見つけたからといって、無理に別URLへ差し替えるのも危険です。文脈に合わない代替URLへ送るくらいなら、404リンクだけ削除する判断もあります。

Codexに任せたこと

Codexには、トップページ内の内部リンクを確認し、リンク先のHTTPステータスを確認し、404リンクを特定させます。さらに、代替URLが存在するか、代替URLが文脈に合うか、削除対象と維持対象を分ける作業を任せます。

修正後は、公開HTMLから404リンクが消えているか、トップページが200 OKのままか、残したリンクが200 OKかを確認させます。

人間が判断したこと

人間が判断したのは、文脈に合わないURLへ無理に差し替えないことです。404になる下層リンクだけ削除し、総合ページとして成立している200 OKリンクは残します。

title、description、H1、canonical、robotsは変更せず、トップページの構成も大きく崩さない方針にしました。

実際に使った指示文の考え方

指示文では、404リンクを一括置換するのではなく、リンク先、代替URL、文脈の一致を確認するようにします。差し替えが自然でなければ削除を提案し、残すリンクは200 OKを確認します。

うまくいった点

うまくいった点は、作業対象を小さく分け、確認項目を先に固定できたことです。Codexに任せる範囲と人間が判断する範囲を分けると、作業後の確認が具体的になります。

詰まった点・危なかった点

危なかった点は、見つかった問題をすぐ一括修正しようとすることです。sitemap、内部リンク、Search Console判断はいずれもサイト全体に関係するため、原因と影響範囲を整理してから最小変更で進めます。

作業後に確認したこと

作業後は、404リンクが公開HTMLから消えていること、残したリンクが200 OKであること、トップページが200 OKであることを確認します。title、description、H1、canonical、robotsを変えていないこと、レイアウトが大きく崩れていないことも確認します。

次から使える指示文テンプレート

以下の公開中サイトで、トップページ内の内部リンクを確認し、404リンクが残っていないか調査してください。

リンク先が404の場合は、代替URLがあるか、代替URLが文脈に合うかを確認してください。

文脈に合う代替URLがある場合だけ差し替えを提案し、文脈に合わない場合は404リンクの削除を提案してください。

修正する場合は、title、description、H1、canonical、robotsは変更せず、対象リンクだけを最小変更してください。

作業後に、トップページの200 OK、公開HTMLから404リンクが消えていること、残したリンクが200 OKであることを確認してください。

確認チェックリスト

  • 404リンクを特定した
  • 代替URLがあるか確認した
  • 代替URLが文脈に合うか確認した
  • 不自然な差し替えをしていない
  • 404リンクが公開HTMLから消えた
  • 残したリンクは200 OK
  • title / description / H1を変えていない
  • canonicalを変えていない
  • robotsを変えていない
  • トップページが200 OK
  • レイアウトが大きく崩れていない

注意書き

この記事は、実際の作業を一般化してまとめた実践ログ型ガイドです。具体的な案件名、内部情報、サーバーパス、秘密情報は掲載していません。作業対象サイトの条件や利用しているサービスの仕様は変わるため、実際に作業する前には現在の環境と公式情報を確認してください。