为什么你需要 Worktree？
传统用法下，让 Codex 跑任务时所有修改都直接发生在你的主目录——多任务并行容易冲突，出错后难以回滚。Codex 0.154 引入了实验性 Git Worktree 支持，让每个 Agent 会话都拥有独立的隔离工作区，互不干扰。
这是从「聊天式使用」到「工程化使用」的关键一步。
一、Worktree 是什么？
Git Worktree 是 Git 的原生功能，允许你在同一仓库中同时检出多个分支/目录。Codex 把它扩展到了 Agent 工作区：
- 每个 Codex 会话可以绑定一个独立的 Worktree
- 主目录保持干净，Worktree 里的修改不会污染主分支
- 任务完成后，你可以选择性地将有效变更合并回主分支
- 失败的尝试可以直接删除 Worktree，不留痕迹
二、三种接入方式
方式 1：Codex App 界面（最简单）
- 在 Codex App 中新建对话
- 点击 Composer 下方的「Worktree」标签
- 选择基础分支（通常是 main 或 master）
- 输入任务提示词，Codex 会自动创建隔离工作区
优势：图形化操作，一键完成，适合大多数用户。
方式 2：CLI 命令行（最灵活）
# 新建一个带 Worktree 的会话
codex --worktree "帮我重构 auth 模块的接口定义"
# 在非交互模式下执行
codex exec --worktree "生成 tests/ 目录下的所有单元测试"
关键参数：
- --worktree：启用隔离工作区模式
- --enable worktrees：首次使用时开启实验性特性
- --ask-for-approval never：批量任务时跳过审批弹窗
方式 3：会话内命令（最方便）
在运行中的会话里输入：
/worktree
Codex 会提示你选择：创建新 Worktree、切换到已有 Worktree、或浏览已存在的 Worktree 列表。
三、Inline Answers：任务中途实时介入
0.154 另一个重大升级是 Inline Answers——Codex 可以在任务执行过程中向你提问，而你无需停止当前正在输入的内容就能回答。
典型场景：
| 场景 | 旧体验 | 新体验 |
|---|---|---|
| Codex 发现两种实现方案 | 必须停下手中文字，去回答 | 直接点击选项，草稿保留 |
| 需要确认关键决策点 | 打断思路，上下文丢失 | 侧边栏快速响应，无缝继续 |
| 多轮迭代中的临时疑问 | 开新会话或等任务结束 | 实时回答，Codex 继续推进 |
操作技巧： - Codex 给出建议选项时，直接点击选择 - 自定义回答：输入框会自动切换为回答模式，输入文字后回车 - 即使你正在输入新指令，Codex 的问题也会被单独标记，不会覆盖你的草稿
四、真实工作流程示例
场景：同时处理两个 Feature
# 终端 1：处理 A 功能（Worktree: feature-a）
codex --worktree "实现用户订阅功能，包括支付和取消订阅"
# 终端 2：处理 B 功能（Worktree: feature-b）
codex --worktree "添加数据导出功能，支持 CSV 和 PDF 格式"
两个任务并行运行，互不影响。完成后：
# 检查各自的工作区
git worktree list
# 选择性合并
git cherry-pick feature-a # 只合并 A 功能的提交
五、最佳实践
1. 明确任务边界
每个 Worktree 对应一个清晰的任务：
codex --worktree "修复 login API 的边界条件处理"
2. 使用 /worktree 管理会话
在长会话中，可以随时切换或查看 Worktree 状态：
/worktree
→ Browse worktrees
→ [选择当前任务] Resume / [选择其他] Hand off
3. 任务结束后清理
# 删除已完成的工作区
git worktree remove ../project-worktree-fix-auth
git worktree prune # 清理悬空引用
六、安全增强
0.154 还包含多项安全改进： - macOS 沙箱阻止终端注入攻击 - 远程恢复会话时保留权限上下文 - 插件刷新行为更透明（安装新工具后自动同步） - 审批记录可追溯，避免误授权
总结
Codex 0.154 的 Worktree + Inline Answers 组合，标志着从「单次对话工具」向「工程化协作平台」的转变：
- 隔离工作区：多任务并行，互不干扰
- 实时介入：任务中途随时提问，不中断思考流
- 可追溯：每个工作区独立存证，方便审计
这些功能目前仍是实验性阶段，建议先在非生产项目中试用，熟悉后再扩展到正式开发流程。
来源： FrontierNews AI《OpenAI's Codex CLI Gets Durable Agent Workspaces》（2026-09-16）、OpenAI 官方文档 Worktrees 页面（developers.openai.com/codex/app/worktrees）
资料最后核对日期：2026-09-17 · 内容整理自 CodexGuide 社区公开教程