---

name: codex-cli-knowledge description: OpenAI Codex CLI の仕様と使い方に関する知識を提供。モデル選択、推論レベル、承認モード、サンドボックス、組み込みツール、スラッシュコマンド、設定方法について回答。Use when user asks about Codex CLI, codex command, approval mode, sandbox, AGENTS.md, codex configuration, /model, /review, /compact, apply_patch, or reasoning level. Also use when user says Codex CLI について, codex の使い方, 承認モード, 推論レベル. context: fork

Codex CLI Knowledge

OpenAI Codex CLI の仕様と使い方に関する包括的な知識を提供するスキル。

概要

OpenAI Codex CLI は、ターミナル上で動作する軽量なコーディングエージェント。ChatGPT レベルの推論能力に加え、コードの実行、ファイル操作、依存関係のインストールなどを自動で行う機能を備える。

---

インストール方法

npm（推奨）

Copynpm install -g @openai/codex

Homebrew（macOS）

Copybrew install --cask codex

その他のパッケージマネージャー

Copy# yarn
yarn global add @openai/codex

# pnpm
pnpm add -g @openai/codex

# bun
bun install -g @openai/codex

システム要件

---

利用可能なモデル

注意: モデル名は頻繁に更新されます。最新のモデル一覧は /model コマンドで確認してください。

推論レベル（Reasoning Effort）

各モデルは複数の推論レベルをサポート:

モデル選択のベストプラクティス

サポートされるプロバイダー

Codex CLI は OpenAI Chat Completions API 互換の複数のプロバイダーをサポート:

モデル変更方法

Copy# コマンドラインで指定
codex --model gpt-5.2-codex-max "タスクを実行"

# インタラクティブモードで変更
/model

---

組み込みツール

Codex CLI が内部で使用するツール一覧:

ファイル操作ツール

シェル・実行ツール

計画・連携ツール

ツール使用のベストプラクティス

• 単一ファイル編集: apply_patch を使用（差分形式で安全）
• ファイル検索: grep_files + rg（ripgrep）を優先
• 複数ファイル変更: シェルスクリプトを活用

---

スラッシュコマンド

インタラクティブモードで使用可能なコマンド:

モデル・設定

セッション管理

開発支援

ツール・その他

---

承認モード（セキュリティモデル）

Codex CLI の中核機能。操作の自動実行レベルを制御する。

承認ポリシー（--ask-for-approval）

ユーザーフレンドリーなモード名

承認モードの選択

Copy# デフォルト（untrusted）
codex "タスク"

# 承認ポリシーを明示的に指定
codex --ask-for-approval on-request "タスク"
codex -a on-failure "タスク"

# Full Auto モード（ショートカット）
codex --full-auto "タスク"
# 上記は以下と同等:
# codex --ask-for-approval on-request --sandbox workspace-write "タスク"

---

サンドボックス機能

サンドボックスモード

ネットワークアクセス

承認ポリシー

macOS サンドボックス

• Apple Seatbelt（sandbox-exec）でラップ
• 読み取り専用ジェイルで実行
• $PWD、$TMPDIR、~/.codex のみ書き込み可能
• ネットワークは完全ブロック

Linux サンドボックス

• Docker によるサンドボックス推奨
• iptables/ipset ファイアウォールで OpenAI API 以外の通信をブロック

---

プロジェクトドキュメント（AGENTS.md）

Codex は以下の場所から AGENTS.md を読み込み、コンテキストを取得:

AGENTS.md の役割

• プロジェクト固有の指示をエージェントに提供
• コーディング規約、ライブラリの使い方などを記述
• Claude Code の CLAUDE.md に相当

作成・無効化

Copy# AGENTS.md を作成
/init

# コマンドラインで無効化
codex --no-project-doc "タスク"

# 環境変数で無効化
export CODEX_DISABLE_PROJECT_DOC=1

---

設定方法

設定ファイルの場所

Copy~/.codex/config.toml  # メイン設定
~/.codex/config.yaml  # または YAML 形式
~/.codex/config.json  # または JSON 形式

基本設定パラメータ

設定例（YAML）

Copymodel: gpt-5.2-codex
approvalMode: suggest
fullAutoErrorMode: ask-user
notify: true

カスタムプロバイダー設定

Copymodel: gpt-5.2-codex
provider: openai
providers:
  openai:
    name: OpenAI
    baseURL: https://api.openai.com/v1
    envKey: OPENAI_API_KEY
  ollama:
    name: Ollama
    baseURL: http://localhost:11434/v1
    envKey: OLLAMA_API_KEY

環境変数

---

主要コマンドとオプション

基本コマンド

サブコマンド

exec サブコマンドのオプション

主要フラグ

追加フラグ

---

Git 操作の安全性

Codex CLI は Git 操作において安全性を重視:

絶対に自動実行しない操作:

• git reset --hard
• git checkout --（変更の破棄）
• 既存の変更の勝手なリバート

条件付きで実行:

• git commit --amend - 明示的に要求された場合のみ

---

よくある質問

Q: モデルを変更するには？

Copycodex --model gpt-5.2-codex-max "タスク"

または /model コマンドで選択。

Q: 推論レベルを上げるには？

/model コマンドでモデルと推論レベルを選択。

Q: 承認モードを変更するには？

Copycodex --approval-mode auto-edit "タスク"

Q: 他のプロバイダー（Ollama など）を使うには？

Copycodex --provider ollama --model llama3 "タスク"

Q: CI/CD で使用するには？

Copycodex -q --json "タスク"

Q: コンテキストが長くなりすぎたら？

/compact コマンドで会話を要約。

Q: ファイルを安全に編集するには？

apply_patch ツールが推奨（差分形式で編集）。