tmux-claude-hatch — Claude Code во всплывающем окне tmux
tmux-claude-hatch
Плагин tmux запускает сессию Claude Code во всплывающем окне на каждый проект и показывает статус всех агентов в списке fzf
- 403 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Плагин Claude Code регистрирует хуки на события агента и запускает при них скрипты оболочки
- Запущенные сессии продолжают работать в фоне после закрытия окна, и агент может выполнять команды, пока вы в редакторе
- Плагин читает файлы сессий Claude Code, чтобы показать статусы и снимки экрана агентов
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/tmux-claude-hatchОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Плагин Claude Code регистрирует хуки на события агента и запускает при них скрипты оболочки
- Запущенные сессии продолжают работать в фоне после закрытия окна, и агент может выполнять команды, пока вы в редакторе
- Плагин читает файлы сессий Claude Code, чтобы показать статусы и снимки экрана агентов
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
tmux-claude-hatch открывает Claude Code во всплывающем окне tmux для текущей папки проекта. Вы передаете агенту задачу, закрываете окно и возвращаетесь в редактор. Каждая сессия живет в собственной вложенной сессии tmux, поэтому закрытие окна ее не прерывает. Список агентов вызывается клавишами `prefix` и `u`. В нем перечислены все работающие Claude Code, в том числе несколько в одном проекте и запущенные вручную в обычной панели. Статус каждого (работает, ждет вас или простаивает) плагин читает из файлов сессий, которые ведет сам Claude Code, и показывает живой снимок экрана. Выбранный агент открывается в окне, из которого его запускали. Когда сессия закончила ход или ждет разрешения, терминал звонит, а tmux подсвечивает исходное окно, так что заглядывать в список не обязательно. Для звонка есть необязательный плагин Claude Code с хуками. Проект написан на нескольких скриптах оболочки и рассчитан на тех, кто сам читает и пишет код в (Neo)vim или Emacs.
Для кого. Для разработчиков, которые живут в tmux и редакторе вроде Neovim или Emacs, сами читают и правят код и хотят вести несколько сессий Claude Code без отдельной оболочки для агентов.
Подходит, если
- Вы работаете в Neovim или Emacs внутри tmux и хотите отдавать агенту задачи, не покидая основной сессии
- Несколько Claude Code идут параллельно в разных проектах, и надо быстро видеть, какому нужен ответ
- Нужен звонок, когда агент закончил ход или просит разрешение, и подсветка окна, из которого он запущен
- Нужно скопировать адрес панели агента в формате `session:window.pane`, чтобы потом отправить в нее команды через `tmux send-keys`
- Вам нужен маленький инструмент на скриптах оболочки, который легко прочитать и переделать
Не подходит, если
- Вам важнее чат с агентом, чем сам код: авторы относят таких пользователей к тем, кому инструмент не подходит
- Нужен один менеджер сессий для нескольких ИИ-провайдеров: плагин рассчитан только на Claude Code
- Вы запускаете рой агентов и сами не читаете и не пишете код
- На машине нет tmux версии 3.2 или новее, fzf или jq, либо система отличается от macOS и Linux
Пример запроса к агенту
Разбери падающие тесты в этом проекте и исправь их, а я пока вернусь в редактор.Ограничения
Нужны tmux 3.2 или новее ради всплывающих окон, fzf, jq, bash, Claude Code 2.1.139 или новее и macOS либо Linux. Версия Claude Code нужна ради команды `claude agents`, запасного источника статусов, когда файлы сессий не читаются.
Плагин работает только с Claude Code, а API Anthropic из России недоступен. Звонок плагин лишь пересылает, создает его сам Claude Code, поэтому нужны хуки из плагина Claude Code или настройки уведомлений. Другие каналы уведомлений Claude Code, кроме `terminal_bell` и `iterm2_with_bell`, tmux не засчитывает как звонок.
Как отключить. Уберите строку `set -g @plugin 'craftzdog/tmux-claude-hatch'` из конфигурации tmux и перезагрузите ее. Если ставили плагин Claude Code, удалите его через меню /plugin. Запущенные сессии claude-* завершите командой `tmux kill-session` или клавишей ctrl-x в списке.
Частые вопросы
Как установить tmux-claude-hatch?
Через менеджер плагинов tpm: добавьте в конфигурацию tmux строку `set -g @plugin 'craftzdog/tmux-claude-hatch'` и нажмите `prefix` и `I`. Без tpm склонируйте репозиторий и подключите файл `claude_hatch.tmux` командой `run-shell`. По умолчанию запуск привязан к `prefix` и `y`, список к `prefix` и `u`.
Что должно стоять на машине кроме самого плагина?
tmux версии 3.2 или новее, fzf для списка, jq для разбора файлов сессий и Claude Code 2.1.139 или новее. Работает на macOS и Linux в bash.
Как настроить звонок, когда Claude Code закончил работу?
Звонок создает сам Claude Code, плагин его только пересылает. Проще всего поставить необязательный плагин tmux-claude-hatch из маркетплейса Claude Code: его хуки звонят на конец хода, запрос разрешения и вопрос агента. Вручную задайте в `~/.claude/settings.json` значение `terminal_bell` для `preferredNotifChannel`.
Как посмотреть статусы всех запущенных агентов?
Нажмите `prefix` и `u`. Агенты, которым нужно ваше внимание (ждут разрешения или простаивают), стоят наверху, а порядок по последней активности включает `@claude_sort 'recent'`. Enter переводит к выбранному агенту, ctrl-x завершает его, ctrl-y копирует его адрес.
Можно ли запускать сессии без запросов разрешений?
Можно: задайте `set -g @claude_args '--dangerously-skip-permissions'`, и каждая сессия, запущенная плагином, начнется с этого флага. Учтите, что агент тогда выполняет команды без подтверждения.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныМаркет из 17 модов для Claude Code: расход токенов, временная шкала правок с откатом, учет допущений, доска проверки и живая лента команд
Плагин для Claude Code: строка статуса с контекстом, лимитами за 5 часов и 7 дней, стоимостью и расходом Codex, Gemini и z.ai
Плагин Claude Code, который ловит ваши поправки в диалоге и после проверки записывает их в CLAUDE.md и AGENTS.md
Канбан-доска в терминале на Python, которую Claude Code и другие агенты читают и меняют через CLI или MCP
Статусная строка для Claude Code: расход токенов и денег, остаток контекста, лимиты и ветка git в четырех стилях и шести темах
Claude-to-IM
claude-to-im
Мост между Claude Code или Codex и мессенджерами: общайтесь с агентом из Telegram, Discord, Feishu, QQ или WeChat
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| tmux-claude-hatch — Claude Code во всплывающем окне tmux (эта запись) | нет | 403 | |
| Claude Squad | нет | 8 694 | отдельное терминальное приложение для параллельных сессий разных агентов в изолированных рабочих копиях |
| tmux-ide | да | 558 | показывает, какие агенты в сессиях tmux работают, ждут решения или простаивают, и разворачивает рабочее окружение |
Коротко о README
Плагин состоит из нескольких скриптов оболочки: запуск сессии, список агентов, пересылка звонка и общие функции. Плагин Claude Code лежит в отдельной папке с хуками и от плагина tmux не зависит.