OpenAI Codex Practical Guide

Codexを使って、作りたいものを形にするための実用ガイド

Webサイト、診断ツール、管理画面、コード修正、レビューまで。Codexで何ができて、どう頼めばよいかを1ページで確認できます。

診断LP 質問フォーム、結果画面、LINE登録導線までまとめて作成
管理画面 診断文やユーザー情報を編集
コード修正 不具合調査から確認まで対応
ドキュメント README、仕様書、PR説明文、操作マニュアルを整理
できることが分かるWeb制作、アプリ開発、診断ツール、修正、レビューを一覧化。
成果物が想像できる完成したら何が手元に残るか、使い道と頼み方まで確認。
そのまま頼めるCodexに貼れる依頼文テンプレートを用途別に掲載。

一致する項目がありません。別のキーワードで検索してください。

1. Codexとは

Codexは「AIにプログラミング作業を任せられる開発パートナー」です。

コードを書くだけでなく、既存コードの修正、バグ修正、機能追加、アプリ開発、Webサイト制作、診断ツール作成、コードレビューなどに使えます。

OpenAI公式では、Codexはコードを書き、レビューし、出荷するためのAIエージェントとして説明されています。

Codexは、コードを読む、変更する、コマンドを実行する、テストを走らせる、レビューする、といった作業を手伝うAIコーディングエージェントです。

コーディングエージェントとは、単に質問に答えるだけでなく、プロジェクトの中身を確認し、必要に応じてファイル編集や確認作業まで進めるAIのことです。

既存プロジェクトの理解、バグ修正、小さな機能追加、テスト追加、リファクタリング、コードレビュー、ドキュメント作成、繰り返し作業の自動化に向いています。

最初の一言は「このプロジェクトの構成を説明して」がおすすめです。いきなり大きな変更を頼むより、Codexに全体像を読ませると作業が安定します。

2. Codexでできること一覧

Codexには、調べる、直す、作る、確認する、まとめる、任せる、という使い方があります。目的に近い分類を選んで依頼すると、最初の一歩がかなり楽になります。

分類できること具体例
Webサイト制作ホームページやLPを作る自己紹介LP、サービス紹介LP、占い診断LP、加盟店募集ページ
Webアプリ制作ブラウザで動くシステムを作る診断アプリ、予約フォーム、会員ページ、管理画面
スマホアプリ制作アプリの設計やコード作成を支援する占いアプリ、ポイ活アプリ、健康チェックアプリ
占い・診断ツール質問や生年月日から結果を出す気学診断、MBTI診断、防災タイプ診断、健康タイプ診断
LINE連携LINE公式と連携する仕組みを作る診断結果をLINEで送る、友だち追加後に自動診断
データベース設計診断結果や顧客情報を管理する構造を考える色×数字×言葉の占いDB、会員DB、予約DB
自動計算ツール入力値から自動判定する本命星・月命星計算、最大吉方計算、相性診断
管理画面運営者が編集できる画面を作る診断文の編集、毎月の言葉変更、ユーザー管理
バグ修正動かないコードを直すエラー原因の特定、表示崩れ修正、フォーム不具合修正
機能追加既存サイトに新機能を追加する決済追加、ログイン追加、PDF出力、メール通知
コードレビューコードの問題点を確認するセキュリティ、速度、保守性のチェック
リファクタリングコードを整理する読みにくいコードを整理、重複処理を削除
テスト作成不具合を防ぐ確認コードを作る診断結果が正しく出るか自動テスト
デザイン調整見た目を整えるボタン配置、スマホ対応、色変更、LPレイアウト
GitHub連携開発履歴や修正提案を管理する修正案をPull Requestとして作成
既存システム解析他のコードを理解する何の処理をしているか説明、改善案を出す

ローカル環境では、Codex CLIが選択したフォルダ内のコードを読み取り、変更し、実行できます。クラウド版では、複数の開発タスクを並行して進める用途にも使えます。

3. Codexで作る成果物の例

Codexに頼むと、単なる回答だけでなく、実際に使える画面、ファイル、コード、説明文、確認結果まで作れます。下の例は「完成したら何が手元に残るか」が分かるようにまとめたものです。

占い・診断LP

質問に答えると診断結果が出る、集客用の1ページサイトです。スマホで読みやすいトップ、質問フォーム、結果画面、LINE登録への導線まで作れます。

成果物index.html、診断ロジック、結果文、スマホ対応デザイン 使い道SNS広告、LINE登録導線、イベント用診断ページ 頼み方「防災タイプ診断LPを作って。5問に答えると4タイプの結果が出て、最後にLINE登録ボタンを出して」

予約フォームつきWebアプリ

ユーザーが日時やメニューを選んで予約できる画面です。入力チェック、確認画面、送信完了画面、管理者向けの一覧画面まで広げられます。

成果物予約フォーム、確認画面、予約データ保存処理、管理画面 使い道個人サロン、鑑定予約、講座予約、相談受付 頼み方「鑑定予約フォームを作って。名前、メール、希望日時、相談内容を入力して、送信後に確認メッセージを表示して」

診断結果を管理できる管理画面

運営者が診断文や毎月のメッセージを編集できる画面です。コードを直接触らずに、文章や表示内容を更新する仕組みを作れます。

成果物ログイン画面、編集画面、一覧画面、保存処理、入力チェック 使い道占いDB更新、月間メッセージ変更、会員向けコンテンツ管理 頼み方「診断結果の文章を編集できる管理画面を作って。タイプ名、説明文、ラッキーカラーを編集できるようにして」

LINE連携の設計・実装案

診断後にLINE登録へつなげたり、友だち追加後に結果を送る仕組みの設計を作れます。実装に必要な画面、データ、API連携の流れも整理できます。

成果物連携フロー図、必要なデータ項目、Webhook処理案、実装コードのたたき台 使い道診断マーケティング、ステップ配信、会員フォロー 頼み方「診断結果をLINE公式に連携する構成を考えて。友だち追加後に結果を送る流れと必要な実装をまとめて」

自動計算ツール

生年月日や入力値から結果を自動判定するツールです。計算ロジック、結果表示、入力ミス防止、説明文までまとめて作れます。

成果物入力フォーム、計算ロジック、結果画面、テストデータ 使い道本命星計算、相性診断、健康タイプ判定、料金見積もり 頼み方「生年月日から本命星を計算するWebツールを作って。入力例と計算結果の確認テストも付けて」

既存サイトの改善版

今あるサイトの表示崩れ、ボタン配置、スマホ対応、フォーム不具合を直した成果物です。変更前後の差分と確認結果も残せます。

成果物修正済みコード、変更点の説明、確認済み項目、必要ならスクリーンショット 使い道LP改善、問い合わせ率改善、スマホ表示改善 頼み方「このLPをスマホで見やすく直して。ボタンを押しやすくして、文章が重ならないようにして」

開発ドキュメント一式

プロジェクトの使い方、起動方法、設定方法、変更手順をまとめたドキュメントです。引き継ぎや外注先への共有に使えます。

成果物README、操作マニュアル、仕様書、PR説明文、調査レポート 使い道開発引き継ぎ、チーム共有、保守運用、外注依頼 頼み方「このプロジェクトを初めて触る人向けにREADMEを作って。起動方法、テスト方法、よくあるエラーを入れて」

成果物を頼むときのコツ

「誰が使うか」「どんな入力があるか」「どんな結果を出すか」「スマホ対応が必要か」「保存や通知が必要か」を伝えると、完成イメージに近づきます。

この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アプリで始める

  1. Codexアプリをインストールします。
  2. ChatGPTアカウントまたはOpenAI APIキーでサインインします。
  3. 作業したいプロジェクトフォルダを選びます。
  4. 最初は Local を選び、ローカルのファイルを対象にします。
  5. 「このプロジェクトについて説明して」と頼んで、Codexに構成を読ませます。

IDE拡張で始める

  1. 使っているIDEにCodex拡張をインストールします。
  2. サイドバーからCodexを開きます。
  3. ChatGPTアカウントまたはAPIキーでサインインします。
  4. まずは「このプロジェクトの構成を説明して」と頼みます。

CLIで始める

  1. Codex CLIをインストールします。
  2. プロジェクトのフォルダをターミナルで開きます。
  3. codex を実行します。
  4. 初回はサインインします。

6. モードの考え方

Local

現在のプロジェクトフォルダを直接作業します。小さな修正や調査に向いています。

Localは、自分のPC上にあるファイルを対象にする作業モードです。

Worktree

Git worktreeを使って変更を分離します。大きめの機能追加、複数案の比較、失敗しても戻しやすくしたい作業に便利です。

Worktreeは、同じGitプロジェクトから別の作業場所を作る仕組みです。元の作業場所を汚さずに変更を試せます。

Cloud

リモート環境でCodexに作業を委任します。GitHub Issueからの実装、PR作成、ローカルPCに依存しない作業に向いています。

7. 良い依頼文の作り方

Codexへの依頼には、目的、範囲、制約、確認方法、出力形式を入れると精度が上がります。

ログイン画面でメール未入力時のエラー表示が出ません。
原因を調べて、最小限の変更で修正してください。
既存のデザインや文言はなるべく変えないでください。
修正後に関連テストを実行し、結果を教えてください。
このプロジェクトの構成を初心者向けに説明してください。
特に、どこからアプリが起動し、主要な画面がどのファイルにあるかを知りたいです。
まだコード変更はしないでください。

8. Codexに任せやすい作業

調査

このエラーの原因を調べてください。まだ修正はせず、原因と修正案を教えてください。

修正

この不具合を最小限の変更で修正してください。既存の挙動を壊さないようにしてください。

テスト追加

この機能に足りないテストを追加してください。既存のテストスタイルに合わせてください。

レビュー

この差分をレビューしてください。指摘は重要度順に、ファイルと行番号つきでお願いします。

9. 作業中の確認ポイント

  1. 最初に目的を伝える
  2. Codexに調査させる
  3. 変更範囲を確認する
  4. 実装させる
  5. テストやビルドを実行させる
  6. 差分を確認する
  7. 必要なら修正を頼む
  8. 最後に要約をもらう

余計なファイルを変更していないか、既存仕様を壊していないか、テストやビルドが通っているかを確認します。

10. 権限と安全性

Codexはファイルを読んだり、変更したり、コマンドを実行したりできます。作業内容によっては承認が必要になります。

  • 破壊的な操作は慎重に扱う
  • 大量削除やリセットは明示的に確認する
  • APIキーやパスワードを貼らない
  • 本番データを扱う場合は範囲を限定する
  • 変更前にGitの状態を確認する
変更前に、どのファイルを触る予定か教えてください。
削除や大きな移動が必要な場合は、先に確認してください。

11. Gitとの付き合い方

Codexアプリには、差分表示、ステージ、コミット、プッシュ、PR作成などのGit機能があります。

Gitは、ファイルの変更履歴を管理する仕組みです。PRはPull Requestの略で、変更内容をチームに確認してもらうための提案です。

  1. 作業前に現在の変更状態を確認する
  2. Codexに作業を頼む
  3. 差分を見る
  4. 必要なら修正を頼む
  5. テストを実行する
  6. コミットする
  7. 必要ならPRを作る

大きな作業はWorktreeで分け、1つの依頼で1つの目的に絞ると安定します。

12. 使用量とクレジット

Codexの使用量は、契約プラン、使うモデル、作業の大きさ、ローカル作業かクラウド作業かによって変わります。

クレジットは、上限を超えてCodexを使うときなどに消費される利用単位です。Usage Dashboardは、現在の使用状況を確認する画面です。

  • 小さな修正は消費が少なめです。
  • 大きなコードベース、長い作業、長い会話は消費が増えます。
  • 画像生成など一部の機能は、通常のやり取りより使用量を早く消費する場合があります。
  • 現在の使用量はCodexのUsage Dashboardや、CLIの /status で確認できます。

13. 困ったときの頼み方

意図と違う変更をした

今の変更は意図と違います。目的は維持したまま、変更範囲を対象ファイルだけに絞ってやり直してください。

テストが失敗した

失敗したテストの原因を調べてください。修正が必要な場合は、最小限の変更で直してください。

変更が大きくなりすぎた

今回の目的に必要な変更だけに絞ってください。関係ない整理やリファクタリングは戻してください。

14. おすすめの定型文

プロジェクト理解

このプロジェクトの構成を説明してください。
主要なフォルダ、起動方法、テスト方法、変更時に注意する点をまとめてください。
まだコード変更はしないでください。

バグ修正

次の不具合を調査して修正してください。
再現条件:
期待する挙動:
実際の挙動:
制約:
修正後に関連テストを実行してください。

機能追加

次の機能を追加してください。
目的:
対象画面/対象ファイル:
仕様:
変えてほしくないこと:
確認方法:

PR説明文

この変更のPR説明文を作ってください。
含める内容は、概要、変更点、確認方法、注意点です。

15. 用語集

本文に出てくる専門用語を、短く確認できるようにまとめました。

Codex

コードの調査、編集、実行、レビューを手伝うOpenAIのAIエージェントです。

エージェント

指示を受けて、調査やファイル編集など複数の手順を進められるAIのことです。

IDE

コードを書くための編集アプリです。VS Code、Cursor、Windsurf、JetBrains系IDEなどがあります。

CLI

キーボードでコマンドを入力して操作する画面です。PowerShellやターミナルが代表例です。

Local

自分のPC上のプロジェクトフォルダを直接対象にする作業モードです。

Cloud

自分のPCではなく、リモート環境でCodexに作業させる使い方です。

Git

ファイルの変更履歴を管理する仕組みです。変更前に戻したり、作業を分けたりできます。

Worktree

同じGitプロジェクトから、別の作業場所を作る仕組みです。変更を分離したいときに便利です。

コミット

変更内容をGitの履歴として保存する操作です。

PR

Pull Requestの略です。変更内容をレビューしてもらい、取り込むための提案です。

APIキー

サービスをプログラムから使うための認証用キーです。パスワードのように扱い、公開しないでください。

リファクタリング

動作を変えずに、コードを読みやすく整理する作業です。

テスト

コードが期待どおり動くか確認するための仕組みや作業です。

ビルド

アプリを実行・公開できる形に変換する作業です。

差分

変更前と変更後で、どこが変わったかを示す表示です。

Usage Dashboard

Codexの使用量やクレジット残量を確認する画面です。

16. 参照元

このWebアプリは、2026-06-08時点で確認した公式情報をもとに作成しています。