Codex CLIとは｜始め方・料金・コードを学習させない設定まで解説

Codex CLI（コーデックス）は、OpenAIが公開するオープンソースのAIコーディングエージェントです。ターミナルに自然言語で指示するだけで、コードの生成・編集・実行までをエージェントが進めます。本記事は「Codexとは何か」から、インストールと始め方、料金、安全性（コードを学習させない設定）、Claude Codeとの違いまでを、実際のコマンド付きで整理します。

まとめ

• 正体：OpenAI製のオープンソースCLI。ターミナルでコードを生成・編集・実行し、画像入力やMCPにも対応する。読み方はコーデックス。
• 始め方：npm install -g @openai/codex で導入し、codex で起動。初回にChatGPTアカウントまたはAPIキーでサインインする。
• 料金：CLI本体は無料。動かすにはChatGPTプラン（Plus／Pro／Business／Enterprise）かOpenAI APIキーが必要。
• 安全性：サンドボックスと承認ポリシーの2層で制御し、設定でコードをモデル学習に使わせない（オプトアウト）こともできる。
• Claude Codeとの違い：開発元・モデル・公開形態（OSSか否か）・プロジェクト指示ファイルが異なる。

以下で、それぞれを順に見ていきます。

Codex CLIとは（OpenAI製のオープンソースAIエージェント）

Codex CLIは、OpenAIがオープンソースで提供するコマンドライン型のAIコーディングエージェントです。チャットUIではなく開発者の作業場であるターミナルで動き、リポジトリの文脈を読んだうえでコードを書き換え、テストやコマンドの実行まで一連で代行します。「Codex（コーデックス）」はもともとOpenAIのコード生成モデル群の名称で、現在はこのエージェント製品全体を指す呼び名として使われています。

同じCodexでも、ブラウザのChatGPT上でクラウド実行する「Codex（クラウド版）」と、手元の端末で動く「Codex CLI」は別物です。本記事が扱うのは後者のローカルCLIです。

Codex CLIでできること

主な役割は、自然言語の指示からのコード生成・補完、既存コードの説明とリファクタリング、バグ修正、テスト追加、そしてシェルコマンドの実行です。たとえば codex "このリポジトリの構成を説明して" のように指示すると、ファイルを横断して要約します。スクリーンショットやUIスケッチを添付して画面から実装を起こすマルチモーダル入力、外部ツールを接続するMCP（Model Context Protocol）にも対応します。

インストールと初期設定

対応OS（macOS・Linux・Windows）

macOS・Linux・Windowsで動作します。Windowsはネイティブ実行のほかWSL2でも利用でき、環境によって前提や挙動が変わるため、導入前にWindows版とCLI版・macOS版の差異を確認しておくと迷いません。npmで入れる場合はNode.js 18以上が前提です。

インストール手順（npm／Homebrew／スクリプト）

導入方法は3通りあります。npmが最も汎用的で、macOSならHomebrew、依存を避けたいなら公式スクリプトが使えます。Node.jsが要るのはnpm導入のときだけで、Homebrewやスクリプトでの導入にNodeは不要です。

# npm（Node.js 18以上）
npm install -g @openai/codex

# Homebrew（macOS）
brew install --cask codex

# スクリプト（macOS / Linux）
curl -fsSL https://chatgpt.com/codex/install.sh | sh

CI など対話できない環境では CODEX_NON_INTERACTIVE=1 を付けると無人インストールになります。

サインイン（ChatGPTアカウントとAPIキー）

インストール後に codex を実行すると、初回だけサインインを求められます。認証は2通りで、ChatGPTアカウント（Plus／Pro／Business／Edu／Enterprise）でのログインか、OpenAIのAPIキー登録のいずれかです。普段ChatGPTの有料プランを使っているなら、追加費用なしでアカウント認証を選ぶのが手軽です。

基本的な使い方

対話モードと非対話実行（codex exec）

そのまま codex を起動すると対話モードに入り、指示と確認を往復しながら作業を進めます。一方、決まった処理を一括で流したいときは codex exec を使うと、応答を待たずにスクリプトやCIへ組み込めます。

# 対話モードで起動
codex

# 非対話で一括実行（CI・スクリプト向け）
codex exec "src のユーティリティにテストを追加して"

セッションの再開（codex resume）

長い作業を中断しても、codex resume で過去のセッションを呼び戻して続きから再開できます。直前の続きなら codex resume --last が手早いです。セッションを一覧・検索してブラウザから管理したい場合は、Codex Viewerでセッションを可視化・操作する方法も役立ちます。

画像・UIスケッチからのコード生成

Codex CLIはテキストだけでなく画像も受け取れます。画面のスクリーンショットや手書きのUIスケッチ、デザイン仕様を添付すると、それを読み取って初期実装やレイアウトのコードを起こします。デザインから試作までを一気通貫で進めたい場面で効きます。

安全性とデータの取り扱い

Codex CLIの安全性は、「何ができるか」を縛るサンドボックスと、「いつ確認するか」を決める承認ポリシーの2層で成り立ちます。ローカルのファイルやコマンドを触るツールだからこそ、ここを理解しておくと安心して任せられます。

サンドボックスと承認モード

サンドボックスは3段階です。読み取り専用の read-only、作業ディレクトリ内の書き込みを許す既定の workspace-write、制限を外す danger-full-access の順に権限が広がります。これと承認ポリシー（untrusted／on-failure／on-request／never）を組み合わせて、確認の頻度を調整します。確認を減らして自動で進めたいときは --full-auto が便利ですが、これは作業ディレクトリ内に限定した上での自動化です。設定は ~/.codex/config.toml に保存されます。

# ~/.codex/config.toml
approval_policy = "on-request"
sandbox_mode   = "workspace-write"

[sandbox_workspace_write]
network_access = false

プロジェクトごとの方針やコーディング規約は、ルートに置く AGENTS.md に書いておくと毎回読み込まれます（Claude Codeの CLAUDE.md に相当します）。

コードを学習させない設定（オプトアウト）

「自社コードをモデルの学習に使われたくない」場合は、設定で止められます。個人のChatGPTアカウントでは、設定→データコントロール→「すべての人のためにモデルを改善」をオフにすると、以降のやり取りが学習に使われなくなります。Codex側には環境全体を学習に使うかどうかの別トグルがあるため、両方を確認するのが確実です。なお、ChatGPT Business／Enterprise とAPI経由の利用は、既定でモデル学習に使われません。業務利用ならこれらのプランを選ぶ判断が、設定の手間を減らす近道になります。

Codex CLIの料金体系（プランとAPIの2系統）

Codex CLIのソフトウェア自体はオープンソースで無料です。費用が発生するのは、CLIを動かすための「ChatGPTプラン」か「OpenAI APIキー」のどちらかです。

個人ならPlus（月額20ドル）が入口です。2026年4月の改定でメッセージ数制からトークン量に応じたクレジット消費へ移行しており、消費ペースはモデルや作業量で変わります。枠や単価は変動が速いので、契約前に公式の料金ページで最新の条件を確認してください。

Codex CLIとClaude Codeの違い

ターミナル型エージェントの比較対象としてよく挙がるのがAnthropicのClaude Codeです。どちらもターミナルで動き、MCPやサンドボックスに対応する点は共通で、差が出るのは開発元・モデル・公開形態と、プロジェクト指示の作法です。

選び分けの目安はシンプルです。普段ChatGPTの有料プランを使っていてOSSの中身を確認しながら使いたいならCodex CLI、Claude系モデルの回答品質を主軸に据えたいならClaude Code、という基準で十分です。両方を併用し、タスクごとに使い分ける開発者も少なくありません。

よくある質問

Codexの読み方は？

「コーデックス」です。古い写本を意味する英単語に由来し、OpenAIのコード生成モデル群の名称として使われています。

Codex（クラウド版）とCodex CLIの違いは？

クラウド版はChatGPT上でタスクをOpenAIのクラウド環境に投げて非同期で進めるエージェント、CLIは手元の端末で動かすローカルツールです。同じ作業をどこで実行するかが異なります。

Codex CLIをアップデートするには？

npmで入れたなら npm install -g @openai/codex@latest、Homebrewなら brew upgrade --cask codex で最新版に更新できます。

日本語に対応していますか？

対応しています。日本語のプロンプトで指示でき、応答や説明も日本語で返せます。応答言語を固定したい場合は、AGENTS.md に「日本語で回答する」と書いておくと安定します。

既存プロジェクトにどう導入する？

対象プロジェクトのルートディレクトリで codex を起動するだけです。規約や前提は AGENTS.md に書いておくと、毎回の指示が短くなります。あわせて、Vibe Kanbanについても解説しています。

関連記事

• Windows版Codexの正体とCLI版・macOS版との根本的な3つの差異
• Codex Viewerとは？Codexのセッション・履歴・アーカイブをブラウザ管理する方法【2026年版】
• 最新ツール『Codex Monitor』とは何か？概要・特徴と活用シーンを徹底解説
• Codex Skillsとは何か？AIエージェントを拡張する最新機能の全貌と開発背景を詳しく徹底解説