「うちは GitHub ではなく GitLab を使っているので、Codex のコードレビューは関係ない」。導入のご相談でこう言われることがあります。実際には、Codex は GitLab の Merge Request のレビューと、Issue や Merge Request を起点にしたクラウドのタスクに Beta で対応しています。社内に GitLab をセルフマネージドで立てている会社でも、管理者の設定を済ませれば使えます。

この記事では、株式会社デジライズが導入支援でご案内している進め方をもとに、Codex を GitLab につないで Merge Request をレビューさせるまでの手順と、法人で先に決めておくことを整理します。仕様は OpenAI 公式ドキュメント「Review GitLab merge requests with Codex」と変更履歴(What’s new)で、2026年11月9日に確認した範囲だけを書いています。GitHub での使い方はGitHub の Pull Request レビューの記事で解説しています。

結論: レビューは早く始められるが修正にはプロジェクトの環境が要る

先に要点をまとめます。

  1. GitLab 対応は Beta で全プランが対象。 公式ドキュメントには「GitLab support is in beta and is available on all ChatGPT plans」と書かれています。動きは Codex のクラウドで行われます
  2. GitLab.com とセルフマネージドで手順が違う。 GitLab.com は利用者がアカウントを接続します。セルフマネージドと Dedicated は、ワークスペースの管理者がテンプレートとサービスアカウントを用意してから各レビュアーが接続します
  3. レビューは @codex review、修正や作業の依頼はプロジェクトの環境が前提。 グループ単位の設定だけではレビューしかできません。@codex fix the P1 issue のような依頼には、プロジェクトごとの環境が必要です
  4. GitHub と同じではない。 デスクトップアプリの Create pull request のような GitHub 向けの操作は、この Beta には含まれていません

GitLab.com とセルフマネージドの違い

最初に、自社の GitLab がどちらに当たるかを確かめてください。設定する人も必要な権限も変わります。

項目 GitLab.com セルフマネージド・Dedicated
接続のしかた ChatGPT で GitLab に接続したあと Codex で接続 管理者がテンプレートを公開したあと各レビュアーが接続
サービスアカウント 公式ドキュメントに必要との記載なし 必要(Codex に作らせるか既存のものを使う)
レビューを有効にする条件 プロジェクトの環境を作る プロジェクトの環境またはグループの Webhook
グループ単位の設定 記載なし Manage groups から設定できる(GitLab Premium または Ultimate)
署名付き Webhook — GitLab 19.0 以降

セルフマネージドの GitLab 19.0 では、webhook_signing_token という機能フラグが有効になっている必要があります。公式ドキュメントでは、このフラグは既定でオンで、19.1 で取り除かれたと説明されています。古いバージョンを使っている場合は、先に GitLab 側の更新計画を確認してください。

設定の手順

1. GitLab を接続する

GitLab.com では、ChatGPT で GitLab に接続したあと Codex でアカウントを接続します。セルフマネージドと Dedicated では、Codex Cloud → Settings → Connectors から接続します。セルフマネージドの接続にはワークスペースの管理者が公開したテンプレートが必要です。

2. サービスアカウントを用意する(セルフマネージド・Dedicated)

Codex が GitLab にレビューやリアクションを書き込むためのアカウントです。用意のしかたは2つあります。

  1. Codex に作らせる: Set up service account → Create a service account を選びます。GitLab インスタンスの管理者権限が必要です。対象を Selected groups か Selected projects only から選ぶと、api スコープの個人用アクセストークンを持つアカウントが作られます
  2. 既存のアカウントを使う: Codex に作業させたいグループやプロジェクトにだけ Developer 権限を付けます。GitLab の Service accounts の画面でアカウントを選び、Manage access tokens → Add new token で api スコープのトークンを作ります。有効期限は30日以上先にします。Codex で Use an existing service account を選んでトークンを貼り付け、Save token で保存します

公式ドキュメントでは、保存したトークンは暗号化され、二度と表示されないと説明されています。有効なトークンを設定するまで、Codex は GitLab の操作に反応しません。

法人で気をつけたいのは、接続した利用者の権限とサービスアカウントの権限は別だという点です。利用者がプロジェクトのメンバーでも、サービスアカウントに Developer 権限がなければレビューは書き込まれません。逆に、サービスアカウントに広いグループの権限を付けると、Codex が操作できる範囲も広がります。最初は試験導入するプロジェクトだけに絞ってください。

3. プロジェクトの環境を作る

Codex Cloud → Settings → Environments でプロジェクトを選んで環境を作り、Enable Codex activity from GitLab をオンにします。これでプロジェクトに Webhook が入ります。設定には、プロジェクトの Maintainer か Owner、インスタンスの管理者、または Webhook を管理できるカスタムロールの権限が要ります。

環境はレビューだけなら省ける場合もありますが、修正やそのほかの作業を頼むときは必須です。GitLab.com ではレビューを有効にするためにも必要です。環境の中に置く鍵や環境変数の扱いは鍵と環境変数を Codex に触らせない設定の記事を参考にしてください。

4. グループ単位でレビューを有効にする(任意)

セルフマネージドと Dedicated では、ワークスペースの管理者が Environments → GitLab activity → Manage groups から、グループとその下のサブグループ全体でレビューを有効にできます。接続している利用者がグループの Owner であることと、GitLab Premium または Ultimate であることが条件です。

ただし、グループ単位の設定でできるのはレビューだけで、プロジェクトの環境は作られません。修正まで任せたいプロジェクトには、別に環境を作ります。

レビューの頼み方

手動で頼む

Merge Request に @codex review とコメントします。Codex が 👀 のリアクションを付け、ディスカッションとノートとしてレビューを書き込みます。手動のレビューでは P0・P1・P2 の指摘が出ることがあります。

1回だけ見てほしい観点があるときは、コメントに書き足します。公式ドキュメントの例は @codex review for issues in the database migration です。日本語の社内運用では「今回はマイグレーションの安全性を中心に」のように、焦点を一文で添える使い方から始めると分かりやすくなります。

自動で頼む

Codex のレビュー設定(chatgpt.com/settings/code-review?provider=gitlab)でリポジトリを選び、Review code の Automatic review をオンにします。Review で誰の Merge Request をレビューするかを、Trigger でいつレビューするかを選びます。リポジトリの設定は個人の既定値より優先されます。

トリガー 動くタイミング 向いている使い方
On MR open Merge Request を開いたとき まず試すとき。レビューの回数を抑えやすい
On every push push のたびに 小さな変更を何度も push するチーム
Smart Trigger (Experimental) Codex が判断 Experimental のため検証用にとどめる

自動レビューは P0 と P1 の重大な指摘に絞られます。プロジェクトか上位グループの Webhook が必要で、セルフマネージドと Dedicated ではサービスアカウントにプロジェクトへの書き込み権限が要ります。

指摘を直してもらう

レビューのあとに @codex fix the P1 issue とコメントすると、Merge Request を文脈にしたクラウドのチャットが始まり、権限があればブランチに修正を push します。review 以外の @codex へのメンション(たとえば @codex fix the CI failures)も同じくクラウドのチャットを始めます。どちらもプロジェクトの環境が前提です。クラウドで作業させる仕組みはクラウドタスクの基本の記事で整理しています。

AGENTS.md でレビューの観点を伝える

リポジトリ独自の観点は、AGENTS.md に ## Code Review Rules の節を作って書きます。### の見出しで確認項目をまとめます。リポジトリ全体のルールはルートの AGENTS.md に、サービスごとのルールは各ディレクトリの AGENTS.md に置きます。Codex は変更されたファイルごとに、ルートのものと最も近いものを当てはめます。

公式ドキュメントがすすめている書き方は次のとおりです。

  • 最初は短いルールを2つか3つにする
  • 守るべき安全な書き方や例外を書く
  • 長く使えて対象がはっきりしたルールにする
  • lint や書式の確認は CI に任せる

たとえば次のように書きます。

## Code Review Rules

### 個人情報
- ログに氏名・メールアドレス・電話番号をそのまま出力していないか確認する
- 例外: テスト用の固定データは対象外

### データベースの変更
- マイグレーションに元に戻す手順があるか確認する

AGENTS.md の書き方全般はAGENTS.md の書き方の記事で詳しく解説しています。

反応しないときの確認点

設定直後によくあるのが「コメントしても何も起きない」という問い合わせです。公式ドキュメントのトラブルシューティングをもとに、確認する順番をまとめます。

  1. 意図した GitLab のアプリ(接続先)が選ばれているか
  2. そのプロジェクトか上位グループで Codex のアクティビティが有効か
  3. GitLab の Webhook の Recent events にエラーが出ていないか。SSL の検証と署名の設定も見る
  4. トークンが有効で api スコープを持っているか
  5. 接続した利用者ではなく、サービスアカウントに Developer 権限があるか
  6. 自動レビューなら、Merge Request がレビューのポリシーとトリガーの条件に合っているか
  7. それでも動かなければ @codex review と手動で頼んでみる

社内の問い合わせ窓口に、この順番をそのまま渡しておくと切り分けが早くなります。

法人で先に決めておくこと

Beta の機能なので、最初から全社に広げず、試験導入のプロジェクトで運用を固めるのが安全です。始める前に次の5点を決めて文書にしてください。

  1. 対象のプロジェクト: 試験導入するプロジェクトを1つか2つに絞る。グループ単位の設定は運用が固まってから
  2. サービスアカウントの権限とトークンの管理者: Developer 権限を付ける範囲、トークンの有効期限、期限前に誰が更新するか。管理者は Connectors の画面から、Codex が作ったアカウントのトークンを取り消して作り直せます。既存のアカウントの場合は Codex 側で差し替えか削除をし、GitLab 側で別に取り消します
  3. 自動か手動か: まず @codex review の手動から始めるか、On MR open の自動にするか
  4. 修正の push を許すか: @codex fix でブランチへの push を許すか。許すならどのプロジェクトに限るか
  5. 人の承認との関係: 公式ドキュメントのとおり、レビューのルールはテスト・ブランチ保護・必須の承認の代わりではありません。マージの判断は人が行うと明記しておく

まとめ

Codex は GitLab の Merge Request のレビューに Beta で対応しており、GitLab.com でもセルフマネージドでも使えます。始めるときに押さえるのは、自社の GitLab がどちらに当たるか、サービスアカウントの権限をどこまで付けるか、レビューだけにするか修正まで任せるか(プロジェクトの環境を作るか)の3点です。まず試験導入のプロジェクトで @codex review を手動で使い、AGENTS.md の ## Code Review Rules を2〜3個から育てていくと、無理なくチームに広げられます。

なお、この記事の内容は2026年11月9日時点の OpenAI 公式ドキュメントで確認した範囲です。Beta のため、画面の名称や条件は変わることがあります。社内ルールに落とし込む前に最新の記載をご確認ください。デジライズでは、GitLab を使う開発チームでの運用設計を含めた Codex の法人導入支援のご相談を承っています。