Codex appの使い方と設定・料金・更新点を確認する方法
Codex appは、プロジェクトを開きAIコーディングエージェントに調査・実装・検証を依頼し、差分を人が確認するデスクトップ入口です。2026年8月24日のOpenAIリリースノートでは、codex mcp-serverコマンドからCodex app serverへ移る案内も出ました。MacとWindowsで使えるいま、料金、設定、モデル選択、差分確認をまとめて整理します。
Codex appは、コードを生成する画面だけではなく、プロジェクトごとの会話、変更差分、確認事項をまとめて扱うデスクトップでの作業入口です。OpenAIの紹介記事では、複数のエージェントを別スレッドで扱い、変更を差分で確認する考え方が示されています。まず小さな修正を一つのプロジェクトで試すと、画面の役割を理解しやすくなります。
利用を始めるにはChatGPTアカウントでサインインし、対象のフォルダーを開いて、どこまで変更してよいかを伝えます。公式ヘルプではCodexはFreeやGoを含む各プランで提供され、利用上限はプランによって異なると説明されています。WindowsではWSLのディストリビューション選択や`codex doctor`も確認材料になります。
2026年8月24日には`codex mcp-server`コマンドの非推奨化が案内され、Codex app serverを使う方向が示されました。さらに8月29日には公式リポジトリで`0.152.0-alpha.1`が公開されています。アプリの入口と周辺コマンドを同じものと考えないことが、更新時の混乱を減らします。
目次 (44)
- Codex appとは何か――コードを書く場所ではなく確認の窓口
- デスクトップ入口としての役割
- Codex CLI・IDEとの違い
- 2026年8月に確認した更新点――アプリと周辺機能を分けて見る
- 8月24日のapp server案内
- GitHubのリリース番号の読み方
- 初回に用意するもの――アカウント、対象フォルダー、確認基準
- 対応環境を確認する
- 先に決める作業範囲
- Codex appの始め方――最初の依頼から差分確認まで
- Step 1: デスクトップアプリでCodexを選ぶ
- Step 2: プロジェクトのフォルダーを開く
- Step 3: 依頼文に完了条件を書く
- Step 4: 提案と差分を確認する
- Step 5: テスト結果と残課題を読む
- 依頼文の作り方――結果を読みやすくする四つの視点
- 目的・範囲・完了条件
- 変更を小さく区切る
- 返却形式を指定する
- モデルと速度の選び方――作業の難しさに合わせる
- 難しい変更は推論の深さを優先する
- 小さな修正は速度を優先する
- 料金と利用量を混同しない
- Windowsで使うときの確認――アプリと開発環境を切り分ける
- WSLのディストリビューションを合わせる
- Codex Doctorで診断する
- Windows固有の問題を小さく切り分ける
- 差分レビューと安全な進め方――採用するのは人
- 設計と実装を分ける
- ファイル範囲と差分の大きさを見る
- 外部操作は確認を置く
- Codex app serverと周辺ツール――今の案内に合わせる
- codex mcp-serverを見かけたら
- MCPと拡張の使い分け
- 旧手順を見直すときの基準
- Codex appとCursor・GitHub Copilotの違い――入口で選ぶ
- Codex app向きの人
- Cursor向きの人
- GitHub Copilot向きの人
- よくあるつまずき――原因を一つずつ分ける
- プロジェクトを開けない
- 変更は見えるがテストが失敗する
- 何度も同じ修正が戻る
- まとめ――Codex appは確認しながら任せるための入口
Codex appとは何か――コードを書く場所ではなく確認の窓口
Codex appは、OpenAIのコーディングエージェントをデスクトップから扱うための製品です。ターミナルに一行ずつ指示を送り、結果だけを受け取る使い方に比べ、プロジェクト、会話、変更内容、次に確認したい点を同じ画面で追いやすいことが特徴です。OpenAIの紹介記事では、複数のエージェントを別スレッドで動かし、差分を見てからエディターで手を入れる流れが説明されています。つまり、アプリの価値はコードの量だけではなく、依頼した内容と実際の変更を照らし合わせる時間を短くする点にあります。
デスクトップ入口としての役割
アプリを開いたら、最初に行うのは「何かを作らせる」ことではなく、対象プロジェクトと現在の状態をそろえることです。リポジトリの場所、作業中のブランチ、未保存の変更、読むべき資料を確認してから依頼すると、別の場所を変更する誤りを防げます。変更が終わったあとも、画面に表示された差分とテスト結果を見て、人が採用する範囲を決めます。
Codex CLI・IDEとの違い
同じCodexでも、入口によって向く作業が違います。CLIはコマンドとログを細かく追いたいとき、IDE拡張は編集中のファイルをすぐ直したいときに便利です。Codex appは複数の依頼をプロジェクト単位で並べ、長めの調査や大きめの変更を確認しながら進めたいときに向きます。モデルやアカウントが同じでも、画面の役割と確認のしやすさは同じではありません。
2026年8月に確認した更新点――アプリと周辺機能を分けて見る
Codex appを今から使う理由は、単に新しいデスクトップ画面があるからだけではありません。2026年8月24日のOpenAIリリースノートでは、codex mcp-serverコマンドを非推奨とし、Codex app serverを使う案内が掲載されました。これは、Codexを外部のツールから呼び出す人に関係する変更です。一方、通常のアプリ利用者は、画面からプロジェクトを開き、依頼を送り、差分を見るという基本を押さえればよく、古いコマンドを見つけたからといってすぐに設定全体を変える必要はありません。
また、OpenAIのCodex app紹介には、2026年3月4日にWindows対応が追加されたことが記載されています。さらに公式リポジトリのリリース一覧では、8月29日に0.152.0-alpha.1が掲載されています。試験的な版を安定版と同じ扱いにせず、アプリの更新、CLIの版、選択中のモデルを別々に確認することが大切です。
8月24日のapp server案内
codex mcp-serverを使った経験がある場合は、公式リリースノートの案内を起点に確認します。非推奨とは、直ちにすべてが動かなくなるという意味ではなく、今後の利用先として別の仕組みが示されたということです。既存の連携があるなら、まず現在の版、起動方法、接続先、戻したいときの手順を記録し、短い確認用プロジェクトで移行後の動作を確かめます。アプリだけを使う人は、この変更を知識として押さえるだけでも十分です。
GitHubのリリース番号の読み方
公式リポジトリのリリースには、安定版と試験的な版が混在します。0.152.0-alpha.1のようにalphaが含まれる場合は、数字が大きいことだけで日常環境への採用を決めません。該当リリースの本文、対象OSの配布物、既知の問題を確認し、現在の版で困っている点が解消されるかを小さく試します。アプリの表示とリポジトリの版が一致しない場合もあるため、入口ごとの版番号を混ぜないようにします。
初回に用意するもの――アカウント、対象フォルダー、確認基準
初回設定で重要なのは、特別な開発環境を増やすことより、Codexが読んでよい場所と変更してよい範囲を決めることです。ChatGPTアカウントでサインインし、対象のリポジトリやフォルダーを選びます。公式ヘルプの「ChatGPTプランでCodexを使う方法」では、デスクトップアプリ、CLI、IDE拡張、Webなど複数の入口が案内されています。最初の依頼には、目的、対象ファイル、触れてはいけない範囲、確認したいテストを明記すると、結果の判断がしやすくなります。
対応環境を確認する
macOSではデスクトップアプリのプロジェクト管理を中心に考え、Windowsではアプリの対応状況に加えて、ローカルの開発環境とWSLの関係を確認します。公式ヘルプによると、Windows版にはWSLのディストリビューション選択があり、複数の環境を使っている場合は対象を間違えないことが重要です。会社の端末で更新が管理されている場合は、利用できる版が管理者の承認済みかも確認します。
先に決める作業範囲
「このプロジェクトを改善して」のような依頼は広すぎます。最初は「ログイン画面の表示崩れを調べ、関連するテンプレートとスタイルだけを変更する」のように範囲を狭めます。データベースや外部サービスに関係する作業なら、読み取りだけにするのか、変更案の提示までにするのかを分けます。Codexが何をしないかも書いておくと、完成の定義が明確になります。
Codex appの始め方――最初の依頼から差分確認まで
ここでは、既存プロジェクトの小さな不具合を調べる場面を想定します。いきなり大規模な改修を依頼せず、対象を限定して、調査結果を読んでから次の依頼へ進みます。画面上のボタン名や配置は版によって変わる可能性があるため、表示が異なるときは公式ドキュメントの現行案内を優先してください。
Step 1: デスクトップアプリでCodexを選ぶ
ChatGPTのデスクトップアプリを開き、メニューからCodexを選びます。初回はChatGPTアカウントでサインインし、表示された利用条件と対象環境を確認します。OpenAIのCodex app紹介ページはmacOS向けに始まった製品がWindowsにも広がった経緯を説明しているため、古い記事だけを見てWindows非対応と判断しないための基準になります。利用できる画面がない場合は、プラン、地域、端末の管理状態を確認します。
Step 2: プロジェクトのフォルダーを開く
作業対象のリポジトリを開いたら、現在の変更を確認します。すでに編集途中のファイルがある場合は、そのまま混ぜず、何が自分の変更で何がCodexの変更か分かる状態にします。依頼の最初に「まず構成を読み、変更せずに関連ファイルと原因候補を説明してください」と伝えると、調査と編集を分けられます。フォルダーを選ぶときは、親ディレクトリを広く指定するより、対象プロジェクトそのものを選ぶ方が確認しやすくなります。
Step 3: 依頼文に完了条件を書く
依頼文には、目的だけでなく、成功したと判断する条件を書きます。たとえば「商品一覧のスマートフォン表示で横スクロールが出ないようにする。既存のデスクトップ表示は保ち、関連する画面のテストを実行し、変更ファイルと確認結果を説明する」とします。エラーが再現する入力、期待する画面、変更してよい範囲があれば追加します。Codexが途中で質問したときは、曖昧なまま進めず、判断に必要な情報を返します。
Step 4: 提案と差分を確認する
変更が提示されたら、まずファイル名と変更行数を見ます。次に、依頼した目的と直接関係する変更だけか、既存の命名や構成を壊していないかを確認します。差分の説明が短くても、実際のコードを読んで判断します。不要な整形、関係のない依存関係の変更、テストの削除が含まれていれば、理由を尋ねて範囲を戻します。採用する前に、変更前後の画面や出力を比べることも有効です。
Step 5: テスト結果と残課題を読む
テストが通ったという表示だけで完了とは決めません。どのテストを実行したか、対象範囲に足りているか、警告や未確認の条件が残っていないかを見ます。テストが失敗した場合は、失敗ログをそのまま渡して原因調査を依頼し、別の問題まで広げないようにします。最後に、変更したファイル、確認したコマンド、手作業で確認すべき画面、残っている懸念を短くまとめてもらうと、レビューを引き継げます。
依頼文の作り方――結果を読みやすくする四つの視点
Codex appでは、長い説明を一度に詰め込むより、目的と確認基準を整理して渡す方が安定します。依頼文は会話のたびに更新できますが、前の説明と矛盾する指示が増えると判断が難しくなります。最初に基本条件を決め、調査結果を読んでから、必要な追加条件だけを渡すのが実用的です。依頼文そのものよりも、何を確認すれば採用できるかが伝わることを重視します。
目的・範囲・完了条件
「何を良くするか」「どのファイルや画面が対象か」「どの状態なら終わりか」を一組にします。目的が性能改善なら測定値、表示修正なら再現条件、バグ修正なら失敗する入力と期待結果を書きます。対象外も明記します。たとえばAPIの設計変更をしない、依存関係を増やさない、文章だけ先に変更案を出す、といった条件は、不要な差分を減らす手掛かりになります。
変更を小さく区切る
調査、実装、検証を一つの依頼にまとめる場合でも、途中の確認点を置きます。まず原因候補と関連ファイルを出してもらい、次に最小の修正を依頼し、最後にテスト結果を確認します。大きな変更を一度に任せると、問題が起きたときにどの判断が原因か分かりにくくなります。画面、データ処理、テストのように責任範囲が異なる部分は、依頼を分ける方が差分を読めます。
返却形式を指定する
最後に「変更したファイル」「変更理由」「実行した確認」「未確認の点」を見出し付きで返すよう指定します。専門用語を減らした説明が必要なら、先に概要、その後に技術的な詳細という順番も伝えます。結果の形式がそろうと、複数の依頼を比較しやすくなります。エラーが残ったときは、成功したように見せず、再現手順と次の候補を分けて示すよう求めます。
モデルと速度の選び方――作業の難しさに合わせる
Codex appで選べるモデルや推論の設定は、アカウント、地域、版によって異なります。ここで大切なのは、最も大きなモデルを常に選ぶことではありません。単純な文言修正や狭い範囲のリファクタリングでは応答の速さが助けになり、複数のファイルにまたがる設計変更では、背景を読み、条件を保ちながら検証する力が重要です。OpenAIのGPT-5.3-Codexモデル情報では、エージェント型のコーディング向けモデルとして、複数の推論段階と大きなコンテキストが案内されています。ただし、APIの仕様や価格を、そのままアプリの利用量に置き換えないでください。
難しい変更は推論の深さを優先する
既存コードの関係を読み、テストの不足を考え、複数案を比較する作業では、短い回答より検討時間を取る設定が役立ちます。依頼文に「変更前に前提を列挙し、リスクの高い点を示す」と書くと、モデルの設定だけに頼らず確認できます。時間がかかる場合も、途中で確認すべき到達点を決めておけば、結果を読む負担を抑えられます。
小さな修正は速度を優先する
文言、余白、単一ファイルの型エラーなど、影響範囲が見えている作業は速い設定から始められます。ただし、速さは確認を省く理由にはなりません。変更対象を一つに絞り、差分と短いテストを必ず確認します。思ったより関係ファイルが広がったら、依頼を止めて、原因調査と実装を分けた設定に切り替えます。
料金と利用量を混同しない
Codexの利用料金を調べるときは、ChatGPTプランの利用上限と、APIでトークンを使う場合の価格を分けて見ます。公式ヘルプには、CodexはFreeやGoを含むプランで提供され、上限はプランによって変わるとあります。モデル情報に表示されるAPI価格は、デスクトップアプリの請求額を直接表すものではありません。契約中のプラン、残りの利用量、追加購入の条件は、OpenAIの料金案内で自分のアカウントに表示される内容を確認してください。
Windowsで使うときの確認――アプリと開発環境を切り分ける
Windowsでは、アプリが開くかどうかと、プロジェクトの開発環境が正しく動くかどうかを分けて調べます。アプリにサインインできても、選択したフォルダーの依存関係やテスト環境が準備されているとは限りません。反対に、端末のコマンドが動いても、アプリ側の権限や接続状態で止まることがあります。問題が起きたら、アプリの版、Windowsの環境、WSLのディストリビューション、プロジェクトのテストを一つずつ確認します。
WSLのディストリビューションを合わせる
複数のWSL環境がある場合、Node.jsやPythonなどの版、パッケージ、環境変数が異なることがあります。公式ヘルプが案内するディストリビューション選択で、普段テストに使う環境を指定します。どれを選ぶか分からないときは、まず端末で対象プロジェクトのテストが通る環境を確認し、その名前と目的を依頼文に書きます。Windows側のフォルダーとWSL側のパスを混ぜず、変更先を一つに固定することも重要です。
Codex Doctorで診断する
起動、接続、速度に問題があるときは、公式ヘルプに記載されたcodex doctorを診断の入口にします。結果を読まずに何度も再インストールするのではなく、どの項目が失敗しているかを分けます。サインインの問題、ネットワークの問題、プロジェクトの依存関係の問題は対処が異なります。診断結果を共有するときは、プロジェクトの中身や個人情報が表示されていないか確認してから必要な部分だけを使います。
Windows固有の問題を小さく切り分ける
ファイルの権限、長いパス、改行コード、シェルの違いは、コードの誤りと別の原因で失敗することがあります。まず新しい小さなフォルダーで読み取りと簡単なテストを試し、アプリと接続が正常かを確認します。その後に対象リポジトリへ戻り、失敗が再現する操作を一つずつ追加します。アプリ自体の問題とプロジェクト設定の問題を分けるだけで、調査の方向が安定します。
差分レビューと安全な進め方――採用するのは人
Codex appは、変更案を出す時間を短くできますが、出力をそのまま採用する仕組みではありません。対象ファイルの差分、テストの内容、画面やログの変化を人が確かめます。特に認証、決済、個人情報、削除処理のように失敗時の影響が大きい箇所は、正常系だけでなく失敗時の挙動も確認します。作業の速さより、何を根拠に採用したかが後から分かることを優先します。
設計と実装を分ける
最初の依頼で設計案を複数出してもらい、採用する案を決めてからコードの変更を依頼します。案を比較するときは、変更ファイルの数、既存機能への影響、テストのしやすさ、戻しやすさを見ます。設計が決まっていない状態で実装まで進むと、きれいに見えるが目的に合わない変更が残りやすくなります。決めた理由を短く記録しておくと、後の修正でも判断がぶれません。
ファイル範囲と差分の大きさを見る
依頼したファイル以外に変更が広がっていないかを最初に確認します。広がる理由が必要な場合は、Codexにファイルごとの理由を説明させます。整形だけの変更が大量に混ざると、本当の修正点が読みにくくなるため、目的に直接関係しない整形は分けます。差分が大きくなったときは、一度に採用せず、機能ごとに区切ってテストします。
外部操作は確認を置く
公開、送信、データの更新、課金に関わる操作は、内容と宛先を人が確認してから進めます。テスト用と本番用の環境を明確に分け、実データを使わずに確認できる場合は先にそちらを選びます。Codexに「実行前に対象、入力、影響を説明し、確認を待つ」と伝えると、重要な分岐で立ち止まりやすくなります。確認を省くことが速さにつながるとは限りません。
Codex app serverと周辺ツール――今の案内に合わせる
Codexをアプリだけで使う人にも、周辺ツールの変更は画面の説明や古い記事を読むときに関係します。2026年8月24日の公式案内は、codex mcp-serverコマンドを非推奨とし、Codex app serverを使う方向を示しました。ここで重要なのは、MCPという接続規格そのものが使えなくなったと短絡しないことです。どの機能が、どの入口から、どの版で提供されるのかを分けて確認します。
codex mcp-serverを見かけたら
古いメモや記事にcodex mcp-serverが出てきた場合は、まずOpenAIの現行リリースノートを開きます。既存の手順をそのままコピーせず、現在のCodex本体と接続先が何かを確認します。アプリで通常のコーディングをするだけなら、コマンドの移行を自分で実施する必要はありません。外部ツールからCodexを利用している場合だけ、現行のapp server案内と公式ドキュメントを読み、短い検証を行います。
MCPと拡張の使い分け
MCPやIDE拡張は、必要な情報や操作をCodexの作業に加えるための手段です。便利そうだからといって最初から多くを加えると、どの接続が原因で問題が起きたか分かりにくくなります。まず標準のプロジェクト読み取りとテストを確認し、必要な機能を一つずつ追加します。追加後は、読み取れる情報、実行できる操作、確認が必要な場面を記録して、アプリの通常利用と切り分けます。
旧手順を見直すときの基準
手順の更新では、日付、対象OS、Codex本体の版、モデル名、アプリ画面を同じ欄に書かないことがポイントです。日付だけ新しくても、参照しているコマンドが古ければ再現できません。公式ページの更新日とリリース番号を確認し、試験的な版を使う理由があるかを決めます。読者に案内する場合は、現在の基本手順と、特定の連携を使う人向けの補足を分けて書きます。
Codex appとCursor・GitHub Copilotの違い――入口で選ぶ
Codex app、Cursor、GitHub Copilotはいずれもコード作業を助けますが、中心となる画面が違います。Codex appはプロジェクト単位で依頼を整理し、長めの作業を差分と会話で確認する入口です。Cursorはエディターで書きながら補完や編集を続けたい人に向き、GitHub Copilotは対応するエディターやGitHub上で、提案やレビュー支援を取り入れたい人に向きます。優劣ではなく、今どこでコードを読んでいるかで選びます。
Codex app向きの人
複数の課題を分けて調べたい人、変更の理由と差分をまとめて読みたい人、リポジトリを開いてテストまで確認したい人はCodex appから試す価値があります。最初に小さな不具合を選び、調査、変更、検証の順に依頼すると、アプリの利点が分かります。エディターを離れたくない場合でも、最終的な差分確認の場所として使う方法があります。
Cursor向きの人
編集中のファイルを見ながら、近くのコードを補完したり、選択範囲をすぐ書き換えたりしたい場合はCursorが候補になります。詳しい機能や現在の料金は、Cursor公式ドキュメントと公式の料金案内を確認します。Codex appと同じモデル名が表示されても、コンテキストの渡し方、編集画面、確認の単位は異なるため、名前だけで使い勝手を判断しません。
GitHub Copilot向きの人
GitHub上のプルリクエストや対応エディターを中心に、提案、説明、レビューを受けたい場合はGitHub Copilotが候補です。最新の提供範囲はGitHub Copilot公式ドキュメントで確認します。Codex appと併用するときは、同じ変更を二つの入口で同時に編集せず、調査する場所と差分を採用する場所を決めておくと、変更の出どころを追いやすくなります。
よくあるつまずき――原因を一つずつ分ける
Codex appの不具合に見えても、アカウント、アプリの版、接続、OS、プロジェクト設定、依頼文のどこかが原因かもしれません。画面のエラー文を短く記録し、いつ、どのプロジェクトで、何をした後に起きたかを残します。別の小さなプロジェクトで同じ操作を試すと、アプリ全体の問題か対象プロジェクトの問題かを分けられます。原因が分からないまま設定を何度も変えると、元の状態を失います。
プロジェクトを開けない
フォルダーの場所、読み取り権限、同期中のファイル、WSLの選択を確認します。対象フォルダーを一段浅い場所に変えるのではなく、まず同じ場所を端末やエディターで開けるか調べます。アプリだけが開けないなら、版とサインイン状態を確認し、別の小さなプロジェクトで再現するかを見ます。プロジェクト固有の依存関係が原因なら、アプリを入れ直しても直りません。
変更は見えるがテストが失敗する
テストが対象の変更を見ているか、必要なパッケージが同じ環境にあるか、失敗が変更前からあったかを確認します。Codexには失敗ログと期待結果を渡し、コードを広げる前に原因候補を列挙させます。環境の違いなら、アプリの問題と決めつけず、選択中のWSLや実行場所を見直します。テストが通ることと、利用者の画面で正しく見えることは別なので、必要なら手作業でも確認します。
何度も同じ修正が戻る
同じ変更が繰り返される場合は、依頼の完了条件が曖昧か、別のファイルに元の設定が残っています。まずCodexに、現在の差分、関連する設定、テスト結果を要約させます。その上で、採用したい実装方針と採用しない案を明記します。会話を延々と続けるより、状態を整理した新しい依頼に切り替えた方が、前提の混線を減らせる場合があります。
まとめ――Codex appは確認しながら任せるための入口
Codex appを始めるときは、アプリを開くことよりも、対象プロジェクト、変更範囲、完了条件を決めることが先です。小さな調査で画面と差分の見方を覚え、依頼、実装、テスト、レビューを分けて進めると、出力の良し悪しを判断しやすくなります。WindowsではWSLやcodex doctorを使って、アプリの問題と開発環境の問題を切り分けます。
2026年8月24日のリリースノートにあるapp serverへの案内、8月29日の0.152.0-alpha.1の公開は、Codex周辺が更新され続けていることを示します。だからこそ、アプリ、CLI、IDE拡張、モデルの情報を一つに混ぜず、使っている入口の公式情報を確認します。料金はプランの利用上限とAPI価格を分けて見て、重要な変更は差分とテストを人が確認してください。OpenAIのCodex公式情報とopenai/codexの公式リリースを基準にすれば、古い手順に引っ張られず、現在の使い方を更新できます。