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

codex-discord-bridge — плагин для Claude Code: обзор и установка

Плагин codex-discord-bridge подключает Codex CLI к боту в Discord через мост на Rust. Позволяет ставить задачи агенту со смартфона и одобрять действия кнопками прямо в чате.

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

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

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

Плагин связывает Discord-бота с локальным сервером codex app-server по протоколу JSON-RPC через WebSocket. Каждое обращение к боту создаёт или продолжает ветку диалога. Ответ агента транслируется в реальном времени в одно обновляемое сообщение Discord на каждый ход диалога. Запросы подтверждений на запуск команд и применение патчей приходят интерактивными кнопками с настраиваемым временем жизни TTL.

Связка работает в режиме одного оператора: команды принимает только пользователь с идентификатором из DISCORD_CONTROLLER_USER_ID. При разрыве соединения супервизор восстанавливает связь с экспоненциальной задержкой до 4 секунд, сохраняя связку тредов в data/state.json.

Для запуска моста необходимы стабильная версия Rust, установленный и авторизованный Codex CLI через команду codex login status, а также бот Discord с включённым разрешением Message Content intent.

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

  • Управлять агентом Codex удалённо со смартфона через Discord
  • Одобрять команды и патчи агента кликом по кнопкам в чате
  • Сохранять отдельные ветки Discord для каждого диалога Codex
  • Следить за выводом работы агента в потоковом режиме

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

  • Настрой окружение через скилл codex-discord-bridge-setup
  • Запусти bridge и покажи статус подключения к Discord
  • Проверь тесты проекта в отдельном треде Discord

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

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

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

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

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

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

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

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

Он запускает мост на Rust, который пересылает сообщения между ботом в Discord и codex app-server по WebSocket, превращая чат в пульт управления агентом.

Кто может отправлять команды боту?

Мост обрабатывает сообщения исключительно от одного владельца, чей Discord ID прописан в переменной DISCORD_CONTROLLER_USER_ID в файле конфигурации .env.

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

codex-discord-bridge · MIT
# codex-discord-bridge

Control Codex CLI from Discord. A Rust bridge (serenity) that connects a
Discord bot to the Codex app-server over WebSocket, so you can run coding
tasks from your phone.

```
Discord thread  <->  bridge (serenity)  <->  JSON-RPC over WebSocket  <->  codex app-server
```

## How it works

- Message the bot: it starts a Codex thread and streams the agent's output
  back into one live Discord message per turn.
- One Discord thread per Codex conversation. Follow-ups inside the thread
  continue the same conversation instead of starting a new one.
- Approval requests (command execution, patches) arrive as buttons with a
  configurable TTL, so Codex can ask permission mid-task while you are away
  from the desk.
- Autothread mode: each conversation gets its own Discord thread under a
  category you choose, titled from the first message.
- A 20s JSON-RPC keepalive and a bounded supervisor (readiness timeout, backoff
  capped at 4s) reconnect the app-server without dropping your Discord session
  or the thread mappings.

Access is single-controller: only the Discord user id set in
`DISCORD_CONTROLLER_USER_ID` can talk to the bot.

## Requirements

- Rust stable
- A Discord application with a bot token (enable the Message Content intent)
- Codex CLI installed and authenticated (`codex login status`)

## Setup

1. Clone the repo, copy `.env.example` to `.env`, and fill it in:

   ```
   DISCORD_BOT_TOKEN=          # from the Discord developer portal
   DISCORD_APPLICATION_ID=     # your application id
   DISCORD_GUILD_ID=           # your server id
   DISCORD_CONTROLLER_USER_ID= # your Discord user id
   CODEX_COMMAND=codex
   CODEX_APP_SERVER_LISTEN_URL=ws://127.0.0.1:8837
   RUST_LOG=info
   ```

2. Copy `bridge.json.example` to `bridge.json`. The defaults are fine to
   start. Turn on `autoThread.enabled` and set `autoThread.categoryId` if you
   want each conversation in its own thread.

3. Build and run:

   ```
   cargo build --release
   ./target/release/codex-discord-bridge
   ```

4. Invite the bot to your server and send it a message.

## State and logs

- Thread mappings live in `data/state.json`. Stop the bridge before editing
  that file by hand.
- The bridge logs to stdout. `RUST_LOG=debug` in `.env` for verbose output.

## Install as a Codex plugin

This repo ships a plugin manifest (`.codex-plugin/plugin.json`), a setup
skill (`skills/codex-discord-bridge-setup`), and its own marketplace file, so
Codex can install it directly:

```
codex plugin marketplace add yaffalhakim1/codex-discord-bridge
codex plugin add codex-discord-bridge@codex-discord-bridge
```

## Development

- `cargo test` runs the full suite, including reconnect, routing, and stream
  regression tests. State-touching tests use temp dirs via
  `BridgeState::with_path`, and a guard test fails if any test writes the
  production state file.
- `cargo clippy --all-targets -- -D warnings` is kept clean.

## License

MIT

© Yafi Alhakim · MIT · hashgraph-online/awesome-codex-plugins

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

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
discord-notifications davila7 Хук discord-notifications для Claude Code. Отправляет уведомление в Discord когда Claude завершил работу или выполнил субагента. Подставляет текущее время через date. 217установок discord acedatacloud Интегрирует аккаунт Discord с ИИ-агентом: читает профиль и список серверов по OAuth либо отправляет сообщения через токен пользователя. CX Codex +1 189установок discord-bot claude-office-skills Скилл discord-bot для Claude Code помогает проектировать Discord-ботов для модерации, уведомлений и управления сообществом. Он описывает настройки бота, команды и сценарии с ИИ. CX Codex +1 5 500установок discord-channel Crokily Скилл discord-channel для Claude Code настраивает подключение бота Pots к Discord и отправляет сообщения, файлы и интерактивные кнопки через REST API. CX Codex +1 ★ 79звёзд репо discord-automation davepoon Скилл discord-automation автоматизирует отправку сообщений, управление ролями, вебхуками и реакциями в Discord через Rube MCP и Composio. Помогает ботам работать с каналами и пользователями прямо из агента. CX Codex +1 128установок cc-connect-ai-bridge reason-machines Скилл cc-connect-ai-bridge помогает связать локального ИИ-агента с мессенджером через cc-connect. Можно отправлять агенту задачи из чата без публичного IP для большинства платформ. CX Codex +1 943установок

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

Весь набор →
codex-reset Плагин codex-reset для Claude Code подключает MCP-инструменты с данными о сбросе лимитов Codex. Он показывает прогноз на 24 и 48 часов, подтверждённые сбросы и состояние сервиса. CX Codex ★ 1 596звёзд репо codex-obsidian Плагин codex-obsidian связывает агента с локальным хранилищем Obsidian через официальный десктопный CLI. Помогает искать заметки, сводить задачи и управлять вкладками. CX Codex ★ 1 596звёзд репо codex-mem Плагин codex-mem для Codex сохраняет наблюдения о работе с инструментами и передаёт сжатый контекст в будущие сессии. Сохраняет контекст проекта после перезапуска. CX Codex ★ 1 596звёзд репо codex-image-plugin Плагин codex-image-plugin для Claude Code генерирует и редактирует растровые изображения через OpenAI-compatible image API. Работает с моделями, референсами и масками. CX Codex ★ 1 596звёзд репо be-serious Плагин be-serious для Claude Code и Codex задаёт агенту формальный научный стиль и проверяет прозу на соответствие ему. Он убирает разговорную манеру из ответов, планов и описаний PR. CX Codex ★ 1 596звёзд репо clera Ищет по базе Clera из 210,000+ кандидатов, которые сами согласились слушать про вакансии, и запрашивает интро прямо из чата. CX Codex ★ 1 596звёзд репо claude-math Плагин claude-math заменяет сырой LaTeX в ответах терминальных агентов на читаемый Unicode-текст с формулами. CX Codex ★ 1 596звёзд репо centricmem-skill Плагин centricmem-skill для Claude Code и Codex раскладывает переданные агентом заметки по Markdown-карточкам и отдаёт их по запросу через MCP. Решения из одного клиента находятся в другом. CX Codex ★ 1 596звёзд репо

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

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