Codex Thread Handoff 是什么？在本地与远程主机之间无缝继续开发
Codex 新增了本地与远程主机之间的 Thread Handoff 能力。开发者可以先在本地开始任务，再把同一个线程和对应的 Git 状态交给已经连接好的远程主机继续处理，之后也可以再交回本地。这解决的不是远程桌面本身，而是让同一个 Codex 开发线程能在不同执行环境之间延续上下文、代码状态和工作进度。
最后核对日期：2026年6月22日类型：Blog / TechArticle
时效性提示
Codex 的远程连接与线程交接能力仍在快速更新，具体入口、支持平台和限制请以 OpenAI 最新官方文档及 Codex App 内实际显示为准。
一句话理解 Thread Handoff
先在本地开始开发，再把同一个 Codex 线程和 Git 状态交接到远程主机继续工作，之后还可以交回本地。
它解决了什么问题
传统的本地与服务器切换，往往要重新登录、重新拉代码、重新说明当前任务、重新确认依赖和环境差异。如果当前还有未提交的修改，切换就更容易出错。Thread Handoff 的价值是降低这种环境切换成本，让线程上下文和 Git 工作状态跟着执行位置一起移动。
它会迁移什么
- 当前 Codex 线程。
- 线程中的任务上下文和对话记录。
- 对应的 Git 状态。
- 目标主机上的匹配项目 worktree 或工作目录绑定。
- 线程当前绑定的执行主机。
它不会自动迁移什么
- 正在运行的系统进程、容器和数据库任务。
- 所有未纳入 Git 管理的大文件或本地资源。
- 本地浏览器 Cookies、桌面应用状态和操作系统级配置。
- 远程主机尚未准备好的依赖、运行时、环境变量和权限。
正在运行的任务会怎样
更准确的说法是，Codex 会交接线程与 Git 状态，然后在目标主机的匹配项目环境中继续工作，而不是把当前外部进程原封不动迁移过去。
使用前需要满足的条件
目标主机已经连接
无论是另一台设备还是 SSH 远程主机，都需要先在 Codex App 的连接能力里完成配置。
两边是同一个 Git 项目
目标主机必须保存同一仓库对应的匹配项目。如果你当前工作在仓库子目录，两边也要对应一致。
远程环境准备完成
运行时、依赖、环境变量、测试工具、数据库访问和仓库权限都要在目标主机提前可用。
重要状态已检查
在交接前检查 `git status`、未跟踪文件、敏感资源和高风险未保存修改，避免把问题带到另一边。
如何把线程交接到远程主机
1. 先连接远程主机
在 Codex App 中进入 `Settings -> Connections`，添加或启用目标远程主机，并确认项目路径已经配置。
2. 打开要交接的线程
进入当前正在开发的那个线程，确认它绑定的是 Git 项目，并且目标主机存在匹配项目。
3. 选择运行位置
在线程底部切换当前运行位置，选择目标远程主机。若要之后交回本地，则选择 `This computer`。
4. 再检查一次目标和分支
确认目标主机正确、目标项目正确、分支正确，并且远程环境具备继续运行的条件。
5. 执行 Hand off 并继续
完成交接后，线程会在目标主机继续运行。你之后依然是在同一个线程里继续发任务，而不是重新新建一条开发线。
也可以让 Codex 协调交接
你还可以在另一个线程里让 Codex 协调交接某个指定线程，但要注意三点：发出请求的那个线程不能把自己交接出去，目标项目必须已配置，而且当前不能直接交接到 Codex Cloud。
适合哪些场景
- 本地先写代码，再把长时间测试交给远程主机继续跑。
- 出门前把任务交给长期在线设备，回来后再交回本地继续。
- 需要在更接近部署环境的机器上验证依赖、权限、路径或容器问题。
- 本地机器性能不够，想把重依赖安装、长构建或大测试移到远程机器。
和其他方式有什么区别
| 维度 | Thread Handoff | Remote Control | Git push/pull | Codex Cloud |
|---|---|---|---|---|
| 核心作用 | 把线程切到另一台已连接主机继续运行 | 从另一台设备继续控制原主机 | 同步代码版本 | 使用云端执行环境 |
| 线程上下文 | 会跟着交接 | 仍在原主机 | 不会处理线程上下文 | 属于云端执行模型 |
| Git 状态 | 会一起处理 | 仍依赖原主机状态 | 主要处理代码提交与拉取 | 不等于本地与远程主机交接 |
| 是否替代 Git | 不能 | 不能 | 本身就是 Git 流程 | 不能 |
| 当前限制 | 不能直接交接到 Codex Cloud | 不切换实际执行主机 | 需要你自己处理线程与环境说明 | 不是 Thread Handoff 的目标位置 |
简单理解就是：Remote Control 是人换设备，但任务还在原机器；Thread Handoff 是任务本身换到另一台已配置主机。Git push/pull 解决的是代码版本同步，不是同一条 Codex 开发线的延续。Codex Cloud 则是另一种执行环境，不等于当前这项交接能力的直接目标。
使用时的风险与注意事项
环境差异
本地与远程主机之间很可能存在操作系统、路径、Shell、依赖版本、权限和环境变量差异。交接完成后，推荐先让 Codex 检查当前工作目录、Git 状态、依赖和测试环境，再继续改代码。
敏感信息
不要假设密钥和凭据会自动安全迁移。远程主机仍应使用最小权限、受控 SSH 密钥和独立环境变量管理。
未跟踪文件
如果任务依赖未跟踪文件、大型数据或只存在于本机的资源，交接前必须先确认哪些会跟着 Git 状态处理，哪些需要额外准备。
高风险操作
交接后第一次执行删除文件、改数据库、部署生产、推送远程仓库、发邮件或合并分支等不可逆操作时，仍应保留人工确认。
AI2Work 的判断
Thread Handoff 的真正价值，不是省掉一次 `git push`，而是让同一条 Codex 开发线的上下文和代码工作状态能够跟着执行环境一起移动。它适合经常在笔记本、长期在线设备和远程开发机之间切换的人。但它不是虚拟机快照，也不是整台机器的完整迁移，更不能替代正常的 Git 提交、远程备份和代码审查流程。
推荐工作流
- 先在本地明确需求并完成初步修改。
- 交接前检查 `git status`、未跟踪文件和敏感资源。
- 确认目标远程主机已连接，项目与分支匹配。
- 执行 Hand off，先检查环境差异，再运行长任务或重测试。
- 审核结果后，按需要交回本地继续。
- 最终仍然走正常的 Git 提交、推送和 PR 流程。
FAQ
- Q：Thread Handoff 会迁移未提交修改吗？
A：官方表述是交接线程与 Git 状态，因此不只面向已经提交的代码。但交接前仍应检查 `git status`，并确认未跟踪文件和大型本地资源是否已妥善处理。 - Q：正在运行的进程会一起迁移吗？
A：不应这样理解。交接会处理中断当前线程响应并切换运行位置，但外部进程、数据库任务、容器状态和桌面程序并不会被默认迁移。 - Q：目标服务器需要提前安装依赖吗？
A：需要。Thread Handoff 不是完整复制本地运行环境，目标主机仍需具备相应运行时、依赖、权限和环境变量。 - Q：可以交接到任意服务器吗？
A：不能直接交接到任意机器。目标主机需要先连接到 Codex，并保存同一 Git 仓库的匹配项目。 - Q：可以交接到 Codex Cloud 吗？
A：按当前官方说明，不能直接交接到 Codex Cloud。 - Q：交接后还能再回到本地吗？
A：可以。在远程线程中重新选择运行位置并切回 `This computer`，即可把线程交回本地。 - Q：它能替代 Git 吗？
A：不能。它用于延续线程与开发状态，正式版本管理、协作、备份和代码审查仍需要 Git 流程。 - Q：它和远程控制一样吗？
A：不一样。远程控制通常还是让任务留在原主机运行，而 Thread Handoff 会把线程执行位置切换到另一台已连接主机。