OpenAI Codex：3つの実用例でわかるステップバイステップガイド

OpenAI の Codex ソフトウェアエンジニアリングエージェントを使って、バグ修正、コード説明、プルリクエストの生成を ChatGPT から直接行う方法を学びます。

更新 2026年6月3日 · 7 分読む

OpenAI の Codex は ChatGPT 内で動作するコーディングエージェントです。英語でタスクを説明すると、Codex は専用のサンドボックスで作業を進め、完成した変更をレビュー可能なプルリクエストとして返してくれます。ときどきの補完ではなく、日々のエンジニアリング作業を肩代わりするために作られています。

このチュートリアルでは、プロの開発者でなくても、ChatGPT 内の Codex を使って GitHub リポジトリで実際に作業する手順を紹介します。以下のことを行います。

コード修正を適用し、プルリクエストを作成する。
コードベース内の複雑な関数を説明する。
Q&A 形式のプロンプトからバグを特定して解決する。

この過程で、Codex が安全なサンドボックスで動作し、ChatGPT から離れずに検証可能な変更を生成する様子がわかります。

要点まとめ（TL;DR）

OpenAI Codex はクラウドベースのソフトウェアエンジニアリングエージェントで、ChatGPT（Plus、Pro、Team、Enterprise プラン）内で利用できます
Codex を GitHub リポジトリに接続し、バグ修正、パッチ適用、テスト生成、コードの説明などのタスクを割り当てます
各タスクは分離されたサンドボックスで実行され、マージ前にレビューできるプルリクエストが開かれます
AGENTS.md ファイルでコーディング規約を定義し、すべてのタスクで Codex に順守させます
Codex は Codex CLI によりターミナルでも、また VS Code 拡張としても動作します

OpenAI の Codex とは？

OpenAI Codex は、コードの作成・編集、テストの実行、バグ修正、プルリクエストの提案まで行えるクラウドベースのソフトウェアエンジニアリングエージェントです。各タスクは独立したサンドボックス環境で実行されます。

Codex は OpenAI の最新フロンティアモデルによって動作し、安全性、テスト容易性、生産性を重視して設計されています。AGENTS.md ファイルで Codex をガイドしたり、ChatGPT のサイドバーから直接操作したりできます。

また、Codex CLI を使えば、これらの機能をターミナルに直接持ち込むこともできます。

Codex のアクセス方法（概要）:

Method	Where	Best for
ChatGPT sidebar	chatgpt.com	GitHub 連携のタスクキュー（本チュートリアル）
Standalone Mac app	chatgpt.com/codex	リッチなインターフェース、自動化、プラグインコネクタ
VS Code extension	VS Code marketplace	エディタ内でのタスク委任
Codex CLI	Terminal	スクリプト化されたワークフロー、CI 連携

OpenAI の Codex をセットアップする

Codex のセットアップは数分で完了します。以下の手順で始めてください。

ステップ 1：Codex ツールの場所を確認

まず ChatGPT にログインします。左側のツールバーで Codex を探してください。ローンチ当初は ChatGPT Pro、Business、Enterprise ユーザーに展開されましたが、現在はすべてのプランに含まれています（Free と Go はアクセスが大幅に制限されています）。

ステップ 2：Codex の開始

Codex をクリックすると、初期設定用の別タブが開きます。「Get Started」をクリックし、次のステップの認証手順に従ってください。

ステップ 3：多要素認証（MFA）

「Set up MFA to continue」をクリックし、お好みの認証アプリ（Google Authenticator や Authy など）で QR コードをスキャンします。コードを入力して確認すれば完了です。

ステップ 4：GitHub に接続

多要素認証が完了したら、Codex を GitHub に接続します。

ステップ 4.1：GitHub コネクタの承認

「Connect to GitHub」をクリックすると、GitHub コネクタの承認用ポップアップが表示されます。内容を確認し、Authorize を実行します。

ステップ 4.2：GitHub アカウントの追加

GitHub の接続ができたら、アカウントを追加します。GitHub organization タブで「Add a GitHub account」を選択します。

すると「Install and Authorize」のポップアップが表示されます。Authorize をクリックすると、ChatGPT の画面にすべてのリポジトリが表示されます。特定のリポジトリだけを承認することもできます。

ステップ 4.3：環境の作成

作業したいリポジトリを選び、「Create environment」をクリックします。

次に「Data Controls」に移動します。Codex は現在も積極的に開発中で、モデル改善のためのデータ利用を許可するオプションが表示される場合があります。無効にして続行できます。

これで環境の準備が整い、探索を開始できます。Codex では、あらかじめ用意されたタスクを並行して開始することができます。

「Start tasks」をクリックするだけで、要件に応じてタスクを選ぶこともできます。これにより、質問をしたり、エージェントに機能の実装を依頼したりできるインターフェースに移動します。

すべてのタスクが準備できたら、取り組みたいタスクを選ぶか、複数タスクを並行して進めてください。

ステップ 5：`AGENTS.md` ファイル（任意）

AGENTS.md は、Codex プラットフォームでの利用を想定して OpenAI が導入した特別な構成ファイルで、コードベース上で作業する AI エージェントをガイドするためのものです。AI のチームメイト向け開発者マニュアルのような位置づけで、README.md に似ていますが、自律エージェント向けの指示に特化しています。以下は AGENTS.md の例です。

# AGENTS.md

## Code Style
- Use Black for Python formatting.
- Avoid abbreviations in variable names.

## Testing
- Run pytest tests/ before finalizing a PR.
- All commits must pass lint checks via flake8.

## PR Instructions
- Title format: [Fix] Short description
- Include a one-line summary and a "Testing Done" section

Codex がコードベースでタスクを実行すると、次のように動作します。