AIツール活用

Codexでコードレビューする方法!/reviewの手順と指摘の直し方

中島大介(なかじ)読了時間 約16分
Codexでコードレビューする方法を解説する記事のアイキャッチ

AIにプログラムを書かせると、動く物はすぐにできあがります。一方で、書かれたコードに計算の誤りや危ない書き方がないかを、プログラムを書かない人が1行ずつ確かめるのは現実的ではありません。

確認を人の目だけに頼ると、AIが作った変更をそのまま使うか、確認待ちで止めるかの二択になりがちです。別のAIにレビューさせる方法を覚えれば、人が受け持つのは指摘の中身の判断と、直した後の動作の確認だけです。

この記事では、OpenAIのAIエージェント「Codex」の/reviewでコードレビューをし、指摘を直して再レビューするまでの手順を、実画面で解説します。

この記事を読めば、Codexにコードレビューを頼む手順と、指摘の読み方・直し方が分かります。指摘が英語で分かりにくいときは、観点を日本語で書いて頼み直すのが近道です。

目次

Codexのコードレビューでできること

Codexの/reviewは、Gitで管理しているフォルダの変更を、専用のレビュー役が読んで問題を指摘する機能です。レビュー役はファイルを書き換えず、優先度を付けた指摘だけを返します。Codexの/reviewで選べるレビューの範囲は、以下の表のとおりです。

レビューの範囲見る変更
Review against a base branch作業中のブランチと、元のブランチ(mainなど)との差分
Review uncommitted changesまだコミットしていない変更(追加したファイルを含む)
Review a commit選んだコミットで加えた変更
Custom review instructions利用者が書いた観点に沿ったレビュー

/reviewは、パソコンの中のフォルダの変更を見る機能です。GitHubのプルリクエストのレビューは、Codexの別の機能で頼みます。

AIコードレビューとは?できることと主なツール・導入の進め方を解説

Codexでレビューする変更を準備する手順

Codexのレビューは、Gitで管理しているフォルダ(リポジトリ)の中で使います。レビューする変更が分かる状態にしてからCodexを起動すると、どの差分を見せればよいかで迷いません。Codexでレビューする変更を準備する手順は、以下の3つです。

  1. レビューする変更を確かめる
  2. フォルダでCodexを起動する
  3. フォルダを信頼してよいかに答える

レビューする変更を確かめる

編集部では、請求書の金額を計算する小さなプログラムのデモを用意しました。デモは記事のために作ったもので配布していないため、読者は自分のリポジトリで、作業用のブランチに変更を用意して試してください。mainのブランチに元のプログラムがあり「feature/discount」のブランチで割引の機能を足した状態です。

上の画像の最後の行では、10%引きの合計が18,480円と表示されています。元の合計184,800円の10%引きなら166,320円になるはずなので、割引の計算は誤りです。

変更の中身は「git diff main」で表示できます。

上の画像の変更には、割引の計算の誤りのほかに、ファイルから読み込んだ数字を「eval」という命令で処理する書き方が入っています。Codexの/reviewで試すのは、2つの問題を見つけられるかどうかです。

フォルダでCodexを起動する

レビューする変更があるフォルダに移ってから、ターミナルで「codex」と入力してCodexを起動します。編集部では、起動の時に新しい版の案内が表示されたため、Escキーで飛ばしてから使いました。

Codexの使い方を解説!CLIの導入から日本語での依頼・変更確認まで

フォルダを信頼してよいかに答える

初めて開くフォルダでは、Codexがフォルダを信頼してよいかを確かめる画面を表示します。

自分で用意したフォルダであれば「1. Trust and continue」を選んでEnterキーを押します。選んだ内容はCodexの設定に保存されるため、次からは聞かれません。

Codexの/reviewで問題を探す手順

Codexの起動後は、入力欄に「/review」と入力してレビューを始めます。レビューの範囲を選ぶ画面が出るため、プルリクエストを出す前と同じ形で確かめたいときは、元のブランチとの差分を選びます。Codexの/reviewで問題を探す手順は、以下の4つです。

  1. 入力欄に/reviewと入力する
  2. レビューの範囲を選ぶ
  3. 比べるブランチを選ぶ
  4. レビューの結果を読む

入力欄に/reviewと入力する

入力欄に「/review」と入力すると、候補に/reviewのコマンドが表示されます。

Enterキーを押すと、レビューの範囲を選ぶ画面に進みます。

レビューの範囲を選ぶ

レビューの範囲の画面には、4つの選択肢が並びます。

ブランチで作業している場合は「1. Review against a base branch」を選びます。コミットする前の変更だけを見たい場合に向いているのは「2. Review uncommitted changes」です。

比べるブランチを選ぶ

「1. Review against a base branch」を選んだ後に出るのは、比べる元のブランチを選ぶ画面です。画面の上には、今のブランチの名前も表示されます。

候補からmainを選んでEnterキーを押すと、レビューが始まります。

レビューの途中の画面に出るのは、Codexが差分やファイルの中身を読むコマンドを実行する様子です。

レビューの結果を読む

レビューが終わると「Code review finished」と表示され、指摘が並びます。

上の画像では、2つの指摘に「P1」が付きました。「P1」や「P2」は、Codexが付ける指摘の優先度です。

Codexが返した2つの指摘の内容は、以下のとおりです。

  • 割引の関数が、割り引いた後の金額ではなく値引きの金額を返している
  • ファイルの数字をevalで読むため、ファイルに書いた命令が実行されてしまう

デモに入れておいた2つの問題を、Codexはどちらも見つけました。指摘には問題の行の番号と、直し方の案も書かれています。

Codexの指摘を直して再レビューする手順

指摘を受け取ったら、意味を確かめてから修正を頼み、直した後にもう一度レビューします。一度直しても、直し方の中に別の問題が残ることがあるためです。Codexの指摘を直して再レビューする手順は、以下の4つです。

  1. 指摘の意味を日本語で説明させる
  2. 修正と動作の確認を頼む
  3. 直した後にもう一度/reviewをかける
  4. 観点を日本語で指定して再レビューする

指摘の意味を日本語で説明させる

指摘が英語で分かりにくいときは、同じ画面で日本語の説明を頼みます。編集部が入力した文は、以下のとおりです。

今のレビューの2つの指摘を、プログラムを書かない人にも分かるように日本語で説明してください。直さないとどうなるかも書いてください。まだファイルは変更しないでください。

上の画像の例は、税抜き1,000円の商品を10%引きにして消費税10%を足す場合です。請求額は正しくは990円なのに110円になると、具体的な金額で説明されています。直さないと、売上の損失や過剰な請求、ファイルの読み取りや削除をされるおそれがあることも書かれていました。

修正と動作の確認を頼む

指摘の意味が分かったら、修正と動作の確認を続けて頼みます。修正を頼んだ文は、以下のとおりです。

2つの指摘を直してください。直したら、python3 invoice.py を実行して、割引の結果が正しいかを確かめてください。

編集部の環境では、Codex全体の指示ファイル(AGENTS.md)に「作業ブランチにコミットする」と書いていました。指示ファイルに従い、Codexは修正をコミットしてよいかを聞いてきました。

AGENTS.mdとは?Codexでの書き方や置き場所・優先順位までわかりやすく解説

許可すると、修正の内容と動作の確認の結果が表示されます。

10%引きの合計は166,320円になり、正しい金額に直りました。Codexは、100%引きと、数字でない入力を受け付けないことも確かめたと報告しています。

直した後にもう一度/reviewをかける

修正の後は、同じ手順で/reviewをもう一度かけます。以下の画像は、元のブランチとの差分を再びレビューした結果です。

再レビューでは、新しく「P2」の指摘が1つ出ました。税抜き101円の商品を10%引きにすると90.9円になり、消費税(1円未満は切り捨てで9円)を足した請求額が99.9円になる問題です。割引後の金額に1円未満の端数が残っています。

1円未満の端数を切り捨てるか四捨五入するかは、会社の請求のルールで決まります。Codexの指摘をそのまま直させる前に、どの扱いにするかを人が決めてから頼んでください。

観点を日本語で指定して再レビューする

最初から日本語の指摘がほしいときは、/reviewの「4. Custom review instructions」を選び、観点を日本語で書きます。

観点の入力欄に書くのは、何を見てほしいかと、指摘の書き方です。

Enterキーを押すと、指定した観点だけのレビューが日本語で返ります。

上の画像では、端数の扱いに加えて、割引率を0〜100%の範囲で確かめていない問題も指摘されました。110%引きを渡すと請求額が-11.1円になる、と具体例も書かれています。悪用されるおそれのある書き方は見つからなかった、という結果も返っています。

codex reviewコマンドでCodexのレビューをする手順

Codexの画面を開かずに、ターミナルのコマンド1行でレビューを頼む方法もあります。毎回同じ範囲をレビューするときや、作業の最後に決まった手順で確かめたいときに便利です。codex reviewコマンドでレビューする手順は、以下の3つです。

  1. codex reviewのオプションを確かめる
  2. 範囲と観点を一緒に書かない
  3. codex review --base mainを実行する

codex reviewのオプションを確かめる

「codex review --help」を実行すると、使えるオプションの一覧が表示されます。

codex reviewで範囲を指定する主なオプションは、以下のとおりです。

  • --uncommitted: まだコミットしていない変更をレビューする
  • --base ブランチ名:指定したブランチとの差分をレビューする
  • --commit コミットの番号:指定したコミットの変更をレビューする

範囲と観点を一緒に書かない

Codex CLI 0.166.0では、範囲を指定するオプションと、観点を書いた文を一緒に使えませんでした。以下の画像は「--base main」の後に観点の文を書いて実行した結果です。

観点を日本語で指定したいときは、Codexの画面の「4. Custom review instructions」を使います。

codex review --base mainを実行する

範囲だけを指定して「codex review --base main」を実行すると、Codexの画面と同じ形のレビューの結果がターミナルに表示されます。

上の画像では、画面の/reviewと同じ「P2」の端数の指摘が返りました。画像の上の「python3: warning: confstr() failed」の行は、Codexがレビュー中に動かしたPythonが出した、編集部の環境の警告です。レビューの結果とは関係ありません。

Claude Codeで書いたコードをCodexでレビューする使い分け

AIに書かせたコードは、書いたAIとは別のAIにレビューさせると、書いた側の思い込みに引きずられにくくなります。Claude Codeで作業している場合は、Codexをレビュー役に回す使い分けが向いています。Claude CodeとCodexの役割の分け方は、以下のとおりです。

  • Claude Code: 頼んだ機能を作り、ファイルを書き換える役
  • Codex: 作った変更を/reviewで確かめ、指摘を返す役
  • 人:指摘のうち、どれをどう直すかを決める役

流れとしては、Claude Codeで作った変更をブランチに置き、Codexの/reviewで元のブランチとの差分を確かめます。指摘はClaude Codeに渡して直させ、もう一度Codexでレビューします。

CodexとClaude Codeの違いを徹底解説!料金比較と併用のコツも紹介

Codexのコードレビューに関するよくある質問

Codexのコードレビューを使い始めると、プルリクエストでの使い方や、レビューの結果をどこまで信用してよいかが気になります。Codexのコードレビューに関するよくある質問は、以下の3つです。

  • GitHubのプルリクエストもCodexにレビューさせられますか?
  • Codexのレビューで問題がなければそのまま使ってよいですか?
  • Codexのレビューの指摘を日本語で受け取れますか?

GitHubのプルリクエストもCodexにレビューさせられますか?

GitHubとCodexをつなぐ設定をすると、プルリクエストのコメントに「@codex review」と書いてレビューを頼めます。設定の手順は、OpenAIのUse Codex in GitHubのページにあります。

Codexのレビューで問題がなければそのまま使ってよいですか?

Codexのレビューは見落としや誤った指摘をすることがあり、問題がないという結果だけで安全とは言い切れません。編集部の例でも、1回目のレビューでは出なかった端数の問題が、2回目のレビューで見つかりました。動かして結果を確かめる手順と、人の判断を残してください。

Codexのサンドボックスを徹底解説!自動承認を安全に使う設定も紹介

Codexのレビューの指摘を日本語で受け取れますか?

Codexのレビューの指摘は、日本語で受け取れます。/reviewの「4. Custom review instructions」で観点と一緒に「指摘は日本語で」と書くか、英語の指摘を受け取った後に日本語での説明を頼みます。

まとめ

Codexの/reviewを使えば、AIが書いたコードの問題を、別のAIに見つけさせて直すところまで進められます。Codexでコードレビューをする手順の要点は、以下の5つです。

  1. Gitで管理しているフォルダで変更を用意する
  2. /reviewで元のブランチとの差分をレビューする
  3. 指摘の意味を日本語で説明させてから修正を頼む
  4. 直した後にもう一度/reviewをかける
  5. 端数の扱いのような決まりごとは人が決める

コマンドで決まった範囲を確かめたいときは、codex reviewも使えます。AIの変更を使う前に、Codexのレビューと動作の確認を1回ずつ挟みましょう。

まずは小さな変更で/reviewを試し、指摘の出方と直し方の流れをつかんでください。

参考リンク

この記事の監修者

中島大介(なかじ)

中島大介(なかじ)

株式会社メリル 代表取締役 / 記事監修

株式会社メリル代表取締役。SEO歴20年以上。最新AIやセキュリティについて発信するYouTube「ウェブ職TV」は登録者15万人以上。著書「ChatGPT & Copilotの教科書」は10万部突破!

プロフィールを見る

関連する記事

Cursorのプラグイン「pstack」の使い方を解説する記事のアイキャッチ
AIツール活用

pstackの使い方|Cursor・Claude Codeへの入れ方と頼み方

pstackを使ってみたい方は必見!この記事では、pstackの入れ方と/poteto-modeでの頼み方を解説します。実は、pstackで最初に覚えるコマンドは2つだけです。記事を読めば、AIに確かめさせながら作業を任せられます。

中島大介(なかじ)監修 / Touch AI編集部25 分で読めます
MetaのAIエージェント「Muse」の使い方を解説する記事のアイキャッチ
AIツール活用

Museの使い方|Meta Museの始め方・初期設定・料金を解説

Museを使い始めたい方は必見!この記事では、Meta Museの始め方・初期設定・料金を解説します。実は、Museとのやり取りをAIの学習に使う設定は最初からオンです。記事を読めば、任せる範囲を決めてから使い始められます。

中島大介(なかじ)監修 / Touch AI編集部26 分で読めます
Claude Codeで複数ファイルを一括置換する方法を解説する記事のアイキャッチ
AIツール活用

複数ファイルの文字列を一括置換するには?Claude Codeで残す語を指定

製品名の変更で複数のファイルを直したい方は必見!この記事では、Claude Codeで複数のファイルの文字を一括置換する手順を解説します。実は、残す語を決めてから置き換えられます。記事を読めば、コピーから元に戻す方法も分かります。

中島大介(なかじ)監修 / Touch AI編集部19 分で読めます

次のステップ

最新動向を学びに変える

話題のAIアップデートを、現役講師が背景と実務への影響まで解きほぐします。Touch AI の最新講座で、変化に追いつくための視点を得てください。

受講できる講座を見る