結論先說
-C/--cd在執行前精確重設工作區根目錄。無論是交互模式codex -C /path/to/repo還是批處理codex exec -C /path/to/repo "...",Codex 都會把指定路徑當成本次會話的根工作區,自動識別該倉庫的.git、各級AGENTS.md與項目級配置,而不必修改外部腳本自身的工作目錄。- 分清
-C和--add-dir的定位。-C決定「主倉庫是誰」,一次任務只有一個主工作區;--add-dir是在主工作區之外「額外掛載同級讀寫目錄」(例如改前端時順帶改公共類型包)。批量逐個巡檢獨立倉庫用-C,跨倉聯動改同一需求用--add-dir。 - 批處理巡檢預設堅持
--sandbox read-only+--ephemeral。先只讀掃描生成彙總報告,確認清單後再有針對性地改代碼,既避免腳本循環意外污染十幾個倉庫,也能防止產生一堆一次性歷史會話。 - 注意區分
-o輸出路徑的基準位置與非 Git 目錄報錯。批處理裏給-o指定輸出報告路徑時,務必傳入絕對路徑;如果目錄清單裏混有未初始化 Git 的普通文件夾,記得按需加上--skip-git-repo-check。 - 批量連續掃描多個代碼倉庫時,單次運行就會產生多輪上下文與工具調用,建議備好充足額度。國內如無外幣支付渠道,可在本站自助開通 ChatGPT Plus 或高配額 ChatGPT Pro,研發團隊多人部署也可了解 ChatGPT Business 團隊定製。

圖:本站根據 OpenAI Codex 官方文檔:Codex CLI reference 整理的示意圖
本文根據 OpenAI Codex 官方文檔《Codex CLI reference》《Non-interactive mode》整理,資料核對於 2026-11-19。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 OpenAI 官方網站。
適用於誰
- 手頭維護多個本地微服務、前後端分倉或組件庫,希望一條批處理腳本自動完成依賴漏洞檢查、配置對齊或文檔巡檢的研發工程師;
- 習慣在總控目錄裏集中存放提示詞模板與巡檢報告,不想在 Shell 循環裏反覆
pushd/popd切來切去的運維與平台開發; - 分不清
-C / --cd與--add-dir各自該在什麼場景下使用的 Codex CLI 用戶。
一、為什麼多項目腳本推薦用 -C / --cd 而不是手動 cd
在寫多倉庫批處理腳本時,很多人第一反應是寫一段 for dir in ...; do cd "$dir"; codex exec ...; cd ..; done。這種寫法在簡單測試時看似能跑,但放到真實工程環境很快就會踩坑:
- 中途失敗容易讓目錄指針跑偏:某一個目錄不存在或命令中途退出,若未嚴格使用子 Shell 或
trap,後續循環會在錯誤路徑裏亂掃; - 相對路徑到處打架:你想把統一提示詞文件放在總控腳本旁邊,並把十個倉庫的報告彙總到
./reports/,每切一次目錄,相對路徑參照系全變了; - 可讀性與調試成本高:用
codex exec -C "$repo"時,調用方腳本永遠停留在總控根目錄,目標倉庫作為顯式參數傳入,單條命令複製出來就能直接復現。
更關鍵的是,指定 -C /path/to/repo 後,Codex 會從該目標目錄出發去發現所屬倉庫根、讀取對應的 AGENTS.md 和 .codex/config.toml(前提是目錄受信任),並把 workspace-write 沙箱邊界牢牢錨定在該倉庫內。若是單次任務需要同時修改兩個關聯倉庫,則應改用 --add-dir(詳見 /guides/codex-multi-repo-add-dir-frontend-backend-shared)。
二、實戰模板:Bash 與 PowerShell 多倉庫批量巡檢腳本
下面給出兩套開箱即用的跨平台巡檢腳本模板(本站建議),均包含只讀隔離、單倉失敗不中斷、絕對路徑集中歸檔和清晰狀態統計(更多 CLI 管道組合見 /guides/codex-cli-pipe-stdin-exec-recipes 與 /guides/codex-exec-full-auto-ephemeral-ci-pipeline-guide)。

圖:本站根據 OpenAI Codex 官方文檔:Non-interactive mode 整理的示意圖
模板 1:macOS / Linux Bash 批量巡檢腳本
bash
#!/usr/bin/env bash
set -uo pipefail
REPORT_DIR="$(pwd)/audit-reports/$(date +%Y%m%d)"
mkdir -p "$REPORT_DIR"
REPOS=(
"/workspace/service-auth"
"/workspace/service-billing"
"/workspace/web-console"
)
PROMPT="僅做只讀巡檢:檢查本倉庫依賴版本是否存在明顯過期或硬編碼密鑰風險,按高/中/低列出文件與行號。"
for repo in "${REPOS[@]}"; do
name="$(basename "$repo")"
echo ">>> 正在巡檢: $name ($repo)"
if codex exec \
-C "$repo" \
--sandbox read-only \
--ephemeral \
-c hide_agent_reasoning=true \
-o "$REPORT_DIR/${name}.md" \
"$PROMPT" \
> /dev/null 2> "$REPORT_DIR/${name}.err.log"; then
echo " 完成 -> $REPORT_DIR/${name}.md"
else
echo " 失敗 -> 請查看 $REPORT_DIR/${name}.err.log"
fi
done
模板 2:Windows PowerShell 批量巡檢腳本
powershell
$ReportDir = Join-Path (Get-Location) ("audit-reports\" + (Get-Date -Format "yyyyMMdd"))
New-Item -ItemType Directory -Force -Path $ReportDir | Out-Null
$Repos = @(
"D:\projects\service-auth",
"D:\projects\service-billing",
"D:\projects\web-console"
)
$Prompt = "僅做只讀巡檢:檢查 Dockerfile 與配置文件中是否存在明文密鑰或過寬權限,並給出修復清單。"
foreach ($repo in $Repos) {
$name = Split-Path $repo -Leaf
$outFile = Join-Path $ReportDir "$name.md"
$errFile = Join-Path $ReportDir "$name.err.log"
Write-Host ">>> 正在巡檢: $name"
codex exec -C $repo --sandbox read-only --ephemeral `
-c hide_agent_reasoning=true -o $outFile $Prompt `
2> $errFile | Out-Null
if ($LASTEXITCODE -eq 0) {
Write-Host " 完成 -> $outFile"
} else {
Write-Host " 失敗(退出碼 $LASTEXITCODE) -> 請查看 $errFile"
}
}
訂閱與帳號準備提示:批處理腳本連續跑十幾個代碼倉庫時,短時間內會疊加大量輸入上下文和推理調用,容易比單倉交互更快觸及週期限額(限額與省額技巧參考 /guides/codex-usage-limits 與 /guides/codex-save-usage-quota-model-reasoning-context-tips)。若有定期多倉巡檢需求,可在本站升級 ChatGPT Pro 充值 或 ChatGPT Pro 5x iOS 可覆蓋檔;新註冊帳號遇到手機驗證環節卡住,可參考 Codex 註冊手機驗證服務。
三、多倉批處理必避的四個坑(本站建議)
- 所有傳入
-C和-o的路徑盡量用絕對路徑。尤其當腳本被定時任務(如cron或 Windows 任務計劃程序)拉起時,預設啟動目錄往往不是腳本所在目錄,統一用絕對路徑能避免找不到倉庫或報告寫錯位置。 - 遇到非 Git 目錄別忘
--skip-git-repo-check。如果清單中某個目錄只是普通文檔或運維腳本文件夾(沒有.git),codex exec會直接報Not inside a trusted directory and --skip-git-repo-check was not specified.並退出;確認該目錄安全後,針對性加上--skip-git-repo-check即可放行。 - 巡檢完畢統一做二次彙總。等十幾個倉庫各自的
*.md報告落盤到$REPORT_DIR後,可以對$REPORT_DIR再跑一次codex exec -C "$REPORT_DIR" --skip-git-repo-check --sandbox read-only,讓它把各倉報告聚合成一份面向團隊主管的總覽表。 - 控制並發數與單倉成本。本站建議初版腳本採用串行循環並關閉冗餘推理輸出;如果倉庫數量很多想並行提速,用
xargs -P 2或最多 2 到 3 路並發即可,避免高並發同時打滿速率限制。更多 CLI 參數可查 /guides/codex-cli-commands-cheatsheet。
常見問題
問:同時傳了 -C /repoA 和 --add-dir /repoB,模型會讀取誰的 AGENTS.md?
答:主工作區以 -C /repoA 為準,Codex 會圍繞 /repoA 加載對應的項目指令與倉庫上下文;--add-dir /repoB 負責放寬沙箱使命令和工具也能讀寫 /repoB 中的文件。
問:批量腳本里如果不僅想巡檢,還想讓 Codex 自動在各倉庫裏修代碼怎麼辦?
答:務必先確保每個倉庫工作樹幹淨(git status 無未提交改動),再把 --sandbox read-only 換成 --sandbox workspace-write 並配合 approval_policy = "never"(或專用 CI Profile),跑完後統一在各倉庫用 git diff 人工覆核後再決定是否提交。
問:國內沒有外幣信用卡,或者公司研發團隊需要開增值稅發票報銷,怎麼開通能跑 Codex 的訂閱?
答:可在本站 AI 會員充值總覽 按需選購 ChatGPT Plus、ChatGPT Plus 官網直充 或高配額的 ChatGPT Pro,團隊多人採購可直接查看 ChatGPT Business 團隊定製。支持支付寶、微信支付與 AlipayHK,自助兌換無需交出帳號密碼,並可開具增值稅發票;實時價格以商品頁展示為準,售後執行掉訂閱按剩餘天數折退、封號不在質保範圍的政策。
相關教學
- Codex 多倉聯調:--add-dir 聯動前後端與共享包實戰
- Codex CLI 管道 stdin 與 exec 批處理腳本配方
- Codex exec 全自動與 --ephemeral 無狀態 CI 流水線指南
- Codex CLI 常用命令與參數速查表
參考資料
- OpenAI Developers 文檔:Codex CLI reference — https://developers.openai.com/codex/cli/reference
- OpenAI Developers 文檔:Non-interactive mode — https://developers.openai.com/codex/noninteractive
- OpenAI Codex 官方文檔:CLI reference — https://learn.chatgpt.com/docs/cli/reference
- OpenAI Codex GitHub 倉庫 — https://github.com/openai/codex
0 條評論
還沒有評論,來搶沙發~