OpenAI Codex CLI 導入ガイド｜AGENTS.md・料金・Windows/WSL設定

結論: Codex CLIの使い方は導入前の設計で決まる

この記事は2026年4月24日時点の公式情報をもとにしています。Codex CLIは更新が速いため、インストール方法、対応OS、利用できるプラン、モデルは公式情報を確認してください。

Codex CLIとは: ターミナルで使うOpenAIのコーディングエージェント

Codex CLIは、ターミナル上でコードベースを読み、ファイル編集やコマンド実行を行うAIコーディングエージェントです。OpenAIのGitHubリポジトリでは、npmまたはHomebrewでインストールし、codex コマンドで開始する流れが案内されています。

クラウド上でタスクを委任するCodex Webとは役割が違います。CLIは手元のリポジトリで対話しながら作業する用途、Codex WebはIssue単位の委任や非同期作業に向いています。

Codex CLIの使い方: 導入前に確認すべき3点

導入方法: npm / Homebrew / GitHub Release

公式リポジトリでは、代表的なインストール方法としてnpmとHomebrewが案内されています。

npm install -g @openai/codex

brew install --cask codex

インストール後は、対象プロジェクトで次を実行します。

cd your-project
codex

Windowsでは、OpenAIのインストールドキュメント上でWindows 11 via WSL2が要件として示されています。Windowsネイティブで動く場合もありますが、まずはWSL側にNode.jsとGitを揃える構成が無難です。

料金に直結する認証方法: ChatGPTサインインかAPIキーか

Codex CLIはChatGPTアカウントでのサインイン、またはAPIキー利用の選択肢があります。どちらを使うかで、運用の見え方が変わります。

料金・利用上限・対象プランは変わりやすいため、記事本文では断定しません。導入前に公式ヘルプと管理画面で確認してください。

AGENTS.mdの書き方: 変更範囲・禁止事項・検証コマンド

Codexに安全に作業させるには、プロジェクトルートに AGENTS.md を置き、作業ルールを明示します。

# AGENTS.md

## 作業ルール

- 変更前に関連ファイルを確認する
- 変更してよいファイルを説明してから編集する
- `.env`、秘密鍵、本番DB接続情報は読まない
- 新しい依存関係を追加する前に理由を説明する
- 実装後は `npm run build` を実行する
- 同じエラーが2回続いたら修正を止め、原因仮説を提示する

## 出力形式

1. 調査結果
2. 変更内容
3. 実行した検証
4. 残った懸念

長いルールより、毎回守ってほしい短いルールの方が効きます。

初回に依頼するタスク

最初の依頼は、ファイル編集ではなく調査にします。

このリポジトリの構成を確認し、主要なディレクトリ、ビルドコマンド、テストコマンド、AIエージェントに触らせない方がよいファイルを整理してください。
まだファイルは変更しないでください。

次に、影響範囲の小さい作業を依頼します。

README内の明らかな誤字だけを修正してください。
コード、設定ファイル、依存関係は変更しないでください。
変更後、差分を要約してください。

Claude Codeとの違い: Codex CLIはOpenAI導線に寄せやすい

Claude CodeとCodex CLIは、どちらもターミナルで使えるコーディングエージェントです。違いは、利用するモデル、認証導線、クラウド側のCodexとの連携、設定ファイルの流儀にあります。

実務では、どちらが絶対に上というより、プロジェクトと作業スタイルで選びます。

• 既存のOpenAI/ChatGPT導線に寄せたい: Codex
• Claude CodeのサブエージェントやAnthropic系ワークフローに寄せたい: Claude Code
• 迷う場合: 同じ小タスクを両方で試し、差分の読みやすさと修正の慎重さで選ぶ

Codex CLIのエラー対策: よくあるつまずき

Windows/WSLでインストール後に起動しない

WindowsはバージョンやNode.js環境の影響を受けやすい領域です。まず公式の対応OS、WSL2要件、GitHubリリースの既知問題を確認します。急ぐ場合はWSL2側での利用を優先します。

料金・コストが読めない

APIキー利用では、月次上限、プロジェクト単位の利用ログ、失敗時の停止ルールを先に作ります。最初から大規模リファクタリングを投げるのは避けます。

期待より大きく書き換えられる

依頼文に「変更してよい範囲」と「変更してはいけない範囲」を入れます。Codexに限らず、AIエージェントは範囲が曖昧だと善意で広く直そうとします。

Codex CLI導入チェックリスト

• npm / Homebrew / GitHub Release のどれで入れるか決めた
• Windowsの場合、WSL2利用を検討した
• ChatGPTサインインかAPIキーか決めた
• APIキー利用なら月次上限を決めた
• AGENTS.md を置いた
• 初回タスクを「調査だけ」にした

次に読む

• Claude Code 導入完全ガイド
• Claude CodeとCodexはどう使い分けるべきか
• AGENTS.md / CLAUDE.mdに何を書くべきか

出典

• OpenAI Codex GitHub Repository
• OpenAI Codex CLI Getting Started
• Using Codex with your ChatGPT plan