このページで分かること
Codexで静的HTMLサイトを作る時の構成、index.htmlと下層ディレクトリ、共通CSS、運営者情報やポリシー、sitemap、robotsの考え方が分かります。
なぜ必要なのか
静的HTMLサイトは、DBや管理画面を使わないため、小規模な情報サイトやサービス紹介サイトを軽く始めやすい方法です。変更範囲が見えやすく、バックアップやロールバックもしやすい利点があります。
Codexに任せられる作業
- index.htmlの作成
- 下層ディレクトリとindex.htmlの作成
- 共通CSSの作成
- ヘッダーとフッターの統一
- SEOタグの設定
- sitemap.xmlとrobots.txtの作成
- 公開前チェック
人間が確認すべき作業
WordPressを使わない判断、問い合わせフォームの扱い、更新頻度、公開してよい情報、運営者情報やポリシーの内容は人間が確認します。静的HTMLはシンプルですが、更新作業の運用ルールは必要です。
よくある失敗
- 共通ナビがページごとにズレる
- CSSパスが下層ページで崩れる
- canonicalがコピー元のまま残る
- sitemapに未完成URLが入る
- 運営者情報や問い合わせ導線が不足する
- バックアップなしで本番上書きする
Codexへの指示文例
目的:
WordPressなし、DBなしの静的HTMLサイトを作る
構成:
/
/about/
/policy/
/disclaimer/
/contact/
/assets/css/style.css
/sitemap.xml
/robots.txt
確認:
全ページにtitle、description、canonical
robots index,follow
CSS読み込み
スマホ表示
sitemap掲載
内部リンク
禁止:
WordPress導入
DB作成
.htaccess変更
秘密情報の掲載静的HTMLサイト公開前チェックリスト
- トップページと下層ページがある
- 共通CSSが読み込まれる
- 運営者情報、ポリシー、免責、問い合わせがある
- canonicalが自己URL
- sitemap.xmlがある
- robots.txtがある
- 404や500がない
- バックアップと戻し方がある
index.htmlと下層ディレクトリの考え方
静的サイトでは、トップにindex.htmlを置き、下層ページはディレクトリごとにindex.htmlを置く構成が分かりやすいです。URLが整理され、canonicalやsitemapも管理しやすくなります。
Codexには、ページ一覧、URL、title、description、H1を表で渡すと、下層ディレクトリと内部リンクをまとめて作りやすくなります。
WordPressなしで始める時の判断
静的HTMLは、更新頻度が高すぎないサイト、管理画面が不要なサイト、小さく公開して後から育てたいサイトに向いています。DBがないため構成が見えやすく、公開前チェックもファイル単位で行えます。
一方で、記事投稿を頻繁に行うサイトや管理画面が必要なサイトでは、別の仕組みが向く場合もあります。Codexには、静的HTMLで十分か、WordPressや別CMSが必要そうかを整理させる使い方もできます。
報告書に残すこと
静的HTMLサイトを作った後は、ファイル構成、共通CSS、全ページのURL、SEOタグ、sitemap、robots、内部リンク、公開確認結果を残します。特に下層ページのCSSパスとcanonicalはコピー時に間違いやすいため、報告書に確認済みとして残します。
静的サイトの決まりをAGENTS.mdに置く
毎回の指示文に「共通CSSの場所」「sitemapの更新」などを書くと、書き忘れが起きます。繰り返す決まりは、AGENTS.mdというファイルに置けます。CodexはAGENTS.mdを、作業を始める前に読み込みます。
- サイトのフォルダでCodex CLIを開き、
/initを実行します。AGENTS.mdの雛形が作られます。 - 雛形を開き、このサイトの決まりに書き換えます。例は、共通CSSの置き場所、ページを足した時にsitemapも直すこと、触らないファイルです。
- 下層のフォルダだけ別の決まりにしたい時は、そのフォルダにAGENTS.override.mdを置きます。
- 読み込まれているかは、「今読んでいる指示を要約して」と頼んで確かめます。
| 置く場所 | 効く範囲 | 優先 |
|---|---|---|
| Codexのホーム(標準では~/.codex) | すべてのプロジェクト | いちばん弱い |
| プロジェクトのルート(通常はGitのルート) | そのサイト全体 | 中 |
| 下層のフォルダ | そのフォルダでの作業 | いちばん強い |
読み込める合計の大きさには上限があり、標準では32KiBです。長くなりすぎたら、下層のフォルダへ分けます。内容を変えたら、Codexを開き直すと反映されます。
出典:OpenAI: Custom instructions with AGENTS.md、Codex CLI reference(2026年11月6日に確認)。
表示を見ながら直す:内蔵ブラウザの使い方
静的HTMLは、ファイルだけでは見た目の崩れに気づきにくいものです。ChatGPTのデスクトップアプリには内蔵ブラウザがあり、ページを開いたまま直したい場所にコメントを付けられます。公式ドキュメントの手順です。
- サイトを確認するための開発用サーバーを起動します(ファイルとして開けるページなら、そのまま開けます)。
- 内蔵ブラウザでそのページのURLを開きます。
- 表示された状態を、コードの差分と並べて見ます。
- ツールバーの「Annotate」を押し、要素をクリックするか範囲をドラッグして、直したい点をコメントにします。
- チャットで、コメントへの対応を頼みます。範囲を狭く保つよう書き添えます。
コメントは、問題と望む結果をセットで書くと伝わります。たとえば「スマホでボタンがはみ出す。文字は1行に収めたい」のようにします。内蔵ブラウザは、普段使うブラウザとは別のプロファイルで動きます。また、Codex CLIとIDE拡張では使えません。
公開済みのページを開く場合の注意もあります。ページの中の指示は、誤りや悪意を含むことがあります。サイトに操作の権限を与えても、その内容を信頼してよいことにはならない、と公式は書いています。
出典:OpenAI Codex ドキュメント Browser(2026年11月6日に確認)。画面の名前は更新で変わることがあります。
