使用情境 · Codex

Codex 資安審查:pull request、本機掃描和 CI

Codex Security 會審查程式碼中的漏洞,並回報你調查時需要的證據。在 GitHub 上,@codex security review 檢查一個 pull request,Auto security review 則可以和程式碼審查一起執行。在本機,Codex Security 外掛會掃描儲存庫,@openai/codex-security CLI 則能從終端機或 CI 執行同樣的掃描。本頁說明每一種,以及值得寫下來的規則。

資安審查:Codex 能做什麼

  • 在合併前檢查每次變更有沒有注入、缺少授權、資料外洩,以及寫在程式碼裡的機密。
  • 依排程掃描整個儲存庫,回報附證據的發現,而不是空泛的警告。
  • 把確認的發現變成修補或 issue,從最嚴重的開始。
  • 修正後再檢查一次,確認漏洞已經補上。

資安審查:用得上的 Codex 功能

功能用途怎麼開始
@codex security review在 pull request 上發出資安發現,完整報告在 Codex 任務裡在 pull request 上留言
Auto security review不必開口就審查 pull request 的漏洞Codex 設定裡的 Review security vulnerabilities
Codex Security 外掛掃描本機儲存庫,並把發現保存在 Security 工作台在 Codex 裡執行 /plugins,再安裝 Codex Security
Codex Security CLI從終端機或 CI 進行可重複的掃描npx @openai/codex-security scan

資安審查:如何設定 Codex

  1. 連接工具

    第一次本機掃描用外掛,腳本和 CI 用 CLI。使用 OpenAI 模型的掃描需要 Codex Security 存取權;用你的 ChatGPT 帳號登入,並把結果放在儲存庫外面。

    # 先登入,再掃描儲存庫;結果放在儲存庫外面
    npx @openai/codex-security login
    npx @openai/codex-security scan /path/to/repo \
      --auth chatgpt --output-dir /path/outside/repo/results
  2. 把規則寫進 AGENTS.md

    Codex 在開始任何工作前都會讀取 AGENTS.md:先讀 ~/.codex/AGENTS.md,再從儲存庫根目錄一路讀到它工作的資料夾。把這項工作的規則寫在那裡;規則很長的話,放進 .agents/skills/ 下的 skill。參見 AGENTS.md 指南。

    ## 資安審查規則
    - 審查每個動到 auth/、billing/ 或 SQL 的 pull request。
      找注入、缺少的授權檢查、寫在程式碼裡的機密,
      以及回傳給錯誤使用者的資料。
    - 每個發現標上 Critical、High、Medium 或 Low,
      附上檔案、行號和可能的利用方式。
    - 絕不對正式環境或任何不屬於我們的東西執行攻擊程式。
      閱讀程式碼,在本機測試。
    - 修正一律開 pull request;絕不推送到 main。
  3. 不開互動介面也能執行

    codex exec 執行一個任務後就結束。進度輸出到 stderr,最終訊息輸出到 stdout;-o 會另外寫進檔案,--json 則以串流輸出事件。除非傳入 --sandbox workspace-write,否則沙箱是唯讀的。

    # 用 AGENTS.md 裡的規則,對這個分支做一輪資安檢查
    codex exec "依 AGENTS.md,把這個分支和 main 比較,審查資安問題"
    
    # 從 CI 掃描儲存庫,不顯示即時儀表板
    npx @openai/codex-security scan "$REPOSITORY" --auth chatgpt \
      --output-dir "$SCAN_DIR" --headless
  4. 排入排程

    在 ChatGPT 桌面 App 或網頁版建立排程任務(CLI 無法管理排程任務),或從 cron 執行 codex exec。參見如何讓 Codex 主動工作。

來源:Codex 文件

限制與安全

  • 它讀的是你簽出的程式碼,不是正在運作的網站,所以抓不到設定錯誤的伺服器。
  • 掃描結果不固定:兩次執行可能找出不同的問題。要定期執行,而不是只跑一次。
  • 它是掃描工具和相依套件警示的補充,不能取代它們,也不能取代滲透測試。
  • Codex 預設會把指令放進沙箱:寫入只限於工作區,網路關閉。danger-full-access 只留給隔離的 runner 或容器使用。

資安審查,用 Claude Code 還是 Codex?

規則可以共用。在 AGENTS.md 寫一次,再把 @AGENTS.md 放進 CLAUDE.md,兩個 agent 就會讀同一份檔案。

另一個 agent 的逐步做法:Claude Code 資安審查。

Claude CodeCodex
規則檔CLAUDE.mdAGENTS.md
連接工具claude mcp addcodex mcp add 或 config.toml
你不在也能執行claude -pcodex exec
排程/schedule、桌面排程任務、/loopChatGPT App 的排程任務、cron
內建功能(資安審查)/security-review、兩個資安外掛@codex security review、Codex Security
使用 Crewmark

資安審查:讓它成為某個人的固定工作

指令只在有人記得時才會執行。Crewmark 把你自己的 Codex 變成 AI 員工,有職位、量化目標、工作時間和心跳,工作就會依排程完成,並出現在看板上。

  1. 從職位開始

    AI 軟體工程師:在職位說明裡寫上這些規則。

  2. 把工作放上它的看板

    把這項工作加成週期性 issue。員工依心跳醒來,做完後以評論回報。

  3. 相關內容

    不屬於資安問題的 bug,參見程式碼審查。

常見問題

如何讓 Codex 對 pull request 做資安審查?

在 pull request 上留言 @codex security review。Codex 會把發現發在那裡;完整報告在 Codex 任務的 Security Report 分頁。

Codex 的程式碼審查和資安審查有什麼不同?

程式碼審查標出各種嚴重的 bug。資安審查針對漏洞深入檢查,並產出資安報告。兩者可以在同一個 pull request 上執行。

可以在 CI 裡執行 Codex 資安掃描嗎?

可以,用 @openai/codex-security 套件裡的 Codex Security CLI;OpenAI 的文件有 GitHub 和 GitLab 的設定範例。

已於 2026 年 11 月 13 日對照 Claude Code 文件和 OpenAI 的 Codex 文件查核。

資安審查,交給 Codex 上的 AI 員工。

Crewmark 把 Claude Code 和 Codex 工作階段變成有職位、目標、工作時間和心跳的 AI 員工。