「CodexとGitHubを連携しても、結局コードを読ませるだけでは？」
そう思っているなら、かなりもったいないです。
2026年現在のCodexとGitHubの連携は、単純なコードの質問機能ではありません。リポジトリを読み、コードを書き、テストし、Pull Request（PR）を作り、さらにPRをレビューして修正までできます。
つまり、GitHub上の開発作業そのものをCodexに任せられる段階まで来ています。
私の感覚では、ここまで来ると「AIにコードを書かせる」という表現すら少し古いです。
むしろ、
「GitHubで管理している開発作業の一部を、CodexというAI開発者に担当させる」
と考えたほうが分かりやすいです。
特に個人開発では効果が大きいです。自分でコードを書き、自分でバグを探し、自分でレビューする。冷静に考えると、全部同じ人がやっています。人類はなぜ一人で三役をしているのか。
そこでCodexをGitHubに入れると、かなり状況が変わります。
この記事では、CodexとGitHubを連携すると何ができるのか、設定方法、PRレビュー、自動修正、GitHub Actionsとの連携まで初心者向けに分かりやすく解説します。
CodexとGitHubを連携すると何ができる？
結論から言えば、2026年現在はかなり多くの作業を任せられます。
代表的なのは次のような作業です。
- GitHubリポジトリのコードを理解する
- 新しい機能を実装する
- バグを修正する
- テストを実行する
- Pull Requestを作成する
- Pull Requestをレビューする
- レビューで見つかった問題を修正する
- CIの失敗を修正する
- PRを自動レビューする
- GitHub ActionsからCodexを実行する
- セキュリティ上の問題をチェックする
単なるコード生成AIではありません。
OpenAI公式でも、Codex cloudではGitHubを接続し、専用のクラウド環境でコードを変更したあと、差分を確認してPRを作成できる仕組みが案内されています。
GitHubのリポジトリ全体を理解させられる
CodexとGitHubを連携する大きなメリットが、リポジトリを前提に作業してもらえることです。
普通のChatGPTに、
「ログイン画面のバグを直して」
と伝えても、コードを渡していなければ詳しい状況は分かりません。
一方、Codex cloudでは対象となるGitHubリポジトリを接続できます。
Codexは指定したブランチやコミットからコードを取得し、専用環境で作業します。
そのため、
「ユーザー登録後にログイン画面へ戻される原因を調べて修正して」
「スマホ表示で崩れている部分を探して」
「この機能に検索機能を追加して」
といった、実際の開発に近い指示ができます。
私はここが普通の生成AIとの大きな違いだと思います。
コードを毎回コピーして説明する必要がなくなるだけでも、かなり楽です。
新機能の実装まで任せられる
Codexはコードを読むだけではありません。
ファイルを書き換え、新しいファイルを追加し、コマンドを実行できます。
OpenAIはCodexについて、
- 機能開発
- コードベースへの質問
- バグ修正
- Pull Requestの提案
などを行えると説明しています。
例えばWebアプリなら、
「ユーザー一覧に検索機能を追加する」
「管理画面にCSV出力を追加する」
「フォームにCSRF対策を追加する」
といった開発を任せられます。
コードを1行ずつ指示するのではなく、完成させたい状態を伝える使い方がかなり重要です。
テストまで実行できる
AIがコードを書いても、動かなければ意味がありません。
ここが昔のコード生成AIで非常に面倒だったところです。
Codexは専用環境で、
- テスト
- Linter
- Type Checker
- 各種コマンド
などを実行できます。
つまり、
「修正しました。たぶん動きます」
で終わるのではなく、
修正 → テスト → 問題発見 → 再修正
という流れまでCodexに進めさせられます。
もちろん100％正しいとは限りません。しかし、人間が毎回コードをコピーして実行結果を返す方式と比べれば、かなり効率的です。
CodexからGitHubのPull Requestを作成できる
GitHubを使うなら、かなり便利なのがPull Requestです。
Codex cloudで作業した結果は、差分を確認してからGitHubのPull Requestとして出せます。
例えば、
「決済画面のバグを修正して」
とCodexへ依頼したとします。
Codexがコードを修正します。
その変更内容を確認して問題なければPRへ進めます。
つまり、
依頼 → 実装 → テスト → 差分確認 → PR
という開発の流れをかなり短くできます。
特に一人でアプリを作っている場合、この仕組みは強いです。
いきなり本番コードを書き換えるのではなく、PRとして一度止められるからです。
AIに全部任せるのではなく、最後の判断だけ人間がする形にできます。
私はこの使い方が一番安全だと思います。
GitHubのPull RequestをCodexにレビューさせられる
さらに便利なのが「Codex Code Review」です。
GitHub上のPull Requestに、
@codex review
とコメントすると、Codexにレビューさせることができます。
OpenAI公式：Codex GitHub Code Review
普通のAI質問とは違う
Codexは単純に変更されたコードだけを見るわけではありません。
PRの差分とリポジトリの情報を使って問題を調べます。
例えば、
- この変更で既存機能が壊れないか
- テストが不足していないか
- 危険な処理が入っていないか
- 想定している仕様と変更内容が一致しているか
などを確認できます。
OpenAI公式では、Codex Code ReviewはGitHub上では特に重大度の高い問題を中心に指摘する設計になっています。
何でもかんでも「ここ直したほうがいいですよ」と言われるより、こちらのほうが実用的です。
細かい好みまでAIに説教されたら、開発よりAIとの会議のほうが長くなります。
PRを作るたびにCodexへ自動レビューさせることもできる
毎回、
@codex review
と入力する必要もありません。
Codexの設定からAutomatic reviewsを有効にすると、新しいPull Requestが作られたとき自動的にCodexレビューを実行できます。
これはかなり便利です。
例えば、
- Codexで機能を実装
- PRを作成
- Codexが自動レビュー
- 問題を発見
- 修正
- 人間が最終確認
- マージ
という流れを作れます。
一人開発では、自分が書いたコードを自分だけで確認することになりがちです。
そこでCodexを「もう一人のレビュアー」として置いておく価値はかなりあります。
Codexが発見した問題をそのまま修正させられる
ここが特に面白いところです。
CodexがPRレビューで問題を見つけた場合、GitHubのコメントから修正を依頼できます。
例えば、
@codex fix the P1 issue
のように指示できます。
するとCodexはそのPull Requestを文脈としてCloud Chatを開始し、権限があれば修正をブランチへ反映できます。
つまり、
AIが問題を発見 → 人間が修正指示 → AIが修正
までGitHub上で進められます。
さらに、
@codex fix the CI failures
のような依頼も可能です。
CIが赤くなった画面を見て、人間がログを延々読む生活から少し距離を置けます。
技術者がログを眺め続ける時間を減らすためにAIが働く。これは文明としてかなり正しい方向です。
AGENTS.mdでCodex専用のルールを設定できる
Codexを本格的に使うなら、私はAGENTS.mdがかなり重要だと思います。
AGENTS.mdは、Codexにプロジェクト固有のルールを伝えるためのファイルです。
例えば、
- PHP8.3に対応すること
- SQLは必ずプリペアドステートメントを使う
- 既存DB構造を勝手に変更しない
- CSRF対策を維持する
- スマートフォン表示を壊さない
- 修正後は必ずテストする
といったルールを記載できます。
OpenAI公式でも、Codexにプロジェクトの構造、テスト方法、開発上のルールを伝える用途としてAGENTS.mdが案内されています。
さらにCode Review用なら、
## Code Review Rules
という項目を作って、レビュー時に確認してほしい内容を指定できます。
これがかなり重要です。
何も教えずに、
「いい感じにレビューして」
だけでは、AIも困ります。
人間相手でも同じですが、指示が雑なのに完璧な結果だけ求める文化は、そろそろ終わってほしいところです。
GitHub ActionsからCodexを動かすこともできる
さらに高度な使い方として、Codexには公式のGitHub Actionがあります。
GitHub Actionsから、
openai/codex-action@v1
を利用できます。
これを使えば、
- Pull Requestの自動チェック
- リリース前チェック
- 品質チェック
- 定期的なコードレビュー
- Migration作業
- CI/CD内でのCodex実行
などを自動化できます。
例えば、
PRが作られたら自動的にCodexで確認する
というWorkflowをGitHub Actions側に組み込むこともできます。
こちらは少し上級者向けです。
Codex cloudのGitHub連携だけでも十分便利なので、最初からGitHub Actionsまで設定する必要はありません。
まず通常のGitHub連携を使い、必要になったら自動化を増やすほうが現実的です。
なお、公式Codex GitHub ActionをAPIキー方式で利用する場合は、GitHub Secretsなどを使ってOpenAI APIキーを安全に渡す必要があります。
セキュリティレビューもできる
2026年現在、CodexにはSecurity Reviewもあります。
Pull Request上で、
@codex security review
とコメントすると、通常のCode Reviewよりセキュリティを重視した確認を実行できます。
例えば、
- 認証
- 権限
- 外部入力
- データ処理
- セキュリティ上危険な変更
などを確認するときに使えます。
また、Codex Security cloudではGitHubリポジトリを分析し、そのリポジトリ固有の状況をもとに脆弱性を探す仕組みも提供されています。
ただし2026年8月時点では、Codex Security cloudやSecurity Reviewにはresearch previewの機能が含まれています。利用可能な範囲はアカウントやWorkspaceによって異なるため、この点は注意が必要です。
CodexとGitHubを連携する方法
設定自体はそれほど難しくありません。
1.GitHubをCodexへ接続する
まずCodex cloudを開き、ChatGPTアカウントでログインします。
その後GitHubアカウントを接続します。
GitHub側でCodexにアクセスさせるリポジトリを選択します。
私は最初から全リポジトリを許可するより、必要なリポジトリだけ許可する方法をおすすめします。
権限は少ないほうが管理しやすいです。
2.リポジトリのEnvironmentを作る
GitHubを接続したら、対象リポジトリ用のEnvironmentを作成します。
Environmentでは、
- 依存関係
- ツール
- 環境変数
- Setup Script
- Secret
などを設定できます。
実際の開発環境に近づけるほど、Codexも正しくテストしやすくなります。
3.Codexへ作業を指示する
あとは対象Environmentを選び、
「ログイン画面のエラー原因を調査して修正してください」
「この画面に検索機能を追加してください」
などと指示します。
Codexが専用環境を作り、GitHubリポジトリを読み込んで作業します。
完了後は変更内容のSummaryやDiffを確認できます。
問題なければPull Requestへ進めればよいです。
4.Code Reviewも有効にする
PRレビューも利用したい場合はCodex Settingsから対象リポジトリのCode ReviewをONにします。
これでPull Request上から、
@codex review
が使えるようになります。
毎回レビューさせるならAutomatic reviewsも有効にします。
ChatGPTのGitHub連携とCodexのGitHub連携は少し違う
ここは混同しやすいです。
ChatGPTにもGitHubを接続する機能があります。
ChatGPT側のGitHub連携は、自分のGitHubリポジトリを検索したり、コードについて質問したりする用途があります。
一方、Codexはそこからさらに踏み込み、
コードを変更し、テストし、PRを作り、レビューや修正まで行う
という開発作業向けです。
「コードについて相談したい」ならChatGPT。
「実際にコードを直してほしい」ならCodex。
私はこのくらいの感覚で使い分けるのが分かりやすいと思います。
個人開発なら「Codex→PR→Codexレビュー→人間確認」が強い
個人開発で私が特におすすめしたい流れはこれです。
Codexに実装を依頼
↓
テストを実行
↓
GitHubへPR
↓
Codex Code Review
↓
問題があればCodexへ修正依頼
↓
人間がDiffを確認
↓
マージ
かなり強力な流れです。
特に複数の小さなWebアプリを管理している場合、毎回すべてのコードを自分だけで確認するのは大変です。
Codexに実装を任せ、Codexにレビューさせ、最後だけ自分で判断する。
一見すると「AIがAIをレビューして大丈夫なのか？」という話にも見えます。
その疑問は正しいです。
だからこそ、最後は人間が確認します。
Codexに全部任せて自動マージするのはおすすめしない
CodexとGitHubの連携は非常に便利ですが、私は完全放置まではおすすめしません。
OpenAI自身も、Codex Code Reviewはテスト、Branch Protection、Required Approvalなどの代わりになるものではないと説明しています。
つまり、
AIレビューがOKだから100％安全
ではありません。
特に、
- データベース変更
- 認証
- 決済
- 個人情報
- 管理者権限
- 本番環境
- APIキー
などに関係する変更は、人間も必ず確認したほうがいいです。
AIは非常に優秀になっています。
しかし「それっぽく正しいコード」を大量に作れる能力と、「絶対に事故を起こさない能力」は別です。
ここを混同すると危険です。
まとめ
CodexとGitHubを連携すると、単にGitHubのコードをChatGPTへ見せられるだけではありません。
2026年現在は、
- GitHubリポジトリを読み込む
- コードを理解する
- 新機能を実装する
- バグを修正する
- テストを実行する
- Pull Requestを作成する
@codex reviewでPRをレビューする- PRを自動レビューする
- レビューで発見した問題を修正する
- CIの失敗を修正する
- AGENTS.mdで独自ルールを設定する
- GitHub ActionsからCodexを実行する
- セキュリティレビューを行う
ところまで可能になっています。
個人的には、GitHubを使っているならCodex連携をしない理由はかなり減ってきたと思います。
特に強いのが、
「Codexに作らせて終わり」ではなく、「GitHubで差分を管理し、PRでレビューしてから採用する」
という使い方です。
AIに本番環境を好き勝手触らせる必要はありません。
人間が仕様と最終判断を担当し、実装、テスト、調査、レビューの一部をCodexへ渡す。
この役割分担なら、安全性をある程度保ちながら開発速度を大きく上げられます。
CodexとGitHubの連携は、単なる便利機能ではありません。
一人で開発している人ほど、「自分＋AI開発者」という開発体制を作るための重要な仕組みになってきています。
コメント