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

Codex CLI は `~/.codex/config.toml` を使用します。インストール済みバージョンのオプションは `codex --help` で確認してください。利用可能なモデルはアカウントと環境によって異なります。古い例のモデル名をそのまま使わないでください。

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

Codex は OpenAI のコーディングエージェントで、ターミナル、IDE、デスクトップ、クラウドの各ワークフローで利用できます。ローカルと worktree のタスクは自分のコンピューターで、クラウドのタスクはリモート環境で実行されます。OpenAI の環境ドキュメントを参照してください。

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

OpenAI Codex CLI とは何か？

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

Codex CLI でできること：

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

Codex の機能は環境と有効なツールによって変わります。OpenAI は画像生成と Web 検索を説明しています。AnyCap はモデル選択と CLI ワークフローを補完できます。

codex --search "Find the official migration guide for this project"

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

Codex CLI のインストール方法

公式の手順でインストールし、codex login でログインしてください。API キーは別の認証方法であり、Codex を利用する唯一の方法ではありません。

npm i -g @openai/codex

codex login
codex --help

インストールの確認：

codex --version

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

Codex CLI の設定方法

Codex CLI は ~/.codex/config.toml を使用します。インストール済みバージョンのオプションは codex --help で確認してください。利用可能なモデルはアカウントと環境によって異なります。古い例のモデル名をそのまま使わないでください。

サンドボックス権限と承認ポリシーは別の設定です。変更前に現在の設定を確認してください。設定と対応プラットフォームは 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

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

5. ドキュメント生成

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

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

MCP サーバー

Skill は手順を記述し、スクリプトやリソースを参照できます。MCP サーバーはツールを提供し、複数の機能をまとめて公開できます。必要な CLI は別途インストールと認証を行い、現在のタスクで利用できるツールを確認してください。

ネイティブツールと外部連携のどちらも完全なワークフローを支援できます。特定のモデル、明示的な CLI 操作、配信機能が必要な場合に AnyCap を追加してください。

npm i -g anycap
anycap login
anycap --version
anycap status

AnyCap setup · MCP

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

Cursor Agent は Web 検索、ブラウザツール、画像入力、ネイティブ画像生成を提供します。公式ツールドキュメントと現在の環境を確認してください。AnyCap はモデル選択と再実行可能な CLI ワークフローのための任意のインターフェースです。

Claude Code はターミナルなどの開発環境で、ファイル編集、コマンド実行、調査ツールを提供します。対応環境と機能は公式概要を確認してください。すべての利用形態をテキスト専用で Web 調査不可と説明するのは不正確です。

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

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

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

# 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 CLI は無料ですか？

プランと課金は最新の OpenAI 料金ドキュメントを確認してください。費用はプラン、モデル、使用量に依存します。固定のセッション単価や試用クレジットは保証しません。

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

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

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

Codex: sandbox / approval policy

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 に全機能を追加する——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 のモデル内での位置づけ。

ネイティブツールと外部連携のどちらも完全なワークフローを支援できます。特定のモデル、明示的な CLI 操作、配信機能が必要な場合に AnyCap を追加してください。 AnyCap チームが執筆しました。私たちは、1つの CLI で Codex、Claude Code、Cursor に動画・画像・検索・ストレージ機能を提供するケイパビリティランタイムを構築しています。

anycap drive upload <file> で既存のファイルを1つアップロードし、返されたノード ID を確認します。共有は別の操作です。anycap drive share <node-id> でリンクと期限を確認してください。確認済みの CLI には drive download やアップロード用の --name、--format url はありません。Drive と Page の文書を参照してください。

anycap page deploy <path> で HTML ファイルや静的ディレクトリからバージョンを作成し、結果を確認します。anycap page publish <page-id> は検証済みバージョンを公開します。公開する意図がある場合は page deploy ... --publish で両方を実行できます。実際に返されたサイト ID と URL を使ってください。公開ガイドを参照してください。

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