Codex practical hub

Codexの使い方 初級・中級・上級ガイド

Codexをいきなり大きな本番作業に使わず、初級、中級、上級の順番で安全に広げるための読み順ページです。

このサイトは、CodexやGitHubを実務で使うための実践ガイドです。機能、料金、利用条件、連携条件は変わる可能性があるため、最新情報が必要な場合は提供元の情報を確認してください。

このページで分かること

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サンドボックスも承認もない(非推奨と記載)
  1. Gitで管理しているフォルダでは、起動時に中級の設定が勧められます。管理していないフォルダでは読み取り専用が勧められます。
  2. 途中で変えるときは、CLIで /permissions を入力します。
  3. 作業フォルダの範囲は /status で確認できます。

出典:Agent approvals & security、Permissions(2026年11月6日に確認)。選べる設定は、バージョンや組織の設定で変わります。

段階ごとに覚えるスラッシュコマンド

CLI では、入力欄に / で始まるコマンドを打てます。次の対応づけは編集部の目安で、各コマンドの役割は公式の一覧に沿っています。

段階コマンド役割
初級/plan実装に入る前に、進め方の案を出させる。Codex が作業中は使えない
初級/status会話のIDや、文脈をどれだけ使っているかを見せる
中級/initAGENTS.md のひな形を、今いるフォルダに作る
中級/diffGit の差分を、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回の難易度別内訳は記録にないため不明です。この記録だけから初心者・中級者・上級者の境界を決めることもできません。

関連ページ

EDITED & REVIEWED

編集・検証情報

編集責任
運営者 ちんあなご編集部
書き方の基準
編集・検証方針
最終確認
(本文を最後に直した日)
更新履歴
(本文を書き足した・直した日。新しい順)

公式情報、実際の操作で確かめたこと、運営者の判断を区別して記載しています。サービスの画面、料金、利用上限、提供地域は変わる場合があるため、重要な操作の前に公式資料と現在の画面を確認してください。