结论先说
-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 条评论
还没有评论,来抢沙发~