Что делает Claudraband

Claudraband — это обёртка для официального TUI Claude Code, которая запускает его в управляемой терминальной среде. Это позволяет разработчикам поддерживать постоянные сессии Claude Code, возобновлять их позже, отвечать на ожидающие запросы, предоставлять доступ к сессиям через демон или управлять ими через Anthropic Client Protocol (ACP).

Ключевые возможности и команды

Инструмент предоставляет несколько конкретных возможностей:

• Возобновляемые неинтерактивные рабочие процессы: По сути claude -p с поддержкой сессий. Пример: cband continue <session-id> 'каков был результат исследования?'
• HTTP-демон для удалённого или автономного управления сессиями: Запустите с помощью cband serve --host 127.0.0.1 --port 7842, затем подключитесь через cband --connect localhost:7842 "начать план миграции"
• Сервер ACP для интеграции с редакторами и альтернативными интерфейсами: Запустите cband acp --model opus или cband acp --model haiku для интеграции с такими инструментами, как Toad или Zed
• Библиотека TypeScript для встраивания этих рабочих процессов в пользовательские инструменты
• Управление сессиями: cband sessions выводит список активных отслеживаемых сессий, cband sessions close --all закрывает все управляемые сессии

Установка и требования

Требования включают Node.js или Bun, уже установленный и аутентифицированный Claude Code, а также tmux для полноценной локальной работы и рабочих процессов с поддержкой демона. Варианты установки:

# разовое использование
npx @halfwhey/claudraband "проверить подготовленные изменения"

глобальная установка
npm install -g @halfwhey/claudraband

Пакет устанавливает как claudraband, так и cband (рекомендуемое сокращение). Он включает Claude Code @anthropic-ai/[email protected], но позволяет переопределить его с помощью переменной окружения CLAUDRABAND_CLAUDE_PATH.

Примеры рабочих процессов

В исходном коде показано несколько практических вариантов использования:

• Локальные постоянные сессии: cband "проверьте последний коммит и скажите, что выглядит рискованно"
• Самоанализ: Claude может анализировать более раннюю сессию Claude и объяснять принятые решения
• Альтернативные интерфейсы: Toad или Zed могут использовать claudraband acp как альтернативный интерфейс для Claude Code
• Интеграция библиотеки: Примеры на TypeScript включают проверку кода, управление несколькими сессиями и ведение журнала сессий

Технические детали

Сессии отслеживаются в ~/.claudraband/. Демон по умолчанию использует tmux в качестве среды выполнения терминала. Существует экспериментальная опция --backend xterm для автономного резервного варианта, но она медленнее, чем tmux. Проект помечен как экспериментальный и развивающийся по мере изменения Claude Code и клиентов ACP.

Важное предостережение: это не замена SDK Claude и ориентировано на личное, ситуативное использование. Он не обрабатывает OAuth и не обходит TUI Claude Code — каждое взаимодействие проходит через реальную сессию Claude Code.