Codex CLIとは｜使い方・料金とClaude Codeとの違い

Codex CLIとは｜ターミナルで動くOpenAIのコーディングエージェント

Codex CLIは、ターミナルからリポジトリを読み、変更を加え、コマンドを実行するところまでを任せられるエージェントです。エディタの補完機能とは層が違います。補完は「書いている行の続き」を助けますが、Codexは「タスク単位」で動きます。

公式ドキュメントでは、CLIの用途を「探索・編集・実行を1ループで回す」「スクリプトやCIから呼ぶ」「ターミナルからクラウドへ作業を引き渡す」と整理しています（Codex CLI｜OpenAI公式ドキュメント）。

CLI・IDE拡張・クラウドの役割分担

Codexという名前は、複数の実行面をまとめた総称として使われています。混乱しやすいので整理しておきます。

CLIとIDE拡張は同じ設定レイヤを共有します。つまり、ターミナル側でモデルや承認ポリシーを決めておけば、エディタ側にもその設定が効きます。片方だけ設定して挙動が食い違う、という事態は起きにくくなっています。ただしプロジェクト単位の設定で上書きされることはあるため、挙動が違うと感じたら優先順位を確認してください。

選べるモデルと推論の強さ

2026年10月時点で公式のモデル一覧に掲載されていた主な系統は、GPT-6 Astra、GPT-6.1 Sol、GPT-6 Lunaの3つです（Models｜OpenAI公式ドキュメント）。Astraが複雑な作業向け、Solがそれに近い性能を低コストで、Lunaが軽量で量をさばく用途、という位置づけでした。最新の提供状況は公式のモデル一覧で確認してください。

モデル名と提供状況は入れ替わります。実際、GPT-5系のモデルは順次Codexから引退しており、記事や社内手順書にモデル名を直書きしていると、数か月で陳腐化します。セッション中はスラッシュコマンドの/modelで切り替えられるので、バージョンは公式のモデル一覧で確認してから選ぶのが安全です。

推論の強さ（reasoning effort）も選べます。軽いリファクタに最上位の推論を当てても待ち時間が伸びるだけなので、タスクの重さに合わせて落とす運用が現実的でしょう。

ミニFAQ：既存のCursorやGitHub Copilotと競合しますか

併用できます。役割が違うためです。Cursorとは？AIコードエディタの特徴・使い方・料金とGitHub Copilotとの違いを解説で整理しているとおり、エディタ統合型は差分を目で追いながら進める用途に向きます。Codex CLIはタスクを投げて待つ用途です。筆者の周囲でも、設計変更はCLI、細かい修正はエディタ、と分けている人が多い印象です。

Codex CLIの料金｜ChatGPTプラン込みとAPI従量課金

結論から言えば、Codexの利用料は「ChatGPTのプラン料金に含まれる」か「APIの従量課金」かの二択です。別建てのCodex専用プランを契約する必要はありません。

ChatGPTプランに含まれる利用量

公式の料金ページでは、CodexはFree・Go・Plus・Pro・Business・Edu・Enterpriseの各プランに含まれると明記されています。プラン価格は次のとおりです（Pricing｜OpenAI公式ドキュメント、執筆時点の公式表記）。

いずれも2026年10月時点の公式表記です。税・為替・請求通貨、Businessの年払い条件や最低ユーザー数によって、実際の請求額は変わります。

利用量は「5時間あたりのローカルメッセージ数」で管理されます。PlusおよびBusiness標準では、5時間あたりのローカルメッセージ数の目安として、GPT-6 Astraが5〜45、GPT-6.1 Solが15〜160、GPT-6 Lunaが350〜3,000という幅が公式に示されています。幅があるのは、タスクの重さで1メッセージあたりの消費が変わるためです。加えて週次の上限が併用される場合があること、ローカルとクラウドで同じ枠を共有することも明記されています。

上限に達した場合、PlusとProはクレジットを追加購入して作業を続けられます。プランを上げずに一時的な繁忙期だけしのぐ、という選択肢があるわけです。

APIキーで使う場合

APIキーでサインインすると、課金はOpenAI Platform側の従量課金に切り替わります。CIジョブのように人間が介在しない実行では、こちらのほうが扱いやすい場面があります。

価格構造で押さえておきたいのは、出力トークンの単価が入力の数倍に設定されている点です。執筆時点の公式料金ページでは、codex系モデルで100万トークンあたり入力1.75ドル・出力14.00ドルという価格が示されています（API Pricing｜OpenAI公式ドキュメント）。長大な差分を何度も出力させる使い方はコストが伸びます。キャッシュ済み入力には割引価格が設定されているため、同じリポジトリを繰り返し読ませる使い方との相性は悪くありません。

なお、APIキー認証ではChatGPTワークスペースに紐づく一部機能が制限されます。クラウド側の機能まで使いたいならChatGPTサインインを選ぶことになります。

インストールと初期設定｜10分で動かす手順

インストール方法は3通りあります。いずれも公式が案内している手順です。

Windowsについては、現行の公式案内でネイティブのインストーラが用意されています。「WSLが必須」と書いている解説記事が今も残っていますが、これは旧バージョンの前提です。対応OSのバージョンなど環境要件はリリースごとに変わるため、着手前に公式ページで再確認してください。

サインインと認証情報の保存先

インストール後、codexコマンドを起動するとサインインを求められます。方式は2つです。

1. Sign in with ChatGPT：ブラウザが開き、ChatGPTアカウントで認証します。Plus・Pro・Business・Edu・Enterpriseのプランに対応していると公式リポジトリに記載があります

2. Sign in with API key：OpenAI Platformで発行したキーを使います。環境変数での指定も可能です

認証情報は既定でホームディレクトリ配下の.codexフォルダに保存されます。保存先はキーチェーンに寄せる設定も用意されており、端末を共有する環境では検討する価値があります。ただし既定の保存方法はバージョンや設定で変わる可能性があるため、機密性の高い端末では実機で保存先を確認してください。

最初にやるべきはAGENTS.mdの作成

ここを飛ばすと、毎回同じ前提を伝える必要が出やすくなります。スラッシュコマンドの/initを実行すると、カレントディレクトリにAGENTS.mdの雛形が生成されます。これはCodexが作業前に読む永続的な指示書です。

ファイルの探索順には規則があります。グローバル設定（ホーム配下の.codexフォルダ）を読んだあと、Gitのルートから現在のディレクトリへ降りながら各階層のAGENTS.mdを読み、手前（作業ディレクトリに近いほう）の指示が優先されます。合計サイズが既定で32KiBに達した時点で打ち切られるため、何でも書けばよいわけではありません（AGENTS.md｜OpenAI公式ドキュメント）。

書く内容は、テストの実行コマンド、使っているパッケージマネージャ、触ってはいけないディレクトリ、コミットメッセージの規約あたりが効きます。モノレポなら、パッケージごとにAGENTS.mdを置いて階層で上書きする構成が機能します。

基本的な使い方｜対話モードと非対話実行

Codex CLIの使い方は、対話モードと非対話実行の2つに大別できます。前者は手元での開発、後者は自動化です。

対話モードとスラッシュコマンド

引数なしでcodexを起動すると対話モードに入ります。タスクを自然文で書いて投げると、ファイルを読み、必要ならコマンドを実行しながら作業を進めます。

セッション中によく使うコマンドを挙げます。

実務で効くのは/reviewです。生成された差分をそのままコミットせず、一度レビューさせてから自分の目で確認する。この一手間で、意図しないファイル削除や設定変更の混入をかなり防げます。

作業を中断した場合は、codex resumeでカレントリポジトリの直近セッションを再開できます。別日に続きをやるとき、前提を説明し直さずに済みます。

非対話実行（codex exec）でCIや定型作業に組み込む

codex execは、プロンプトを引数に渡して1回だけ実行する非対話モードです。進捗は標準エラー出力に、最終的な回答は標準出力に流れるため、シェルスクリプトからの扱いが素直になっています。

定型作業との相性がよい領域です。たとえば、リリースノートの下書き生成、テストが落ちた箇所の原因切り分け、依存更新後の差分要約。CI用には公式のGitHub Actionも提供されています。

テスト生成を任せる場合の限界と勘どころは、AIテスト自動化の実務｜生成AIで単体・E2Eテストを作る手順と限界に整理があります。

設定ファイルで既定値を決める

毎回フラグを付けるのは現実的ではありません。ホーム配下の.codexフォルダにあるconfig.tomlに既定値を書いておけます。モデル、承認ポリシー、サンドボックスの種類、推論の強さ、Web検索の扱い、MCPサーバーの定義などが対象です。

設定はCLIフラグ、プロジェクト直下の設定、プロファイル、ユーザー設定、システム設定の順に優先されます。案件ごとに安全側の設定を分けたいなら、プロファイルを作って切り替えるのが手堅いやり方です。

MCPサーバーを登録すれば、社内の検索基盤やチケット管理と接続できます。仕組み自体はModel Context Protocolとは｜MCPの仕組み・活用事例をエンジニア視点で解説で解説しています。

承認モードとサンドボックス｜自走させる範囲を決める

ここがCodex CLIで最も重要な設定です。結論として、サンドボックス（何に触れるか）と承認ポリシー（いつ人に聞くか）は別の軸であり、組み合わせて考えます。

サンドボックスの3モード

既定で押さえておくべきは、サンドボックス内のネットワークアクセスが初期状態でオフという点です。パッケージのインストールなど外部通信が必要な作業は、設定で明示的に有効化しない限り止まります。裏を返せば、黙ってコードが外部へ送られる経路が1つ減っているということでもあります。

OSごとの実装も公開されています。macOSはSeatbelt、Linuxはbwrapとseccompの組み合わせ、WindowsはMXCが使われます（Agent approvals & security｜OpenAI公式ドキュメント）。

承認ポリシー

承認ポリシーは、作業を止めて人に確認を取るタイミングを決めます。on-requestが基本形で、ワークスペース内の操作は進めつつ、ワークスペース外の編集とネットワークアクセスでは承認を求めます。neverは確認を挟まず走り切るモード、granularは操作のカテゴリごとに挙動を振り分ける設定です。

サンドボックスと承認の両方を一括で外すフラグも用意されていますが、公式ドキュメント上も「Elevated Risk」と明記されています。他人のリポジトリでこれを使う理由は、まずないでしょう。

案件タイプ別の設定の当て方

このあたりは公式に正解が書いてあるわけではないので、リスクの性質から整理した私見です。

ミニFAQ：承認を厳しくすると作業が進みません。緩めても大丈夫ですか

自分の管理下にあるリポジトリで、かつGitでいつでも戻せる状態なら緩めて構いません。判断の分かれ目は「巻き戻せるか」です。コミットしていない変更が大量にある状態で自走させると、どこが壊れたのか追えなくなります。緩める前にコミットする、を習慣にしておくと事故が減ります。

Claude Codeとの違い｜比較表と使い分け

比較の前提として、両者はどちらもターミナルで動く自律型のエージェントであり、できることの大枠は重なります。違いが出るのは料金の入口、実行面の広がり、そして承認の出方です。

価格と利用枠はいずれも2026年10月時点の公式ページ表記です（Claude Plans & pricing｜Anthropic公式）。為替と税の扱いで実際の請求額は変わります。なお「安全設計」「実行面」の行は各公式ドキュメントの記載を要約したもので、使用感の優劣を示すものではありません。両者とも更新が速い領域のため、細部は公式ドキュメントで確認してください。

どう使い分けるか

どちらかが全面的に優れている、という整理にはなりません。すでにChatGPTのPlusやProを契約しているならCodex CLIの追加コストはゼロですし、Claudeを契約しているなら逆です。まず「すでに払っているほう」から試すのが合理的でしょう。

実行面の広がりを重視するならCodex、という選び方はあります。ターミナルで始めた作業をクラウドへ渡し、IDE拡張で差分を確認する、という移動が同じ設定のまま行えるのは構造的な違いです。

Claude Code側の詳細はClaude Codeとは｜使い方・料金プラン・案件動向を解説にまとめてあります。OSSのエージェントを自分で課金経路ごと制御したい場合はClineとは｜OSSのAIコーディングエージェントの使い方・料金・違い、AWS環境中心ならKiroとは｜AWS製AI IDEの使い方・料金とCursorとの違いも選択肢に入ります。

客先案件で使う前に確認すること

フリーランスにとっては、ここが技術的な設定より重い論点です。結論として、導入の可否は「コードが外部APIに送信される」前提で確認を取る必要があります。

契約・秘密保持の確認先

確認すべき相手は、発注元の担当者ではなく契約上の窓口です。業務委託契約やNDAに、第三者サービスへの情報提供を制限する条項が入っていることがあります。口頭で「便利だから使っていいよ」と言われても、契約書の条項が優先されます。

本記事はツールの仕様を整理したものであり、個別契約の解釈を示すものではありません。利用可否の最終判断は、契約書の条項と契約先からの回答によります。判断に迷う条項がある場合は、契約先またはエージェントの担当窓口を通じて書面で確認してください。

確認の進め方と、聞くべき項目の整理は業務委託で生成AIを使うときの契約・機密情報の注意点｜客先案件の実務にまとめています。着手前に目を通しておくと、やり取りが1往復で済みます。

データ取り扱いの公式方針

説明材料として押さえておきたい公式記載が2点あります。

OpenAIのAPIについては、「APIに送信されたデータは、明示的にオプトインしない限りモデルの学習に使われない」と公式ドキュメントに明記されています。不正利用監視のログは最大30日保持され、Zero Data Retentionの適用には事前承認が必要です（Data controls｜OpenAI公式ドキュメント）。

Anthropicの商用規約では、顧客が入力に対する権利を保持し、出力を所有すること、顧客コンテンツをモデル学習に使用しないことが定められています。ただし個人向けプランは学習利用がオプトインで、有効化すると保持期間が長くなります。個人契約のプランをそのまま客先案件に持ち込むのは、この点で薄氷です。

常駐案件で支給PCに入れられない場合

会社支給端末にツールを追加できないケースは珍しくありません。この場合、手元の端末で設計の検討やサンプル実装だけ回し、成果物は人の手で持ち込む、という分離が現実的です。ただし、持ち込んだコードがどこで生成されたものかを説明できる状態にしておくこと。成果物の責任はツールではなく自分にあります。

フリーランス案件での使いどころと単価への影響

正直に言えば、Codex CLIを使えること自体が単価を押し上げる要素にはなりにくいです。AIコーディングエージェントの利用は、公開されている募集要項を見る限り、特別なスキルというより前提として扱われる場面が増えています。

効いてくるのは別の部分です。

• 見積もり精度：調査にかかる時間が読めるようになり、短納期案件の受諾判断が速くなります

• 守備範囲の拡張：慣れない言語のメンテナンス案件に手を出しやすくなります

• 提案の厚み：既存コードの問題点を洗い出したうえで改善提案まで持っていけます

一方で、エージェント基盤そのものを構築する案件は別の市場です。単価帯や必要スキルはAIエージェント開発案件の単価相場｜必要スキル・獲得ルートを解説で整理しています。ツールの利用者ではなく実装者として入るルートです。

ツールの使い分けを案件でどうアピールするかはエンジニアの生成AI活用術｜ツール使い分けで開発効率化と単価アピールに効く実務が参考になります。自分の現在地が市場でどのあたりかを把握しておきたい方は、無料のフリーランスエンジニア単価診断で目安を確認できます。単価を体系的に上げる考え方は【2026年最新版】フリーランスエンジニアの単価相場と単価の上げ方とは？に整理があります。

よくある失敗と対策

いきなり全権限で走らせる

最初の設定でサンドボックスと承認をまとめて外してしまうパターンです。デモ動画の見栄えはよくなりますが、実務では差分が追えなくなります。read-onlyで数回動かし、挙動の癖を掴んでから緩めてください。

AGENTS.mdを書かずに使い続ける

毎セッション同じ指摘を繰り返すことになります。「テストはこのコマンド」「このディレクトリは触るな」の2行を書くだけでも結果が安定します。費用対効果が最も高い初期投資です。

利用量の消費に気づかない

5時間枠の消費は、重いタスクを投げると一気に進みます。締め切り前に上限へ当たるのが最悪のパターンです。/statusや/usageで消費を確認する癖をつけ、繁忙期はクレジットの追加購入も選択肢に入れておきましょう。

生成された差分を読まずにコミットする

レビュー責任は常に自分側にあります。意図しないファイルの削除、設定値の書き換え、デバッグコードの残留。いずれも/reviewと自分の目視で防げます。

客先コードを確認前に投げる

最も取り返しがつかない失敗です。契約確認は着手前に済ませてください。

実践チェックリスト｜導入前と導入後

導入前（初回セットアップ時）

• インストール方法を決めた（npm・Homebrew・スタンドアロンのいずれか）

• サインイン方式を決めた（ChatGPTアカウント／APIキー）

• 既定のサンドボックスと承認ポリシーを設定ファイルに書いた

• ネットワークアクセスの要否を判断した（既定はオフ）

• AGENTS.mdをリポジトリ直下に作成した

• 案件で使う場合、契約上の可否を確認した

導入後（案件ごとに毎回）

• 作業開始前に未コミットの変更がない状態にした

• 案件のリスクに応じてサンドボックスを選び直した

• 生成差分を/reviewと目視の両方で確認した

• 利用量の消費を定期的に確認した

• 機密情報を含むファイルが作業範囲に入っていないか確認した

まとめ

Codex CLIは、ChatGPTのプランに含まれるターミナル常駐型のコーディングエージェントです。導入のハードルは低く、要点は「どこまで自走させるか」の設計に集約されます。

• インストールからサインインまでは5〜10分程度。npm・Homebrew・スタンドアロンの3通りから選べる

• 料金はChatGPTプラン込み（Plus 20ドル/月〜）かAPI従量課金の二択。利用量は5時間枠で管理され、週次上限が併用される場合がある

• サンドボックス（read-only／workspace-write／danger-full-access）と承認ポリシーは別軸。ネットワークは既定でオフ

• AGENTS.mdを最初に書くと結果が安定する。階層マージで、作業ディレクトリに近いファイルが優先される

• Claude Codeとは機能より「すでに契約しているプラン」で選ぶのが合理的。実行面の広がりはCodex側の構造的な強み

• 客先案件では、契約上の可否確認が技術設定より先。生成コードの責任は受託者にある

次のステップとしては、自分のリポジトリでread-onlyのまま数タスク投げてみることをおすすめします。挙動の癖が掴めてから権限を緩めるほうが、結果的に早く慣れます。

参照した一次情報

• Codex CLI｜OpenAI公式ドキュメント

• Agent approvals & security｜OpenAI公式ドキュメント

• AGENTS.md｜OpenAI公式ドキュメント

• Pricing｜OpenAI公式ドキュメント

• Data controls｜OpenAI公式ドキュメント

• Claude Plans & pricing｜Anthropic公式