说实话，同时调试后端接口、跑前端热更新、检查数据库迁移状态——这种场景在传统工具里，你免不了要在好几个终端窗口之间来回倒腾，手忙脚乱。而Codex线程系统正是为了解决这个痛点设计的：它让你在一个界面里，并行驱动多个独立任务流，每个任务还都有自己的专属上下文和执行环境。

创建并管理多线程会话

先打开Codex桌面客户端或VS Code插件，确保已经用ChatGPT账号登录（注意：用API Key登录是没法启用多线程会话的）。

接下来，点击左下角的「+ New Project」→ 选择「Multi-threaded Workspace」模板 → 给项目起个名字（比如“订单服务联调”）→ 点创建。系统会自己初始化一个主会话（Manager），同时在后台预分配3个Subagent线程槽位。这时候你看到的不是单个命令行，而是一个带标签页的多面板视图：Manager、Agent-1、Agent-2、Agent-3。

每个Agent标签页右上角都有实时状态图标：绿色圆点表示Alive，灰色方块表示Exited，问号则代表Unknown。点击任意标签页就能向对应线程发指令，互不阻塞，这就很舒服了。

为不同线程注入精准上下文

方法一：拖拽式上下文绑定
在Project模式下，把 src/main/ja va/com/example/order/ 目录直接拖入Agent-1标签页的输入框，Codex会自动识别为Ja va Spring Boot模块，后续所有指令默认作用于该路径下的文件。

方法二：指令级上下文锚定
在Agent-2中输入类似这样的内容：
context: frontend/vue3; target: src/views/OrderList.vue; constraint: 不修改setup()外的逻辑
这一步强制锁定了技术栈、文件路径和修改边界，避免跨层误改，尤其适合多人协作场景。

方法三：记忆快照复用
在Manager中执行 /snapshot order-api-debug-context，完成后，在任意Agent输入 /load order-api-debug-context 就能秒级还原完整上下文（包括当前变量、历史输出、依赖树）。注意：快照不包含运行时进程状态，仅保存静态上下文。

协调多线程任务执行流程

第一步：在Manager中输入拆解指令
拆解「验证订单分页手机号筛选失效」任务为3个并行子任务：① 检查Controller层参数接收逻辑；② 分析MyBatis XML中SQL条件拼接；③ 抓包确认前端传参格式

第二步：自动分发至空闲Agent
Codex识别出这3个子任务没有依赖关系，于是把①分给Agent-1（已绑定order后端上下文）、②分给Agent-2（已绑定MyBatis上下文）、③分给Agent-3（自动启用网络抓包工具链）。

第三步：同步监控与冲突仲裁
所有Agent的输出实时汇聚到Manager面板底部的「DAG Timeline」视图。如果Agent-2发现SQL中 AND phone LIKE ? 被硬编码覆盖了，Manager会立刻暂停Agent-1的Controller分析，并触发 /conflict-resolve 指令启动联合诊断，避免矛盾结论。

第四步：合并结果生成交付物
当所有Agent状态变为Exited且exit_code=0，Manager自动生成一份 diagnosis-report.md，里面包含各线程的关键发现、时间戳、原始输出片段以及修复建议锚点。这份报告可以直接扔给团队共享。

回收闲置线程与清理上下文

在任意Agent标签页输入 /kill，该线程立即终止并释放内存。如果忘了手动终止，Codex会在会话闲置5分钟后自动执行 collect_output_until_deadline 并标记为Exited状态，避免资源浪费。

执行 /clear-context --all 可以清空当前Project所有Agent的上下文缓存，但不会删除本地Worktree中的文件变更。

【执行此命令后，所有Agent将丢失当前绑定的代码路径与约束条件，需重新注入】