執行深度安全掃描
對儲存庫或資料夾反覆執行安全審查，並設定並發數和時長限制。
深度掃描會對同一儲存庫或資料夾執行多次獨立的標準掃描， 並合併發現的問題。如果你希望反覆審查， 且能接受額外的執行時間和 token 用量，可以使用深度掃描。
先執行一次標準掃描，檢查 範圍和安全上下文是否符合目標。反覆審查可能發現 先前審查遺漏的問題，但無法保證檢測到所有問題，也無法保證 各次執行的結果相同。
在標準掃描和深度掃描之間選擇
| 標準掃描 | 深度掃描 | |
|---|---|---|
| 審查 | 一次標準掃描 | 多次標準掃描，並合併發現的問題 |
| 適用場景 | 首次掃描或審查明確的範圍 | 對該範圍進行額外的獨立審查 |
| 範圍 | 儲存庫或資料夾 | 儲存庫或資料夾 |
| 變更 | 使用變更審查工作流程 | 不支援 |
啟動深度掃描
為獲得最佳掃描質量，請使用 gpt-5.6-sol，
並將推理強度設為 xhigh。
- 開啟 Security > 掃描，然後選擇 + 掃描。
- 選擇儲存庫或資料夾，選擇程式碼庫，並開啟深度掃描。 掃描會審查所選儲存庫或資料夾的全部內容。
- 選擇模型和推理強度。在附加上下文 中新增威脅模型或部署 上下文。
- 選擇開始掃描。
你也可以從 Codex 對話中啟動：
Use $codex-security:deep-security-scan to run a deep security scan of this repository.對於單個元件，請將 "this repository" 替換為其資料夾路徑。
深度掃描工作程序會繼承你選擇的模型和推理設定。每個 工作程序執行一次完整的標準掃描，Codex Security 會彙總 已完成的結果。從掃描 中跟蹤已儲存的掃描，或選擇檢視 活動 以檢視其 Codex 任務。如果需要限制並發數或時長，請在開始前設定執行時限制， 以控制資源使用。
審查結果
深度掃描與標準掃描使用相同的已儲存掃描詳情和完整掃描
目錄。在掃描 中開啟已完成的掃描，或在
發現的問題 中審查其問題。當你請求相應輸出時，生成的 report.md 會連結到詳細的漏洞報告
或結構性加固指導。
共享或歸檔結果時，請將連結的 findings/ 和 hardening/ 目錄與報告
一並保留。
先檢視覆蓋範圍摘要，再審查發現的問題。即使深度掃描也有侷限， 因此在得出結論前，請檢查暫緩審查的範圍和仍然存在的 證據缺口。對於已確認的問題，請繼續修復並驗證 問題。
要審查PR、提交、分支範圍或本機補丁，請使用審查程式碼 變更。深度掃描不接受差異作為目標。
設定深度掃描的執行時間
若要控制深度掃描的並發數和持續時間，請建立或編輯
~/.codex/codex-security/config.toml。如果設定了 CODEX_HOME，請改用
$CODEX_HOME/codex-security/config.toml。
例如，以下設定檔會以有限的並發數執行一次較短的掃描：
[deep_scan]
workers = 2
subagents = 0
stop_after_no_new = 3
max_discovery_runs = 10
max_time_hours = 1.5| 設定 | 預設值 | 說明 |
|---|---|---|
workers |
4 |
允許同時執行的獨立標準掃描工作程序數量。舊版 "auto" 也會解析為 4。 |
subagents |
3 |
每個工作程序可以啟動的子智能體數量。設為 0 可將其停用。 |
stop_after_no_new |
4 |
連續完成這麼多次工作程序掃描且均未產生新發現後停止。 |
stop_after_consecutive_errors |
3 |
連續出現這麼多次工作程序錯誤後停止。 |
max_discovery_runs |
40 |
限制聚合前獨立標準掃描的執行次數。 |
max_time_hours |
96 |
將工作程序執行時間限制為不超過 96 的正小時數；可按需使用小數。 |
較低的值可以減少掃描時間和令牌用量，但可能遺漏發現。 設定更改僅適用於新啟動的深度掃描，不適用於已經在進行的掃描。
達到時間限制時，Codex Security 會停止尚未完成的工作程序，保留 已完成的掃描結果，並將其聚合到最終報告中。如果截止時間前沒有任何工作程序 完成源程式碼審查，報告會記錄覆蓋範圍不完整。
max_time_hours 設定要求外掛版本為 0.1.19 或更高版本。有關發布詳情，請參閱
外掛更新日誌。