OpenAI Codex 完全ガイド

OpenAI Codex は、OpenAI が提供するコーディング用 AI エージェントです。最大の持ち味は「タスクを渡しておくと、自分でファイルを読み、コードを書き、テストを走らせ、必要なら GitHub に Pull Request まで出してくれる」こと。手元のターミナルで対話しながら使うこともできれば、クラウドに長い作業を預けて別のことをしている間に進めてもらうこともできます。本ガイドは、Codex が何で・どう動き・いくらかかり・どう使い分けるかを、はじめての人にも分かるように整理します。

What it is

01Codex は「自分で手を動かす」AI

普通のチャット型 AI は、聞くと答え（テキストやコード片）を返してくれます。Codex が違うのは、あなたの環境の中で実際に作業する点です。リポジトリ内のファイルを開いて読み、コマンドを実行し、結果を見て次の手を決め、最終的に「動くコードの変更」として差し出します。人間の開発者に作業を頼むのに近い感覚です。

FIG.1　答えを返すだけでなく、ファイルを読み・書き・実行まで踏み込むのがエージェント型

2026 年時点の Codex は、その頭脳に GPT‑5.5（多くのタスクで既定）をはじめとする「Codex 系」モデルを使います。用途に応じてモデルや推論の深さを切り替えられ、長時間の作業向けには履歴を圧縮しながら走り続けるモデル（GPT‑5.1‑Codex‑Max など）も選べます。具体的なモデル名や既定値は更新が速いため、最新は公式ドキュメントで確認してください。

Three surfaces

023 つの入り口：CLI・IDE 拡張・Cloud

Codex は同じエージェントを 3 つの場所から使えます。最初の記事の頃は「CLI と Cloud」の 2 形態でしたが、現在は エディタ（VS Code 等）に組み込む拡張が加わり、用途で選べるようになりました。

Codex CLI を試す

npm install -g @openai/codex
codex login   # ブラウザで OpenAI にサインイン

cd your-project
codex         # 対話モードが起動

対話モードでは、自然文でそのまま頼めます。

$ codex
> このプロジェクトの構成を説明して
> auth モジュールを JWT 認証に書き直して、テストも追加して

1 行で渡す使い方も便利です。

$ codex "全 TypeScript ファイルを strict mode に対応させて"

Approvals & sandbox

03権限は 3 段階：勝手に走らせない設計

「AI が自分でコマンドを実行する」と聞くと不安になりますが、Codex はどこまで自動で許すかを選べます。2026 年現在はおおむね 3 段階に整理されています。最初は厳しめから始め、信頼できる範囲で緩めるのが安全です。

FIG.2　左ほど安全・右ほど自動。実行はサンドボックスで隔離され、ネット接続も許可リストで制御できる

• 読み取り中心：ファイルを読むのは自由だが、変更や危険なコマンドは毎回あなたの承認を求める。
• 自動（作業領域内）：プロジェクトの作業ディレクトリ内なら自動で実行。領域外やネットアクセスは承認が必要。
• フルアクセス：広い読み書きとネット接続まで許す。速いが、その分だけ慎重に。

コマンドはサンドボックス（隔離環境）で動き、アクセスして良いサイトを許可リスト／拒否リストでプロジェクト単位に制御できます。それでも機密リポジトリや本番に触れる操作は、自動化しすぎないのが原則です。

Cloud workflow

04Codex Cloud：寝ている間に PR が出る

Cloud は「長い仕事を預ける」ための形態です。GitHub と連携し、Issue や指示をきっかけに、クラウド上の隔離環境でブランチを切り、コードを書き、テストを走らせ、Pull Request まで作ってくれます。進捗は手元の画面から確認できます。

FIG.3　指示 → クラウドで作業 → ブランチ → PR。最後は必ず人間が確認してからマージ

典型的な流れはこうです。

さらに、GitHub の PR で @codex review とコメントすると、Codex が差分を読み、リポジトリの方針に沿ってもう一段のレビューを投稿してくれます（重大な問題に絞った指摘）。AI が書いた PR を、別の AI がレビューする、という二段構えも組めます。

AGENTS.md

05AGENTS.md でルールを覚えさせる

プロジェクト直下に AGENTS.md を置くと、Codex はそこに書かれた約束ごとを常に踏まえて作業・レビューします。チーム共通の規約を一度書いておけば、毎回プロンプトで繰り返さずに済みます。

# AGENTS.md
## Project rules
- TypeScript は strict
- すべての変更にテストを含める
- 仕上げ前に npm run lint を実行
- コミットメッセージは Conventional Commits 形式

## Review guidance
- 誤字・文法は P0 として指摘
- ドキュメント不足の可能性は P1
- テスト不足は P1

「Review guidance」のようにレビューの観点まで書けるのがポイント。Codex のコードレビューは、この指針に従って指摘の重み付けを変えてくれます。

うまく使う鍵は、賢いプロンプトより 明文化されたルール。AGENTS.md がチームの「暗黙の前提」を AI に渡す。

Pricing

06料金の考え方（2026 年時点）

Codex は ChatGPT の有料プランに含まれる形で使えるほか、API キーでの従量課金でも使えます。料金体系は頻繁に変わるため、契約前に必ず公式の最新情報を確認してください。2026 年時点の大枠は次の通りです。

• ChatGPT Plus（USD 20/月）：個人で試すのに十分。クラウドタスクには利用枠の上限がある。
• ChatGPT Pro（USD 100 / USD 200 月の上位枠）：Plus より大幅に多い利用枠。長時間・並列の本格利用向け。
• Business / Enterprise：座席（シート）単位や個別見積もり。チーム導入向け。
• API キー：トークン量に応じた従量課金。CLI / SDK / IDE 拡張で使えるが、PR レビューなど一部のクラウド機能は含まれない。

注意点として、2026 年 4 月に料金の数え方が「メッセージ数」からトークン使用量に連動する形へ見直されました。同じプランでも、小さなスクリプト修正と大規模リポジトリの長時間タスクでは消費する枠が大きく異なります。「何回使えるか」は作業の重さ次第と捉えるのが実態に合います。

Strengths & cautions

07強みと、気をつけたいところ

強み	気をつけたい点
非同期：預けて他の作業ができる	クラウド実行はリアルタイム介入がしにくい
並列：複数タスクを同時に進められる	長時間・大規模ほど利用枠を多く消費する
GitHub 統合：Issue → PR → レビューまで一気通貫	機密リポジトリはアクセス範囲を絞る配慮が要る
隔離環境でテストまで実行できる	生成コードは必ず人間レビューと CI で検証

共通する心得は、AI の出力を鵜呑みにしないこと。もっともらしく見えて誤った変更（ハルシネーション）も起こり得ます。引用や差分を一次情報として確認し、テストで裏を取る運用にすれば、安心して任せられる範囲が広がります。

In practice

08向いている仕事と、使いこなしのコツ

定型的で、結果を機械的に検証しやすい作業ほど Codex の威力が出ます。まずは小さく、検証しやすいタスクから任せるのが定石です。

コツは次の 4 つに集約されます。

• Issue 駆動：GitHub Issue に背景・再現手順・完了条件を具体的に書いて渡す。
• 承認フローを守る：自動生成された PR は必ず人間がレビューしてからマージ。
• テストを必須化：CI で AI 生成コードの品質を担保する。AGENTS.md に「テスト必須」を明記。
• 定型から広げる：依存更新・テスト追加・Lint 修正など、検証しやすい仕事から始める。

09次のステップ

主要なコーディング AI（Claude Code / Cursor / GitHub Copilot / Codex）の輪郭がつかめました。Codex は「クラウドに長い仕事を預けられる」点が際立ちます。手元での会話なら CLI / IDE 拡張、まとまった自動作業なら Cloud、と使い分けるのが出発点です。次は、これらのツールを底上げする Skills や AI ペアプログラミングのノウハウへ進みましょう。