클로드 코드 실전 활용: Claude Squad 병렬 작업, ccusage 사용량 모니터링, GitHub Actions와 훅

핵심 메시지

• Claude Squad는 tmux와 git worktree를 기반으로 여러 클로드 코드 세션을 동시에 굴리고 나중에 통합하는 도구로, 발표 시점 기준 맥에서만 동작한다.
• ccusage는 토큰 사용량을 시각화하는 도구이며, 발표자는 실시간 모니터링 명령 하나만 알아도 충분하다고 봤다.
• 클로드 코드 GitHub Actions는 푸시만 하면 배포까지 자동으로 이어지는 기존 CI/CD 흐름에 클로드 코드를 얹은 것이다.
• 훅은 도구 사용 전후, 알림, 응답 종료, 컴팩트 직전 같은 특정 시점에 원하는 코드를 끼워 넣어 워크플로를 직접 설계하게 해 준다.
• 발표자는 GitHub Actions 방식이 토큰을 많이 소비하는 것으로 보이므로, 깃 자체 기능과 클로드 코드 기능을 어디까지 분리할지 더 고민해야 한다고 짚었다.

쉽게 이해하기

이 발표는 클로드 코드 가이드북의 24장부터 27장까지를 스터디에서 정리한 내용이다. 다루는 도구는 네 가지로, 병렬 작업용 Claude Squad, 사용량 분석 도구 ccusage, 클로드 코드 GitHub Actions, 그리고 훅이다. 발표자는 각 도구를 직접 돌려 본 경험과 아직 확신이 서지 않는 지점을 함께 이야기한다.

Claude Squad는 tmux 위에서 동작한다. tmux는 터미널 창 하나를 여러 개로 분할해 각 창에서 별도 프로세스를 돌리는 도구인데, 세션을 30~40개까지 만들어 놓고 키보드 입력 한 번으로 모든 창에 같은 명령을 동시에 흘려보낼 수 있다. Claude Squad는 여기에 git worktree를 얹어, 세션마다 클로드 코드 인스턴스를 따로 띄우고 각각이 만든 변경을 GitHub CLI로 계속 밀어 넣은 뒤 나중에 통합하는 구조를 만든다. 설치는 패키지 매니저 한 줄로 끝나고, GitHub CLI 연결은 로그인 명령을 치면 나오는 여덟 자리 코드를 웹페이지에 넣는 방식이다.

ccusage는 훨씬 단순하다. 토큰 사용량을 분석해 시각화해 주는 도구로, 일별·월별·세션별·블록 단위 집계 옵션이 있지만 발표자가 꼽은 핵심은 실시간 모니터링이다. 리눅스의 시스템 모니터나 윈도우의 프로세스 뷰어처럼 클로드 코드 사용량이 실시간으로 오르내리는 화면을 보여 준다. 책에는 이 실시간 명령이 빠져 있어 직접 찾아 확인했다고 한다. 실행에 쓰이는 Bun은 노드보다 네 배가량 빠르다고 알려져 있고 타입스크립트와 웹소켓 표준 API를 지원한다.

GitHub Actions는 저장소에 푸시하면 서버 배포까지 자동으로 이어지는 구조다. 예전에는 소스를 푸시한 뒤 타깃 서버에 들어가 다시 내려받고 로컬 설정과 IP를 바꾼 다음 프로그램을 실행해야 했지만, 액션을 붙이고 나면 푸시만으로 3~4분 뒤 배포가 끝난다. 저장소 안의 워크플로 설정 파일에 스크립트를 지정하고 타깃 서버에 키 등을 세팅해 두면 된다. 클로드 코드에서는 슬래시 명령으로 GitHub 앱을 설치해 이 흐름을 붙일 수 있다.

훅은 원하는 시점에 원하는 코드를 끼워 넣는 장치다. 도구 사용 직전과 직후, 알림이 발생할 때, 사용자가 프롬프트를 제출할 때, 클로드 코드나 서브에이전트가 응답을 마칠 때, 컴팩트 작업 직전 같은 시점이 정리돼 있다. 설정 파일은 홈 디렉터리 아래 사용자 설정, 프로젝트 폴더 안의 프로젝트 설정, 그리고 키나 비밀번호처럼 공유하지 않을 값을 담는 로컬 설정으로 나뉜다.

주요 인사이트

• 발표자는 AI 도구로 코드를 조금만 고쳐도 무조건 커밋해 두는 습관을 강조하며, Claude Squad가 그 습관을 여러 세션에 동시에 적용하게 해 준다고 봤다.
• 훅의 실용적인 쓰임새로 발표자가 꼽은 것은 세 가지다. 파일을 고친 직후 린팅과 포매팅을 자동 실행하는 것, 테스트 스위트를 만들어 두고 도구 사용 후 자동으로 돌리는 것, 그리고 작업이 끝났을 때 알림을 보내는 것이다. 알림은 데스크톱 푸시든 문자든 모바일 푸시 서비스든 셸에서 실행할 수 있는 명령이면 무엇이든 연결할 수 있다.
• 커밋이나 푸시 직전에 유효성 검사를 돌리는 사전 검사 훅도 가능하다. 셸 스크립트를 실행하는 구조라서 기존에 쓰던 어떤 프로그램과도 엮을 수 있다.
• 발표자는 GitHub Actions로 가능하다고 소개되는 활용 사례들, 예컨대 이슈 기반 자동 구현이나 자동 아키텍처 진화 같은 이야기 상당수가 아직은 아이디어에 가깝다고 선을 그었다. 대신 환경별 API 키 분리나 키 로테이션 자동화처럼 현업에서 바로 쓸 수 있는 것부터 하나씩 적용하라고 권했다.
• 설정과 디버깅이 실제 관문이다. 훅은 처음부터 제대로 돌아가는 경우가 드물기 때문에 설정 파일과 변수를 디버깅하는 방법을 미리 익혀 두는 편이 낫다.

자주 묻는 질문

관련 AI 소식