Codex CLI 使い方完全ガイド｜インストールから実践活用まで【2026年最新】

結論: Codex CLIはOpenAIが提供するターミナルベースのコーディングエージェントです。GPT-5.6モデルを搭載し、自然言語の指示からコードの生成・修正・リファクタリングを行います。インストールはnpmで1コマンド、OpenAI APIキーがあればすぐに使い始められます。

※本記事の情報は2026年7月時点のCodex CLI仕様・料金に基づいています。最新情報はOpenAI公式サイトでご確認ください。

この記事の要点

• Codex CLIはnpmでインストール。Node.js 22以上が必要
• OpenAI APIキー（有料アカウント）で認証。ChatGPTサブスクリプションでも利用可能
• 3つの実行モード: suggest（提案のみ）、auto-edit（編集確認）、full-auto（完全自動）
• Claude Codeと比較して、GPT-5.6の3Dデザイン力と並列処理に強み
• API従量課金。Terraモデルなら入力2.50ドル/100万トークンと手頃

Codex CLIとは

Codex CLIは、OpenAIが2025年にオープンソースとしてリリースしたコーディングエージェントです。ターミナル上で動作し、自然言語での指示を受けてコードの生成、バグ修正、リファクタリング、テスト作成などを行います。2026年7月時点ではGPT-5.6モデル（Sol/Terra/Luna）を搭載しており、ChatGPTデスクトップアプリのCodexモードと同じモデルを利用できます。

インストール方法

前提条件

• Node.js 22以上がインストールされていること
• macOS 12以上、Ubuntu 20.04以上、またはWindows（WSL2経由）
• OpenAI APIキーまたはChatGPTサブスクリプション

インストール手順

npmを使ってグローバルにインストールします。

npm install -g @openai/codex

インストール後、バージョンを確認します。

codex --version

認証設定

APIキーを環境変数に設定します。

export OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx

永続化する場合は、.bashrcや.zshrcに追記してください。ChatGPTサブスクリプション（Plus/Pro/Max）を持っている場合は、codex --loginでブラウザ経由の認証も可能です。

基本的な使い方

対話モード（デフォルト）

プロジェクトディレクトリでcodexと入力すると対話モードが起動します。自然言語でやりたいことを伝えると、Codex CLIがコードの変更を提案します。

cd your-project && codex

ワンショットモード

特定のタスクを1回だけ実行したい場合は、コマンドラインで直接指示を渡します。

codex "ユーザー認証にMFAを追加して"

3つの実行モード

Codex CLIには、安全性と自動化のレベルが異なる3つの実行モードがあります。

• suggest（提案モード） — コードの変更を提案するだけで、ファイルは書き換えません。安全に試したいときに最適。デフォルトモード
• auto-edit（自動編集モード） — ファイルの変更は自動で適用しますが、シェルコマンドの実行前には確認を求めます。codex --approval auto-editで起動
• full-auto（完全自動モード） — ファイル変更もコマンド実行も自動で行います。サンドボックス内で動作するため安全ですが、変更内容は必ず確認してください。codex --approval full-autoで起動

実践的な活用パターン

パターン1: バグ修正

エラーメッセージをそのまま貼り付けると、Codex CLIが原因を特定して修正コードを提案します。

codex "このエラーを修正して: TypeError: Cannot read properties of undefined (reading 'map')"

パターン2: テスト作成

既存のコードに対してテストを自動生成します。

codex "src/utils/auth.ts のユニットテストをvitestで書いて"

パターン3: リファクタリング

コードの品質改善を指示できます。

codex "src/components/ のコンポーネントをReact Server Componentsに移行して"

パターン4: プロジェクト全体の分析

GPT-5.6の大規模コンテキストを活かして、プロジェクト全体を理解した上での作業が可能です。

codex "プロジェクト全体のアーキテクチャを説明して。改善すべき箇所があれば指摘して"

Codex CLI の料金

Codex CLIの料金は利用方法によって異なります。

• ChatGPTサブスクリプション経由 — Plus（月額20ドル）以上のプランに含まれる。プランの利用枠内で使用
• API従量課金 — GPT-5.6 Sol: 入力5ドル/出力30ドル、Terra: 入力2.50ドル/出力15ドル、Luna: 入力1ドル/出力6ドル（いずれも100万トークンあたり）
• 推奨 — 日常のコーディングにはTerraモデルが最もコストパフォーマンスが高い。難しい設計課題にはSolを使い分ける

Codex CLI vs Claude Code: どちらを選ぶべきか

2026年7月時点で、ターミナルベースのコーディングエージェントとして最も人気のある2つのツールを比較します。

• モデル — Codex CLI: GPT-5.6（Sol/Terra/Luna）、Claude Code: Opus 5/Sonnet 5
• コンテキスト — 両方とも100万トークン以上に対応
• デザイン力 — Codex CLIが優位。GPT-5.6はUI/3Dデザインの生成品質が高い
• コード品質 — Claude Codeが優位。特に複雑なロジックや長いコードベースの理解に強み
• 速度 — Codex CLIが優位。GPT-5.6 Terraは応答が速い
• 並列処理 — Codex CLI: ultra modeで4エージェント並列。Claude Code: 並列実行は手動管理
• 料金 — 同価格帯。日常業務にはCodex CLI Terra（2.50ドル/100万トークン）またはClaude Sonnet 5（3ドル/100万トークン）

結論としては、UIやフロントエンド開発にはCodex CLI、バックエンドや複雑なシステム設計にはClaude Codeという使い分けが合理的です。両方を場面に応じて使い分けるのが2026年の最適解です。

よくあるトラブルと解決方法

Q. インストール時にPermission deniedが出る

npmのグローバルインストールに管理者権限が必要な環境では、sudo npm install -g @openai/codexを実行するか、npmのプレフィックスを変更してください。

Q. APIキーを設定したのに認証エラーになる

APIキーの残高（クレジット）を確認してください。platform.openai.comの設定画面でクレジット残高が0になっていないか確認します。

Q. full-autoモードで予期しない変更が行われた

full-autoモードはサンドボックス内で動作しますが、作業ディレクトリ内のファイルは直接変更されます。重要なプロジェクトでは、gitで変更をコミットしてからfull-autoモードを使うことを推奨します。git stashで変更を退避させることもできます。

まとめ

• Codex CLIはnpm1コマンドでインストール。Node.js 22以上が必要
• 3つの実行モード（suggest/auto-edit/full-auto）で安全性を調整可能
• GPT-5.6搭載。UIデザインや3D関連の生成品質が高い
• Claude Codeとの使い分けが2026年の最適解。UI系はCodex、ロジック系はClaude
• API従量課金。日常業務にはTerraモデル（入力2.50ドル/100万トークン）が最適

一人でAIを使うのと、チームでAIを使うのは違う

個人でAIツールを使いこなせるようになっても、チーム全体の業務改善には限界があります。一人のプロンプトスキルが属人化し、ナレッジが共有されず、ツール間の転記作業が残る。これは「個人のAI活用」と「組織のAI活用」の構造的な違いです。

• 個人のAI活用 — 個人チャットで質問と回答を繰り返す。成果物はコピペで別のツールへ。ナレッジは個人の履歴に閉じる
• チームのAI活用（Kylon） — AIエージェントがチームメンバーとして参加。業務の文脈を記憶し、外部ツールと連携し、チーム全員がその成果を共有できる

Kylonは、AIエージェントをチームの一員として組み込むワークスペースです。エージェントがSlack、Gmail、Notion、スプレッドシートなどと直接連携し、業務の文脈を継続的に蓄積します。「AIに毎回説明し直す」必要がなくなります。