clarp: 6월 15일 종량제 이전 클로드의 오픈소스 드롭인 대체제

Claude -p (프린트 모드)와 Agent SDK가 6월 15일부로 별도의 크레딧 기반 가격 체계로 전환됩니다. claude -p를 기반으로 도구와 워크플로우를 구축한 개발자라면 비용이 크게 증가할 수 있습니다. 이에 대한 해결책으로 clarp가 등장했습니다. clarp는 로컬 개발 환경에서 claude -p를 바로 대체할 수 있는 오픈소스 CLI입니다.

작동 방식

내부적으로 clarp는 일반적인 대화형 Claude Code CLI를 숨겨진 PTY에서 실행한 후, 로컬 읽기 전용 프록시를 사용해 Anthropic API 스트림을 관찰하고 claude -p 스타일의 출력을 재구성합니다. Claude의 요청이나 응답을 수정하지 않으며, 단순히 대화형 출력을 프린트 모드 형식으로 변환하는 프록시 역할만 합니다.

대부분의 프로젝트에서 마이그레이션은 바이너리 이름을 claude에서 clarp로 변경하는 것만으로 충분합니다.

지원 기능

• 텍스트, JSON, 스트림-JSON 출력
• stdin 프롬프트
• 다중 턴 스트림-JSON 입력
• 대부분의 Claude Code 플래그 전달
• 권한 전달
• --include-partial-messages를 통한 토큰 수준 부분 결과

아직 완벽하지 않은 점

사이드밴드/비-어시스턴트 이벤트가 정확히 일치하지 않습니다. 일부 훅/태스크/진행 이벤트가 아직 불완전합니다. 제작자는 일반적인 claude -p 사용 사례에 대해 높은 호환성을 제공하지만 Claude Code 내부 프린트 모드 파이프라인의 완벽한 재구현은 아니라고 말합니다. 이 도구는 로컬 개발자 워크플로우를 대상으로 하며, 호스팅 서비스가 아닙니다.

설치

npm install -g clarp-cli

설치 후, 스크립트와 도구에서 claude -p를 clarp로 바꾸면 됩니다. 이 프로젝트는 Claude 자체의 상당한 도움을 받아 구축되었습니다. 프록시/세션 부분 구현, 호환성 테스트 작성, 인수 구문 분석의 엣지 케이스 발견, 릴리스 및 문서 개선 등에 Claude가 활용되었습니다.

대상 사용자

claude -p에 의존하는 자동화 도구나 스크립트를 사용하는 개발자로, 워크플로우를 다시 작성하지 않고 다가오는 종량제 요금을 피하려는 경우에 적합합니다.