OpenAI Codex CLI 完全ガイド 2026年版｜インストールから拡張まで

OpenAI Codex CLI の導入から設定、動画・画像生成やウェブ検索との連携まで網羅した2026年版完全ガイド。ターミナルだけで完結する自律型コーディングの全手順を解説。

OpenAI Codex CLI は、ターミナル上で動作するエージェント型コーディングアシスタントです。機能の計画、リポジトリ全体にまたがるコードの記述、シェルコマンドの実行、そして成果物の納品まで、すべて自律的にこなします。

GitHub Copilot がインラインで提案を行うのに対し、Codex CLI は自律的に動作します。あなたが目標を伝えると、コードベースを読み込み、実装を計画し、ファイルを作成し、テストを実行して結果を報告します。すべてのループがターミナル内で完結します。

2026年における Codex CLI のすべて——インストール、設定、拡張、統合——を解説します。

OpenAI Codex CLI とは何か？

Codex CLI は OpenAI のエージェント型コーディングツールで、2025年4月にリリースされ、2026年を通じて継続的にアップデートされています。従来の「Codex」（API モデル）との最大の違いは、提案ではなく実際のアクションを実行する点です。

Codex CLI でできること：

リポジトリ全体をコンテキストとして読み込む（開いているファイルだけでなく）
コードを1行書く前に、複数ステップの実装を計画する
シェルコマンドを実行する（npm test、git commit、make build）
ディレクトリをまたいでファイルを作成・編集・リファクタリングする
テストが通るか、ブロッキング問題が発生するまでループし続ける

ネイティブではできないこと：

画像や動画の生成
ウェブ検索
クラウドへのファイル保存・共有
カスタム統合なしの外部 API 呼び出し

これらの制限は意図的なものです——そして拡張可能です。詳細は後述します。

Codex CLI を使ったターミナルベースのエージェント型コーディング環境で作業する開発者

Codex CLI のインストール方法

必要な環境： Node.js 18 以上、OpenAI API キー、macOS または Linux（Windows は WSL 経由）。最良の互換性のために Node.js 20 LTS を推奨します。

npm i -g @openai/codex

API キーを設定します：

export OPENAI_API_KEY=sk-...

セッションをまたいで持続させる場合は、シェルプロファイル（~/.zshrc、~/.bashrc）に追記してください。

インストールの確認：

codex --version

ターミナルでマルチステップのエージェントタスクを実行している Codex CLI の MacBook 画面

Codex CLI の設定方法

Codex CLI は ~/.codex/config.json を読み込みます。このファイルを作成または編集してください：

{
  "model": "gpt-4.5",
  "notify": true,
  "approvalMode": "suggest"
}

主な設定オプション：

オプション	値	効果
`model`	`gpt-4.5`、`o3`、`o4-mini`	計画とコード生成に使用するモデル
`approvalMode`	`suggest`、`auto-edit`、`full-auto`	承認なしに Codex がどこまで自律的に動作するか
`notify`	`true` / `false`	タスク完了時のデスクトップ通知
`context`	パスまたは `auto`	追加のコンテキストファイルを含める

approvalMode の詳細：

suggest——Codex は各変更を提案し、あなたが手動で承認します。本番リポジトリに最適。
auto-edit——Codex は承認なしでファイルを編集しますが、シェルコマンドの実行前には確認します。
full-auto——Codex が計画から実行まで全ループを自律的に処理します。隔離されたタスクやクリーンなブランチに最適。

Codex CLI のコア機能

拡張なしでの Codex の標準機能をご紹介します：

1. エージェント型コード実装

codex "Add a rate limiter middleware to the Express API — 100 req/min per IP, return 429 with Retry-After header"

Codex はプロジェクト構造を読み込み、適切なファイルを特定し、ミドルウェアを作成し、app.js に組み込み、テストを追加します。

2. リポジトリ全体のリファクタリング

codex "Migrate all fetch() calls in /src to use the axios wrapper in lib/http.js"

Codex はリポジトリ全体からすべての該当箇所を見つけ、一貫性を持って書き換え、テストスイートを実行します。

3. テスト生成

codex "Generate Jest tests for every exported function in /src/utils — aim for 80% branch coverage"

4. シェルコマンドのチェーン実行

Codex はコマンドを自然にチェーンできます：

npm run build && anycap video generate --prompt "product demo" --model veo-3.1 -o demo.mp4 && git add . && git commit -m "add demo"

各コマンドの出力を理解して適応します。npm run build が失敗した場合、続行するのではなくエラーを診断します。

5. ドキュメント生成

codex "Write a README for this project — setup instructions, API reference, and examples"

Codex CLI の拡張：ケイパビリティレイヤー

Codex はコーディングタスクに意図的にスコープを絞っています。動画生成、画像作成、ウェブ検索、クラウドストレージは組み込まれておらず、Codex がスキルや MCP サーバー経由で呼び出すケイパビリティレイヤーに存在します。

MCP サーバー

Model Context Protocol サーバーにより、Codex は外部ツールをネイティブ組み込みのように呼び出せます。各 MCP サーバーが1つの機能を担当します——動画 API、データベース、ブラウザ自動化ツールなど。

デメリット：各サーバーに独自のセットアップ、認証、メンテナンスが必要です。動画 + 画像 + 検索 + ストレージが必要なら、4つのサーバーが必要です。

スキル（CLI ベース）

スキルは Codex が認識してシェルコマンド経由で呼び出す CLI ツールです。最もシンプルな拡張モデル：CLI をインストールすれば、Codex がそれを呼び出せます。

AnyCap は、1回のインストールで機能ギャップ全体を埋めるスキルです——セットアップは60秒未満：

動画生成（Veo 3.1、Sora 2 Pro、Kling 3.0、Seedance 2.0）
画像生成（GPT Image 2、Seedream 5、Flux）
引用付きウェブ検索
クラウドストレージとファイル共有

npm i -g anycap
anycap login
anycap skill install --target ~/.codex/skills/anycap-cli/

インストール後、Codex はすべての anycap コマンドを利用可能なアクションとして認識します。

Codex + AnyCap でできること

プロダクトデモ動画の生成

anycap video generate \
  --prompt "a smooth walkthrough of a SaaS dashboard, clean UI, soft lighting" \
  --model veo-3.1 \
  -o demo.mp4

Codex が機能を実装し、AnyCap がデモを生成します。同じターミナルセッション内で。

→ 完全ガイド：Codex で動画を生成する方法

ビルド用の画像生成

anycap image generate \
  --prompt "product hero shot, dark UI, floating interface, product photography" \
  --model gpt-image-2 \
  -o hero.png

→ 完全ガイド：Codex で画像を生成する方法

生成したファイルの保存と共有

anycap drive upload demo.mp4

共有可能なリンクを返します。Codex はこれを生成するドキュメントに埋め込めます。

Codex CLI vs. Claude Code vs. Cursor

	Codex CLI	Claude Code	Cursor
主なインターフェース	ターミナル	ターミナル	IDE（VS Code）
モデル	GPT-4.5 / o3 / o4-mini	Claude 3.7 / 4	GPT-4o / Claude
リポジトリコンテキスト	リポジトリ全体	リポジトリ全体	ファイル/フォルダ範囲
シェル実行	あり	あり	限定的
エコシステム	OpenAI ネイティブ	Anthropic ネイティブ	マルチモデル
AnyCap サポート	✅ `~/.codex/skills/`	✅ `~/.claude/skills/`	✅ `~/.cursor/skills/`
最適な用途	OpenAI エコシステム、自律ループ	長い推論タスク、サブエージェント並列処理	IDE 内編集 + 生成

同じ anycap コマンドが3つのツールすべてで動作します——インストールパスは異なりますが、機能は同一です。

Codex CLI + OpenAI エコシステム：フルスタック

OpenAI でエンドツーエンドに構築する場合：

# 1. Research (web-grounded)
anycap search --prompt "competitor features for project management SaaS 2026" --citations

# 2. Plan + implement (Codex)
codex "Add the top 3 missing features identified in the research to our roadmap page"

# 3. Generate visuals (GPT Image 2, via AnyCap)
anycap image generate --prompt "roadmap hero, timeline graphic, product UI" --model gpt-image-2 -o roadmap-hero.png

# 4. Generate demo video (Sora 2 Pro, via AnyCap)
anycap video generate --prompt "product roadmap walkthrough" --model sora-2-pro --mode image-to-video --param images=./roadmap-hero.png -o demo.mp4

# 5. Store and share
anycap drive upload demo.mp4

Codex + GPT Image 2 + Sora 2 Pro + AnyCap 検索——すべて OpenAI ネイティブまたは OpenAI 互換で、1つの CLI を通じてルーティングされます。

よくある質問

Codex CLI は無料ですか？

Codex CLI のインストールは無料です。OpenAI アカウントの API 使用量に対して料金が発生します。モデルの選択によりコストが異なります——o4-mini は典型的なタスクで1セッションあたり約 $0.003〜0.01 程度、o3 は複雑な推論タスクに適しており約 $0.05〜0.15/セッションです。AnyCap は新規ユーザーに 250 クレジットを無料提供——約22回の画像生成または5本の短い動画を試すのに十分な量です。

Codex CLI と Codex API の違いは何ですか？

Codex API（2021〜2023年利用可能）はコード補完モデルでした——プロンプトを送り、補完を受け取るものです。Codex CLI（2025年〜）はエージェント型システムです：リポジトリを読み込み、実装を計画し、シェルコマンドを実行し、コードをエンドツーエンドで納品します。まったく異なるパラダイムです。

Codex CLI は Windows で動作しますか？

はい、WSL（Windows Subsystem for Linux）経由で動作します。ネイティブ Windows サポートは限定的で、WSL 2 + Ubuntu が推奨される方法です。

approvalMode: full-auto とは何ですか？いつ使うべきですか？

Full-auto は、Codex が各ステップで承認を求めることなく、ファイル編集・シェルコマンド・テスト実行を含む全計画を実行することを意味します。隔離された機能ブランチで使用し、メインブランチや本番リポジトリではレビューなしに使用しないでください。

Codex CLI と Claude Code を並行して使えますか？

はい。それぞれ独自の設定を持つ別々のツールです。一部のチームは、主な実装ループ（OpenAI モデル）に Codex を使い、長い推論タスクや並列サブエージェントワークフローに Claude Code を使っています。AnyCap はどちらでも同様に動作します。

Codex CLI に動画生成機能を追加するにはどうすればいいですか？

AnyCap をインストールして（npm i -g anycap && anycap login）、anycap skill install --target ~/.codex/skills/anycap-cli/ を実行します。その後、Codex は anycap video generate を利用可能なコマンドとして認識します。完全ガイド：Codex 動画生成。

まとめ

Codex CLI は 2026年において最も高性能なターミナルネイティブのコーディングエージェントです。インストールして設定すれば、計画・記述・テスト・コミットを1回の無人セッションで自律的に処理するコーディングループ全体を任せられます。

機能ギャップ——メディア生成、ウェブ検索、クラウドストレージ——は、AnyCap を1回インストールするだけで解消されます。同じ CLI、同じセッション、完全なパイプライン。Codex + AnyCap を使うチームは、以前は3〜4つの別々のツールを必要としていたコードから完成デモまでのサイクル（コード → 画像 → 動画）を、単一のターミナルセッションで完結できるようになったと報告しています。

→ Codex に全機能を追加する——AnyCap を無料でインストール

📖 次に読むべき記事

Codex で動画を生成する方法：2026年版完全ガイド — 動画生成パイプライン：Veo 3.1、Sora 2 Pro、Kling 3.0、Seedance 2.0。
Codex で画像を生成する方法：2026年版完全ガイド — Codex の画像生成：GPT Image 2、Seedream 5 など。
Codex ウェブ検索ガイド 2026 — Codex ワークフローにリアルタイムのウェブリサーチを追加する。
コーディングエージェント向け AI 動画モデル比較 2026 — Veo 3.1 vs Seedance vs Kling vs Sora：あなたのワークフローに最適なモデルは。
ケイパビリティランタイムとは？ — Codex にメディアと検索の機能を与えるインフラストラクチャレイヤー。

エージェント型 AI vs 従来型 AI：5つの重要な違い — ツールと自律性が次世代 AI を定義する理由。
AI エージェントとは？完全開発者ガイド — エージェントアーキテクチャ、ツールレイヤー、そして Codex のモデル内での位置づけ。

AnyCap チームが執筆しました。私たちは、1つの CLI で Codex、Claude Code、Cursor に動画・画像・検索・ストレージ機能を提供するケイパビリティランタイムを構築しています。

OpenAI Codex CLI：完全開発者ガイド（2026年版）