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 条评论

登录 后参与评论

还没有评论,来抢沙发~