Claudraband의 기능

Claudraband는 공식 Claude Code TUI를 제어된 터미널 환경에서 실행하는 래퍼입니다. 이를 통해 개발자들은 지속적인 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 "스테이징된 diff 검토"

전역 설치
npm install -g @halfwhey/claudraband

패키지는 claudraband와 cband(권장 약칭) 둘 다 설치합니다. Claude Code @anthropic-ai/[email protected]을 번들로 제공하지만, CLAUDRABAND_CLAUDE_PATH 환경 변수로 재정의할 수 있습니다.

워크플로우 예시

소스에는 몇 가지 실용적인 사용 사례가 나와 있습니다:

• 로컬 지속 세션: cband "마지막 커밋을 감사하고 위험해 보이는 부분을 알려줘"
• 자체 질의: Claude는 이전 Claude 세션을 질의하고 자신이 내린 결정을 정당화할 수 있습니다
• 대체 프론트엔드: Toad나 Zed는 Claude Code의 대체 프론트엔드로 claudraband acp를 사용할 수 있습니다
• 라이브러리 통합: TypeScript 예시에는 코드 리뷰, 다중 세션 관리, 세션 저널링이 포함됩니다

기술적 세부사항

세션은 ~/.claudraband/에서 추적됩니다. 데몬은 기본적으로 터미널 런타임으로 tmux를 사용합니다. 헤드리스 폴백을 위한 실험적인 --backend xterm 옵션이 있지만 tmux보다 느립니다. 이 프로젝트는 Claude Code와 ACP 클라이언트가 변화함에 따라 발전하는 실험적 단계로 표시되어 있습니다.

중요한 주의사항: 이것은 Claude SDK의 대체품이 아니며 개인적이고 임시적인 사용을 목표로 합니다. OAuth를 처리하지 않거나 Claude Code TUI를 우회하지 않습니다 - 모든 상호작용은 실제 Claude Code 세션을 통해 실행됩니다.