OpenAI Codex CLI使い方入門｜インストールからSES現場での実践活用法まで解説

AIコーディングツールは2026年、エンジニアの必須スキルになりつつあります。中でもOpenAI社が提供するCodex CLIは、ターミナルから直接AIにコーディングを任せられる強力なツールです。

この記事では、Codex CLIのインストールから基本操作、SES現場での実践的な活用法まで、初心者でもすぐに始められるよう手順付きで解説します。

Codex CLIとは？OpenAI公式のターミナル型AIエージェント

Codex CLIは、OpenAI社が開発したオープンソースのターミナル型AIコーディングエージェントです。ChatGPTのようなWebインターフェースではなく、**ターミナル（コマンドライン）**から直接AIとやり取りしてコーディングを行います。

Codex CLIの3つの特徴

他のAIコーディングツールとの違い

特徴	Codex CLI	Claude Code	GitHub Copilot
動作環境	ターミナル	ターミナル	エディタ拡張
実行方式	サンドボックス	直接実行	コード補完
コード実行	✅ 安全に実行	✅ 直接実行	❌ 補完のみ
オープンソース	✅	❌	❌
料金	API従量課金	サブスク+API	月額固定

インストール手順

Codex CLIのインストールは3ステップで完了します。

前提条件

• Node.js 22以上
• Git（プロジェクトがGitリポジトリであること）
• OpenAI APIキー

ステップ1：npmでインストール

npm install -g @openai/codex

ステップ2：APIキーの設定

export OPENAI_API_KEY="sk-your-api-key-here"

永続化する場合は ~/.bashrc や ~/.zshrc に追記します。

ステップ3：動作確認

codex --version

バージョンが表示されれば成功です。

基本的な使い方

対話モード

ターミナルでプロジェクトディレクトリに移動し、codex コマンドで起動します。

cd ~/projects/my-app
codex

対話形式でAIに指示を出せます。

ワンショット実行

特定のタスクを一発で実行したい場合は exec サブコマンドを使います。

codex exec "このプロジェクトにESLintの設定を追加して"

3つの実行モード

Codex CLIには安全性レベルが異なる3つのモードがあります。

SES現場ではsuggestモードまたは**—full-auto**モードの使用を推奨します。--yoloモードはシステムに直接変更を加えるため、ローカル開発環境でのみ使用してください。

サンドボックスの仕組み

Codex CLIの最大の特徴はサンドボックス実行です。

┌─────────────────────────────┐
│  あなたのPC（ホスト環境）      │
│  ┌───────────────────────┐  │
│  │  サンドボックス         │  │
│  │  - ファイル編集 ✅      │  │
│  │  - コマンド実行 ✅      │  │
│  │  - ネットワーク ❌      │  │
│  │  - システム変更 ❌      │  │
│  └───────────────────────┘  │
│  変更を承認 → ホストに反映     │
└─────────────────────────────┘

サンドボックス内ではネットワークアクセスが制限され、ファイルシステムも隔離されます。AIが提案した変更を確認してから承認できるため、安全にコーディングを進められます。

実践活用テクニック5選

テクニック1：テスト自動生成

codex exec "src/utils/validation.ts のユニットテストを vitest で作成して"

既存コードを分析し、エッジケースを含むテストを自動生成します。

テクニック2：リファクタリング

codex exec "src/api/handlers.ts の重複コードをDRYに整理して"

コードの重複を検出し、共通関数への抽出を自動で行います。

テクニック3：ドキュメント生成

codex exec "src/ 配下の全関数にJSDocコメントを追加して"

テクニック4：バグ修正

codex exec "テスト失敗の原因を調べて修正して"

テスト実行→エラー分析→修正→再テストまで自動で行います。

テクニック5：コードレビュー

codex exec "git diff main...HEAD のコードをレビューして、問題点を指摘して"

PR前のセルフレビューに最適です。

SES現場での導入ポイント

クライアントへの説明テンプレート

SES現場でAIツールを使う際は、クライアントへの事前説明が重要です。

セキュリティ上の注意点

料金の目安

Codex CLIはOpenAI APIの従量課金制です。

使用量	月額目安
ライト（1日2-3回）	$5〜$15
ミドル（毎日活用）	$20〜$50
ヘビー（チーム利用）	$50〜$150

よくある質問（FAQ）

まとめ

OpenAI Codex CLIは、サンドボックスによる安全な実行環境とターミナルからの直感的な操作が特徴のAIコーディングツールです。

AIコーディングツールを比較検討したい方は「AIコーディングツール比較2026」も合わせてご覧ください。Claude Codeの使い方が気になる方は「Claude Code使い方入門」をどうぞ。

Link1 Link2 Link3

ああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああ