このページで分かること
Codexは便利ですが、初回からサイト全体の修正や共通パーツの大きな変更を頼むと、確認範囲が広がります。まずは修正せず確認だけ頼む、次に1ページだけ補強する、最後にGitHub運用やPR確認へ進むと安全です。
初級で覚えること
初級では、Codexとは何か、対象URLと対象ファイルの分け方、触ってはいけないファイルの指定、報告書の読み方を覚えます。最初は修正ではなく調査だけ頼むのが安全です。
中級で覚えること
中級では、既存ページの本文補強、内部リンク確認、公開前チェック、sitemapやrobots、canonicalの確認に進みます。ここでも1作業1目的を守り、SEOタグを勝手に変えないよう依頼します。
上級で覚えること
上級では、GitHub運用と組み合わせ、作業ブランチ、Pull Request、追加レビュー、報告書の実践ログ化まで一連の流れとして扱います。AIの確認だけで完了せず、人間レビューと公開確認を残します。
レベル別Codex指示文例
初級: まず修正はせず、対象ページの実ファイル、title、canonical、robots、H1、内部リンク、CSS読み込みを確認してください。
中級: 対象ページ本文だけを補強してください。SEOタグ、共通ヘッダー、共通フッター、sitemap.xml、robots.txtは変更しないでください。
上級: Pull Requestの差分を確認し、重大な不具合、不要ファイル、秘密情報の混入候補、戻しにくい変更を優先して報告してください。次のレベルへ進むタイミング
レベルを上げる目安は「作業に慣れたか」ではなく、失敗しても自力で戻せるようになったかです。次の状態になっていれば、次の段階の作業を試してよい合図です。
| 今のレベル | 次へ進んでよい合図 | まだ早い合図 |
|---|---|---|
| 初級 → 中級 | 変更前のファイルを自分で保存でき、おかしくなったら戻せる | 「戻し方が分からないので触りたくない」状態 |
| 中級 → 上級 | 報告書を読んで、確認が足りない箇所を自分で指摘できる | 報告書の「完了しました」をそのまま信じている |
逆に言えば、レベルを上げる近道は戻し方を先に覚えることです。戻せる状態を作ってから新しい作業を試すと、失敗が学習になります。戻せないまま挑戦すると、失敗が事故になります。
飛ばさない方がいいこと
- 対象URLと対象ファイルを決める
- 触らないファイルを明記する
- SEOタグ維持を指定する
- 公開HTMLで確認する
- 報告書を読む
- GitHub連携前に権限と秘密情報を確認する
確認チェックリスト
- 初級の確認だけ依頼を試した
- 中級の1ページ補強を試した
- 公開前チェックの見方を理解した
- 報告書を読める
- GitHub連携へ進む前の注意を確認した
- 人間確認を残している
権限の設定を、レベルの目安にする
Codexの公式ドキュメントでは、「サンドボックス(できること)」と「承認(確認を求める場面)」の2つで権限が決まります。次の組み合わせを、この記事の初級から上級に重ねて考えると整理しやすくなります(対応づけは編集部の目安です)。
| 目安 | 設定 | 公式の説明 |
|---|---|---|
| 初級 | --sandbox read-only --ask-for-approval on-request | ファイルを読み、読み取り専用の範囲でコマンドを実行できる |
| 中級 | --sandbox workspace-write --ask-for-approval on-request | 作業フォルダ内で読み書きと実行ができ、範囲外の編集やネットワークは承認が必要 |
| 使わない | --dangerously-bypass-approvals-and-sandbox | サンドボックスも承認もない(非推奨と記載) |
- Gitで管理しているフォルダでは、起動時に中級の設定が勧められます。管理していないフォルダでは読み取り専用が勧められます。
- 途中で変えるときは、CLIで
/permissionsを入力します。 - 作業フォルダの範囲は
/statusで確認できます。
出典:Agent approvals & security、Permissions(2026年11月6日に確認)。選べる設定は、バージョンや組織の設定で変わります。
段階ごとに覚えるスラッシュコマンド
CLI では、入力欄に / で始まるコマンドを打てます。次の対応づけは編集部の目安で、各コマンドの役割は公式の一覧に沿っています。
| 段階 | コマンド | 役割 |
|---|---|---|
| 初級 | /plan | 実装に入る前に、進め方の案を出させる。Codex が作業中は使えない |
| 初級 | /status | 会話のIDや、文脈をどれだけ使っているかを見せる |
| 中級 | /init | AGENTS.md のひな形を、今いるフォルダに作る |
| 中級 | /diff | Git の差分を、CLI の中で見る |
| 上級 | /review | 作業ツリーを点検し、動きの変化やテスト不足を中心に挙げる |
| 上級 | /goal | 続けて目指す目標を置く。/goal pause、/goal resume、/goal clear で止める・再開する・消す |
/review のあとに /diff を続けると、指摘された変更の中身を見られます。点検に使うモデルは、いまの会話のものが基本で、config.toml の review_model で変えられます。また /plan は、続けて依頼文を書いて、そのまま最初の相談にできます。
/init でできるのは、ひな形までです。公式も、できたファイルを自分のリポジトリの決まりに合わせて直し、コミットするよう案内しています。/plan は、最初の「確認だけ頼む」段階で、いきなり手を動かさせない手段にも使えます。
出典:OpenAI 公式「CLI and IDE commands」(2026年11月6日に確認)。
編集部の記録から分かる利用段階
編集部は2026年11月8日、Codex CLI 0.167.0をnpmで入れ、ChatGPT Plusのログインで使いました。画面に出たプランはplusでした。作業は、読むだけのread-onlyと、--cdで指定した作業フォルダだけを書き換えられるworkspace-writeに分けました。同日の0時から11時台に編集部の道具から94回呼び、1回の中央値は27.6秒でした。導入、読み取り、範囲を限った書き込み、使用量の確認という各段階は、この記録で確認できます。
昼前には5時間ごとの枠を99%まで使い、利用上限の表示後は2026年11月8日14時すぎまで使えませんでした。その時点の週の枠は15%で、残りはchatgpt.comの設定にあるusageページで見ました。一方、編集部員の習熟度、学習にかかった日数、94回の難易度別内訳は記録にないため不明です。この記録だけから初心者・中級者・上級者の境界を決めることもできません。
