1. Codexとは
Codexは「AIにプログラミング作業を任せられる開発パートナー」です。
コードを書くだけでなく、既存コードの修正、バグ修正、機能追加、アプリ開発、Webサイト制作、診断ツール作成、コードレビューなどに使えます。
OpenAI公式では、Codexはコードを書き、レビューし、出荷するためのAIエージェントとして説明されています。
Codexは、コードを読む、変更する、コマンドを実行する、テストを走らせる、レビューする、といった作業を手伝うAIコーディングエージェントです。
コーディングエージェントとは、単に質問に答えるだけでなく、プロジェクトの中身を確認し、必要に応じてファイル編集や確認作業まで進めるAIのことです。
既存プロジェクトの理解、バグ修正、小さな機能追加、テスト追加、リファクタリング、コードレビュー、ドキュメント作成、繰り返し作業の自動化に向いています。
2. Codexでできること一覧
Codexには、調べる、直す、作る、確認する、まとめる、任せる、という使い方があります。目的に近い分類を選んで依頼すると、最初の一歩がかなり楽になります。
ローカル環境では、Codex CLIが選択したフォルダ内のコードを読み取り、変更し、実行できます。クラウド版では、複数の開発タスクを並行して進める用途にも使えます。
3. Codexで作る成果物の例
Codexに頼むと、単なる回答だけでなく、実際に使える画面、ファイル、コード、説明文、確認結果まで作れます。下の例は「完成したら何が手元に残るか」が分かるようにまとめたものです。
占い・診断LP
質問に答えると診断結果が出る、集客用の1ページサイトです。スマホで読みやすいトップ、質問フォーム、結果画面、LINE登録への導線まで作れます。
予約フォームつきWebアプリ
ユーザーが日時やメニューを選んで予約できる画面です。入力チェック、確認画面、送信完了画面、管理者向けの一覧画面まで広げられます。
診断結果を管理できる管理画面
運営者が診断文や毎月のメッセージを編集できる画面です。コードを直接触らずに、文章や表示内容を更新する仕組みを作れます。
LINE連携の設計・実装案
診断後にLINE登録へつなげたり、友だち追加後に結果を送る仕組みの設計を作れます。実装に必要な画面、データ、API連携の流れも整理できます。
自動計算ツール
生年月日や入力値から結果を自動判定するツールです。計算ロジック、結果表示、入力ミス防止、説明文までまとめて作れます。
既存サイトの改善版
今あるサイトの表示崩れ、ボタン配置、スマホ対応、フォーム不具合を直した成果物です。変更前後の差分と確認結果も残せます。
開発ドキュメント一式
プロジェクトの使い方、起動方法、設定方法、変更手順をまとめたドキュメントです。引き継ぎや外注先への共有に使えます。
成果物を頼むときのコツ
「誰が使うか」「どんな入力があるか」「どんな結果を出すか」「スマホ対応が必要か」「保存や通知が必要か」を伝えると、完成イメージに近づきます。
このREADMEを、初めて触る人でも起動できる内容に整えてください。
含める内容は、概要、必要なもの、起動方法、テスト方法、よくあるエラーです。
この不具合の調査レポートを作ってください。
原因、影響範囲、修正方針、確認方法、再発防止策を短くまとめてください。
4. 使う場所を選ぶ
Codexアプリ
普段使いにおすすめです。プロジェクトごとにスレッドを分けたり、複数の作業を並行したり、差分を見ながら進めたりできます。
スレッドは、Codexとの1つの作業単位です。相談、調査、修正、確認の流れをまとめて残せます。
- ローカルのプロジェクトを一緒に直す
- 複数スレッドで作業を分ける
- Git差分を見ながら調整する
- Worktreeで変更を分離する
IDE拡張
VS Code、Cursor、Windsurf、JetBrains系IDEなど、エディタの横でCodexを使いたいときに向いています。
IDEは、コードを書くための編集アプリです。VS CodeやCursorのような開発用エディタを指します。
CLI
ターミナル中心で作業する人向けです。プロジェクトのディレクトリで codex を起動して使います。
CLIは、文字でコマンドを入力して操作する画面です。WindowsならPowerShell、macOSならターミナルが代表例です。
Codex Web / Cloud
ブラウザやクラウド環境で作業を委任したいときに使います。GitHub連携やクラウド環境の設定が必要な場合があります。
Cloudは、自分のPCではなくOpenAI側などのリモート環境で作業を進める使い方です。
5. 最初の始め方
Codexアプリで始める
- Codexアプリをインストールします。
- ChatGPTアカウントまたはOpenAI APIキーでサインインします。
- 作業したいプロジェクトフォルダを選びます。
- 最初は
Localを選び、ローカルのファイルを対象にします。 - 「このプロジェクトについて説明して」と頼んで、Codexに構成を読ませます。
IDE拡張で始める
- 使っているIDEにCodex拡張をインストールします。
- サイドバーからCodexを開きます。
- ChatGPTアカウントまたはAPIキーでサインインします。
- まずは「このプロジェクトの構成を説明して」と頼みます。
CLIで始める
- Codex CLIをインストールします。
- プロジェクトのフォルダをターミナルで開きます。
codexを実行します。- 初回はサインインします。
6. モードの考え方
Local
現在のプロジェクトフォルダを直接作業します。小さな修正や調査に向いています。
Localは、自分のPC上にあるファイルを対象にする作業モードです。
Worktree
Git worktreeを使って変更を分離します。大きめの機能追加、複数案の比較、失敗しても戻しやすくしたい作業に便利です。
Worktreeは、同じGitプロジェクトから別の作業場所を作る仕組みです。元の作業場所を汚さずに変更を試せます。
Cloud
リモート環境でCodexに作業を委任します。GitHub Issueからの実装、PR作成、ローカルPCに依存しない作業に向いています。
7. 良い依頼文の作り方
Codexへの依頼には、目的、範囲、制約、確認方法、出力形式を入れると精度が上がります。
ログイン画面でメール未入力時のエラー表示が出ません。
原因を調べて、最小限の変更で修正してください。
既存のデザインや文言はなるべく変えないでください。
修正後に関連テストを実行し、結果を教えてください。
このプロジェクトの構成を初心者向けに説明してください。
特に、どこからアプリが起動し、主要な画面がどのファイルにあるかを知りたいです。
まだコード変更はしないでください。
8. Codexに任せやすい作業
調査
このエラーの原因を調べてください。まだ修正はせず、原因と修正案を教えてください。
修正
この不具合を最小限の変更で修正してください。既存の挙動を壊さないようにしてください。
テスト追加
この機能に足りないテストを追加してください。既存のテストスタイルに合わせてください。
レビュー
この差分をレビューしてください。指摘は重要度順に、ファイルと行番号つきでお願いします。
9. 作業中の確認ポイント
- 最初に目的を伝える
- Codexに調査させる
- 変更範囲を確認する
- 実装させる
- テストやビルドを実行させる
- 差分を確認する
- 必要なら修正を頼む
- 最後に要約をもらう
余計なファイルを変更していないか、既存仕様を壊していないか、テストやビルドが通っているかを確認します。
10. 権限と安全性
Codexはファイルを読んだり、変更したり、コマンドを実行したりできます。作業内容によっては承認が必要になります。
- 破壊的な操作は慎重に扱う
- 大量削除やリセットは明示的に確認する
- APIキーやパスワードを貼らない
- 本番データを扱う場合は範囲を限定する
- 変更前にGitの状態を確認する
変更前に、どのファイルを触る予定か教えてください。
削除や大きな移動が必要な場合は、先に確認してください。
11. Gitとの付き合い方
Codexアプリには、差分表示、ステージ、コミット、プッシュ、PR作成などのGit機能があります。
Gitは、ファイルの変更履歴を管理する仕組みです。PRはPull Requestの略で、変更内容をチームに確認してもらうための提案です。
- 作業前に現在の変更状態を確認する
- Codexに作業を頼む
- 差分を見る
- 必要なら修正を頼む
- テストを実行する
- コミットする
- 必要ならPRを作る
大きな作業はWorktreeで分け、1つの依頼で1つの目的に絞ると安定します。
12. 使用量とクレジット
Codexの使用量は、契約プラン、使うモデル、作業の大きさ、ローカル作業かクラウド作業かによって変わります。
クレジットは、上限を超えてCodexを使うときなどに消費される利用単位です。Usage Dashboardは、現在の使用状況を確認する画面です。
- 小さな修正は消費が少なめです。
- 大きなコードベース、長い作業、長い会話は消費が増えます。
- 画像生成など一部の機能は、通常のやり取りより使用量を早く消費する場合があります。
- 現在の使用量はCodexのUsage Dashboardや、CLIの
/statusで確認できます。
13. 困ったときの頼み方
意図と違う変更をした
今の変更は意図と違います。目的は維持したまま、変更範囲を対象ファイルだけに絞ってやり直してください。
テストが失敗した
失敗したテストの原因を調べてください。修正が必要な場合は、最小限の変更で直してください。
変更が大きくなりすぎた
今回の目的に必要な変更だけに絞ってください。関係ない整理やリファクタリングは戻してください。
14. おすすめの定型文
プロジェクト理解
このプロジェクトの構成を説明してください。
主要なフォルダ、起動方法、テスト方法、変更時に注意する点をまとめてください。
まだコード変更はしないでください。
バグ修正
次の不具合を調査して修正してください。
再現条件:
期待する挙動:
実際の挙動:
制約:
修正後に関連テストを実行してください。
機能追加
次の機能を追加してください。
目的:
対象画面/対象ファイル:
仕様:
変えてほしくないこと:
確認方法:
PR説明文
この変更のPR説明文を作ってください。
含める内容は、概要、変更点、確認方法、注意点です。
15. 用語集
本文に出てくる専門用語を、短く確認できるようにまとめました。
コードの調査、編集、実行、レビューを手伝うOpenAIのAIエージェントです。
指示を受けて、調査やファイル編集など複数の手順を進められるAIのことです。
コードを書くための編集アプリです。VS Code、Cursor、Windsurf、JetBrains系IDEなどがあります。
キーボードでコマンドを入力して操作する画面です。PowerShellやターミナルが代表例です。
自分のPC上のプロジェクトフォルダを直接対象にする作業モードです。
自分のPCではなく、リモート環境でCodexに作業させる使い方です。
ファイルの変更履歴を管理する仕組みです。変更前に戻したり、作業を分けたりできます。
同じGitプロジェクトから、別の作業場所を作る仕組みです。変更を分離したいときに便利です。
変更内容をGitの履歴として保存する操作です。
Pull Requestの略です。変更内容をレビューしてもらい、取り込むための提案です。
サービスをプログラムから使うための認証用キーです。パスワードのように扱い、公開しないでください。
動作を変えずに、コードを読みやすく整理する作業です。
コードが期待どおり動くか確認するための仕組みや作業です。
アプリを実行・公開できる形に変換する作業です。
変更前と変更後で、どこが変わったかを示す表示です。
Codexの使用量やクレジット残量を確認する画面です。
16. 参照元
このWebアプリは、2026-06-08時点で確認した公式情報をもとに作成しています。