Claude Codex Adapter CLI
Адаптер подключает десктопное приложение Codex к Claude Code через родной протокол app-server в режиме Remote.
- 109 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Адаптер выполняет команды и правки файлов на удаленной машине от имени Claude Code, подтверждения идут через приложение.
- Ключ Anthropic хранится в переменных окружения удаленной машины.
Установка
- Работает в
Ручная установка
npm installВ клоне репозитория; затем `npm run build` и `npm run doctor`. Нужен Node.js 24 или новее.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Адаптер выполняет команды и правки файлов на удаленной машине от имени Claude Code, подтверждения идут через приложение.
- Ключ Anthropic хранится в переменных окружения удаленной машины.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Приложение Codex в режиме Remote по SSH привычно проверяет версию и вызывает `codex app-server`. Адаптер перехватывает этот вызов и отдает его Claude Code вместо настоящей среды Codex, а все остальные команды идут в обычный Codex CLI. Ходы агента выполняет Claude Code, а в Codex App они выглядят как родные. Текст и рассуждения Claude попадают в разговор, `Bash` и другие инструменты превращаются в запросы на подтверждение команд, а `Edit`, `Write` и `MultiEdit` показывают изменения файлов с живым diff. Вызовы MCP получают карточку подтверждения приложения. Ответ может содержать встроенную визуализацию: плитки с метриками и графики, которые приложение рисует внутри сообщения.
Для кого. Пользователям приложения Codex, которые хотят вести задачи моделями Claude через Claude Code на удаленной машине.
Подходит, если
- Нравится интерфейс Codex App, но агентную работу нужно отдать Claude Code.
- Удаленная машина по SSH уже готова, а на ней есть Claude Code с входом.
- Правки файлов и команды нужно подтверждать карточками приложения с diff.
- Результат анализа данных хочется видеть графиками прямо в ответе.
Не подходит, если
- Приложение Codex и так работает на родном рантайме Codex.
- Нет удаленной машины: адаптер рассчитан на режим Remote по SSH.
- Среда не может запускать Node.js 24.
Пример запроса к агенту
Запусти через Claude Code разбор падающего теста на удаленной машине и покажи изменения файлов карточками подтверждения.Ограничения
Нужен Node.js 24 и новее из-за стабильного `node:sqlite`, путь к нужному бинарнику задает `CLAUDE_CODEX_NODE`. На удаленной машине требуется клон репозитория, сборка и шим `codex` раньше настоящего в PATH. Для работы Claude нужен ключ Anthropic в переменной `ANTHROPIC_API_KEY` или вход через `claude /login`, расход идет по вашему тарифу. Ключи передавайте только через оболочку или менеджер секретов и не коммитьте. Размышления Claude скрывает `CLAUDE_CODEX_REASONING_VISIBLE=0`. Проект подмешивается в запуск Codex, поэтому обновление приложения может потребовать новой проверки совместимости.
Как отключить. Уберите шим `codex` из `~/bin` и переменные `CLAUDE_CODEX_ADAPTER` и `ANTHROPIC_API_KEY`, затем удалите клон репозитория. Remote-подключение в Codex App можно отключить в его настройках.
Частые вопросы
Как установить Claude Codex Adapter?
Выполните `npm install`, `npm run build` и `npm run doctor` в клоне репозитория. Затем скопируйте `scripts/codex-shim` в `~/bin/codex`, дайте право на запуск и добавьте `~/bin` в PATH.
Что делает команда npm run doctor?
Проверяет окружение: версию Node.js, наличие нужных файлов и настройки. Выполняйте ее перед добавлением Remote-подключения в приложение.
Как адаптер вызывает Claude?
Через Claude Code на удаленной машине. Нужен `ANTHROPIC_API_KEY` или вход командой `claude /login`.
Как выглядят действия Claude в Codex App?
Команды становятся запросами на подтверждение, правки файлов показываются с живым diff, а вызовы MCP получают карточку приложения.
Где полная инструкция?
На сайте документации проекта, раздел Getting started. Там описаны подключение к Codex App и настройка удаленной машины.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCodex MCP Server — Codex внутри Claude Code
Codex MCP Server
MCP-сервер передает задачи Codex CLI прямо из Claude Code: вопросы по коду, ревью изменений, веб-поиск и сессии с продолжением диалога
Плагин синхронизирует Claude Code, Codex CLI и Antigravity в одном проекте и дает им передавать друг другу задачи.
Агент OpenAI для программирования, который работает локально в терминале, с версиями для IDE и десктопа
Скилл Claude Code передает Codex CLI трудоемкую реализацию, а планирование, ревью и приемку оставляет Claude.
Три команды для Claude Code: второй взгляд Codex на план, критика плана и мозговой штурм через Codex CLI в режиме чтения
Скилл /codex-workflows: Claude Code пишет сценарий, а десятки агентов Codex выполняют его, и прогон виден на карте
Коротко о README
Адаптер на TypeScript встраивается между Codex App и Claude Code, сохраняя интерфейс приложения и подтверждения действий.