К основному содержанию
плагин CX Codex

codex-zcode-bridge — плагин для Codex: делегирование задач

Плагин codex-zcode-bridge для Claude Code и Codex передаёт задачу из Codex локальному ZCode и возвращает ход работы для проверки изменений и сверки результата с критериями приёмки.

Apache-2.0 ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install codex-zcode-bridge@awesome-codex-plugins
Открыть на GitHub

Что делает codex-zcode-bridge

Codex передаёт разработку локальному ZCode, при необходимости подготавливает worktree и затем проверяет diff и критерии приёмки. Статус completed сам по себе не означает, что Codex принял изменения. Для диагностики установки можно вызвать MCP-инструмент zcode_doctor: он не запускает сессию ZCode.

Для работы нужны Node.js 22.18+, Git, установленный и авторизованный ZCode, а также Codex с поддержкой плагинов. По умолчанию режим yolo разрешает обычные операции с правами текущего пользователя; для режима с подтверждением задайте ZCODE_BRIDGE_MODE в build. Worktree не изолирует команды от системы, а ограничения путей служат инструкциями, не принудительным барьером. Задачи, логи и результаты сохраняются локально в .codex/codex-zcode-bridge/ — проверьте содержимое рабочей области перед передачей.

Какие задачи решает

  • передать задачу разработки локальному ZCode
  • следить за ходом выполнения задачи в Codex
  • сверить diff с критериями приёмки
  • диагностировать проблемы запуска через zcode_doctor

Примеры запросов агенту

  • Передай ZCode задачу реализовать обработку ошибок в src/api.ts; после завершения проверь diff.
  • Поручи ZCode исправить баг в текущем worktree и сверь результат с критериями приёмки.
  • Проверь проблемы установки или запуска через zcode_doctor, не запуская сессию ZCode.

Как установить codex-zcode-bridge

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install codex-zcode-bridge@awesome-codex-plugins

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о codex-zcode-bridge

Как установить codex-zcode-bridge в Claude Code?

Добавьте маркетплейс командой /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем установите плагин командой /plugin install codex-zcode-bridge@awesome-codex-plugins.

Что делает codex-zcode-bridge?

Он передаёт задачу из Codex локальному ZCode, помогает следить за выполнением и проверяет получившиеся изменения.

Что нужно для работы codex-zcode-bridge?

Нужны Node.js 22.18+, Git и установленный авторизованный ZCode. Для работы также требуется Codex с поддержкой плагинов.

Исходный текст

codex-zcode-bridge · Apache-2.0
# 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 安装示例:

```sh
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`;记录版本上已完成单次 43,014-byte Write 的真实审批往返实测。超过单事件行上限的大审批请求会以显式标记的预览事件交付,并附私有完整记录的 `full_request` 引用(路径、字节数、SHA256,按 `JSON.stringify(params)` 紧凑序列化计量);预览不是全文,批准前需要全文时读引用记录。审批 params 完整保存上限为 1 MiB,超过时会收到含 actual/limit 与拆分建议的明确拒绝。worktree 不是沙箱。

可选浏览器宿主(ADR-007):`ZCODE_BRIDGE_BROWSER_USE` 默认 `off`;设为 `headless` 后,任务内 ZCode 原生浏览器工具经 `interaction/browserList`/`interaction/browserExecute` 反向 RPC 使用 worker 托管的 headless Chromium/Edge(独立临时 profile,不下载浏览器、不连接用户窗口)。可选 `ZCODE_BRIDGE_BROWSER_EXECUTABLE` 指定系统浏览器绝对路径。插件包内 `worker/vendor/` 自带所需运行资源,不依赖 Codex 的 node_modules。真实模型链路验收与边界见 仓库中的 `../../docs/reports/2026-10-15-browser-and-transport-fixes.md`。

## 安全边界

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

Marketplace 用户配置自定义 ZCode 路径或默认模型的说明见[中文安装指南](https://github.com/Sandyzzx/codex-zcode-bridge/blob/master/README.zh-CN.md#安装)。

© Sandy · Apache-2.0 · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
zcode-delegate amElnagdy Скилл zcode-delegate для Claude Code, Codex, Cursor и других платформ делегирует изолированные задачи по коду в Z.AI ZCode CLI. Запускает фонового исполнителя, пока основной агент проверяет диффы. CX Codex +1 3 200установок codex-bridge IgorGanapolsky Плагин codex-bridge для Claude Code запускает ревью Codex, adversarial review и второй проход проверки. ThumbGate сохраняет pre-action gates в цепочке. ★ 33звёзд репо Codex Bridge Fanch-hui MCP-сервер Codex Bridge для Claude Code связывает клиента с локальными агентами, папками проектов и терминалом. Выполняет задачи с ручным подтверждением действий. CX Codex +1 ★ 314звёзд репо ERC-8004 Agent Identity Bridge hartjustin6 MCP-сервер ERC-8004 Agent Identity Bridge читает реестры идентичности и репутации ERC-8004: отдаёт агенту DID, оценку доверия и неподписанные аттестации для вашего подписанта. CX Codex +1 555установок cheatengine-mcp-bridge reason-machines Скилл cheatengine-mcp-bridge для Claude Code связывает ИИ-агента с Cheat Engine через MCP для чтения памяти, сканирования указателей и анализа кода. Автоматизирует реверс-инжиниринг и отладку. CX Codex +1 201установок agy-bridge sshahzaiib MCP-сервер agy-bridge для Claude Code: отдаёт тяжёлые задачи в Antigravity CLI и возвращает один ответ. Лог и история git остаются вне контекста. CX Codex +1 ★ 69звёзд репо

Из того же набора391

Весь набор →
agent-vision Плагин agent-vision для macOS подключает встроенную камеру Mac к диалогу с агентом через разовые снимки JPEG. CX Codex ★ 1 596звёзд репо amq-cli Плагин amq-cli связывает кодинг-агентов через локальную файловую очередь: они могут отправлять запросы, читать ответы и продолжать переписку в одной ветке. CX Codex ★ 1 596звёзд репо abuzzhive Подключает агента к публичным Q&A-доскам AbuzzHive, где агенты публикуют ошибки и предлагают друг другу решения. Хук автоматически предлагает find_by_error после каждой упавшей shell-команды. CX Codex ★ 1 596звёзд репо call-me Плагин call-me связывает агента с телефоном на iOS или Android: агент звонит голосом или отправляет пуш, а ответ возвращает текстом прямо в сессию. CX Codex ★ 1 596звёзд репо zagrosi-forge Плагин zagrosi-forge для Claude Code делит большой бриф на спецификации, строит план по секциям и пишет код по TDD с записями о проверках. Разбивает задачи, которые не помещаются в один заход. CX Codex ★ 1 596звёзд репо yylo Плагин yylo для Claude Code и Codex изолирует задачи агентов в отдельных git worktree и распределяет работу между субагентами Codex и Pi, фиксируя изменения квитанциями. CX Codex ★ 1 596звёзд репо wtfm wtfm — плагин для Claude Code и Codex, который пишет справочные статьи по коду проекта и добавляет скриншоты его интерфейса. Запросите руководство обычным языком, например о приглашении коллеги. CX Codex ★ 1 596звёзд репо writers-loop Плагин writers-loop ведёт написание текста по шагам: рамка задачи, план, черновик, критика, правка по подтверждённым пунктам. Предпочтения запоминает только с вашего согласия. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой