Codex CLI 完全ガイド
ターミナルの
AIエージェントを使いこなす

リポジトリのルート（または ~/.codex/）に AGENTS.md を置くと、Codex が毎回そのルール・前提・コーディング規約を読んでから作業する。「日本語で説明して」「テストは vitest で」などを書いておけば毎回指示する手間が消える。CLI・VS Code 拡張・Desktop で同じ設定が共有される。

使うモデル、デフォルトの承認モード、MCP サーバなどを config.toml に集約できる。毎回オプションを打たずに「自分の標準設定」で起動できるようになる。

config.toml に STDIO / HTTP の MCP サーバを登録するか、`codex mcp` コマンドで管理すると、セッション開始時に自動で立ち上がり、その外部ツール（DB・検索・社内APIなど）を組み込みツールと並べて使えるようになる。

.agents/skills/（プロジェクト用）または ~/.codex/skills/（ユーザー用）に、SKILL.md（YAML の説明 + 手順）を置いたフォルダを作ると、定型作業を「スキル」として呼び出せる。リリース手順やレビュー観点など、毎回同じ流れの作業に効く。

Q. codex コマンドが見つからない

A. グローバルインストール（npm install -g @openai/codex）が通っているか、`node -v` が18以上かを確認。`codex doctor` でも検出できる。

Q. 英語で返ってくる

A. AGENTS.md に「常に日本語で回答する」と書くか、最初の指示で言語を指定する。プロジェクト単位で固定できる。

Q. 勝手にファイルを書き換えて怖い

A. 承認モードを suggest か auto-edit に下げる。full-auto は変更前にバックアップ（git コミット）してから使う。

Q. Windows で TUI の表示が崩れる

A. 最新版に更新する。tmux 利用時の Shift+Enter など一部は新しいバージョンで順次修正されている。

• ▸ GPT-5.3-Codex モデル正式対応 — OpenAI の最新コーディング特化モデル
• ▸ Sites 機能（プレビュー）— Codex 内から Web アプリを作成・デプロイ・検査
• ▸ Record & Replay（macOS）— 操作録画で再利用可能なスキルに変換
• ▸ 役割別プラグイン6種（Data Analytics/Creative/Sales/Product Design/Public Equity/Investment Banking）
• ▸ Claude Code からの設定インポートに対応（Migrate to Codex フロー）
• ▸ Browser Use が Chrome DevTools Protocol 経由で最大2倍高速化
• ▸ Computer Use が Enterprise 向けに提供開始
• ▸ ローカル↔リモートホスト間でスレッドをハンドオフ可能に

• ▸ TUI（ターミナルUI）の大幅刷新 — セッション情報・トークン使用量をリアルタイム表示
• ▸ @ メンション検索がファイル/ディレクトリ/プラグイン/スキルを一括検索可能に
• ▸ プラグインマーケットプレイス CLI コマンド追加
• ▸ `codex doctor` コマンド新設 — 環境・認証・ネットワーク設定の診断
• ▸ Python SDK が `openai-codex` / `openai_codex` パッケージ名に統一
• ▸ Windows の tmux で Shift+Enter が効かないバグを修正

• ▸ リモートワークフローに daemon-managed remote-control を追加
• ▸ プラグインフックをデフォルト有効化
• ▸ ワークスペースのバケット管理を改善
• ▸ URL表示の折り返しバグを修正

• ▸ ライトモードでの選択コントラストを修正
• ▸ /review でのMCPスタータスステータス表示を改善
• ▸ Markdown テーブルのレスポンシブ対応を強化
• ▸ Chrome 拡張版 Codex との統合を開始

• ▸ GPT-5 シリーズモデルのサポートを追加
• ▸ マルチターン並列ルーティングをPython SDKに実装
• ▸ 承認モードの設定をセッション間で保存
• ▸ ネットワーク承認履歴のテキスト表示を改善