Codex CLI使い方完全ガイド｜
インストール・AGENTS.md・
承認モード設計【2026年最新】
Codex CLIはOpenAI公式のターミナル型AIコーディングエージェントだ。導入自体は1行で終わるが、実際につまずくのは「Windowsでネイティブか WSL2 か」「承認モードをどこまで緩めるか」「AGENTS.md に何を書くか」の3点。この記事ではインストールから、失敗しやすい箇所と本番運用の設計までを実務目線で解説する。
1. 結論——3ステップで動かす
npm install -g @openai/codex（macOSならbrew install --cask codexでも可）codex loginでChatGPTアカウントにサインイン。CI/CDで使うならAPIキー方式codexと打てば対話セッションが始まる。日本語で指示してよい2. Codex CLIとは何か——「昔のCodex」との違い
Codex CLIは、OpenAIが公式に提供するターミナル上で動くコーディングエージェントだ。GitHubでopenai/codexとして公開されており、macOS・Linux・Windowsで動作する。リポジトリを読み取り、ファイル編集やコマンド実行までを自律的に進める。
3つの入口がある
| 入口 | 特徴 | 向いている人 |
|---|---|---|
| ChatGPT経由（Web） | ブラウザで完結。環境構築不要 | まず試したい人・非エンジニア |
| Codex CLI（ターミナル） | ローカルリポジトリを直接操作。最も効率的 | エンジニア（本記事の対象） |
| デスクトップアプリ | 2026年3月リリース。ターミナル不要でクリック操作 | CLIに抵抗がある人 |
3. インストール——OS別の最短手順
npm install -g @openai/codex
# Homebrew（macOS / Linux）
brew install –cask codex
# 動作確認
codex –version
Node.jsが既に入っているならnpmが最短だ。パッケージマネージャを統一したい場合はHomebrewを使う。複数の方法を混在させるとバージョン管理が混乱するので、経路は1つに決めておくこと。
4. 【要注意】Windowsは3経路ある
ここが最も質問の多い箇所だ。Windowsでの導入経路は「ネイティブ」「WSL2」「npm」の3つがあり、どれを選ぶかで安定性が変わる。
// 業務利用の推奨
- 安定性が最も高い
- Linux系開発（Node.js・Python・Docker）と相性が良い
- 改行コード・文字コード問題を回避しやすい
- プロジェクトはLinux側ホームに置く
// 手軽さ重視
- WSL2なしで動作する
- PowerShell・Windows Terminalと統合
- .NET / Windows GUI開発向き
- 文字コード問題が残る場合がある
// 開発者向け
- Node.js環境が前提
- 他OSと同じ手順で統一できる
- PATH設定でつまずきやすい
~/code/...）に置くこと。/mnt/c 配下のWindowsファイルシステムを参照すると、ファイルI/Oが極端に遅くなり、エージェントの動作が実用にならないことがある。ここは多くの人が最初に踏む地雷だ。「codex is not recognized」と出る場合
npm経由でインストールしたのにコマンドが通らないのは、ほぼPATHの問題だ。npmのグローバルインストール先がPATHに含まれていない状態なので、以下で確認する。
npm config get prefix
# 表示されたパスを環境変数PATHに追加し、ターミナルを再起動する
5. 認証——OAuthとAPIキーの使い分け
codex login
# 方法2：APIキー（CI/CD・自動化スクリプト向け）
export OPENAI_API_KEY=”sk-…”
| 認証方式 | 推奨される場面 | 注意点 |
|---|---|---|
| ChatGPT OAuth | 個人での日常利用 | 契約プランの利用枠内で動作する |
| APIキー | CI/CD・自動化ジョブ | 従量課金。キーはSecret管理ツールで扱う |
6. 基本操作とモデル切り替え
codex
# 特定のディレクトリを作業対象に指定
codex –cd ./my-project
# セッション中のモデル切り替え
/model
指示は日本語で構わない。「このエラーの原因を調べて直して」「テストが通らない箇所を特定して」といった自然文で動く。
/modelでセッション中に切り替えられることと、config.tomlでチーム標準を揃えられることを押さえておくほうが実務的だ。モデル選定の考え方はAIモデルの使い分け方｜タスク別おすすめLLMも参照してほしい。7. 承認モードとサンドボックス設計
業務で使うなら、ここが最重要だ。Codex CLIはファイル編集やコマンド実行を自律的に行うため、どこまで許可するかを設計しないと事故につながる。
承認モード
| モード | 挙動 | 使いどころ |
|---|---|---|
| Suggest（提案のみ） | 変更を提案するが実行しない | 初めて使うリポジトリ・慎重に進めたい場合 |
| Auto（既定） | 作業フォルダ内は自律実行、外は都度確認 | 日常利用の標準。安全と効率のバランスが良い |
| Full Auto | サンドボックス内で自由に動作 | 使い捨て環境での検証時のみ |
サンドボックス設定
| 設定 | 書き込み範囲 | 安全性 |
|---|---|---|
| workspace-write | 起動ディレクトリ以下のみ | 通常はこれ |
| danger-full-access | 全ファイルシステム＋任意コマンド実行 | Docker等の隔離環境のみ |
danger-full-accessをホストマシンで使わないこと。名前のとおり全ファイルシステムへの書き込みと任意コマンド実行が可能になる。使うのはDockerコンテナのような、壊れても捨てられる隔離環境に限定してください。「速いから」という理由で常用すると、いつか取り返しがつかなくなります。実務での推奨設定
初めてのリポジトリはSuggestで挙動を確認 → 慣れたらAuto＋workspace-writeを標準にする。この組み合わせなら、作業フォルダの外に手を出すときは必ず確認が入るため、事故の大半を構造的に防げる。
8. AGENTS.mdで精度を上げる
プロジェクトルートにAGENTS.mdを置くと、Codexがそのルールを読んで動く。Claude CodeのCLAUDE.md、Cursorの.cursorrulesに相当する仕組みだ。毎回同じ指示を書く手間が減り、チーム全体で出力を揃えられる。
Next.js 14 + TypeScript + Prisma のWebアプリ。
# コーディング規約
– 型は interface を使う（type は使わない）
– 関数は arrow function
– any は原則禁止
– コンポーネントは PascalCase
# ディレクトリ構造
– コンポーネント: src/components/
– API: src/app/api/
– 型定義: src/types/
# 実行してよいコマンド
– npm run test / npm run lint / npm run build
– npm run db:migrate は実行前に必ず確認を取ること
# 禁止事項
– .env ファイルの読み取り・出力を行わない
– 本番DBへの接続を伴うコマンドは実行しない
.envの扱いと本番環境への接続については、必ず書いておくことを推奨する。9. 料金——対象プランの誤解を解く
現在のCodexは、旧Codexのようなトークン従量課金ではなくChatGPTのサブスクリプションに含まれる形で提供されている。
| プラン | 月額（参考） | Codexの利用 |
|---|---|---|
| Plus | $20 | 基本的なCodexエージェント機能 |
| Pro | $200 | 大幅に多い利用枠。高推論モードが使える |
| Business / Enterprise | 要問い合わせ | 組織向けの管理機能つき |
10. Claude Code・Cursorとの使い分け
| 比較項目 | Codex CLI | Claude Code | Cursor |
|---|---|---|---|
| 提供元 | OpenAI | Anthropic | Anysphere |
| 形態 | CLI＋デスクトップアプリ | CLI主体 | IDE（VSCodeベース） |
| ルールファイル | AGENTS.md | CLAUDE.md | .cursorrules |
| 課金形態 | ChatGPTサブスクに内包 | Claudeサブスク／API | 独自サブスク |
| GUI操作の手厚さ | △（アプリ版で改善） | △ | ◎ |
| 既存契約との相性 | ChatGPT契約があれば追加費用なし | Claude契約が前提 | 別途契約が必要 |
並列実行で差が出る
Codexは複数タスクの並列処理に強みがある。worktreeを使った別ブランチでの並列作業や、複数エージェントの同時進行についてはCodex Parallel Agentsとは？1時間で6タスク同時進行——OpenAI公認マルチタスキング術の全手順で詳しく解説している。
11. よくあるトラブルと対処
✗ codex is not recognized / command not found
npmのグローバルインストール先がPATHに含まれていない。npm config get prefixで確認し、そのパスをPATHに追加してターミナルを再起動する。
✗ WSL2で動作が異常に遅い
プロジェクトが/mnt/c配下にある可能性が高い。Linux側のホーム（~/code/...）へ移動させると解決するケースが大半だ。
✗ Windowsで文字化け・改行コードの問題が出る
Windows特有の問題が完全に解消されたわけではない。改行コードや文字コードに敏感なプロジェクトでは、WSL2環境に移すほうが安定する。
✗ 想定外のファイルを書き換えられた
承認モードとサンドボックス設定を見直す。workspace-writeにしていれば起動ディレクトリ以下に限定される。それでも不安ならSuggestモードに戻して挙動を確認すること。
✗ 古い記事のコマンドが動かない
CLIのフラグ仕様は変わりやすい。コマンドを暗記するより、公式ドキュメントを都度確認する運用にしたほうが結果的に早い。
メリット・デメリット
- OpenAI公式で、保守体制が明確
- ChatGPT契約があれば追加費用なしで使える
- インストールが1行・5分で終わる
- 日本語の指示でそのまま動く
- 承認モードで安全側に倒せる
- AGENTS.mdでチーム標準を揃えられる
- 並列実行に強い
- Windowsは経路選択でつまずきやすい
- CLIのフラグ仕様が変わりやすい
- GUI操作の手厚さはIDE型に劣る
- Windows特有の文字コード問題が残る
- 設定を誤ると想定外のファイル操作が起きうる
- プランごとの利用量差が大きい
- Codex Parallel Agentsとは？1時間で6タスク同時進行——OpenAI公認マルチタスキング術の全手順
- Claude CodeでGPT-5.6 Solを動かす「Claudex」完全ガイド｜設定・コスト比較・利用規約リスク
- Claude Code完全ガイド2026｜最新機能・料金プラン・実践活用法まとめ
- Claude Code生みの親「Boris」が実践する30の最強Tips完全版
- Cursor Composer 2.5×Claude Code併用ガイド｜チームでの役割分担とルール二重化を防ぐ運用設計
- GitHub MCPとは？できることやMCPサーバーの導入・使い方
- AIモデルの使い分け方｜タスク別おすすめLLM
- AIコスト最適化完全ガイド｜企業のAI利用料削減方法と事例
12. よくある質問
Codex CLIは個人で動かすところまでは簡単ですが、チームで使うとなると承認モードの統一、AGENTS.mdの標準化、禁止事項の設計が必要になります。LIFRELLではCodex（OpenAI）の法人導入支援・研修を提供しています。実際に有料契約して検証している立場から、現場で回るルール設計まで伴走します。
