AI 요약
Claudraband는 Anthropic의 공식 Claude Code TUI(텍스트 사용자 인터페이스)를 제어된 터미널 환경에서 실행할 수 있도록 설계된 실험적 도구입니다. 기존 Claude Code가 단발성 세션에 그치는 한계를 극복하기 위해, 세션을 백그라운드에서 유지하거나 나중에 다시 연결하여 중단된 지점부터 작업을 이어갈 수 있는 기능을 제공합니다. 이를 위해 HTTP 데몬(Daemon)을 통한 원격 제어와 에디터 연동을 위한 ACP(Anthropic Control Protocol) 서버 기능을 포함하고 있습니다. 사용자는 cband라는 단축 명령어를 통해 로컬 tmux 환경이나 데몬 환경에서 AI 워크플로우를 구축할 수 있습니다. 이 도구는 Claude SDK를 대체하는 것이 아니라 개인적인 ad-hoc(임시) 작업을 효율화하기 위한 도구로, 기존 Claude Code의 인증 체계를 그대로 활용합니다.
핵심 인사이트
- 버전 정보: 해당 패키지는 공식
@anthropic-ai/claude-code@2.1.96버전을 내장하고 있으며, 환경 변수(CLAUDRABAND_CLAUDE_PATH)를 통해 바이너리 경로를 변경할 수 있습니다. - 세션 지속성:
~/.claudraband/디렉토리에 라이브 세션을 추적하며,cband continue <session-id>명령어를 통해 이전 상태의 연구 결과나 프롬프트를 재개할 수 있습니다. - 원격 제어:
cband serve --port 7842와 같이 HTTP 데몬을 실행하여 원격지 혹은 헤드리스(Headless) 환경에서 세션을 제어할 수 있는 API를 노출합니다. - 에디터 통합: ACP(Anthropic Control Protocol) 서버 기능을 내장하여 외부 에디터나 다른 프론트엔드 도구들이 Claude를 구동할 수 있게 지원합니다.
주요 디테일
- 런타임 요구사항: 실행을 위해 Node.js 또는 Bun이 필요하며, 로컬 및 데몬 기반 워크플로우를 위해 tmux 설치가 필수적으로 요구됩니다.
- 설치 및 실행:
npm install -g @halfwhey/claudraband를 통해 전역 설치가 가능하며,npx또는bunx를 통한 일회성 실행도 지원합니다. - 백엔드 옵션: 기본적으로 tmux를 터미널 런타임으로 사용하지만, 헤드리스 환경을 위한 실험적인
xterm.js백엔드(--backend xterm) 옵션도 제공합니다. - 인증 방식: 별도의 OAuth를 직접 처리하지 않으며, 사용자가 이미 인증된 Claude Code 세션을 보유하고 있어야 정상 작동합니다.
- 라이브러리 활용: TypeScript 라이브러리를 제공하여 사용자가 자신만의 맞춤형 도구에 이러한 세션 워크플로우를 직접 구축할 수 있습니다.
향후 전망
- 지속적 진화: Claude Code 및 ACP 클라이언트의 사양 변경에 맞추어 프로젝트가 실험적으로 계속 업데이트될 예정입니다.
- 에디터 생태계 확장: ACP 서버 기능을 통해 향후 다양한 IDE 및 코드 에디터 내에서 Claude Code의 강력한 기능을 더 유연하게 사용할 수 있는 기반이 마련될 것으로 보입니다.
출처:hackernews