--- title: "Codex CLI 使い方完全ガイド｜インストールから実践活用【2026年最新】" description: "OpenAI Codex CLIのインストール方法、初期設定、基本コマンド、実践的な活用パターンを解説。Claude Codeとの比較、料金、トラブルシューティングまで。開発者向け完全ガイド。" url: "https://kylon.io/ja/blog/codex-cli-guide-2026" language: "ja" --- MEDIA AI活用の最前線 [HOME](https://kylon.io/ja)\>[ブログ](https://kylon.io/ja/blog)\>[AIコーディングツール](https://kylon.io/ja/blog/topics/ai-coding-tools)\>Codex CLI 使い方完全ガイド｜インストールから実践活用まで【2026年最新】 Guide2026年7月27日·18分で読める # Codex CLI 使い方完全ガイド｜インストールから実践活用まで【2026年最新】 OpenAIのCodex CLIのインストール方法、基本的な使い方、実践的な活用パターンを解説。Claude Codeとの違い、料金体系、セットアップのトラブルシューティングまで網羅します。 K Kylon編集部 コンテンツチーム · 18分で読める ## Codex CLI 使い方ガイド **結論:** Codex CLIはOpenAIが提供するターミナルベースのコーディングエージェントです。GPT-5.6モデルを搭載し、自然言語の指示からコードの生成・修正・リファクタリングを行います。インストールはnpmで1コマンド、OpenAI APIキーがあればすぐに使い始められます。 _※本記事の情報は2026年7月時点のCodex CLI仕様・料金に基づいています。最新情報は[OpenAI公式サイト](https://platform.openai.com/)でご確認ください。_ ## この記事の要点 - 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万トークンと手頃 KYLON公式LINE ### 仕事で使える生成AI情報を、LINEで毎週チェック 重要な生成AIニュースと、企業での活用事例をコンパクトにお届けします。営業、顧客対応、採用、バックオフィスで使える実務のヒントも、週ごとにまとめます。 [Kylon公式LINEを友だち追加](https://lin.ee/UM9AHkx) ![Kylon公式LINE QRコード](https://kylon.io/assets/line-qr.png)登録は無料です。配信停止はいつでもLINE上で設定できます。 ## 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に毎回説明し直す」必要がなくなります。 AIコーディングツールを業務に組み込みたいですか。Kylonでは、Claude CodeやCodex CLIを含む複数のAIを統合したワークスペースで、開発チームの生産性を向上させます。 [無料相談を予約する](https://cal.com/forms/5bd983bd-70e5-4afa-afd7-098b78cde6c3) ## 関連記事 [AIコーディングツールをもっと見る](https://kylon.io/ja/blog/topics/ai-coding-tools) [ ## Cursor 料金・使い方 ### Cursor 料金・使い方完全ガイド｜無料版・Pro・Businessの違い【2026年最新】 Cursorの料金、無料版と有料版の違い、導入から実務での使い方までを整理します。個人開発者とチームが選ぶべきプランも解説します。 Kylon編集部·2026年7月27日 ](https://kylon.io/ja/blog/cursor-pricing-guide-2026)[ ## Claude Code 使い方ガイド ### Claude Code 使い方ガイド｜始め方から料金、実務活用まで徹底解説【2026年最新】 Claude Codeの始め方、使い方、料金プランを初心者向けに解説。ターミナルやVS Codeからの利用方法、Pro/Max/Teamプランの違い、実務でのコスト管理まで、導入に必要な情報をまとめました。 Kylon編集部·2026年7月26日 ](https://kylon.io/ja/blog/claude-code-guide-2026)