Practical log guide

Codexでカードの外部リンク偏重を直した実践ログ

カード一覧で外部リンクが主導線になりすぎると、読者がサイト内で比較・確認する前に離脱しやすくなります。この実践ログ型ガイドでは、内部詳細ページを主導線にし、外部公式リンクを補助導線として残す考え方を整理します。

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

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

今回やった作業

公開中のランキング型サイトで、カード一覧のサムネイルやタイトルが外部サイトへ直接飛んでいたため、内部詳細ページへの導線中心に整理した作業を一般化してまとめます。

カードは並んでいましたが、クリックするとすぐ外部へ出る導線が強く、サイト内で比較したり詳細を確認したりする流れが弱い状態でした。

作業前の状態

作業前は、カードのサムネイル、タイトル、ボタンがクリックできる状態でした。ただし主なクリック先が外部サイトになっており、内部詳細ページが存在していても、読者がそこへ進みにくい構造でした。

内部詳細ページがないカードへ無理に内部リンクを作ると404リンクになります。そのため、内部ページがあるカードだけを内部導線にし、ないカードは無理にリンクしない判断が必要でした。

作業前に問題だったこと

ランキング型サイトや情報メディアでは、ユーザーがサイト内で比較・確認できることが重要です。カードからすぐ外部へ出てしまうと、サイト内の詳細ページや比較ページの価値が伝わりにくくなります。

外部公式リンク自体は必要ですが、主導線と補助導線を分けることが大切です。サムネイルやタイトルは内部詳細ページへ、外部公式リンクは明示した補助ボタンへ、という整理が自然です。

Codexに任せたこと

Codexには、カード内の各リンク先を役割ごとに確認させました。サムネイル、タイトル、詳しく見るボタン、外部公式リンクがそれぞれどこへ向いているかを整理し、内部詳細ページの有無も確認対象にしました。

  • サムネイルリンク先の確認
  • タイトルリンク先の確認
  • 詳しく見るボタンの確認
  • 内部詳細ページの有無の確認
  • 外部公式リンクの残し方確認
  • 404リンクがないか確認

人間が判断したこと

人間側で判断したのは、すべてを内部リンクにするのではなく、内部詳細ページがあるものだけを内部導線にすることです。内部ページがないカードに無理なURLを付けると、404リンクを増やしてしまいます。

  • 内部詳細ページがあるカードは内部リンクへ向ける
  • 内部ページがないカードは無理にリンクしない
  • 外部公式リンクは補助導線として残す
  • 外部直行を主導線にしすぎない

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

依頼文では、「外部リンクを内部リンクにして」だけでは足りません。どの要素を主導線にするか、内部詳細ページが存在する場合だけ変更すること、外部公式リンクは補助導線として残すことまで指定します。

作業後は公開HTMLだけでなく、実画面でサムネイル、タイトル、ボタンをクリックし、想定外の外部遷移や404がないか確認します。

うまくいった点

うまくいった点は、カードのクリック先を役割ごとに整理できたことです。読者はまず内部詳細ページで比較材料を確認し、必要に応じて外部公式リンクへ進めるようになります。

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

危なかった点は、内部詳細ページがないカードまで内部リンク化してしまうことです。内部導線を増やすこと自体が目的になると、未作成URLや404リンクを生みやすくなります。

作業後に確認したこと

作業後は、公開HTMLと実画面の両方でリンク先を確認します。サムネイル、タイトル、詳しく見るボタン、外部公式リンクの役割が分かれているかを見ます。

あわせて、404 / 500 がないこと、内部詳細ページがあるカードだけ内部リンクになっていること、外部公式リンクが補助導線として残っていることを確認します。

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

以下の公開中サイトで、カード一覧のサムネイル、タイトル、詳しく見るボタンのリンク先を確認してください。

内部詳細ページがあるカードは、サムネイルとタイトルを内部詳細ページへ向ける案を出してください。

内部詳細ページがないカードは、無理に内部リンクを作らず、404リンクを出さない方針にしてください。

外部公式リンクは補助導線として残し、主導線になりすぎていないか確認してください。

作業後に、公開HTMLと実画面でリンク先を確認し、404 / 500 がないことを報告してください。

確認チェックリスト

  • サムネイルリンク先を確認した
  • タイトルリンク先を確認した
  • 詳しく見るボタンを確認した
  • 内部詳細ページがある場合だけ内部リンクにした
  • 内部詳細ページがないカードに404リンクを作っていない
  • 外部公式リンクは補助導線として残した
  • 外部リンクが主導線になりすぎていない
  • 公開HTMLでリンク先を確認した
  • 実画面でクリック先を確認した
  • 404 / 500 がない

注意書き

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