Codex CLI Knowledge

Codex CLI Knowledge

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

最新バージョン: v0.116.0（2026-03-19）

概要

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

インストール方法

npm（推奨）

npm install -g @openai/codex

Homebrew（macOS）

brew install --cask codex

直接インストールスクリプト（v0.106.0+、macOS/Linux）

# npm なしでインストール可能
curl -fsSL https://codex.openai.com/install.sh | sh

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

# yarn
yarn global add @openai/codex

# pnpm
pnpm add -g @openai/codex

# bun
bun install -g @openai/codex

Windows インストーラー（v0.110.0+）

Windows ネイティブインストーラーが利用可能。PowerShell 環境で直接動作。

システム要件

認証

ChatGPT プラン（メイン）

ChatGPT のサブスクリプション（Plus/Pro/Team/Edu/Enterprise）で利用可能。

codex login

ブラウザで OAuth 認証を完了。

Device-code auth（ヘッドレス環境）

SSH やコンテナなどブラウザが利用できない環境:

codex login --device-code

表示されるコードを別のデバイスで入力して認証。

v0.116.0 で App-server TUI がデバイスコードによるサインインとトークン更新に完全対応。

codex app コマンド（デスクトップアプリ）

codex app

macOS / Windows デスクトップアプリを起動。CLI と同期する GUI 環境を提供。

認証情報の保存

• ~/.codex/auth.json またはシステムキーチェーンに分離保存

利用可能なモデル

注意: gpt-5.4 を標準使用すること。サブエージェント用途には gpt-5.4-mini も有効。

推論レベル（Reasoning Effort）

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

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

モデル変更方法

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

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

Plan モード（v0.94.0 デフォルト有効化）

概要

実装前に計画を策定するモード。v0.94.0 以降デフォルトで有効。

使い方

/plan

• Plan モードの推論 effort: medium（通常実行時より軽量）
• Shift+Tab でモード切り替え: Plan → Act → Auto（サイクル）

/collab コマンド（v0.114.0+）

3つのコラボレーションモードを選択可能:

動作

1. Plan モードで計画を策定
2. ユーザーが承認
3. Act モードで実行

マルチエージェント協調（v0.90.0+、v0.115.0 一般公開）

概要

複数のサブエージェントを並列で起動し、複雑なタスクを分割処理する機能。v0.115.0 でサブエージェント機能が一般公開。

設定

プリセットエージェント（v0.115.0+）

カスタムエージェント定義（v0.115.0+）

~/.codex/agents/ に TOML ファイルで独自エージェントを定義可能:

# ~/.codex/agents/reviewer.toml
[agent]
name = "reviewer"
role = "code reviewer"
tools = ["read_file", "grep_files", "list_dir"]
model = "gpt-5.4"

AGENTS.md でのロール定義（v0.102.0+）

# AGENTS.md で定義
agents:
  explorer:
    role: "read-only explorer"
    tools: [read_file, grep_files, list_dir]
  implementer:
    role: "code writer"
    tools: [apply_patch, shell, read_file]

CSV マルチエージェントファンアウト（v0.105.0+）

spawn_agents_on_csv による並列タスク実行。進捗/ETA 表示付き。

スレッドフォーク（v0.107.0+）

現在のスレッドをサブエージェントにフォーク可能。コンテキストを引き継いで並列作業。

TUI 個別承認（v0.110.0+）

サブエージェントの動作を TUI 上で個別に承認/拒否。

サブエージェント高速化（v0.110.0+）

シェル状態の再利用で起動を大幅高速化。

Git Worktree 隔離

各エージェントが独立 Git Worktree で作業し、コード競合を防止。

有効化方法

# ~/.codex/config.toml
[experimental]
multi_agent = true

または /experimental コマンドでトグル。

メモリ管理システム（v0.97.0+）

スラッシュコマンド

特徴

• ローカル永続化（~/.codex/memory/）
• セッション間で情報を保持
• シークレットサニタイザー: 機密情報（API キー等）を自動的にフィルタリング
• 差分ベース忘却アルゴリズム（v0.106.0+）: メモリ管理の精度向上
• ワークスペーススコープのメモリ書き込み対応（v0.110.0+）

デバッグ

# メモリのデバッグクリア（v0.107.0+）
codex debug clear-memories

注意: 旧 get_memory ツールは削除済み。スラッシュコマンドに移行。

パーソナリティ設定（v0.94.0 Stable）

概要

Codex CLI の応答スタイルをカスタマイズ。

プリセット

設定方法

/personality

利用可能なパーソナリティを選択。AGENTS.md にプロジェクト専用の性格・規約を記述可能。

Steer モード（v0.98.0 Stable）

概要

タスク実行中の入力方法を変更するモード。デフォルトで安定版として統合。

動作

• Enter: 即送信（リアルタイム介入）
• Tab: フォローアップキューに追加（次ステップへの指示を予約）

破壊的変更

v0.98.0 以前は Enter でフォローアップキュー、Tab+Enter で送信だったが、動作が逆転。

プラグインシステム（v0.110.0+）

概要

スキル、MCP エントリ、アプリコネクタをロードするプラグイン機構。

機能

• スキル、MCP サーバー、アプリコネクタのインストール
• @plugin メンション（v0.112.0+）: チャット内でプラグインを直接参照
• 不足プラグインのインストール補助プロンプト（v0.116.0+）
• マーケットプレイスからの MCP スキル直接インストール

フックエンジン（v0.114.0+）

概要

Codex CLI のライフサイクルイベントに対してユーザー定義のアクションを実行する機能。

対応イベント

userpromptsubmit フック

プロンプト実行前にブロック/拡張が可能。既存ワークフローへの介入ポイントを提供。

組み込みツール

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

ファイル操作ツール

シェル・実行ツール

JavaScript REPL（v0.100.0+）

• js_repl はツールコール間で状態（変数、関数定義等）を保持
• 計算、データ変換、プロトタイピングに有用
• /experimental コマンドからも利用可能（v0.106.0+）

計画・連携ツール

マルチモーダルカスタムツール（v0.107.0+）

画像等の構造化出力を返却可能なカスタムツール。

統合ターミナル読み取り（v0.114.0+）

実行中サーバーの状態やビルドエラーを直接確認可能。

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

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

MCP（Model Context Protocol）連携

概要

MCP サーバーとの双方向連携。GitHub、Figma、Sentry 等と直接接続。

設定（config.toml）

# ~/.codex/config.toml
[mcp_servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "./src"]

[mcp_servers.github]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
env = { GITHUB_TOKEN = "your_token_here" }

Codex を MCP サーバー化

# 他の AI エージェントから Codex を利用可能に
codex mcp-server

MCP サーバー一覧

# 有効な MCP サーバーの確認（v0.109.0+）
codex mcp list

動的接続（v0.115.0+）

設定リロードなしで実行中セッションが新 MCP サーバーを認識。

スラッシュコマンド

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

モデル・設定

セッション管理

計画・開発支援

メモリ・パーソナリティ

ツール・その他

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

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

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

注意: on-failure は v0.102.0 で非推奨化。使用しないこと。

Smart Approvals（v0.93.0 デフォルト有効化）

• 安全と判断された操作を自動承認
• デフォルトで有効
• "Allow and remember" でセッションスコープの承認を記憶

権限の永続化（v0.114.0+）

承認された権限がターンをまたいで保持される。

request_permissions ツール（v0.113.0+）

実行中のターンで動的に追加権限を要求可能。

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

承認モードの選択

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

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

# Full Auto モード（ショートカット）
codex --full-auto "タスク"

サンドボックス機能

サンドボックスモード

ReadOnlyAccess ポリシー

• ファイル読み取りのみ許可
• コードレビューや調査に最適

macOS サンドボックス

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

Linux サンドボックス

• bwrap（Bubblewrap）によるサンドボックス
• Docker ベースのサンドボックス（v0.107.0+）
• AppArmor 環境への対応（v0.116.0+）
• コンテナレスでの軽量隔離
• ファイルシステム・ネットワークの制限

Windows サンドボックス（v0.115.0+）

• ネイティブ Windows サンドボックス対応
• PowerShell 環境での安定動作
• unified_exec IPC 基盤

ネットワークサンドボックス

SOCKS5 プロキシ

# 環境変数で設定
export WS_PROXY=socks5://localhost:1080
export WSS_PROXY=socks5://localhost:1080

構造化ネットワーク承認

• ドメイン単位でのネットワーク許可
• ポート・プロトコルの制限

サンドボックス設定（config.toml）

[sandbox]
allowed_commands = ["ls", "git diff", "npm test"]
blocked_commands = ["rm -rf", "curl", "wget"]
restrict_to_workspace = true

音声機能

音声ディクテーション（v0.105.0+）

TUI 内でスペースキー長押しにより音声入力が可能。

オーディオ制御（v0.107.0+）

リアルタイム音声セッションでのマイク/スピーカーの選択と設定保存。

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

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

AGENTS.md の役割

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

フォルダ信頼（v0.115.0+）

未信頼ディレクトリでの実行が制限される。初回アクセス時に信頼確認。

作成・無効化

# AGENTS.md を作成
/init

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

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

設定方法

設定ファイルの場所

~/.codex/config.toml   # メイン設定（推奨、TOML 形式に移行）
.codex/config.toml     # プロジェクト設定
~/.codex/auth.json     # 認証情報（設定から分離）

注意: JSON / YAML 形式も引き続きサポートされるが、TOML への移行を推奨。

マルチプロファイル（v0.115.0+）

# ~/.codex/config.toml

[general]
default_profile = "dev"
log_level = "info"

[profiles.dev]
model = "gpt-5.4"
temperature = 0.2
approval_policy = "on-request"
sandbox_mode = true

[profiles.creative]
model = "gpt-5.4"
temperature = 0.9
approval_policy = "never"
sandbox_mode = false

基本設定パラメータ

設定例（TOML）

model = "gpt-5.4"
approvalMode = "suggest"
fullAutoErrorMode = "ask-user"
notify = true

設定の優先順位

コマンドライン引数 > プロファイル > プロジェクト設定 > ユーザー設定

環境変数

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

基本コマンド

サブコマンド

codex exec の詳細

# 非対話型でファイル修正
codex exec --full-auto "Fix all TypeScript errors"

# 標準入力から指示
echo "Add error handling to main.ts" | codex exec -

# 最終出力をファイルに書き出し（v0.109.0+）
codex exec --last-message-file output.txt "タスク"

主要フラグ

TUI（ターミナル UI）

テーマ（v0.105.0+）

/theme コマンドでライブプレビュー付きのテーマ選択。シンタックスハイライト対応。

App-Server アーキテクチャ（v0.115.0+）

TUI が App-server 上に配置される新アーキテクチャ。

ヘルスチェック（v0.114.0+）

/readyz、/healthz エンドポイント。CI/CD 連携用。

Git 操作の安全性

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

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

• git reset --hard
• git checkout --（変更の破棄）
• 既存の変更の勝手なリバート
• git push --force（v0.102.0+ で強化）

条件付きで実行:

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

codex apply の改善（v0.108.0+）:

• git apply --3way を利用した競合解決に対応

実験的機能

コードモード（v0.114.0+）

隔離環境でのコーディング作業に特化したワークフロー。

codex --mode code

/fast トグル（v0.110.0+）

高速/フレックスサービスティアの永続的な切り替え。

破壊的変更

approval_policy: on-failure 非推奨（v0.102.0）

• on-failure ポリシーは非推奨
• on-request への移行を推奨

get_memory ツール削除

• 旧 get_memory ツールは削除済み
• /m_update、/m_drop スラッシュコマンドに移行

Steer モードで Enter の動作変更（v0.98.0）

• Enter: 即送信（旧: フォローアップキュー）
• Tab: フォローアップキュー（旧: 送信）

Git 操作の安全性強化（v0.102.0）

• git push --force の自動実行をブロック
• より厳格な破壊的操作の検出

TUI App-Server 移行（v0.115.0+）

• 古いターミナルエミュレータで表示崩れの可能性

コンテキスト除外設定のデフォルト化（v0.116.0）

• 一部スキル/エージェントが初期コンテキストから除外
• 復元には設定変更が必要

フォルダ信頼の導入（v0.115.0+）

• 未信頼ディレクトリでの実行が制限される

よくある質問

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

codex --model gpt-5.4 "タスク"

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

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

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

Q: Plan モードを使うには？

/plan

または Shift+Tab でサイクル切り替え。/collab で3モードから選択も可能。

Q: メモリを管理するには？

/m_update   # 追加・更新
/m_drop     # 削除
codex debug clear-memories  # デバッグクリア

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

codex -q --json "タスク"
codex exec --full-auto "タスク"

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

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

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

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

Q: Codex を MCP サーバーとして使うには？

codex mcp-server

Q: カスタムエージェントを定義するには？

~/.codex/agents/ に TOML ファイルを作成、または AGENTS.md で定義。

Q: プロファイルを切り替えるには？

codex --profile creative "タスク"