조용한 날엔 토큰 0원, 예약형 에이전트 관제판

클로드 코드(Claude Code) 세션을 여러 개 동시에 돌리고, 질문이 생기면 텔레그램으로 답해 주는 오픈소스 관제 도구가 공개됐다. 샤독 에이아이(shadok-ai)는 예약 실행에 모델을 부르지 않는 가드를 붙여, 처리할 일이 없는 날에는 토큰을 한 개도 쓰지 않는다고 밝혔다.

무슨 일인가

npx shadok-ai 한 줄로 실행되는 웹 관제판이다. 라이선스는 AGPL-3.0이고, 커밋 184건에 별 8개로 아직 초기 단계다. 특징은 각 에이전트를 별도의 깃 워크트리(git worktree)에 넣는다는 점이다. 같은 저장소를 두고 여러 세션이 서로의 파일을 밟는 사고를 구조로 막는 방식이다.

구동에는 사용자가 이미 결제한 클로드 구독을 그대로 쓴다. 노드(Node) 20 이상이 필요하고, 클로드 CLI가 없으면 첫 에이전트를 띄울 때 대신 설치한다. 세션이 서버 재시작을 견디도록 tmux도 자동으로 깔며, 설치가 불가능하면 node-pty로 물러선다. 기본 포트는 3789지만 이미 쓰이고 있으면 다음 빈 포트로 옮겨 붙는다.

핵심 짚어보기

세 가지가 눈에 띈다.

첫째, 에이전트가 다른 에이전트를 부린다. 각자 워크트리와 브랜치, 역할을 갖고 갈라져 나가며, 부모는 자식이 끝나거나 질문에서 막히거나 죽었을 때만 깨어난다. 계속 들여다보는 폴링이 아니라 사건이 생길 때만 알리는 구조다.

둘째, 예약 실행에 모델 없이 도는 가드를 붙였다. 조건이 맞지 않으면 아무것도 출력하지 않고 그대로 끝난다. 매일 도는 크론이 매일 요금을 만드는 문제를 정면으로 겨냥한 설계다.

셋째, 고삐다. 프로필은 역할과 가드레일의 묶음이라 git commit을 금지해 두면 에이전트는 커밋을 할 수 없다. 시크릿은 저장소 바깥 금고에 두고 필요한 에이전트에만 주입한다. 5시간과 7일 사용량 게이지를 보여 주고, 창이 흐르는 속도보다 빠르게 태우면 에이전트를 붙잡아 둔다.

개발 방식 자체가 이 도구의 주장을 겸한다. 제작자는 샤독 에이아이가 대체로 그 안에서 도는 에이전트들이 각자 워크트리에서 만들어 리뷰된 풀 리퀘스트로 합쳐 온 결과물이라고 설명한다.

1인기업 실전 적용 포인트

• 크론에 물린 자동화가 있다면 가드부터 분리한다. 새 소재가 0건이면 모델을 호출하기 전에 종료하도록 한 줄만 넣어도 매일 도는 잡의 월 비용이 크게 내려간다.
• 병렬 작업은 반드시 워크트리로 나눈다. 한 저장소에서 두 세션이 같은 파일을 고치면 반쯤 적용된 산출물이 나온다. git worktree add ../작업A -b feat/작업A 한 줄이면 충분하다.
• 승인 대기를 휴대폰으로 뺀다. 에이전트가 막히는 지점은 대개 질문 하나다. 에이전트별로 텔레그램 토픽을 하나씩 두면 자리를 비운 사이에도 파이프라인이 멈추지 않는다.
• 사용량 게이지를 대시보드에 붙인다. 5시간과 7일 창을 눈으로 보지 않으면, 한도가 끊긴 뒤에야 자동화가 멈춘 것을 알게 된다.

전망과 주의점

별 8개짜리 초기 프로젝트라는 점은 감안해야 한다. AGPL-3.0이라 사내 서비스에 얹어 외부에 제공할 계획이라면 라이선스 조건을 먼저 읽어야 한다. 자동 설치가 편한 만큼 tmux 설치에 관리자 권한을 요구하는 등 시스템에 깊이 손대는 대목도 있어, 처음에는 개인 개발기에서 시험하는 편이 안전하다.

그럼에도 방향은 분명하다. 에이전트를 얼마나 잘 부르느냐보다, 안 부를 때 얼마나 조용한가가 자동화의 원가를 결정한다.

출처: shadok-ai GitHub (https://github.com/shadok-ai/shadok-ai)