「codex github」で検索すると、OpenAIのリポジトリ、GitHubアカウントとの連携、PRレビュー、GitHub Copilotとの違いなど、複数のテーマが混在して出てきます。この記事では、CodexとGitHubの関係を3つの接点に分けて整理し、接続手順、料金の考え方、安全な運用のコツまでを1本で解説します。
Codexとは｜OpenAIが提供するコーディングエージェント
Codexは、OpenAIが提供するコーディングエージェントです。※コーディングエージェントとは: 質問に答えるだけでなく、コードを読み、ファイルを編集し、コマンドを実行してテストまで試し、結果を報告する「作業を任せられるAI」のことです。
人間が1行ずつ補完を受け取るタイプのツールと違い、「この不具合を直して」「このAPIにテストを追加して」といった作業単位の依頼を受け取り、自律的に進めるのが特徴です。公式情報は OpenAI Codex の公式ページ と Codex 開発者ドキュメント で公開されています。
利用できる形態
Codexにはいくつかの利用形態があります。GitHubとの関わり方も形態ごとに異なるため、先に全体像を押さえておきましょう。
| 形態 | 概要 | GitHubとの関係 |
|---|---|---|
| CLI | ターミナルから使うオープンソースのツール | ソースコードがGitHubで公開されている |
| IDE拡張 | VS Codeなどのエディタ内で使う | ローカルのGitリポジトリを対象に作業する |
| クラウド版 | ChatGPT上からタスクを依頼する | GitHubアカウントを連携してリポジトリを扱う |
| Codex app | デスクトップから複数タスクを管理する | ローカルやGitの作業フローと組み合わせる |
各形態の違いは、Codex appとは？機能・料金・始め方・CLIとの違いをOpenAI公式情報ベースで初心者向けに徹底解説の記事で詳しく整理しています。
旧Codexとの混同に注意
「Codex」という名前は、2021年ごろに発表されたコード生成向けの言語モデルにも使われていました。これはGitHub Copilotの初期の基盤技術として知られており、現在のコーディングエージェントのCodexとは別物です。古い記事を読むときは、どちらのCodexの話なのかを確認してください。
CodexとGitHubの関係｜3つの接点
「codex github」という検索の意図は、大きく次の3つに分かれます。自分がどれを知りたいのかを確認すると、読むべき箇所がわかります。
| 接点 | 知りたいこと | 該当する説明 |
|---|---|---|
| 1. GitHub上のリポジトリ | CLIのソースや更新履歴を見たい | 後述の「オープンソースのCLI」 |
| 2. リポジトリ連携 | 自分のリポジトリをCodexに触らせたい | 後述の「リポジトリ接続とPR作成」 |
| 3. PRレビュー・自動化 | PRのレビューやCIにCodexを使いたい | 後述の「PRレビュー」「自動化」 |
接点1｜GitHub上のオープンソースCLI
Codex CLIのソースコードは、GitHubの openai/codex リポジトリ で公開されています。READMEにはインストール方法、認証方法、設定の説明がまとまっています。IssueやPull Requestの履歴を見れば、機能追加や不具合修正の流れも追えます。
CLIのバージョンや導入コマンドは更新されることがあるため、この記事ではコマンドを固定して書きません。最新の手順は、上記READMEと公式ドキュメントで確認してください。
※オープンソースとは: ソースコードが公開され、決められたライセンスの範囲で誰でも閲覧・利用できるソフトウェアのことです。ライセンスの具体的な条件はリポジトリ内のLICENSEファイルで確認できます。
接点2｜自分のGitHubリポジトリをCodexに扱わせる
クラウド版のCodexでは、ChatGPTのアカウントとGitHubアカウントを連携し、対象のリポジトリを選んでタスクを依頼できます。Codexは隔離された環境（サンドボックス）でリポジトリのコードを読み書きし、変更内容を差分として提示します。確認して問題なければ、その内容からPull Requestを作る流れです。
※サンドボックスとは: 外部や本番環境に影響が出ないよう、隔離して安全にプログラムを動かすための仕組みです。
接点3｜PRレビューとCI/CDでの自動化
GitHub上のPull Requestに対してCodexにレビューを依頼する機能や、GitHub Actionsから実行する公式の仕組みも提供されています。設定方法や対応状況は更新されやすいため、導入前に Codex 開発者ドキュメント の該当ページを確認してください。
GitHub Copilotとの違い
「codex github」ではGitHub Copilotとの比較も多く検索されます。考え方の違いを整理すると次のようになります。
| 観点 | Codex | GitHub Copilot |
|---|---|---|
| 提供元 | OpenAI | GitHub（Microsoft傘下） |
| 中心的な使い方 | 作業単位のタスクを任せる | エディタ内の補完・チャット・エージェント |
| GitHubとの関係 | 連携して利用する外部サービス | GitHubのサービスとして統合されている |
| 課金の入口 | ChatGPTプランまたはAPI | GitHubのCopilotプラン |
両者は競合する面もありますが、併用する人もいます。機能やプランは頻繁に更新されるため、導入前に各公式サイトで最新の内容を確認してください。
Codexの主な機能とGitHubでの使いどころ
ここでは、GitHubを使った開発で役立つ4つの機能を、プロンプト例とあわせて紹介します。なお、以下はあくまで依頼文の「例」であり、結果を保証するものではありません。
1. コードベースの理解と質問
リポジトリを読み込んで、構造や処理の流れを説明してもらえます。新しいプロジェクトに参加した直後や、他人が書いたコードを読むときに有効です。
このリポジトリのディレクトリ構成を説明してください。
あわせて、ユーザー認証がどのファイルでどう処理されているか、
呼び出しの流れを順番に教えてください。コードを変更しない質問から始めると、Codexの理解度を確認でき、安全に慣れることもできます。
2. バグ修正とPull Requestの作成
Issueの内容をもとに修正案を作らせ、差分を確認してPRにする使い方です。依頼文には「現象」「再現条件」「期待する動作」「触ってよい範囲」を含めると精度が上がりやすくなります。
Issue: 日付が空のとき、一覧画面でエラーになる。
再現条件: created_at が null のレコードを表示する。
期待する動作: エラーにせず「日付なし」と表示する。
変更してよい範囲: src/components/List 配下のみ。
修正後、関連するテストも追加してください。作成された差分は必ず自分の目で確認します。ローカルで検証する場合は、通常のGitコマンドが使えます。
git fetch origin
git switch 作業ブランチ名
git diff main...HEAD※上記はGit標準のコマンドです。「作業ブランチ名」は実際のブランチ名に置き換えてください。
3. テストの追加とリファクタリング
テストが不足している箇所の補強や、重複したコードの整理も依頼しやすい作業です。範囲を絞った依頼が向いています。
src/utils/date.ts の関数に対して、境界値を含む単体テストを追加してください。
既存の公開関数の挙動は変えないでください。※リファクタリングとは: 外から見た動作を変えずに、コードの内部構造を読みやすく整理することです。
4. PRレビューの補助
GitHub上のPull Requestに対して、Codexにレビューコメントを書かせる機能があります。公式ドキュメントでは、リポジトリ側で機能を有効にしたうえで、PRのコメント欄でCodexに呼びかける方法が案内されています。コメントの例は次のとおりです。
@codex review有効化の手順や呼び出し方は変更される可能性があります。実際に使う前に公式ドキュメントで最新の手順を確認してください。レビュー結果は参考意見として扱い、最終的な承認判断は人間が行うのが基本です。
プロジェクトのルールを伝えるAGENTS.md
Codexには、リポジトリのルートに AGENTS.md というファイルを置き、作業のルールを伝える仕組みがあります。※AGENTS.mdとは: AIエージェント向けに、ビルド手順、コーディング規約、禁止事項などを書いておく説明書のようなMarkdownファイルです。書き方の背景は AGENTS.md の公式サイト にまとまっています。
# AGENTS.md の記述例
## テスト
- 変更後は、プロジェクトのテスト手順を実行して結果を報告すること
## コーディング規約
- 既存のコードスタイルに合わせること
- 依存パッケージを新規追加する場合は、理由をPRの説明に書くこと
## 禁止事項
- .env など秘密情報を含むファイルを読み書きしないこと
- main ブランチへ直接コミットしないことGitHubのリポジトリにこのファイルをコミットしておくと、チームで同じルールを共有できます。AGENTS.mdの活用を含む全体の使い方は、Codexの使い方を完全解説｜導入から実践・つまずき対策までの記事で解説しています。
料金プラン｜GitHub連携で追加料金は必要か
Codexの料金は、使う形態によって考え方が異なります。大枠は次のとおりです。
| 項目 | 考え方 |
|---|---|
| CLI本体 | オープンソースで、ツール自体は無料で入手できる |
| モデルの利用 | ChatGPTのプラン、またはAPI課金が基本 |
| クラウド版 | ChatGPTのプランに紐づく利用枠の範囲で使う |
| GitHub側 | GitHubアカウントの連携自体は別料金とは限らないが、GitHubのプラン条件は別途確認 |
ポイントは「CLIが無料＝すべて無料ではない」という点です。実際にモデルを動かすための利用枠は、ChatGPTのプランまたはAPIの従量課金で賄います。
無料枠の有無や利用上限、各プランの金額は、時期によって変わる可能性があります。正確な金額や上限は、Codex の公式ページおよび公式の料金ページで必ず最新情報を確認してください。
比較や節約のコツは、次の記事で詳しくまとめています。
費用を抑える基本の考え方
- まずは小さな作業（テスト追加、軽微なバグ修正）で使い方を確かめる
- 依頼文で対象のファイルや範囲を絞り、無駄なやり取りを減らす
- AGENTS.mdにルールを書いておき、同じ説明の繰り返しを避ける
- 利用状況は公式の画面で確認し、上限に近づいたら作業の優先度を見直す
始め方｜GitHubと連携して使う手順
最も手軽なのは、ChatGPTからクラウド版を使い、GitHubを連携する方法です。画面の名称や配置は更新されることがあるため、手順は目安として読み、細部は公式ドキュメントで確認してください。
事前に準備するもの
- ChatGPTのアカウントと、Codexを利用できるプラン
- GitHubのアカウント
- Codexに触らせたいリポジトリ（最初は個人の検証用リポジトリがおすすめ）
- そのリポジトリに対する適切な権限
クラウド版でGitHubを連携する流れ
- ChatGPTにログインし、Codexの画面を開きます。入口は Codex の公式ページ からたどれます。
- 画面の案内に従い、GitHubアカウントを連携します。GitHubの認可画面が表示されたら、内容を確認して許可します。
- アクセスを許可するリポジトリを選びます。可能であれば「すべてのリポジトリ」ではなく、必要なものだけに限定します。
- 対象リポジトリに対する実行環境（環境設定）を作成します。依存パッケージの導入手順やテストの実行方法などは、公式ドキュメントの案内に沿って設定します。
- まずは変更を伴わない質問（構成の説明など）を送り、読み取りが正しくできているか確認します。
- 小さな修正タスクを依頼し、提示された差分を確認します。
- 問題なければPull Requestを作成し、通常のレビューフローに乗せます。
- CIが通ること、レビュアーの承認を得ることを確認してからマージします。
CLIから使う場合
CLIを使う場合は、openai/codex リポジトリ のREADMEにインストール方法と認証方法が記載されています。コマンドやバージョンは更新されることがあるため、必ず最新のREADMEと 公式ドキュメント を参照してください。
CLIを使うときは、作業前に必ず別ブランチを切っておくと安全です。
git switch -c codex-trial
git statusCodexに作業させた後は、差分を確認します。
git diff意図しない変更があれば、コミット前に取り消したり、依頼文を直して再実行したりします。
つまずきやすいポイント
| 症状 | 確認すること |
|---|---|
| リポジトリが一覧に出ない | GitHub側でアクセスを許可したリポジトリに含まれているか。組織のリポジトリは管理者の承認が必要な場合がある |
| テストが動かない | 環境設定で依存パッケージの導入やテストの実行方法を正しく指定しているか |
| PRが作れない | 対象リポジトリへの書き込み権限があるか。ブランチ保護の設定も確認する |
| 期待と違う修正になる | 依頼文に現象・期待動作・変更範囲を明記したか。AGENTS.mdにルールを書いたか |
安全に使うためのチェックポイント
GitHub上のコードは、会社の資産や個人情報を含むことがあります。AIに作業を任せるときは、次の点を押さえておきましょう。
権限は最小限にする
GitHub連携では、アクセスを許可するリポジトリを必要なものに絞ります。重要なリポジトリは、慣れるまで連携対象から外しておく判断も有効です。組織で使う場合は、セキュリティ担当者や管理者に事前確認してください。
秘密情報をコードに置かない
APIキー、パスワード、個人情報などをリポジトリに含めないのは、AI利用の有無にかかわらず基本です。.env などの扱いはAGENTS.mdにも明記しておくとよいでしょう。
差分は必ず人間が確認する
Codexが提示した変更は、そのままマージせず、レビューを必ず挟みます。GitHubのブランチ保護で「レビュー承認を必須にする」設定を使えば、確認の抜け漏れを防げます。設定方法は GitHub Docs のブランチ保護に関する説明 を参照してください。
外部ネットワークへのアクセス設定に注意する
実行環境がインターネットに接続できるかどうかは、設定によって異なります。外部アクセスを許可する場合は、読み込まれる情報や取得されるパッケージのリスクを理解したうえで設定してください。具体的な仕様は公式ドキュメントで確認しましょう。
導入前の確認リスト
- 検証用の小さなリポジトリで試したか
- 連携対象のリポジトリを限定したか
- mainブランチに保護設定があるか
- CIが自動で動く構成になっているか
- 社内ルールでAI利用が許可されているか
どんな人に向いているか
ユースケース別の目安を整理します。向き不向きはプロジェクトの性質によって変わるため、あくまで参考にしてください。
| ユースケース | 向いている使い方 | 補足 |
|---|---|---|
| 個人開発者 | 小さな修正やテスト追加を任せ、自分は設計に集中する | 検証用リポジトリで慣れてから本番へ |
| チーム開発 | PRのレビュー補助、定型的なIssue対応 | AGENTS.mdでルールを共有する |
| OSSの利用・調査 | openai/codexなど公開リポジトリのコード理解 | 読み取りの質問から始める |
| 初心者・学習者 | 既存コードの解説、エラーの原因調査 | 提案をうのみにせず理由まで確認する |
| 保守・運用担当 | 古いコードのテスト補強や小規模なリファクタリング | 変更範囲を明確に指定する |
向いていないケース
- 要件が曖昧で、仕様そのものが固まっていない作業
- 機密性が極めて高く、外部サービスへの接続が認められていないリポジトリ
- 影響範囲が広く、人間が全体像を理解したうえで判断すべき大規模な設計変更
このような場合は、AIには調査や下書きだけを任せ、決定は人間が行う使い方が現実的です。
まとめ
- 「codex github」には、GitHub上のオープンソースCLI、リポジトリ連携、PRレビュー・自動化という3つの意味があり、目的によって読むべき情報が異なる。
- CLIのソースは openai/codex で公開されている。インストール方法や最新情報は、READMEと公式ドキュメントで確認する。
- クラウド版ではGitHubアカウントを連携し、リポジトリのタスクを依頼してPRにつなげられる。まずは小さなタスクから試す。
- CLI本体は無料でも、モデルの利用にはChatGPTのプランまたはAPI課金が基本。金額や上限は公式サイトで最新情報を確認する。
- 連携範囲の限定、秘密情報の管理、差分レビュー、ブランチ保護を組み合わせ、AIの変更を必ず人間が確認する運用にする。
よくある質問
CodexのソースコードはGitHubで公開されていますか？
CodexのCLIは、GitHubの openai/codex リポジトリで公開されています。READMEにインストールや認証の案内があります。ただしバージョンや手順は更新されるため、最新情報はリポジトリと公式ドキュメントで確認してください。
CodexとGitHubアカウントは連携できますか？
クラウド版ではChatGPT上でGitHubアカウントを連携し、リポジトリを選んでタスクを依頼できます。アクセス許可は必要なリポジトリに絞るのがおすすめです。画面や手順は変わる場合があるため、公式ドキュメントを確認してください。
CodexでGitHubのPull Requestをレビューしてもらえますか？
PRレビューを依頼する機能が提供されており、公式ドキュメントではリポジトリ側で有効化したうえでPRのコメントから呼び出す方法が案内されています。設定条件は変わる可能性があるため、利用前に最新の手順を確認してください。
GitHubと連携するとCodexの料金は別にかかりますか？
連携の設定自体と、モデル利用の課金は別の話です。モデルの利用にはChatGPTのプランまたはAPI課金が基本で、CLI本体は無料で入手できます。金額や無料枠の範囲は変わるため、公式サイトで最新情報を確認してください。
CodexとGitHub Copilotはどう違いますか？
Codexはまとまった作業を任せる使い方が中心のOpenAIのエージェントで、CopilotはGitHubが提供し、エディタ内の補完やチャットなどが統合されています。提供元も課金体系も異なり、機能は更新が早いため、各公式サイトで比較してください。
