Zcode Bridge

把开发任务从 Codex 交给本机 ZCode Agent，在 Codex 中跟进进度并审查实际改动。

使用前

需要 Node.js 22.18+、Git、已安装并登录的 ZCode，以及支持插件 marketplace 的 Codex。

添加本项目 GitHub marketplace 并安装 Zcode Bridge：在桌面应用中先用 CLI 注册 marketplace，再到 Plugins Directory 选择并安装；CLI 用户可直接按下方命令安装。之后开启新对话并检查、信任插件的 SessionStart hook。Windows 上 hook 会检查本机环境并报告配置问题。Marketplace 安装无需克隆源码或运行 npm install；Node.js 和 ZCode 需另行安装。

CLI 安装示例：

codex plugin marketplace add https://github.com/Sandyzzx/codex-zcode-bridge.git --ref master
codex plugin add codex-zcode-bridge@codex-zcode-bridge

派发任务

向 Codex 描述开发任务和验收条件。Codex 根据任务决定是否准备 worktree，并把任务交给 ZCode。未提供 worktree 时在项目目录执行；提供时在该 worktree 执行。完成后由 Codex 检查 diff 和验收结果。completed 不等于 Codex 已接受改动。

遇到安装或启动问题时，可调用 MCP 工具 zcode_doctor 查看只读诊断；它不会启动 ZCode session。

可按任务选择 provider/model，也可配置用户默认模型。执行模式默认是 yolo，它会放行普通工具操作并使用当前操作系统账户权限。需要审批时，将 ZCODE_BRIDGE_MODE 设为 build。worktree 不是沙箱。

安全边界

ZCode 以当前操作系统用户权限运行。Git worktree 不是 OS 沙箱；allowed_paths 和 forbidden_paths 是任务指令，不能强制限制文件或命令访问。任务 prompt、日志、可见模型输出和结果会保存在本机 .codex/codex-zcode-bridge/ 目录。派发前请检查任务可见的工作区内容。

Marketplace 用户配置自定义 ZCode 路径或默认模型的说明见中文安装指南。