Codex CLI の基本
2025/12 時点での Codex CLI に関する簡易マニュアルおよびTipsです。Claude Code などの Coding Agent を利用したことがある人を想定した内容になっています。
model の切り替え
/model で切り替えが可能です、2025/12 時点の筆者の環境では以下のモデルが利用可能でした。
Select Model and Effort
Access legacy models by running codex -m <model_name> or in your config.toml
› 1. gpt-5.2-codex (current) Latest frontier agentic coding model.
2. gpt-5.1-codex-max Codex-optimized flagship for deep and fast reasoning.
3. gpt-5.1-codex-mini Optimized for codex. Cheaper, faster, but less capable.
4. gpt-5.2 Latest frontier model with improvements across knowledge, reasoning and coding
Claude Code では契約するプランによって利用可能なモデルに差異がありますが、Codex の場合は プランに関わらず全てのモデルが利用できます。
mode(Approval)の切り替え
/approvals で切り替えが可能です。
Select Approval Mode
› 1. Read Only Requires approval to edit files and run commands.
2. Agent Read and edit files, and run commands.
3. Agent (full access) Codex can edit files outside this workspace and run commands with network access. Exercise caution when using.
通常は Agent を使用することが多いと思います。なお、Claude Code とは異なりシェルのコマンド単位（およびパラメータ）で allow/deny を指定することができません、やり方があれば教えてください。Agent で使用するとコマンドの実行確認がその都度表示されるので Claude Code の感覚で使用すると煩わしく感じることが多いです（セッション中は同一コマンドの実行を許可することもできます)。
Agent (full access) は所謂 dangerous mode です、こちらを使うとリスクと引き換えに煩わしさが減ります。
allow/deny 設定
~/.codex/rules に rule ファイルを追加することでコマンド単位で許可を制御可能です。
plan mode
2025/12 時点では Claude Code に存在する Plan Mode が Codex にはありません。代替手段として /approvals を使って一時的に read only に切り替えるという手があります。
Codexに「設計して」と指示してもいきなりコードの編集を始めちゃうことが多いので、面倒ですが read only に切り替えるのが無難な感じがします。
status
/status で各種設定・状態を確認できます。Approval や Sandbox の設定、Rate Limit などを確認できます。Codex の Rate Limit は 5h/Weekly の2種類あります。
/status
╭─────────────────────────────────────────────────────────────────────────────╮
│ >_ OpenAI Codex (v0.76.0) │
│ │
│ Visit https://chatgpt.com/codex/settings/usage for up-to-date │
│ information on rate limits and credits │
│ │
│ Model: gpt-5.2-codex (reasoning medium, summaries detailed) │
│ Directory: ~ │
│ Approval: on-failure │
│ Sandbox: workspace-write │
│ Agents.md: <none> │
│ Account: xxxxxx │
│ Session: xxxxxx │
│ │
│ Context window: 100% left (0 used / 272K) │
│ 5h limit: [████████████████░░░░] 82% left (resets 15:25) │
│ Weekly limit: [███████████████████░] 95% left (resets 10:25 on 27 Dec) │
│ Credits: 801 credits │
╰─────────────────────────────────────────────────────────────────────────────╯
Custom Prompts(Custom slash commands)
$CODEX_HOME/prompts/ (通常は ~/.codex/prompts/) に *.md を配置するとカスタムプロンプト（Claude Code のカスタムスラッシュコマンド相当）として利用できます。呼び出しは /prompt:xxx(.md) です。
Claude Code とは異なりプロジェクトのディレクトリに配置することはできないようです。
Skills (experimental)
つい最近 Skills に対応しました。筆者はまだ試していないので割愛します。
notify
タスク完了時などに通知するアレです。macOS で通知を表示するだけであれば以下のように config に追記するだけです。
notify = ["terminal-notifier", "-title", "Codex", "-message", "ターン終了"]
その他
-
/new: Claude Code の/clear -
/resume: resume
Claude Code との比較（主観）
筆者の主観としては、Claude Code（Anthropic 系）の Coding Agent よりも、Codex の方が設計面での指摘や判断が適切である場面が多い印象があります。
Claude Code は指示に対して忠実である反面、迎合的になりやすく、問題点の指摘や代替提案が弱いことがあります。一方、Codex（gpt-5 系）は理由を述べて提案を棄却する姿勢が見られ、複数設計案の比較検討に役立つ場面が多いです。
そのため、設計レビュー・トレードオフ検討といった用途では Codex を優先的に利用することが多いです。
Discussion