Codex CLI のインストール方法と使い方 (2026年版)

Codex CLI のインストールと使用方法 (2026年版)

OpenAI の Codex CLI は、OpenAI のモデルを使用して、コマンドラインから直接コードの記述、編集、デバッグ、リファクタリングを行えるターミナルベースの AI コーディングエージェントです。Anthropic の Claude Code に対する OpenAI からの回答とも言える、フル機能の IDE を必要とせずターミナル内で動作する軽量かつ強力なツールです。

このガイドでは、2026年における Codex CLI のインストール、設定、日常的な使い方、および最大限に活用するためのヒントについて解説します。

Codex CLI とは？

Codex CLI は、OpenAI によって開発されたオープンソースのコマンドラインツールです。OpenAI API に接続し、以下の機能を提供します。

• ターミナルでのインタラクティブなコーディングセッション
• AI の支援によるファイルの読み取りと編集
• 自然言語の説明からのコード生成
• 既存コードのデバッグとリファクタリング
• AI ガイド付きワークフローによるシェルコマンドの実行
• マルチファイルプロジェクトの理解

機能	Codex CLI	Claude Code	Aider
プロバイダー	OpenAI	Anthropic	任意 (APIキー持ち込み)
デフォルトモデル	o4-mini	Claude Sonnet	設定可能
オープンソース	はい	いいえ	はい
サンドボックスモード	はい	はい	いいえ
ファイル編集	はい	はい	はい
シェルコマンド	はい	はい	制限あり
コスト	API 使用料	サブスクまたは API	API 使用料
IDE 統合	ターミナルのみ	ターミナルのみ	ターミナルのみ

前提条件

Codex CLI をインストールする前に、以下が必要です。

• Node.js 22+ (LTS バージョン推奨)
• npm または yarn
• OpenAI API キー (o4-mini または GPT-4o へのアクセス権があるもの)
• Git (バージョン管理プロジェクトでの使用を推奨)
• macOS または Linux (Windows は WSL 経由でサポート)

インストール

方法 1: npm によるインストール (推奨)

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

# インストールの確認
codex --version

方法 2: ソースからインストール

# リポジトリをクローン
git clone https://github.com/openai/codex.git
cd codex

# 依存関係のインストール
npm install

# ビルドとリンク
npm run build
npm link

方法 3: インストールせずに実行

# npx を使用してインストールせずに実行
npx @openai/codex "explain this project"

設定

API キーの設定

# オプション 1: 環境変数 (推奨)
export OPENAI_API_KEY="sk-your-api-key-here"

# 永続化のためにシェルプロファイルに追加
echo 'export OPENAI_API_KEY="sk-your-api-key-here"' >> ~/.bashrc
source ~/.bashrc

# オプション 2: インラインで渡す
OPENAI_API_KEY="sk-your-key" codex "your prompt"

設定ファイル

永続的な設定のために設定ファイルを作成します。

# 設定ディレクトリの作成
mkdir -p ~/.codex

# ~/.codex/config.yaml
model: o4-mini
approval_mode: suggest  # suggest, auto-edit, または full-auto

承認モード (Approval Modes)

Codex CLI には、AI の自律性を制御する 3 つのセーフティレベルがあります。

モード	フラグ	挙動
Suggest (デフォルト)	--suggest	変更案を表示し、編集前に承認を求める
Auto-edit	--auto-edit	ファイル編集を自動適用し、シェルコマンド実行前に承認を求める
Full-auto	--full-auto	すべてを自動実行する (サンドボックス環境でのみ使用してください)

# suggest モードを使用 (最も安全)
codex --suggest "refactor this function"

# auto-edit モードを使用
codex --auto-edit "add error handling to all API calls"

# full-auto モードを使用 (注意して使用)
codex --full-auto "set up a new Express.js project with TypeScript"

基本的な使い方

インタラクティブモード

プロジェクトディレクトリで対話型セッションを開始します。

cd /path/to/your/project
codex

これにより、チャット形式のインターフェースが開き、プロンプトを入力すると Codex がファイルを読み取り、変更を提案し、コマンドを実行します。

ワンショットコマンド

インタラクティブモードに入らずに単一のプロンプトを送信します。

# コードについて質問する
codex "what does the handleAuth function do?"

# コードを生成する
codex "create a Python script that monitors CPU usage and sends a Slack alert when it exceeds 90%"

# エラーをデバッグする
codex "I'm getting a TypeError: Cannot read property 'map' of undefined in UserList.tsx. Fix it."

# リファクタリング
codex "refactor the database queries in models/user.js to use prepared statements"

パイプ入力

ファイルの内容やコマンド出力を Codex に渡します。

# エラーログを解説させる
cat error.log | codex "explain what went wrong and how to fix it"

# diff をレビューする
git diff | codex "review these changes for bugs or issues"

# ファイルを分析する
cat src/utils/auth.ts | codex "are there any security vulnerabilities in this code?"

一般的なユースケース

1. 新規ファイルの生成

codex "以下の条件でユーザー登録用の REST API エンドポイントを作成して:
- email/password のバリデーション
- bcrypt によるパスワードハッシュ化
- JWT トークンの生成
- 適切なエラーハンドリング
src/routes/auth.ts として保存して"

2. エラーのデバッグ

# エラーを直接渡す
codex "このエラーを修正して:
Error: ECONNREFUSED 127.0.0.1:5432
src/db/connection.ts で PostgreSQL への接続に失敗しています"

3. テストの記述

codex "Jest を使って src/utils/validation.ts のユニットテストを書いて。すべてのエッジケースをカバーして。"

4. コードのリファクタリング

codex "src/components/Dashboard.tsx をリファクタリングして:
1. チャートのロジックをカスタムフックに抽出
2. 適切な TypeScript の型を追加
3. any 型を具体的な型に置き換え"

5. コードの解説

codex "このプロジェクトの認証フローを説明して。関連する各ファイルを順に追って解説して。"

6. ドキュメントの作成

codex "src/utils/ 内のすべてのエクスポート関数に対して JSDoc コメントを生成して"

7. シェルの自動化

codex "以下の処理を行う bash スクリプトを書いて:
1. PostgreSQL データベースをバックアップ
2. バックアップを gzip で圧縮
3. S3 にアップロード
4. 30日以上前のバックアップを削除"

高度な設定

異なるモデルの使用

# 複雑なタスクに GPT-4o を使用
codex --model gpt-4o "architect a microservices system for an e-commerce platform"

# 迅速なタスクに o4-mini を使用 (デフォルト、低コスト)
codex --model o4-mini "fix the typo in the README"

カスタムインストラクション (Custom Instructions)

プロジェクト固有の指示ファイルを作成します。

<!-- プロジェクトルートの codex.md -->
# Codex 指示書

## プロジェクトコンテキスト
これは TypeScript、Tailwind CSS、Prisma ORM を使用した Next.js 15 アプリケーションです。

## コーディング標準
- フックを使用した関数コンポーネントを使用すること
- すべての関数に TypeScript の型を定義すること
- ランタイムバリデーションには Zod を使用すること
- 既存のファイル命名規則 (kebab-case) に従うこと
- すべての新しいユーティリティ関数にテストを書くこと

## 禁止事項
- 許可なくデータベーススキーマを変更しないこと
- 承認なしに新しい依存関係をインストールしないこと
- .env ファイルを変更しないこと

Codex CLI は、プロジェクトディレクトリで作業する際にこのファイルを自動的に読み取ります。

環境固有の設定

# .env を使用してプロジェクトごとにモデルを設定
echo 'CODEX_MODEL=gpt-4o' >> .env

# プロジェクトごとに承認モードを設定
echo 'CODEX_APPROVAL_MODE=auto-edit' >> .env

Codex CLI vs. Claude Code

どちらもターミナルベースの AI コーディングエージェントです。比較は以下の通りです。

項目	Codex CLI	Claude Code
モデル	OpenAI (o4-mini, GPT-4o)	Claude (Sonnet, Opus)
価格	トークン従量課金 (API)	サブスク ($20/月) または API
オープンソース	はい (Apache 2.0)	いいえ
サンドボックス	ネットワーク切断サンドボックス	権限ベース
コンテキスト窓	最大 128K トークン	最大 200K トークン
ファイル編集	Diff ベースのパッチ	インライン編集
MCP サポート	制限あり	フルサポート
最適なユーザー	OpenAI エコシステム利用者	Claude エコシステム利用者
コミュニティ	GitHub issues	Anthropic サポート

Codex CLI を選ぶべき場合

• OpenAI のモデルを好む
• 自分でカスタマイズ可能なオープンソースツールを使いたい
• 複雑なロジックのために o4-mini 推論モデルが必要
• すでに OpenAI API キーを持っている

Claude Code を選ぶべき場合

• Claude のモデル (特に長いコンテキスト) を好む
• MCP サーバーの統合が必要
• 従量課金よりもサブスクリプションモデルを好む
• 複雑なリファクタリングに Anthropic の Extended Thinking が必要

コスト管理

コスト見積もり

モデル	入力 (100万トークンあたり)	出力 (100万トークンあたり)	標準的なセッションコスト
o4-mini	$1.10	$4.40	$0.05 - $0.50
GPT-4o	$2.50	$10.00	$0.10 - $2.00
GPT-4o-mini	$0.15	$0.60	$0.01 - $0.10

コスト削減のヒント

1. ほとんどのタスクには o4-mini (デフォルト) を使用する
2. プロンプトを具体的に書き、やり取りの回数を減らす
3. 設定で max_tokens を指定し、レスポンスの長さを制限する
4. suggest モードを使用して、実行前に変更内容を確認する (無駄な再試行を避ける)
5. OpenAI ダッシュボードで利用額制限を設定する

トラブルシューティング

事象	解決策
command not found: codex	npm install -g @openai/codex を再実行し、PATH を確認してください
OPENAI_API_KEY not set	キーをエクスポートしてください: export OPENAI_API_KEY="sk-..."
model not found	OpenAI アカウントでそのモデルへのアクセス権があるか確認してください
レスポンスが遅い	出力を速くするために o4-mini または gpt-4o-mini に切り替えてください
ファイル編集が適用されない	ファイルの権限と、正しいディレクトリにいるかを確認してください
Node.js version too old	Node.js 22 以上にアップグレードしてください: nvm install 22
サンドボックスエラー	サンドボックス外での実行を試してください: codex --no-sandbox

よくある質問

Codex CLI は無料ですか？ ツール自体は無料でオープンソースです。消費されたトークンに応じて OpenAI API の利用料金が発生します。

OpenAI キーなしで Codex CLI を使えますか？ いいえ。Codex CLI には OpenAI API キーが必要です。無料の代替案としては、Google や Groq の無料枠 API キーを使用した Aider を検討してください。

Codex CLI は Windows で動作しますか？ ネイティブでは動作しません。Windows 上で実行するには WSL (Windows Subsystem for Linux) を使用してください。

Codex CLI はシステム上の任意のファイルを変更できますか？ suggest モード (デフォルト) では、変更前に必ず許可を求めます。full-auto モードでは、安全のためネットワークアクセスが無効化されたサンドボックス環境で動作します。

GitHub Copilot との違いは何ですか？ Copilot はインラインでの提案を行う IDE 拡張機能です。Codex CLI は、複雑なマルチファイルタスクを処理するターミナルエージェントです。これらは目的が異なり、併用することが可能です。

まとめ

Codex CLI は、特に OpenAI エコシステムをすでに利用している場合、非常に堅牢なターミナルベースの AI コーディングエージェントです。オープンソースであること、サンドボックスによる安全性、そして推論モデルのサポートにより、ターミナルでの作業を好む開発者にとって強力な選択肢となります。

画像、動画、アバターなどを生成する AI 駆動型アプリケーションを構築している場合は、Hypereal AI を無料でお試しください (35 クレジット、クレジットカード不要)。REST API は、Codex CLI で構築しているあらゆるプロジェクトに簡単に統合できます。