Codex -C / --cd 指定工作目錄與多項目批處理腳本寫法:不切目錄也能批量巡檢多個本地倉庫

本地同時管着十幾個微服務倉庫,寫腳本逐個 cd 切換既容易搞亂輸出路徑又難排查失敗。本文詳解 Codex -C / --cd 參數原理、與 --add-dir 的區別,並提供 Bash 與 PowerShell 多項目批量巡檢腳本模板。

NNathaniel bigo··原創首發·AI 輔助撰寫
12 分鐘讀完
資料核對於 2026-11-19 · 依據官方文檔與公開資料整理 Plus 帳號

結論先說

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

-C、--add-dir 與手動 cd 三種方式對比

圖:本站根據 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 註冊手機驗證服務。

三、多倉批處理必避的四個坑(本站建議)

  1. 所有傳入 -C 和 -o 的路徑盡量用絕對路徑。尤其當腳本被定時任務(如 cron 或 Windows 任務計劃程序)拉起時,預設啟動目錄往往不是腳本所在目錄,統一用絕對路徑能避免找不到倉庫或報告寫錯位置。
  2. 遇到非 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 即可放行。
  3. 巡檢完畢統一做二次彙總。等十幾個倉庫各自的 *.md 報告落盤到 $REPORT_DIR 後,可以對 $REPORT_DIR 再跑一次 codex exec -C "$REPORT_DIR" --skip-git-repo-check --sandbox read-only,讓它把各倉報告聚合成一份面向團隊主管的總覽表。
  4. 控制並發數與單倉成本。本站建議初版腳本採用串行循環並關閉冗餘推理輸出;如果倉庫數量很多想並行提速,用 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,自助兌換無需交出帳號密碼,並可開具增值稅發票;實時價格以商品頁展示為準,售後執行掉訂閱按剩餘天數折退、封號不在質保範圍的政策。

相關教學

參考資料

  • 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

Nathaniel 的更多內容

  1. 01

    獨立開發者用 ChatGPT + Codex 跑通產品全流程:市場驗證、PRD、原型到代碼上線覆盤清單

    單人做獨立產品最容易陷入「閉門寫兩個月代碼上線零用戶」或「AI 寫到一半目錄越改越崩」。本文整理「ChatGPT 負責市場驗證、PRD 與覆盤 + Codex 負責工程實現與測試」的五階段雙軌流程,附起手提示詞與 7 項上線覆盤清單。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成規範文件命名規則、整理混亂目錄樹與合併零散發票抬頭清單腳本

    面對滿桌面的「新建文件夾」「最終版2」和上百張零散電子發票,手工改名抄台帳耗時又容易漏重。本文分享先脫敏取樣、再用 ChatGPT 生成帶預演和回滾日誌的本地 Python 腳本,離線安全完成目錄整理與發票抬頭合併去重的實戰流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外電郵營銷(EDM)受眾分層文案、A/B 主題行測試與防進垃圾箱自檢

    做海外獨立站或出海 SaaS 電郵營銷(EDM),最怕千人一面群發被直接送進垃圾箱。本文結合 Gmail/Yahoo 批量發件人規範,梳理用 ChatGPT 設計受眾分層文案、批量生成 A/B 主題行矩陣並開展發前垃圾詞與合規自檢的實戰提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫 Notion Formula 2.0 公式、Obsidian Dataview 查詢與 Airtable 自動化腳本

    給 Notion 數據庫寫多條件 Formula 2.0 公式、給 Obsidian 寫 Dataview 動態看板,或在 Airtable 裏寫自動化腳本,經常因為一個小括號或類型不匹配報錯半天。本文整理三大工具的通用上下文喂料規範與三套直接可複製的生成提示詞。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 處理複雜 JSON / YAML / XML 字段映射、格式轉換與校驗規則編寫實戰

    對接第三方 API、遷移 Kubernetes 配置或解析政企 XML 報文時,手工對照幾百行嵌套字段既慢又容易漏掉空值與類型邊界。本文整理用 ChatGPT 完成字段映射表梳理、生成確定性轉換腳本以及編寫 JSON Schema / Pydantic / XSD 校驗規則的實戰流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 準備本科/碩士畢業論文答辯:提煉答辯 PPT 結構、模擬導師犀利追問與 3 分鐘自述稿

    畢業論文寫完後,要在 3–5 分鐘內講清研究價值並頂住答辯評委的連環追問並不輕鬆。本文整理在嚴格遵守高校學術規範的前提下,用 ChatGPT 提煉答辯 PPT 結構、打磨 3 分鐘口語自述稿並開展模擬導師犀利追問的排練流程與提示詞。

    ChatGPT0

同產品的其他教學

  1. 01

    用 ChatGPT 整理家庭裝修預算明細、隱蔽工程驗收清單與主材優缺點對比表實戰

    第一次裝修面對幾十頁施工報價單、密密麻麻的水電防水隱蔽項目與五花八門的主材參數,極易踩坑增項。本文梳理用 ChatGPT 審查裝修報價漏項、生成帶公式的預算明細表、定製工地隱蔽工程驗收單與主材對比表的實戰提示詞。

    ChatGPT0
  2. 02

    用 ChatGPT 做費曼學習法讀書共讀:反向追問檢驗自己是否真讀懂專業書籍與整理書單筆記

    讀完一本專業硬書常感覺「合上書就忘」,直接讓 AI 概括全書又容易產生懂了的錯覺。本文介紹用 ChatGPT 結合 Study Mode 與費曼學習法做反向追問共讀,通過通俗複述、挑刺盲區到沉澱書單卡片的完整流程與提示詞。

    ChatGPT0
  3. 03

    用 ChatGPT 做外貿產品多語種目錄、展會邀約與客戶跟進節奏表(附脫敏與本地化提示詞)

    做外貿展會與海外推廣時,手工翻譯十幾款產品目錄費時且容易留下一堆中式英文,展後客戶跟進也常缺節奏。本文梳理用 ChatGPT 先脫敏建術語庫、再批量產出多語種目錄、展前邀約函與展後 21 天跟進節奏表的實戰流程與提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫高質素技術專欄文章、開源項目 Release Notes 與版本更新日誌實戰

    讓 AI 直接憑空寫技術文章容易滿篇空洞套話,直接甩 Git 記錄寫更新日誌又常常漏掉破壞性變更。本文整理用 ChatGPT 結合真實代碼片段、壓測數據與 PR 摘要,高效產出深度技術專欄、GitHub Release Notes 與 CHANGELOG 的實戰工作流。

    ChatGPT0
  5. 05

    用 ChatGPT 做產品用戶訪談紀要編碼、提煉高頻痛點需求池與 RICE 優先級打分實戰

    手頭攢了十幾份用戶訪談逐字稿,手工貼便利貼歸納痛點耗時又容易帶入主觀偏見。本文分享用 ChatGPT 完成脫敏檢查、逐份開放式編碼、跨樣本聚類高頻痛點並搭建 RICE 優先級打分表的 5 步實戰流,附可直接複製的三段核心提示詞。

    ChatGPT0
  6. 06

    ChatGPT 網頁版上載超過 10 個文件或回形針附件按鈕變灰怎麼辦:打包合併與配額限制排查

    在 ChatGPT 網頁版批量分析文檔時,常遇到一次選超 10 個文件被攔截或輸入框回形針按鈕變灰。本文依據 OpenAI 文件上載與存儲說明,梳理 6 類常見報錯的分流排查法,提供 ZIP 打包、本地合併與 Projects 複用方案及可直接複製的解包提示詞。

    ChatGPT0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~