Claude Code 与 Codex 实用技巧（带版本和验证日期）

用 --add-dir 一次处理多个仓库

默认只能访问启动目录。--add-dir 额外授权其他目录，适合前后端分仓、或者要参考另一个仓库代码的场景。

用 --bg 把长任务放到后台跑

--bg 启动后立刻返回一个会话 ID，任务在后台继续。用 claude agents 列出，claude attach、logs、stop 管理。

CI 里用 --bare，让结果不受本机配置影响

--bare 跳过 hooks、LSP、插件同步、自动记忆和 CLAUDE.md 自动发现，脚本运行更可复现。注意它只认 ANTHROPIC_API_KEY 或 --settings 里的 apiKeyHelper，不读订阅登录。

按任务难度用 --effort 调思考力度

简单改动用低 effort 更快更省，难题用高 effort。只影响本次会话，不改全局设置。

用 --fallback-model 防止模型过载时整个任务失败

主模型过载或不可用时自动切到备用模型，可用逗号写多个依次尝试；每轮用户消息开始时会重新尝试主模型。

从当前对话分叉，试另一种方案而不弄乱原对话

--fork-session 配合 --continue 或 --resume，会带着之前的上下文开一个新的会话 ID，原会话保持不变。

用 --from-pr 接着某个 PR 的会话继续干

给 PR 编号或链接，直接恢复当初创建或处理这个 PR 的会话，上下文都在。不带参数会打开选择器。

脚本里用 -p + JSON 输出，顺手拿到每次花了多少钱

非交互模式 -p 配合 --output-format json，返回结果里带 total_cost_usd、is_error、num_turns，适合批处理和记账。

用 --json-schema 让输出严格符合你的格式

给 -p 调用传一个 JSON Schema，结果会出现在返回 JSON 的 structured_output 字段，省掉自己解析和重试。

--max-budget-usd 给脚本封顶，但别设太低

--max-budget-usd 只在 -p 模式生效。我们实测：设 0.05 美元时，第一轮（缓存还是冷的）就花了约 0.105 美元，直接以错误结束、没有结果。预算要按“第一轮冷缓存成本”留余量。

大改动先用 plan 模式开局

--permission-mode plan 让 Claude 先只读调研、写出计划，你批准后才动文件，适合陌生代码库或大重构。

Codex · 9

CI 和脚本里用 codex exec

codex exec（简写 codex e）不需要人工交互就能跑完任务；加 --json 输出逐行 JSON 事件，方便程序读取。

用 --output-schema 拿到固定格式的结果

给 codex exec 一个 JSON Schema 文件，最终回答会按这个格式校验，适合把结果直接喂给下一步程序。

codex exec resume --last 接着上次的脚本任务

codex exec resume --last 继续当前目录最近一次 exec 会话，可以附一句后续指令；加 --all 会在所有目录的会话里找。

用 /init 生成 AGENTS.md，把项目规矩写下来

在交互界面输入 /init 会在当前目录生成 AGENTS.md 骨架。把构建命令、代码风格、禁区写进去，Codex 每次都会读。

验证于 2026年10月17日 · 按官方文档核对

需要最新信息时加 --search

Codex 的网页搜索默认是缓存模式；查最新版本号、刚发布的 API 时加 --search 切到实时搜索（等于 web_search = "live"）。

用 --oss 接本地开源模型

--oss 改用本地开源模型，--local-provider lmstudio|ollama 选择后端。适合离线、敏感代码或想省钱的场景。

本地开发的推荐权限组合

官方建议本地低摩擦开发用 --sandbox workspace-write --ask-for-approval on-request：能改工作区文件，超出范围的命令再来问你。

用 --profile 切换整套配置

--profile 名字会把 $CODEX_HOME/名字.config.toml 叠加到基础配置上。可以给“省钱模式”“严格沙箱”等场景各建一个文件。

用 --worktree 让任务在独立的 git worktree 里跑

--worktree 在新的受管 git worktree 里开工，不碰你当前的工作区；交互会话、codex exec 和 fork 都支持，需要本地运行。