Hacker News • 48일 전

클로드 코드 파워유저를 위한 Claudraband

IMP

6/10

핵심 요약

해커뉴스에 공개된 Claudraband는 공식 Claude Code TUI를 래핑(wrapping)하여 세션 유지, 백그라운드 재개, 원격 데몬 제어 기능을 제공하는 실험적 오픈소스 도구입니다. 개발자는 이를 통해 비인터랙티브 워크플로우를 구축하고 에이전트 통합 프로토콜(ACP)을 통해 에디터나 다른 프론트엔드와 연동할 수 있습니다. 파워유저를 위한 개인적이고 유연한 Claude Code 활용에 초점을 맞춘 프로젝트입니다.

번역된 본문

Claudraband: 파워유저를 위한 Claude Code

실험적 안내: 이 프로젝트는 Claude Code 및 ACP 클라이언트의 변화에 따라 계속해서 발전하고 있습니다.

CLI • 라이브러리 • 데몬 API • 예제

claudraband는 공식 Claude Code TUI를 제어된 터미널 환경으로 감싸서(wrapping) 세션을 계속 유지하거나, 나중에 이어서 작업하거나, 대기 중인 프롬프트에 응답하거나, 데몬을 통해 노출하거나, ACP를 통해 제어할 수 있게 해줍니다.

제공 기능:

재개 가능한 비인터랙티브 워크플로우. 기본적으로 세션을 지원하는 claude -p 명령어와 같습니다: cband continue '연구 결과는 어땠나요?'
원격 또는 헤드리스(headless) 세션 제어를 위한 HTTP 데몬
에디터 및 대체 프론트엔드 연동을 위한 ACP 서버
이러한 워크플로우를 자체 도구에 통합할 수 있는 TypeScript 라이브러리

주의사항 이것은 Claude SDK를 대체하는 것이 아닙니다. 개인적이고 임시적인(ad-hoc) 사용에 맞춰져 있습니다. OAuth를 다루지 않으며 Claude Code TUI를 우회하지도 않습니다. Claude Code를 통해 인증해야 하며, 모든 상호작용은 실제 Claude Code 세션을 거쳐 실행됩니다.

설치 요구 사항:

Node.js 또는 Bun
이미 인증이 완료된 Claude Code
최고의 로컬 및 데몬 기반 워크플로우를 위한 tmux

설치 또는 실행:

일회성 실행

npx @halfwhey/claudraband " staged diff를 리뷰해줘 " bunx @halfwhey/claudraband " staged diff를 리뷰해줘 "

한 번 설치

npm install -g @halfwhey/claudraband

이 패키지는 claudraband와 cband를 모두 설치합니다. cband가 권장되는 단축 명령어입니다. 패키지에는 Claude Code (@anthropic-ai/claude-code@2.1.96)가 포함되어 있습니다. 다른 바이너리를 사용해야 한다면 CLAUDRABAND_CLAUDE_PATH를 설정하세요.

빠른 시작 두 가지 주요 사용 방식은 로컬 tmux 세션과 데몬 기반 세션입니다.

로컬 영구 세션: cband " 마지막 커밋을 감사하고 위험해 보이는 부분을 알려줘 " cband sessions cband continue " 계속해줘 " cband continue --select 2

데몬 기반 세션: cband serve --host 127.0.0.1 --port 7842 cband --connect localhost:7842 " 마이그레이션 계획을 시작해줘 " cband attach cband continue --select 2

데몬은 로컬 방식과 마찬가지로 기본적으로 터미널 런타임으로 tmux를 사용합니다. --connect는 새로운 데몬 기반 세션을 생성할 때만 사용하세요. 그 이후에는 추적되는 continue, attach, sessions가 기록된 활성 소유자를 통해 자동으로 라우팅됩니다.

실험적 Xterm 백엔드 --backend xterm 옵션은 로컬 또는 데몬에서 사용할 수 있지만, 실험적이며 tmux보다 느립니다. 헤드리스 대체 수단이 필요할 때 사용하며, 장기적인 인터랙티브 작업의 기본 경로로 사용하지 마세요. 현재 주의사항과 백엔드 동작에 대해서는 docs/cli.md를 참조하세요.

ACP 다른 도구가 claudraband를 통해 Claude를 제어하려는 경우 ACP를 사용하세요. cband acp --model opus

예시: toad 실행

uvx --from batrachian-toad toad acp ' cband acp -c "--model haiku" '

에디터 및 ACP 클라이언트 지원은 프론트엔드마다 다르지만, claudraband 자체는 ACP를 통해 세션 팔로우(follow) 및 재개를 지원합니다.

세션 모델 활성 세션은 ~/.claudraband/에서 추적됩니다. cband sessions: 활성 추적 세션을 나열합니다. continue: 더 이상 활성 상태가 아닌 경우에도 기존 Claude Code 세션을 재개할 수 있습니다. attach: 활성 세션에서만 작동합니다. sessions close ...: 로컬 또는 데몬 기반의 활성 추적 세션을 종료합니다.

예시

자가 질의(Self-interrogation): Claude가 이전 Claude 세션에 질의하여 내린 결정에 대한 정당성을 설명하게 할 수 있습니다.
ACP를 통한 Toad: Toad는 claudraband acp를 Claude Code의 대체 프론트엔드로 사용할 수 있습니다. 그 UI 역시 내부적으로는 실제 Claude Code 창(pane)에서 작동합니다.
ACP를 통한 Zed: Zed 역시 claudraband acp를 대체 프론트엔드로 사용할 수 있습니다.

라이브러리 실행 가능한 TypeScript 예제는 examples/ 디렉토리에 있습니다: examples/code-review.ts examples/multi-session.ts examples/session-journal.ts

전체 API는 docs/library.md를, CLI 세부 정보는 docs/cli.md를, 원시 데몬 엔드포인트는 docs/daemon-api.md를 참조하세요.

치트 시트(Cheat Sheet)

설치 또는 한 번 실행

npx @halfwhey/claudraband " staged diff를 리뷰해줘 " bunx @halfwhey/claudraband " staged diff를 리뷰해줘 " npm install -g @halfwhey/claudraband

로컬 영구 세션

cband " 마지막 커밋 감사해줘 " cband sessions cband sessions close --all # 모두 닫기

원문 보기

원문 보기 (영어)

Claudraband Claude Code for the power user Experimental: this project is still evolving as Claude Code and ACP clients change. CLI • Library • Daemon API • Examples claudraband wraps the official Claude Code TUI in a controlled terminal so you can keep sessions alive, resume them later, answer pending prompts, expose them through a daemon, or drive them through ACP. It provides: Resumable non-interactive workflows. Essentially claude -p with session support: cband continue <session-id> 'what was the result of the research?' An HTTP daemon for remote or headless session control An ACP server for editor and alternate frontend integration A TypeScript library for building these workflows into your own tools Caveats This is not a replacement for the Claude SDK. It is geared toward personal, ad-hoc usage. We do not touch OAuth and we do not bypass the Claude Code TUI. You must authenticate through Claude Code, and every interaction runs through a real Claude Code session. Setup Requirements: Node.js or Bun An already authenticated Claude Code tmux for the first-class local and daemon-backed workflow Install or run: # one-off npx @halfwhey/claudraband " review the staged diff " bunx @halfwhey/claudraband " review the staged diff " # install once npm install -g @halfwhey/claudraband The package installs both claudraband and cband . cband is the recommended shorthand. The package bundles Claude Code @anthropic-ai/claude-code@2.1.96 ; set CLAUDRABAND_CLAUDE_PATH if you need to override the binary. Quick Start The two first-class paths are local tmux sessions and daemon-backed sessions. Local persistent sessions cband " audit the last commit and tell me what looks risky " cband sessions cband continue < session-id > " keep going " cband continue < session-id > --select 2 Daemon-backed sessions cband serve --host 127.0.0.1 --port 7842 cband --connect localhost:7842 " start a migration plan " cband attach < session-id > cband continue < session-id > --select 2 The daemon defaults to using tmux as the terminal runtime, just like the local path. Use --connect only when creating a new daemon-backed session; after that, tracked continue , attach , and sessions route through the recorded live owner automatically. Experimental Xterm Backend --backend xterm exists for local or daemon use, but it is experimental and slower than tmux . Use it when you need a headless fallback, not as the default path for long-lived interactive work. See docs/cli.md for current caveats and backend behavior. ACP Use ACP when another tool wants to drive Claude through claudraband . cband acp --model opus # example: toad uvx --from batrachian-toad toad acp ' cband acp -c "--model haiku" ' Editor and ACP client support varies by frontend, but claudraband itself supports session follow and resume through ACP. Session Model Live sessions are tracked in ~/.claudraband/ . cband sessions lists live tracked sessions continue can resume an existing Claude Code session even when it is no longer live attach only works on live sessions sessions close ... closes live tracked sessions, either local or daemon-backed Examples Self-interrogation Claude can interrogate an older Claude session and justify the choices it made. Toad via ACP Toad can use claudraband acp as an alternative frontend for Claude Code. That UI is still backed by a real Claude Code pane underneath. Zed via ACP Zed can also use claudraband acp as an alternative frontend. Library Runnable TypeScript examples live in examples/ : examples/code-review.ts examples/multi-session.ts examples/session-journal.ts For the full API, see docs/library.md . For CLI details, see docs/cli.md . For raw daemon endpoints, see docs/daemon-api.md . Cheat Sheet # install or run once npx @halfwhey/claudraband " review the staged diff " bunx @halfwhey/claudraband " review the staged diff " npm install -g @halfwhey/claudraband # local persistent sessions cband " audit the last commit " cband sessions cband sessions close --all # close all claudraband controlled sessions cband continue < session-id > " keep going " # answer pending prompts cband continue < session-id > --select 2 cband continue < session-id > --select 3 " xyz " # daemon mode cband serve --host 127.0.0.1 --port 7842 cband --connect localhost:7842 " start a migration plan " cband attach < session-id > # ACP cband acp --model opus

클로드-코드 오픈소스 개발자-도구 세션-관리 해커뉴스