안녕하세요, 자바파커입니다.

Claude Code를 하나만 쓰다가 둘, 셋으로 늘리면 새로운 문제가 생깁니다. 터미널 창이 여러 개가 되고, 어느 창이 승인을 기다리며 멈춰 있는지 하나씩 열어 봐야 합니다. herdr는 이 문제를 풀겠다는 도구입니다. 스스로를 "코딩 에이전트가 사는 런타임"이라고 소개하고, 2026년 11월 14일 기준 GitHub 별 5만 9백 개를 받았습니다.

직접 설치해서 Claude Code 3개를 동시에 돌려 봤습니다. 결과부터 말씀드리면 이렇습니다.

• herdr는 Claude Code가 승인 창을 띄운 지 약 0.6초 안에 그 창을 "승인 대기"로 표시했습니다. 세 에이전트가 동시에 멈춘 순간도 사이드바에서 한눈에 보였습니다.
• 같은 폴더에서 3개를 동시에 돌리니, 한 에이전트가 고친 코드를 다른 에이전트가 덮어썼습니다.
• herdr 워크트리로 에이전트마다 작업 폴더를 나누니 덮어쓰기는 없어졌습니다. 대신 브랜치를 합칠 때 git 충돌이 났습니다.
• 서버를 껐다 켜면 창 배치와 작업 폴더는 돌아왔지만, Claude Code 대화는 연동(integration)을 설치하지 않으면 이어지지 않았습니다.

herdr는 무엇인가

herdr는 Rust로 만든 단일 실행 파일입니다. tmux처럼 터미널을 작업 공간(workspace), 탭, 창(pane)으로 나누고, 그 안에서 도는 코딩 에이전트를 알아봅니다. Apache-2.0 라이선스이고, 최신 안정판은 v0.9.5(10월 14일)입니다. v0.9.5에는 macOS에서 한국어 입력기를 쓸 때 단축키가 먹지 않던 문제를 고친 내용이 들어 있습니다.

brew install herdr        # 또는 curl -fsSL https://herdr.dev/install.sh | sh
herdr                     # 지금 폴더에서 시작 (ctrl+b q 로 빠져나오기, herdr 로 다시 붙기)

실험 환경

• 2026년 11월 14일, macOS, herdr 0.9.5(Homebrew), Claude Code 2.1.325
• 화면 없이 도는 서버(herdr --session blog server)를 띄우고, 에이전트 시작·지시·승인은 herdr CLI로 했습니다. herdr 명령은 결과를 JSON으로 돌려줘서 스크립트로 다루기 좋았습니다.
• Claude Code는 기본 권한 모드로 띄워 명령과 파일 수정마다 승인을 받게 했습니다. 승인 창이 뜨면 3초 뒤 자동으로 승인하도록 스크립트를 짰습니다.
• 과제는 버그 하나(add()가 a - b를 반환)를 심은 작은 파이썬 프로젝트입니다. 세 에이전트에게 각각 버그 수정, README 작성, 곱셈 함수 mul 추가를 시켰습니다.
• 실제 화면은 가상 터미널로 herdr 화면을 받아 그렸습니다.

상태 표시는 정확하고 빨랐다

에이전트 하나로 먼저 확인했습니다. 0.5초 간격으로 Claude Code 화면과 herdr가 판단한 상태를 함께 기록했습니다.

기록 간격이 0.5초라 0.6초는 대략적인 값입니다. 한 번의 실행에서 잰 결과이기도 합니다. Claude Code를 처음 띄웠을 때 나오는 "이 폴더를 신뢰하는가" 확인 창도 시작 4초 만에 승인 대기로 잡았습니다. 세 에이전트를 함께 돌릴 때는 18초쯤 세 창이 동시에 승인 대기가 됐는데, 사이드바에서 세 점이 모두 분홍색으로 바뀌어 어느 창부터 열어 볼지 바로 알 수 있었습니다.

사이드바의 점 색은 분홍이 승인 대기, 노랑이 일하는 중, 청록이 완료, 초록 테두리가 대기(idle)였습니다. 이 상태 판단은 herdr의 Claude Code 연동을 설치하지 않은 상태에서 화면 인식만으로 이뤄졌습니다.

같은 폴더에서 3개를 돌리면

세 에이전트를 같은 프로젝트 폴더의 창 3개에 띄우고 동시에 지시했습니다. 36초 만에 세 에이전트가 모두 "끝났다"고 표시됐는데, calc.py에는 여전히 return a - b가 남아 있었습니다.

herdr의 "끝남" 표시는 에이전트가 프롬프트로 돌아왔다는 뜻입니다. 결과가 맞는지는 따로 확인해야 합니다. 같은 파일을 여러 에이전트가 동시에 만지면 이런 일이 생길 수 있습니다.

herdr 워크트리로 나누면

herdr에는 git 워크트리 기능이 있습니다. herdr worktree create로 에이전트마다 별도 작업 폴더와 브랜치를 만들고, 각 작업 공간에서 에이전트를 띄웠습니다.

herdr worktree create --cwd ./proj --branch fix-add --label fix-add
herdr worktree create --cwd ./proj --branch docs-readme --label docs-readme
herdr worktree create --cwd ./proj --branch add-mul --label add-mul

워크트리는 충돌을 없애 주지 않고, 합치는 순간으로 옮겨 줍니다. 이번 충돌은 두 줄을 합치는 것으로 정리됐고, 합친 뒤 테스트는 통과했습니다. 작업 도중에 서로의 결과를 모르게 덮어쓰는 것과 달리, 충돌이 어디서 났는지 git이 짚어 줍니다.

워크트리는 기본으로 홈 폴더 아래 ~/.herdr/worktrees/<저장소>/<브랜치>에 만들어집니다. 다른 곳에 두려면 --path를 지정합니다.

서버를 껐다 켜면

herdr server stop으로 서버를 끈 뒤 다시 켰습니다. 원래 저장소와 워크트리 3개를 합친 작업 공간 4개, 창 배치, 각 창의 작업 폴더는 그대로 돌아왔습니다. 하지만 창 안에 있던 Claude Code는 이어지지 않았고, 빈 셸만 남아 있었습니다.

README에도 "원래 프로세스는 살아남지 않는다"고 적혀 있고, 지원하는 에이전트의 대화를 이어 붙이려면 herdr integration install claude로 연동을 설치해야 합니다. 이 연동은 ~/.claude/hooks에 훅 스크립트를 추가합니다. 평소 쓰는 Claude Code 전역 설정을 바꾸는 일이라 이번 실험에서는 설치하지 않았습니다. 설치 여부는 각자 판단하시되, 설치하면 무엇이 바뀌는지는 herdr integration status로 먼저 확인하세요.

써 보니 좋은 점과 주의할 점

에이전트를 여럿 부릴 때는 이렇게 쓰는 편이 좋겠습니다.

1. 같은 파일을 고칠 일은 한 에이전트에게만 맡깁니다.
2. 동시에 돌릴 때는 에이전트마다 워크트리를 나눕니다.
3. 브랜치 합치기는 마지막에 한 번, 사람이나 에이전트 하나가 맡습니다. 문서처럼 다른 작업 결과에 기대는 일은 합친 뒤에 시킵니다.

자주 묻는 질문 (FAQ)

tmux와 무엇이 다른가요?

창을 나누고, 닫아도 작업이 이어지는 점은 tmux와 비슷합니다. 차이는 herdr가 창 안의 코딩 에이전트를 알아보고 상태(일하는 중, 승인 대기, 완료)를 표시한다는 점입니다. CLI와 소켓 API로 에이전트에게 지시를 보내고 상태를 기다릴 수도 있습니다.

Claude Code 말고 다른 에이전트도 되나요?

됩니다. Codex, Cursor, OpenCode, Gemini, Grok 등 20여 가지를 지원 목록에 올려 두었습니다. 이번 실험은 Claude Code로만 했습니다.

무료인가요?

Apache-2.0 오픈소스라 무료입니다. 에이전트 사용료는 각 에이전트의 구독이나 API 요금으로 나갑니다.

에이전트 여러 개를 같은 폴더에서 돌려도 되나요?

권하지 않습니다. 이번 실험에서 같은 폴더의 두 에이전트가 같은 파일을 고치다 한쪽 수정이 덮였습니다. herdr의 worktree create로 에이전트마다 작업 폴더를 나누고, 합치기는 마지막에 하세요.

처음 써 볼 때

1. brew install herdr로 설치하고, 프로젝트 폴더에서 herdr를 실행합니다.
2. 창을 나눠 Claude Code나 Codex를 띄우고, 사이드바의 상태 점을 지켜봅니다.
3. 에이전트를 둘 이상 동시에 돌릴 때는 herdr worktree create로 작업 폴더부터 나눕니다.
4. 세션 이어가기가 필요하면 herdr integration status로 무엇이 설치되는지 확인한 뒤 연동을 설치합니다.

비슷하게 여러 에이전트를 한 화면에서 다루는 T3 Code 실측, 서브에이전트 여러 개를 경쟁시키는 arena 스킬 실측도 함께 보세요.

참고: herdr 저장소 · herdr 문서