Claude — панель сессий Claude Code

Сверху — дерево активных сессий Claude Code и их субагентов (модель, контекст, worktree), снизу — лимиты подписки и баланс extra usage. Панель — страница на http://127.0.0.1:8766/: её показывает iTerm2 Toolbelt, её можно открыть в браузере, в том числе с iPad через SSH-туннель. Сервер панели — фоновая служба macOS, iTerm2 для неё не нужен.

Установка

Запускать за самим Mac, не по SSH (из SSH-сессии launchd и iTerm2 не настроить — установщик откажется):

tar xzf claude-panel.tar.gz
cd claude-panel
./install.sh

Затем в iTerm2: View → Toolbelt → Show Toolbelt, Toolbelt → Claude, и перезапустите открытые сессии claude. Повторный запуск install.sh обновляет установленное.

Нужно: macOS, python3, jq (brew install jq, в macOS 15+ уже есть); iTerm2 — для Toolbelt.

Что ставится

Что	Куда
служба (сервер панели)	~/.local/share/claude-agents/claude_agents.py
описание службы launchd	~/Library/LaunchAgents/com.andrey.claude-agents.plist
лог службы	~/Library/Logs/claude-agents/panel.log
скрипт Toolbelt	~/Library/Application Support/iTerm2/Scripts/AutoLaunch/claude_agents.py
хук Claude Code	~/.claude/hooks/agents_panel_hook.sh + записи в ~/.claude/settings.json
пример настроек	~/.config/claude-agents/config.example.json

Служба запускается при входе в систему и перезапускается при падении. Перед изменением settings.json и заменой файлов старые копии кладутся в ~/.claude-panel-backup/<дата>/. Ваши остальные хуки и настройки не трогаются.

С iPad (Termius)

1. В Termius: Port Forwarding → Local: хост — ваш Mac, local port 8766, bind address 127.0.0.1, destination 127.0.0.1, destination port 8766.
2. Запустите forward и откройте в Safari http://127.0.0.1:8766 — именно 127.0.0.1, не localhost (сервер слушает только IPv4).

Сервер доступен только с самого Mac, в сеть не открывается: с других устройств — только через туннель. Клики работают через tmux, так что переходы и lf появляются в том же tmux, что у вас в Termius.

Работа с панелью

• клик по сессии или агенту — последние сообщения (копятся, пока окно открыто);
• ⌘-клик по сессии — перейти в её панель tmux;
• клик по ⎇ папка — открыть в ней lf в соседней панели tmux;
• цвет точки: зелёный — работает, жёлтый — ждёт вас, серый — свободен;
• переходы и lf работают для сессий в tmux; сессии вне tmux только показываются;
• цвет токенов: жёлтый > 500k, красный > 700k;
• ⚙ в нижней строке — фон панели на этом устройстве (образцы или свой цвет, текст подстроится); выбор хранится в этом браузере, «сброс» возвращает тему по умолчанию.

Настройки

Скопируйте config.example.json в ~/.config/claude-agents/config.json и оставьте только нужные ключи. Меняется на лету, кроме port.

Если что-то не так

• http://127.0.0.1:8766/raw — что панель видит: логи хука, причины скрытия сессий, ошибки лимитов и баланса;
• ~/Library/Logs/claude-agents/panel.log — лог службы;
• launchctl print gui/$(id -u)/com.andrey.claude-agents — состояние службы; ошибки запуска (например, «не найден python») видны только здесь, а не в panel.log;
• после переустановки или обновления Python (в том числе brew upgrade/brew cleanup) запустите ./install.sh заново — служба хранит путь к python3, и без этого launchd не сможет её запустить;
• «⎇ папка» мигает разделителем и панель сразу закрывается — служба не нашла lf. Служба берёт PATH из оболочки, в которой запускали install.sh: запустите его заново из терминала, где command -v lf находит файловый менеджер.

Удаление

./uninstall.sh          # настройки и логи остаются
./uninstall.sh --purge  # удалить всё