Watch使用限额（Usage Limit）约束一段时间内可用额度，与单会话的上下文长度限制（Context Window）是两类不同问题。若仅是上下文过长，应优先在 Claude Code 内部执行 /compact 压缩；若确定是账户达到额度限制且需要更换工具，再使用 Watch 接力已保存的历史记录。Watch 不绕过限额，也不迁移磁盘代码。
在长任务调试过程中，Claude Code 界面可能会显示达到使用限额及预计重置时间。此时已探索的思路、报错结论和测试命令都保存在本机会话文件中。Watch 提供了将该会话记录转入 OpenAI Codex 的限定通道，确保新工具能够读取此前的上下文，而不必由人工重新向新 Agent 叙述整个背景。
步骤 1：核对来源会话 ID 与工作目录
在原终端或会话目录确认 Claude Code 的 Session ID。Claude Code 会话记录保存在 ~/.claude/projects/<encoded-cwd>/<session-id>.jsonl 中。检查当前项目目录（cwd）与会话记录所属目录完全一致，避免 Worktree 路径与主仓库路径发生混淆。
步骤 2：在 OpenAI Codex 中预先建立项目
依据官方通用导入协议要求，目标项目必须已经存在于 Codex Desktop 中。如果尚未添加，请先在 Codex Desktop 中打开该目录并完成首次信任确认，确保 Codex 的项目数据库能识别该工作空间。
步骤 3：准备导入计划并核查字段（Prepare）
在 Watch 桌面端选择来源会话并点击 OpenAI Codex，或在终端执行 prepare 命令生成导入计划。此阶段仅建立计划并核验目标锁状态，不会向目标文件写入任何记录。
步骤 4：确认导入并核查降级项（Confirm）
在预览窗口核对检测到的来源路径、消息条数与工具调用记录后，显式点击确认导入。Watch 将调用本地 Codex app-server 的会话导入接口并写入目标记录。工具调用与执行结果在 Codex 侧可能降级为文本展示。
步骤 5：独立打开目标客户端（Open）
导入完成后，通过桌面端或目标恢复命令独立唤起 Codex Desktop。导入过程与打开客户端是严格分离的两个步骤；如果打开失败，仅需重试打开动作，切勿重复发起导入。
# 1. 准备导入计划（只读探测与生成计划）
npm run watch -- import-codex prepare <claude-id> --cwd /abs/project/path --desktop-project --experimental --json
# 2. 明确确认并写入（使用计划返回的 planId）
npm run watch -- import-codex confirm <plan-id> --json
# 3. 查看执行状态（发生异常时只读查询）
npm run watch -- import-codex status <plan-id> --json1. 不支持无损还原：工具调用记录在 Codex 端将作为文本参考呈现，模型的自动延续不在当前限定验收范围内。 2. 遇到 uncertain 状态必须立即停止：若提交过程中断或网络超时，状态会保持锁定，请通过 status 命令只读排查，严禁强制删除锁或重复再次提交。 3. 本地转换不等于全流程离线：Watch 自身无中继服务器，但在触发 Codex 原生接口时，Codex 会遵循其本地配置与模型云端鉴权。