Codex Bridge — MCP-сервер для Claude Code: что делает и установка
Десктопное приложение и сервис для связи MCP-клиентов с локальными агентами, папками проектов и терминалом. Нужен для выполнения задач с ручным подтверждением действий.
Открыть на GitHubЧто делает Codex Bridge
Codex Bridge объединяет графический интерфейс и фоновую службу на базе Swift для macOS, Windows и Linux. Сервер открывает клиентам вроде Claude Code доступ к рабочему каталогу через Direct Workspace, позволяя проверять файлы и вносить изменения через патчи. Авторизация каталогов и история действий сохраняются на компьютере.
Когда возможностей встроенных файловых инструментов мало, приложение перенаправляет задачи внешним агентам вроде Codex или OpenCode. Опасные системные операции запрашивают подтверждение во всплывающих карточках. Сессии и файлы конфигурации остаются на диске, а токены сохраняются в системном хранилище учётных записей.
На Windows программе обязательно требуется среда WebView2 Runtime. В macOS сборка использует ad-hoc подпись, поэтому операционная система блокирует запуск до ручного подтверждения в настройках конфиденциальности.
Какие задачи решает
- открыть MCP-клиентам контролируемый доступ к локальным файлам
- запускать терминальные команды и патчи с ручным одобрением
- делегировать сложные задачи агентам Codex или OpenCode
- хранить ключи и проектные доступы локально без сторонних облаков
Примеры запросов агенту
- Проверь статус git в проекте через мост Codex Bridge
- Примени подготовленный патч к файлам локального репозитория
- Запусти тестовый набор проекта и покажи вывод консоли
Как установить Codex Bridge
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Codex Bridge
Как установить Codex Bridge?
Загрузите файл версии 2.1.2 со страницы релизов на GitHub: DMG для macOS, установщик Setup.exe для Windows или пакет .deb для Ubuntu. Запустите приложение, чтобы активировать локальный фоновый сервис.
Что делает режим Direct Workspace?
Direct Workspace позволяет читать файлы, применять патчи и выполнять консольные команды в доверенных папках без запуска сторонних агентов. Все операции подчиняются правилам каталога, заданным в приложении.
Что нужно подготовить перед запуском на Windows и macOS?
В Windows необходим предварительно установленный компонент WebView2 Runtime. На macOS 14 и новее запуск приложения с ad-hoc подписью нужно отдельно разрешить в системных настройках безопасности.
