本文へ移動
BenriWorks LabBenriWorks トップ

ガイド更新日

Codexのクラウド作業と、GitHubでのレビュー

この記事で分かること

Codex 集中講座の第14回。クラウドで進める作業と、プルリクエストのレビューを整理します。自動検査、Codexの指摘、人の確認がそれぞれ何を見るかを比べます。

レビューコメントが並んだ画面の前で、こちらを向いて考えている女性
目次 読みたいところから

プルリクエストの検査は通った。変更の読み落としも確かめたい。検査コマンドとは別に、Codexへレビューを頼む入口があります。

手元を離れたクラウドでの作業と、GitHub上でのレビューを整理します。指摘が返ってきたら、根拠となる変更箇所を読み、人が採用するかを判断します。

クラウドは、使い捨ての環境で動く

Codex クラウドは、作業ごとにコンテナを立て、そこにリポジトリを取り出して作業する形です。手元のパソコンは関係しません。

手元との違いは2つあります。

ひとつは、手元を占有しないことです。数十分かかる作業を投げておいて、その間に別のことができます。パソコンを閉じても進みます。

もうひとつは、手元にしかないものが使えないことです。入れてある道具、置いてある設定ファイル、環境変数。これらは新しいコンテナには存在しません。公式ドキュメントによれば、使うリポジトリと道具と接続先をまとめた環境を先に作ります。依存や道具の準備は Codex がリポジトリを調べて進め、足りない情報や権限があれば聞いてきます。準備と検査の結果を確かめて公開した環境から、作業を始めます。

この設定作業は、第13回の GitHub Actions のワークフローを書く作業とよく似ています。どちらも「きれいな環境から動く状態を作る手順」を書き出す作業だからです。片方を書いていれば、もう片方はほぼ同じ内容になります。

コマンドライン版からもクラウドの作業を扱えます。

codex cloud list            # 走っている作業を並べる
codex cloud status <ID>     # 状態を見る
codex cloud diff <ID>       # 差分を見る
codex cloud apply <ID>      # 手元へ取り込む

投げっぱなしにせず、diff で中身を見てから apply で手元に落とす。第3回で決めた「差分を読んでから受け入れる」の形が、ここでも同じように使えます。なお、この機能は実験的なものとして提供されています。

手元とクラウドの違いを示した図。手元は自分のパソコンの環境をそのまま使い作業中は占有すること、クラウドは使い捨てのコンテナが立ち環境を事前に設定する必要があるが手元を占有しないことが並べて示されている
違いは2つ。占有するかどうかと、環境が用意されているかどうか

プルリクエストの画面から呼ぶ

もう1つの入口が、GitHub のプルリクエストです。

使うには先に設定が要ります。公式ドキュメントによれば、GitHub のリポジトリを Codex につないだうえで、Codex のコードレビューの設定画面で対象のリポジトリのコードレビューを有効にします。

有効にしたあとは、プルリクエストのコメントに書くだけです。

@codex review

受け付けられると、コメントに目のマークが付きます。作業が終わると、通常のレビューと同じ形で指摘が並びます。

review 以外の言葉を書いた場合は、そのプルリクエストを文脈にした会話が始まります。「この変更で影響を受ける画面はどこか」のような質問を、レビューの途中で投げられます。

レビューの観点を、リポジトリ側で決める

レビューで気にしてほしい挙動は、リポジトリの規約に書いておけます。

公式の説明によれば、Codex はリポジトリの中の AGENTS.md を探し、そこに書かれたレビューの規則に従います。書き方は、規則が関わるコードに一番近い AGENTS.md に ## Code Review Rules という節を足す形です。書式や Lint のような機械で判定できる確認は、規則に入れずに CI に残すよう勧められています。

つまり、第9回で作った規約が、そのままレビューの基準として働きます。規約を書く、Codex がそれに従って書く、別の Codex がそれに従って確かめる。同じ1つのファイルが、書く側と見る側の両方に効いていることになります。

観点を書くときの注意は、第9回と同じです。判定できる形で書いてください。「読みやすいコードにする」は指摘になりませんが、「この形式のログ出力に個人情報を含む項目が入っていないか」は指摘になります。

手元からもレビューできる

GitHub を経由せずに、手元でレビューを走らせることもできます。第6回で /review に触れましたが、コマンドライン版には対象を選ぶ引数があります。

codex review --uncommitted        # まだコミットしていない変更
codex review --base main          # main との差分
codex review --commit <SHA>       # あるコミットが入れた変更

使い分けの目安は、プルリクエストを出す前か後かです。出す前なら --base で全体を見せ、出したあとに指摘を直したら --uncommitted でその部分だけ見せる。全体を毎回見せると、直っていない指摘が繰り返し出てきて読む気が失せます。

2つのレビューは別のものを見る

第13回の自動検査と、この回のレビューは、混ぜないでください。見ているものが違います。

自動検査は、答えが一意に決まるものを見ます。型、書式、テストの成否。落ちたら直すしかありません。

Codex のレビューは、答えが一意に決まらないものを見ます。この変更で振る舞いが変わる範囲、抜けているテスト、想定していない入力への対応。指摘は参考意見であって、判定ではありません。

この違いは、指摘への対応のしかたに出ます。自動検査が落ちたら直します。レビューの指摘は、読んで、納得したら直し、納得しなければ理由を書いて残します。

人が最後に見る場所は変わらない

3つの目を通す形になりました。自動検査、Codex のレビュー、そして人。

人が見る場所は、前の2つが通ったあとに残るところです。この変更は何のためにあるのか。利用者にとって意味があるのか。将来これを読む人に分かるか。どれも、機械が判定できません。

第8回で「なぜ変えたかは差分からは絶対に読み取れない」と書きました。3つの目を通してなお、最後に残る仕事はそこです。

レビューの観点を書き出す

小さな変更を1つ選び、レビューで確かめたい挙動を具体的に書きます。本文の観点の例と比べて、検査コマンドで確認することと分けてください。

指摘がある場合は、対象の行と再現する条件を読みます。指摘の有無だけで変更を受け入れず、根拠を判断する材料にします。

次の回

変更を確認できたら、プレビューと本番を分けて、見てもらえるURLへ届けます。「Vercelで、作ったものを自分のURLへ届ける」へ進めます。

参照した公式情報

  • OpenAI「Codex Cloud」「Review GitHub pull requests with Codex」「Code review」(learn.chatgpt.com/docs、2026年11月時点。developers.openai.com/codex から移転)
  • codex cloud と codex review の引数は codex-cli 0.167.0 を執筆環境へ導入して取得

READ NEXT

次はこれを読む

Codex 集中講座の次の回へ

Vercelで、作ったものを自分のURLへ届ける

Codex 集中講座の第15回。GitHubとVercelを連携し、プレビューで確認して本番へ届ける流れを学びます。環境変数、ビルドの記録、戻し方も整理します。

続きを読む →
公開されたサイトを画面に映しながら、こちらを向いて立っている男性

よくある質問

クラウドで動かすと手元と何が違いますか
作業ごとに使い捨ての環境が立ち、そこでリポジトリを取り出して作業します。手元のパソコンを占有しないので、時間のかかる作業を投げておけます。一方で、手元にしかない資材や設定は使えないため、環境の設定を先に済ませておく必要があります。
レビューを頼むのに何が要りますか
公式ドキュメントによれば、先に GitHub のリポジトリを Codex につなぎ、Codex のコードレビューの設定画面で対象のリポジトリのコードレビューを有効にします。そのうえで、プルリクエストのコメントで `@codex review` と書くと開始します。コメントに目のマークが付くのが、受け付けられた合図です。
レビューの観点を指定できますか
できます。公式の説明によれば、Codex はリポジトリの中の AGENTS.md を探し、そこに書かれたレビューの規則に従います。`## Code Review Rules` という節を、規則が関わるコードに一番近い AGENTS.md に足しておけば、その観点で見ます。