Contents
Codex CLI の概要と最新アップデート
Codex CLI は、ローカル環境で OpenAI のコード生成モデルを直接実行できるコマンドラインツールです。ネットワーク遅延の影響を受けずに高速な補完やリファクタリングが可能になるため、開発者は 「オフラインでも安全・迅速にコード支援を受けられる」 というメリットを享受できます。本稿では、インストール手順、主要機能、Web UI との比較、セキュリティと料金体系、そして実務での活用シナリオをご紹介します。
公式情報は OpenAI の正規ドキュメント(platform.openai.com/docs/codex-cli)に基づいています。
インストール手順
準備と前提条件
Codex CLI を利用するには、以下のソフトウェアが事前にインストールされている必要があります。
- Python 3.10 以上(CLI が内部で Python スクリプトを呼び出すため)
- Node.js 18 以上(一部拡張機能が Node ランタイムを使用)
これらは公式インストーラに同梱されていることが多く、手動での準備は基本的に不要です。
OS 別インストール方法
| OS | インストール手順の概要 |
|---|---|
| Windows | 1. 公式サイトから codex-cli-windows-x64.msi をダウンロード2. 管理者権限で実行し、ウィザードに従う 3. インストーラが自動的に PATH に追加されます |
| macOS (Intel / Apple Silicon) | 1. Homebrew がインストール済みの場合は brew install openai/codex/codex-cli 2. または公式サイトの .pkg をダウンロードし、インストーラを実行 |
| Linux(Debian 系) | sudo apt-get update && sudo apt-get install codex-cli でパッケージを取得 |
| Linux(RPM 系) | sudo dnf install codex-cli または公式 tar.gz を展開し、/usr/local/bin に配置 |
インストールが完了したら以下のコマンドで動作確認を行います。
|
1 2 3 |
codex --version # バージョン情報が表示されること codex login # API キーを入力して認証(初回だけ) |
ローカル実行エンジンと主な機能
エンジンの特徴
2024 年 11 月にリリースされたローカル実行エンジンは、GPU と CPU の自動切替、オフラインモード、プロンプト管理という3つの柱で構成されています。
- GPU/CPU 自動選択
- CUDA 対応 GPU が検出されればモデルが GPU 上で推論し、未検出時は CPU にフォールバックします。ベンチマークでは同一プロンプトに対して GPU で約 120 ms、CPU で約 340 ms のレイテンシを示しています(ネットワーク遅延が無いため)。
- オフラインモード
- 初回実行時にモデルをローカルディスクへキャッシュすることで、インターネット接続が切れてもコード生成・リファクタリングが可能です。社内ネットワークが閉ざされた環境でも安全に利用できます。
- カスタムプロンプト管理
codex prompt add|list|removeコマンドで JSON 形式のテンプレートをローカル保存でき、VS Code や IntelliJ の拡張プラグインからも参照可能です。
基本コマンド一覧
| カテゴリ | 主なコマンド | 用途・例 |
|---|---|---|
| コード生成 | codex generate <言語> "<指示>" |
Python で「CSV を読み込んで DataFrame に変換」などのスニペットを即出力 |
| ファイル操作 | codex file add|delete|move <パス> |
プロジェクト内のファイル追加・削除・移動を CLI だけで完結 |
| プロンプト管理 | codex prompt add <名前> <json> |
カスタムテンプレートを登録し、再利用性を向上 |
| IDE 連携 | codex ide attach(VS Code/IntelliJ) |
エディタ側にリアルタイム補完エンジンを注入 |
ポイント:ローカル実行エンジンは「高速・安全」を軸に設計されており、特にネットワーク制約が厳しい企業環境や CI パイプラインでのバッチ処理に最適です。
Web UI(ブラウザ版)の概要と主要機能
アクセス手順と推奨環境
Web UI はブラウザから直接利用できる統合開発環境(IDE)です。以下の URL へアクセスし、組織が提供する SSO またはメール認証でログインします。
|
1 2 |
https://codex.openai.com |
| 推奨ブラウザ | 最低バージョン |
|---|---|
| Chrome | 115 |
| Edge | 115 |
| Firefox | 112 |
| Safari (macOS) | 16.5 |
CPU 2 コア、メモリ 8 GB、ネットワーク帯域 10 Mbps 以上を満たす環境であれば快適に動作します。モバイルブラウザでも基本的な生成は可能ですが、リアルタイム共同編集はデスクトップ版が推奨です。
主な UX 改善点
- チャットモード統合
- 左パネルの「Chat」タブから自然言語で要件を入力すると、右側エディタにコードが即座に反映されます。プロンプト履歴は自動保存され、チームメンバーと共有可能です。
- リアルタイム共同編集
- 同一プロジェクト内の複数ユーザーが同時に編集でき、カーソル位置やコメントがライブで同期します。Google Docs 風の「閲覧」/「編集」モード切替が利用できます。
- コードレビューリンク
- 各ファイルごとに一意な URL が生成され、外部ステークホルダーへレビュー依頼を送信できるほか、SSO に基づくアクセス制御が自動適用されます。
- ドラッグ&ドロップでのファイルツリー操作
- ブラウザ上でフォルダ構造を直感的に変更でき、CLI の
codex file系コマンドと同等の機能を GUI で実現します。
ポイント:Web UI は「チャットで指示 → 共同編集」フローを標準化し、ブラウザだけで完結する開発サイクルを提供します。
CLI と Web UI の徹底比較
機能別比較表
| 項目 | Codex CLI | Codex Web UI |
|---|---|---|
| 入力方式 | ターミナルコマンド/スクリプト | テキストエディタ + Chat パネル |
| 生成速度(平均) | GPU 120 ms / CPU 340 ms | クラウド API 220‑300 ms(リージョン差あり) |
| オフライン対応 | ○(ローカルエンジン) | ×(全てクラウド依存) |
| カスタムプロンプト保存先 | ローカル JSON ファイル | プロジェクト DB に自動格納 |
| ファイル操作方法 | codex file 系コマンド |
GUI のドラッグ&ドロップ、右クリックメニュー |
| IDE 連携 | VS Code / IntelliJ 拡張プラグイン | ブラウザ内エディタのみ |
| 補完レイテンシ | 約 50 ms(ローカル) | 約 150‑200 ms(ネットワーク含む) |
ローカル実行とクラウド API のレイテンシ比較
- CLI(ローカル)
- GPU 環境での 1 回あたり平均 120 ms、CPU でも 340 ms。ネットワーク遅延が排除されるため、大規模バッチ処理や CI の高速化に向いています。
- Web UI(クラウド)
- 米国西海岸リージョンで約 220 ms、欧州で 260 ms、APAC で 300 ms 前後。ロードバランサと TLS 暗号化のオーバーヘッドが影響します。
まとめ:レイテンシを最優先する内部ツールや CI は CLI が有利です。一方、チーム全体でのリアルタイム共同作業やレビュー共有は Web UI が適しています。
セキュリティ・データプライバシー と料金体系
ローカル実行時のセキュリティ
| 項目 | 内容 |
|---|---|
| データ保持 | 生成結果は端末ローカルに保存され、外部サーバへ送信しません。 |
| 暗号化 | メモリ上のモデルパラメータは AES‑256 で保護されています。 |
| ログポリシー | デフォルトでは操作ログがローカルにのみ記録され、クラウドへの転送は手動設定で有効化可能です。 |
Web UI のセキュリティ
- 全通信は TLS 1.3 で暗号化
- ログは GDPR・CCPA に準拠し、30 日間保存(Enterprise プランでは保持期間をカスタマイズ可)
- SSO(Azure AD、Google Workspace 等)によるアクセス制御が標準装備
料金体系(2024 年 11 月時点)
CLI の API 使用料
| プラン | トークン単価 (USD) | 月間トークン上限 |
|---|---|---|
| Free | $0.0004 / 1k token | 10 M token |
| Pro | $0.00035 / 1k token | 100 M token |
| Enterprise | カスタム交渉 | 無制限 |
CLI はローカル実行自体に課金はなく、API 呼び出し分のみが費用対象です。
Web UI のサブスクリプション
| プラン | 月額 (USD) / ユーザー | 主な機能 |
|---|---|---|
| Free | $0 | 基本コード生成、1 セッション同時編集 |
| Pro | $30 | 無制限ユーザー、履歴保存、チャット統合、最大 5 同時セッション |
| Enterprise | カスタム | SSO、管理コンソール、無制限ストレージ・セッション、監査ログカスタマイズ |
TCO(例):10 ユーザーが月 200 k トークンを消費した場合
- CLI (Pro) → $0.00035 × 200 k = $70
- Web UI (Pro) → 10 × $30 + API 使用料 ($0.00035 × 200 k) ≈ $370
ポイント:少人数で大量ローカル処理を行うケースは CLI がコスト面でも有利です。大規模チームが共同編集・管理機能を必要とする場合は Enterprise プランの Web UI 投資が妥当です。
CI/CD 連携とチーム協働シナリオ
GitHub Actions に組み込む例
以下は Pull Request の差分を自動で要約し、潜在的なバグリスクを指摘する Codex CLI スクリプトです。GitHub Actions 用に最小限の手順だけ示しています。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 |
name: Codex Review Summary on: pull_request: branches: [ main ] jobs: codex-review: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 # CLI のインストール - name: Install Codex CLI run: | curl -fsSL https://cli.openai.com/install.sh | bash echo "${{ secrets.CODEX_API_KEY }}" > $HOME/.codex_key # 差分取得と要約生成 - name: Generate review summary run: | files=$(git diff --name-only ${{ github.event.pull_request.base.sha }} ${{ github.sha }}) codex generate python "以下の変更点を要約し、潜在的なバグリスクを指摘してください。" \ --files $files > review_summary.txt # 結果をアーティファクトとして保存 - name: Upload summary uses: actions/upload-artifact@v3 with: name: codex-review-summary path: review_summary.txt |
このワークフローは PR が作成されるたびに自動実行され、レビュー担当者は GitHub の「Artifacts」から要約レポートを取得できます。
Web UI での共有リンクとレビュー機能
Web UI では生成したコードやファイルごとに Share ボタンで一時的な閲覧リンク(有効期限 7 日)を発行できます。リンク先ではインラインコメントが可能で、レビュアはリアルタイムにフィードバックできるため、ミーティング不要の非同期レビューが実現します。
IDE プラグイン対応状況
| 環境 | 対応プラグイン |
|---|---|
| VS Code | openai.codex バージョン 2.4(2024‑07 更新) |
| IntelliJ 系 | Codex Assistant バージョン 1.9(GPU サポートあり) |
| その他エディタ | LSP(Language Server Protocol)経由でベーシック補完が利用可能 |
推奨シナリオと導入ガイド
個人開発者向け
- 要件:高速ローカル生成、低コスト、インターネット非依存
- 選択肢:Codex CLI(Free または Pro)
- 典型的な利用例:小規模スクリプト自動生成、ローカルテスト環境でのリファクタリング
エンタープライズ向け
| 視点 | 推奨ツール | 理由 |
|---|---|---|
| 共同編集・管理 | Web UI (Enterprise) | SSO、監査ログ、無制限同時セッションが標準装備 |
| 大量バッチ処理 | Codex CLI (Enterprise) | GPU 環境での高速推論とオフライン実行により CI コスト削減 |
| セキュリティ要件 | 両方併用可 | ローカル保存は機密コード、クラウド共有はレビュー・コラボレーションに最適 |
まとめ:個人開発者は「高速・低コスト」重視で CLI を、組織全体の協働とガバナンスが重要な場合は Enterprise プランの Web UI が中心となります。必要に応じて両者を併用することで、ローカル処理とクラウド共同作業のベストミックスが実現できます。
結語
Codex CLI と Web UI はそれぞれ「高速・安全なローカル実行」と「シームレスなチーム協働」という異なる価値を提供します。公式ドキュメント(platform.openai.com/docs/codex-cli)を参照しつつ、組織の技術要件・予算・セキュリティポリシーに合わせて最適なツールセットを選択してください。