Codex CLI 使い方｜インストール・料金・AGENTS.md・Claude Codeとの違い【2026年最新】

ターミナルから動くAIコーディングエージェントを探していて、OpenAIの「Codex CLI」が候補に挙がっている人は多い。この記事は、インストール手順・基本的な使い方・料金・AGENTS.mdの書き方・Claude Codeとの違いを、公式ドキュメント準拠で順に解説する。

なお、ペアプロ的に並走するもう一方の主役であるClaude Codeについては、Claude Codeベストプラクティスで詳しくまとめている。本記事はCodex CLI側を起点に、両者の使い分けまで踏み込む。

1. Codex CLIとは｜ターミナルで動くAIコーディングエージェント

OpenAI Codex CLIは、ターミナルから直接動作するオープンソースのコーディングエージェントだ。GitHubのOpenAI公式リポジトリ（openai/codex）でApache-2.0ライセンスのもと公開されている。

最大の特徴は「ローカルで動くAIコーディングエージェント」である点だ。既存のIDEやエディタとは独立して動作し、コードの読み取り・編集・コマンド実行をターミナルから直接制御できる。

従来のCopilotやCursorのような補完・提案型のツールに対し、Codex CLIは自律実行型エージェントとして設計された。プロンプトを送るだけでファイルを読み、コードを書き、テストを実行し、修正まで完了する。

Codex CLIで何ができるか：主要機能一覧

要するにCodex CLIは、コードの理解からテスト実行・PR前レビューまでを一連のフローとして委任できるエージェントだ。次章からは、実際に動かすためのインストール手順を解説する。

2. Codex CLIのインストールとセットアップ

システム要件

・macOS：正式サポート（Apple Silicon・x86_64）
・Linux：正式サポート（x86_64・arm64）
・Windows：WSL2（Windows Subsystem for Linux 2）推奨、実験的サポート
・Node.js：npm経由の場合はNode.js 18以上が必要

インストール方法

npm経由（推奨）

# グローバルインストール
npm install -g @openai/codex

# バージョン確認
codex --version

# パッケージを更新
npm install -g @openai/codex@latest

Homebrew経由（macOS）

brew install --cask codex

GitHub Releasesからバイナリ取得

macOS Apple Silicon・x86_64、Linux x86_64・arm64向けのコンパイル済みバイナリがGitHub Releasesページで配布されている。npmが使えない環境ではこちらを利用する。

APIキー・認証設定

Codex CLIには2つの認証方法がある。

方法1: ChatGPTアカウントでログイン（推奨）

codex login

ブラウザが開き、OpenAIアカウントでのOAuth認証が行われる。ChatGPT Plus/Pro/Business以上のプランに加入していれば、そのままCodex CLIが利用できる。

方法2: APIキーを使用

# 環境変数で設定
export OPENAI_API_KEY="sk-proj-..."

# または設定ファイル（~/.codex/config.toml）で永続化
# [provider]
# api_key = "sk-proj-..."

初回起動の流れ

# ターミナルでプロジェクトディレクトリに移動
cd /path/to/your/project

# Codex CLIを起動（インタラクティブモード）
codex

# または最初のプロンプトを引数で渡す
codex "このプロジェクトのバグを修正して"

初回起動時にモデルの選択・サンドボックス設定の確認が表示される。デフォルト設定で始めて、使いながら調整していくのがおすすめだ。

config.toml による設定

~/.codex/config.tomlで各種設定を永続化できる。

# ~/.codex/config.toml の基本設定例

# デフォルトモデルの設定（ChatGPTサインインならgpt-5.5推奨）
model = "gpt-5.5"

# Web検索の設定（"live" / "cached" / "disabled"）
web_search = "live"

# サンドボックスポリシー
sandbox = "workspace-write"

# AGENTS.mdの代替ファイル名（既存ドキュメントを流用する場合）
agents_md_fallback_names = ["TEAM_GUIDE.md", "CONTRIBUTING.md"]

Codexは起動時に、この設定ファイルとAGENTS.md、認証情報を順に読み込んでから動作する。一連の流れは次の図のとおりだ。

3. Codex CLIの基本的な使い方｜コマンドと承認モード

起動コマンド

# インタラクティブモード（TUI起動）
codex

# 初期プロンプトありで起動
codex "src/components/Button.tsx のバグを修正して"

# 作業ディレクトリを指定して起動
codex -C /path/to/project "テストを全部通して"

# 特定のモデルを使用（推奨はgpt-5.5）
codex --model gpt-5.5 "パフォーマンスを最適化して"

# 画像を添付して起動
codex -i screenshot.png "このUIデザインを実装して"

# デスクトップアプリを開く（macOS限定）
codex app

主要サブコマンド一覧

モデルの切り替えとGPT-5.5の使い方

Codex内のモデルはインタラクティブモードの/modelコマンド、または起動時の--modelフラグで切り替える。

# 1. ChatGPTサインインで起動（GPT-5.5はサインイン必須）
codex login

# 2. インタラクティブモードに入る
codex

# 3. /modelコマンドでGPT-5.5に切り替え
> /model
# → モデル選択画面で「gpt-5.5」を選ぶ

# 4. または起動時にモデル指定
codex --model gpt-5.5 "このコードベースをリファクタリング"

ポイント：Codex内のGPT-5.5はChatGPTサインインのみで利用可能で、APIキー認証セッションでは選択できない。APIキー利用時はGPT-5.4系から選ぶことになる。~/.codex/config.tomlのmodel = "gpt-5.5"でデフォルト化もできる。

3つの承認（アプルーバル）モード

Codex CLIはファイル操作とコマンド実行の権限を3段階で制御できる。

# 承認モード付きで起動
codex --sandbox read-only "このコードを解析して"
codex --sandbox workspace-write "バグを修正して"
codex --sandbox danger-full-access "プロジェクト全体をリファクタリング"

# 全自動モード（承認をスキップ）
codex --full-auto "テストを実行してすべて修正"

# --yolo（全制約解除・危険環境専用）
codex --dangerously-bypass-approvals-and-sandbox "..."

exec コマンド：CI/CDへの組み込み

# 非対話型でバグ修正を実行
codex exec "src/utils/parser.ts のTODOを全部解決して"

# JSON形式で出力
codex exec --json "テストカバレッジを分析して"

# 最後のメッセージをファイルに保存
codex exec -o output.txt "コードレビューして"

# セッションを保存しない（使い捨て実行）
codex exec --ephemeral "このdiffをレビューして"

# Gitリポジトリ外のディレクトリで実行
codex exec --skip-git-repo-check "このスクリプトを解析して"

スラッシュコマンド（TUI内部）

インタラクティブモード中に使用できる組み込みコマンドだ。

4. Codex CLIの料金とプラン｜ChatGPT各プランとAPI課金

「Codex CLIの料金はいくらか」という疑問に対する答えは明確だ。Codex単体の月額料金は存在せず、ChatGPTのどのプランを選ぶかがそのまま料金になる。Codex CLIはChatGPTのサブスクリプションに同梱されており、加入済みなら追加費用なしで使える。

4-1. ChatGPTプラン別の利用枠

OpenAI公式のCodex料金ページによれば、CodexはFree・Go・Plus・Pro・Business・Edu・Enterpriseの各プランに含まれる。主なプランと利用枠は次のとおりだ。

4-2. トークンベースのクレジット課金（2026年4月以降）

2026年4月2日、OpenAIはCodexの課金方式を「メッセージ数」から「API相当のトークン課金」へ刷新した。現在は100万トークンあたりのクレジット消費で計算される。

プラン枠を使い切っても、Plus・Proユーザーは追加クレジットを購入すれば作業を継続できる。プランをアップグレードせずに一時的な繁忙期を乗り切れる設計だ。

4-3. APIキー（従量課金）で使う場合

ChatGPTのサブスクリプションを持たなくても、APIキーさえあればCodex CLIは動く。この場合はOpenAI APIの標準従量課金が適用され、固定の利用上限はない。小さく試したい個人開発者は、月5〜10ドル程度から始められるのが利点だ。

# APIキー従量課金で使う（サブスク不要）
export OPENAI_API_KEY="sk-proj-..."
codex "このリポジトリのテストを実行して失敗を直して"

4-4. コストを抑える使い方

APIキー従量課金・クレジット課金のどちらでも、トークン消費を抑える工夫が効く。

・作業範囲を明確に指定する（「src/components/Button.tsxのみ修正して」のように絞る）
・--ephemeralでセッション保存をスキップし、使い捨て実行にする
・分析だけなら--sandbox read-onlyで読み取り専用にし、書き込みトークンを使わない
・軽量タスクはGPT-5.4-mini、重い推論だけGPT-5.5に切り替える

5. AGENTS.md の書き方

AGENTS.mdはCodex CLIに対する永続的な指示ファイルだ。プロジェクトのルールやチームの規約、コーディング規約をMarkdown形式で記述しておくと、Codexは毎回セッション開始前にこのファイルを読み込み、指示に従って動作する。

GSCの実測クエリでも「codex cli agents.md instructions」「agents.md 書き方」といった検索が目立つ。Codex CLIを使いこなす鍵がAGENTS.mdにあると言ってよい。

AGENTS.md の優先度チェーン

Codex CLIはAGENTS.mdを「グローバル→プロジェクトルート→サブディレクトリ」の順で収集し、連結して使用する。

優先度（高） ~/.codex/AGENTS.override.md    ← 一時的な上書き用
              ~/.codex/AGENTS.md             ← グローバル設定
優先度（低） {repo_root}/AGENTS.md           ← プロジェクト設定
              {subdir}/AGENTS.md             ← サブディレクトリ設定

ポイント：AGENTS.override.mdは実験的な設定を一時的に追加したいときに使う。ベースファイルを変更せずに済むため、後で消去するだけで元に戻せる。

AGENTS.md 基本フォーマット

# Project Rules

## Working Agreements
- コミットメッセージは日本語で書く
- プルリクエストは1機能1PRとする
- テストなしのコードはマージしない

## Code Style
- TypeScript を使用。`any`型は禁止
- 関数は100行以内に収める
- コンポーネントはアトミックデザイン原則に従う

## Repository Structure
- `src/components/` — UIコンポーネント
- `src/api/` — APIクライアント
- `src/types/` — 型定義
- `tests/` — テストファイル

## Testing Rules
- ユニットテストは `vitest` を使用
- E2Eテストは `playwright` を使用
- カバレッジ80%以上を維持する

サイズ制限と分割戦略

AGENTS.mdのデフォルト上限は32 KiBだ。大規模プロジェクトでは以下の戦略で管理する。

AGENTS.md と CLAUDE.md の比較

AIのMDファイル対応表では、AGENTS.md・CLAUDE.md・.cursorrules・Copilot Instructions の4ファイルを横断比較している。Codex CLIを使う開発者が押さえるべき主要な違いを以下に示す。

6. サンドボックス実行の仕組み

Codex CLIのセキュリティ設計の核心がサンドボックス機能だ。macOSではseatbelt、LinuxではLandlockという仕組みを使い、Codexが実行するプロセスの権限を制限する。

重要：Codexはすべてのアクション履歴をトランスクリプトとして残す。何かおかしな変更があっても、git diffやgit resetで即座に元に戻せる安全設計だ。

サンドボックスポリシーの確認

# macOSでのseatbeltポリシーを確認
codex sandbox -- ls /tmp

# Linuxでのlandlockポリシーを確認
codex sandbox -- cat /etc/passwd

# 追加ディレクトリへの書き込み権限を付与
codex --add-dir /tmp/workspace "一時ファイルを使って処理して"

7. Codex CLIとClaude Codeの違いと使い分け

同じ「ターミナルで動くAIコーディングエージェント」として比較されるCodex CLIとClaude Codeだが、設計思想と得意分野に明確な違いがある。「codex cli claude code 連携」「claude code codex 違い」といった検索が多いポイントだ。

7-1. 基本スペック比較表

7-2. 機能比較表

7-3. 得意分野の違い

Claude Codeが得意なこと

・複雑な多段階タスク（設計→実装→テスト→デバッグ）
・精密な局所的コード修正
・長文コンテキストを必要とするタスク（100万トークン）
・CLAUDE.md・スキル・エージェントによる高度なカスタマイズ
・Agentハーネスエンジニアリングとの深い統合

Codex CLIが得意なこと

・広範なリファクタリング・一括置換
・CI/CDパイプラインへの組み込み（codex exec）
・クラウドタスクとローカルの行き来（codex cloud + codex apply）
・軽量なコードレビュー（/reviewコマンド）
・GitHubアプリとの統合（Codex Cloudとの連携）

7-4. 使い分けの指針

タスクの性質で使い分ける：

日常的な開発作業（コード理解・逐次実装）
→ Claude Code が向く

大規模バッチ処理（全ファイルに同じ変更）
→ Codex CLI の --full-auto が向く

CI/CDでの自動コードレビュー
→ Codex CLI の codex exec が向く

複雑なバグ調査（コンテキスト量が多い）
→ Claude Code の大コンテキストが向く

チームのコーディング規約自動適用
→ どちらもAGENTS.md/CLAUDE.mdで対応可能

7-5. ベンチマーク実数値で見る両者の差

2026年5月時点のSWE-Bench結果は、両ツールの役割分担を裏付けるデータになっている。

読み解き：細かいツール操作・ファイルナビはGPT-5.5、大規模アーキテクチャ推論はOpus 4.7。次章のハイブリッド運用が合理的な理由が、ベンチマーク数値からも見えてくる。

8. 「Claude Codeで作る→Codexで直す」ハイブリッドワークフロー

2026年4〜5月、X上で広く拡散した使い方が「Claude Codeで作る → Codexで直す」だ。AnthropicとOpenAIの双方を併用し、それぞれの強みを役割分担させる手法である。

8-1. なぜハイブリッドなのか

両ツールには明確な得意分野の違いがあり、片方だけでは取りこぼすケースが目立ってきた。

Claude Code（Claude Opus 4.7・1Mコンテキスト）の強み

・大規模コードベースを丸ごと読み込んで設計する力
・抽象的なゴールから実装計画を立てる構造把握力
・対話的な作業でユーザーと並走するペアプロ的スタイル
・1Mコンテキストで長文書類・巨大ログを丸ごと処理可能

Codex CLI（GPT-5.5）の強み

・深い推論を時間をかけて回す論理性
・細かい穴・エッジケース・型不整合の検出
・サンドボックス隔離で安全にコマンド実行
・codex execで非対話型レビューをCIに組み込み可能

つまりClaude Code＝設計者・実装者、Codex＝レビュアー・品質ゲートとして並べると、それぞれの長所が補完し合う。

8-2. 具体的なコマンド例

# Step 1: Claude Codeで実装
claude "user_serviceにマルチテナント対応を追加。
既存のRBACロジックは活かしつつ、tenant_idをすべての
クエリに注入してほしい。テストも書いて"

# Step 2: Codexでレビュー
codex --sandbox read-only "直前のコミットを
セキュリティとパフォーマンス観点でレビュー。
SQLインジェクション・N+1・型不整合を重点確認"

# Step 3: Codexの指摘を再度Claude Codeで修正
claude "Codexが指摘した3点（SQL文字列結合・N+1・
nullable型の扱い）を修正してテストを追加"

# 仕上げ：Claude Codeでドキュメント
claude "今回の変更をCHANGELOG.mdに追記。
README.mdのテナント分離セクションも更新"

8-3. ワークフロー図

9. codex-plugin-ccでClaude Code内からCodexを呼ぶ

OpenAI公式のcodex-plugin-ccは、Claude Codeのプラグイン機構を使い、Claude Code内から直接Codexのレビュー・タスク委譲ができる仕組みだ。前章の「Claude Codeで作る→Codexで直す」ワークフローを、ツール切り替えなしで完結できる。

9-1. インストール手順

# 1. Claude Code内でマーケットプレイスを追加
> /plugin marketplace add openai/codex-plugin-cc

# 2. プラグインをインストール
> /plugin install codex-plugin-cc

# 3. Claude Codeを再起動

# 4. Codex側のセットアップ確認
> /codex:setup

# 5. 必要ならCodexにログイン
> !codex login

9-2. 提供される3つのコマンド

/codex:adversarial-reviewが特に強力。「このコードを批判的に見て、潜在的バグ・セキュリティリスク・パフォーマンス問題を洗い出して」という指示を内部的にCodexに投げる。Claude Codeが書いたコードに対する「対抗レビュー」として機能する。

9-3. 仕組みの裏側

codex-plugin-ccはCodex App ServerとJSON-RPC 2.0で双方向通信する。Claude Code側のスラッシュコマンドが呼ばれると、ローカルのCodex CLI認証情報を使ってCodexが起動し、結果がClaude Codeのセッションに返る。追加の認証作業なしで動くのが大きな利点だ。

10. GPT-5.5搭載とCode with Claude 2026｜2026年の動き

Codex CLIをめぐる勢力図は、2026年4〜5月に大きく動いた。背景を押さえておくと、モデル選択や使い分けの判断がしやすくなる。

10-1. GPT-5.5搭載でCodexはこう変わった

2026年4月23日、OpenAIは新フロンティアモデルGPT-5.5をChatGPTおよびCodexで提供開始した。Codex CLIにとって最大の転換点だ。

ポイント：GPT-5.5は同じCodexタスクをGPT-5.4より少ないトークンで完了する。性能向上とトークン圧縮が同時に進んだアップデートだ。

10-2. Code with Claude 2026（Anthropic側の一括強化）

2026年5月6日、AnthropicはCode with Claude 2026カンファレンスを開催し、Claude Code側で複数の新機能を一挙に発表した。

10-3. Codex for Chrome拡張（5月7日）

OpenAIは翌5月7日、Codex for Chromeを投入した。Codexアプリ（macOS・Windows）から起動するChrome拡張で、署名済みブラウザセッションをCodexが直接操作できる。

・マルチタブcontext：複数タブ横断で情報収集
・DevTools連携：Webアプリのデバッグ
・サインイン済みサイト操作：LinkedIn・Salesforce・Gmail・社内ツール
・ホスト単位の許可制御：「このチャットだけ許可」「常に許可」

両陣営の動きを並べると、戦略の違いが見える。

・Anthropic：Routines/Auto Mode/Dreamingで「自律性」を深掘り、開発フロー自体をエージェント化
・OpenAI：Chrome拡張で「ブラウザ全体」へ進出し、開発者ワークフローの上流・下流まで取りに行く

11. Cursor・GitHub Copilot との位置づけ

ターミナルエージェント型の Codex CLI・Claude Code と、IDE統合型の Cursor・Copilot はそもそもカテゴリが違う。

2026年の主流は「ターミナルエージェント ＋ IDE補完の併用」だ。Codex CLIやClaude Codeで大きなタスクを実行しながら、Claude Code vs Cursor比較記事で紹介したCursorやCopilotでリアルタイムの補完を行うハイブリッドスタイルが広まっている。

IDEの補完が「一行ずつの会話」なら、ターミナルエージェントは「機能丸ごとの委任」だ。この使い分けを意識することで、各ツールの強みを最大化できる。

12. Codex CLIの実践ユースケース

ユースケース1：バグ修正の自動化

テストが失敗しているが原因がわからない場合に有効だ。

# テスト失敗を解析して修正
codex "npm test を実行して失敗しているテストをすべて修正して。
修正前に必ずコミットして、各修正の理由をコミットメッセージに書いて"

# 特定ファイルのバグを修正
codex "src/api/auth.ts の認証トークン検証に脆弱性がある。
修正して対応するテストも追加して"

実行するとCodexがテストを実行し、スタックトレースを読み、ソースコードを確認し、修正案を提示する。承認モードがworkspace-writeの場合は確認なしで修正される（変更はgitで追跡される）。

ユースケース2：テスト生成

既存コードに対するテストがない場合に威力を発揮する。

# カバレッジレポートを渡してテスト生成
codex "vitest でカバレッジを計測して、80%未満のファイルに
ユニットテストを追加して。既存のテストパターンに合わせること"

# 特定モジュールのテスト生成
codex "src/utils/ 以下のすべての関数に対して、
エッジケースを含むテストを生成して"

ユースケース3：大規模リファクタリング

プロジェクト全体に渡る変更はCodex CLIが特に得意とする場面だ。

# CommonJS → ESModules 変換
codex --full-auto "すべての require() を ES imports に変換して。
package.json の type: module も設定して。テストが通ることを確認して"

# TypeScript any型の除去
codex "src/ 以下のすべての any 型を適切な型定義に置き換えて。
型定義が必要な場合は src/types/ に追加して"

ユースケース4：CI/CDへの組み込み

# .github/workflows/codex-review.yml
name: Codex Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
      - run: npm install -g @openai/codex
      - run: |
          codex exec \
            --ephemeral \
            --json \
            "このPRのdiffをセキュリティ・パフォーマンス・可読性の観点でレビューして"
        env:
          OPENAI_API_KEY: $

13. MCPとサブエージェント：高度な活用方法

MCP（Model Context Protocol）連携

Codex CLIはMCPをサポートしており、外部ツールやデータソースとの連携が可能だ。

# ~/.codex/config.toml での MCP サーバー設定

[[mcp_servers]]
name = "github"
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
env = { GITHUB_TOKEN = "${GITHUB_TOKEN}" }

[[mcp_servers]]
name = "filesystem"
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/workspace"]

# MCPサーバーをCLIで追加
codex mcp add github

# 利用可能なMCPサーバーを確認
codex mcp list

MCPサーバーはセッション開始時に自動的に起動され、Codexの組み込みツールと同列で利用できる。

サブエージェントによる並列処理

複雑なタスクを分割して並列実行できる。

# ~/.codex/config.toml でのサブエージェント設定

[[subagents]]
name = "test-runner"
description = "テスト実行専門エージェント"
model = "gpt-5.5"

[[subagents]]
name = "doc-writer"
description = "ドキュメント生成専門エージェント"
model = "gpt-5.5"

14. 制限事項・注意点

技術的な制限

セキュリティ上の注意点

・APIキーは環境変数か設定ファイルで管理し、コードにハードコードしない
・--dangerously-bypass-approvals-and-sandbox（--yolo）は隔離環境専用
・AGENTS.mdに機密情報（APIキー・パスワード）を書かない
・Gitリポジトリ外のディレクトリで実行する場合は--skip-git-repo-checkが必要

15. まとめ：Codex CLIを使いこなすために

OpenAI Codex CLIは、ターミナルから動くOSSのコーディングエージェントとして急成長を続けている。以下の4点を押さえれば、すぐに活用を始められる。

1. まずインストールして試す：npm i -g @openai/codex → codex login → codex --model gpt-5.5 "このプロジェクトを説明して"で、数分で動作確認できる。

2. 料金はChatGPTプランで決まる：Codex単体課金はなく、Plus（月20ドル）からPro（月100〜200ドル）の枠内で使える。小さく試すならAPIキー従量課金が安い。

3. AGENTS.mdを育てる：チームのコーディング規約をAGENTS.mdに追記していくと、Codexが毎回同じルールに従う。最初は空でよい。使いながら追加していく。

4. Claude Codeと使い分ける：「Claude Code（Opus 4.7・1M）で作る → Codex（GPT-5.5・400K）で直す」が主流スタイルだ。設計力と批判的レビュー力を両取りできる。

ターミナルは単なるコマンド入力の場ではなく、AIエージェントとの協働空間に進化している。Codex CLIとClaude Codeを武器に、開発生産性の新しい次元を体験してほしい。

16. 参照ソース

• GitHub - openai/codex — 公式リポジトリ（Apache-2.0）
• Codex CLI公式ドキュメント — OpenAI公式
• Pricing – Codex — OpenAI公式（料金・利用枠の一次ソース）
• Using Codex with your ChatGPT plan — OpenAI Help Center
• AGENTS.md公式ガイド — OpenAI公式
• Codex Changelog — OpenAI公式
• Introducing GPT-5.5 — OpenAI公式（2026/4/23）
• Codex Chrome extension — OpenAI公式（2026/5/7）
• openai/codex-plugin-cc — Claude Code向け公式プラグイン
• Live blog: Code w/ Claude 2026 — Simon Willison
• SWE-Bench Verified Leaderboard — 2026年5月時点