結論先說
- 它跑在 Codex Cloud 雲端,不用你自己改寫
.gitlab-ci.yml流水線腳本:配通連接器與項目 Webhook 後,GitLab 會把 MR 差異事件推給雲端審查並將高信噪比意見貼回討論區。 - GitLab.com 與企業自託管(Self-managed)走兩條不同的授權鏈路:公有云直接連個人帳號並建項目雲環境;自託管實例需要工作區管理員在連接器後台配置服務帳號(Service account)與最小範圍令牌。
- 註冊項目 Webhook 需要項目 Maintainer(維護者)或更高權限:普通只讀成員無法往倉庫寫入事件回調開關。
- 想讓審查懂你們項目的家規,在倉庫放好
AGENTS.md:Codex 審 MR 時會自動讀取倉庫裏的審查指引,預設聚焦嚴重故障隱患而不是瑣碎排版挑刺。

圖:本站根據 OpenAI Codex 官方文檔 Review GitLab merge requests 整理的示意圖
本文根據 OpenAI Codex 官方文檔《Review GitLab merge requests with Codex》整理,核對日期 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 OpenAI 或 GitLab 官方網站。
適用於誰
- 搜「codex gitlab 代碼審查」「gitlab merge request 接入 codex」的研發負責人與工程師;
- 團隊倉庫放在
GitLab.com或公司內網自託管(Self-managed / Dedicated)GitLab 上,想給每個合併請求(MR)加一道自動抓高危漏洞與邏輯缺陷的雲端評審防線的人; - 想對比「用 Codex Cloud 原生連接器審 GitLab」和「在 GitLab Runner 容器裏跑 CLI 審查」(見 /guides/claude-code-gitlab-ci-cd-merge-request-guide)哪種更省維護成本的架構師。
如果你平時做的是本地終端審查或 GitHub 審查,可先參考基礎篇 /guides/codex-code-review;本文專門拆解 GitLab 合併請求雲端集成的官方配置步驟。
一、情況 A:倉庫託管在官方公有云 GitLab.com
如果你的項目直接在 GitLab.com 上,配置路徑非常短:
- 綁定 GitLab 帳號:先按標準連接流程在 ChatGPT / Codex 裏關聯你的 GitLab 帳號;
- 創建項目雲環境(必做):打開 Codex Cloud → Settings → Environments(雲端環境基礎見 /guides/codex-cloud-how-to-use),在倉庫選擇器裏挑中你的 GitLab.com 項目創建環境——官方文檔特別註明,在 GitLab.com 上啟用代碼審查必須先創建對應的項目環境;
- 勾選安裝項目 Webhook:創建環境時,打開 啟用來自 GitLab 的 Codex 活動(Enable Codex activity from GitLab) 開關。這一步會自動幫你在該倉庫安裝投遞 MR、評論與議題事件的 Webhook(確保你當前綁定的帳號在該項目擁有 Maintainer、Owner 或管理 Webhook 的權限)。
二、情況 B:公司內網自託管(Self-managed)或專屬 GitLab 實例
企業自建實例涉及實例級安全邊界,需要 ChatGPT 工作區管理員先在 Codex Cloud → Settings → Connectors 裏為該實例配置專職審查身份(支持兩種方式):
方式一:讓 Codex 自動創建服務帳號
管理員(需同時具備該 GitLab 實例管理員權限)在連接器頁選擇 設定服務帳號(Set up service account) → 創建服務帳號,明確勾選允許 Codex 介入的指定群組(Selected groups)或僅指定項目(Selected projects only)。系統會自動建好僅擁有對應範圍 Developer 權限與 api 令牌的服務帳號,避免給全局超級權限。
方式二:綁定你們自己預先建好的服務帳號(最受安全團隊歡迎)
- 在你們自己的 GitLab 後台新建一個專用服務帳號,只在需要開啟 AI 審查的群組或項目裏授予 Developer 權限;
- 為該服務帳號生成一枚勾選了
api範圍、且過期時間距離當前不少於 30 天的個人訪問令牌(PAT); - 回到 Codex 連接器後台選擇 使用現有服務帳號(Use an existing service account) 粘貼儲存。令牌落庫後即加密隱藏,後續輪換或吊銷隨時可在同一頁面更換。

圖:本站根據 OpenAI Codex 官方文檔 GitLab 集成指南 整理的示意圖
三、用 AGENTS.md 管住審查口徑
無論走公有云還是自託管,想讓雲端審查員少報誤報、抓準你們業務獨有的雷區(比如「金額計算嚴禁使用浮點數」「所有對外查詢接口必須校驗租戶 ID」),只需把審查要點寫進倉庫的 AGENTS.md(層級規則見 /guides/codex-agents-md-how-it-reads)。
個人或小團隊日常評估開啟雲端審查與本地 CLI 聯調的訂閱方案時,也可參考 /chongzhi/chatgpt-plus 的整理說明。
常見問題
Q:配完環境提了新的 Merge Request,為什麼 Codex 完全沒過來評論?
按順序查三處:第一,如果是自託管實例,檢查服務帳號的 PAT 令牌是否已過期(令牌失效後 Codex 無法響應任何 GitLab 事件);第二,進 GitLab 項目的 Settings → Webhooks 看最近一次推送返回狀態碼是不是 2xx;第三,確認該服務帳號在當前目標倉庫確實擁有 Developer 訪問權。
Q:為什麼在 Codex 桌面客戶端裏看不到給 GitLab 一鍵點「創建合併請求」的按鈕?
按官方文檔說明,目前 GitLab 集成尚處於測試階段(Beta),桌面 App 內置的倉庫快捷按鈕(如一鍵建 PR)暫未包含在該測試版範圍內,代碼推送與評審交互主要在 Codex Cloud 與 GitLab 網頁端完成。
相關教學
- /guides/codex-code-review:Codex 代碼審查核心用法與觸發命令
- /guides/codex-cloud-how-to-use:Codex Cloud 雲端環境創建與配置教學
- /guides/codex-agents-md-how-it-reads:用
AGENTS.md定製項目專屬編碼與審查規則 - /guides/claude-code-gitlab-ci-cd-merge-request-guide:Claude Code 在 GitLab CI/CD 流水線審 MR 方案對比
參考資料
- OpenAI Codex 官方文檔:Review GitLab merge requests with Codex — https://learn.chatgpt.com/docs/gitlab
- OpenAI Codex 開發者中心 — https://developers.openai.com/codex
0 條評論
還沒有評論,來搶沙發~