Herdr 심화 가이드: Claude Code와 AI 에이전트 오케스트레이션 및 SSH 원격 세션 관리 (2편)
AI 에이전트 여러 개를 동시에 가동할 때 진짜 승패는 모니터링 효율성에서 갈린다.
이 글은 Herdr 사용법 시리즈 2편이다. Herdr의 개념과 기본 설치를 다룬 Herdr 사용법 1편을 먼저 읽으면 이해가 빠르다. 2026년 8월 기준으로 작성됐다.
1편에서 Herdr의 개념과 기본적인 세션 생성 및 패널 분할 방법을 살펴봤다. 이번 2편에서는 실제 개발 환경에서 Claude Code, Codex CLI 등 복수의 AI 코딩 에이전트를 패널별로 역할을 분담시켜 병렬로 운용하는 오케스트레이션 기법과 SSH 원격 세션 관리 전략을 알아본다.
복수의 AI 코딩 에이전트를 어떻게 오케스트레이션할까?
Herdr 패널을 분할하고 각 패널마다 특정 개발 임무를 부여한 AI 에이전트를 가동하여 작업 효율을 극대화할 수 있다.
단일 터미널 세션 내부에서 백엔드 리팩토링, 프론트엔드 연동, 테스트 코드 생성을 전담하는 AI 에이전트를 동시에 실행하면 비동기적 병렬 개발이 가능해진다. 개발자는 Herdr 하단 상태 바에 표시되는 에이전트 상태 변경에만 주의를 기울이면 된다.
다음 흐름도는 3개의 패널에서 각기 다른 작업을 수행하는 AI 에이전트 오케스트레이션 구성을 나타낸다.
graph LR
subgraph Herdr Session [Session: Feature-Dev]
direction TB
Pane1["Pane 1: Claude Code<br/>(Backend Refactoring)<br/>Status: Working ⚡"]
Pane2["Pane 2: Codex CLI<br/>(Frontend Integration)<br/>Status: Blocked ✋"]
Pane3["Pane 3: Gemini CLI<br/>(Unit Test Generator)<br/>Status: Done ✅"]
end
Developer((Developer)) -->|Monitors Status Bar| Herdr Session
Developer -->|Selectively Interacts| Pane2
실전 3패널 오케스트레이션 구성 예시
# 1. 새 세션 생성
herdr new -s feature-dev
# 2. 첫 번째 패널: 백엔드 모듈 개발 (Claude Code)
claude
# 3. 화면 가로 분할 후 두 번째 패널: 프론트엔드 API 연결 (Codex)
# Ctrl+B + % 누른 후
codex --task "Connect auth API to login form"
# 4. 화면 세로 분할 후 세 번째 패널: 자동 테스트 생성 (Gemini)
# Ctrl+B + " 누른 후
gemini-cli "Generate pytest for auth service"
Herdr 상태 바에는 각 패널의 실행 상태가 아래와 같이 나타난다.
[1:claude-code] Working... ⚡ | [2:codex-cli] Blocked (Waiting User Confirmation) ✋ | [3:gemini] Done ✅
SSH 원격 세션 재접속 및 원격 노드 관리는 어떻게 할까?
SSH를 통해 원격 서버나 클라우드 개발 인스턴스에 접속한 상태에서도 Herdr 백그라운드 서버를 통해 세션을 지속시킬 수 있다.
Herdr 서버 데몬은 독립 프로세스로 상주하므로 SSH 접속이 예기치 않게 끊기더라도 원격 서버 내부의 AI 에이전트 작업은 중단되지 않고 계속 실행된다. 재접속 시 명령 한 줄로 이전 패널 배치와 상태를 그대로 복원한다.
원격 서버에서의 Herdr 데몬 운용법
원격 서버에 SSH 접속 후 다음 명령어로 기존에 돌아가던 Herdr 세션을 조회하고 재연결한다.
# 1. SSH 원격 접속
ssh developer@remote-dev-server
# 2. 실행 중인 Herdr 세션 목록 확인
herdr list
# 3. 끊어졌던 세션에 다시 연결
herdr attach -t feature-dev
또한 로컬 Herdr 클라이언트에서 원격 서버의 Herdr 세션으로 직접 연결하는 SSH 터널링 기능도 제공한다.
herdr attach --ssh developer@remote-dev-server -t feature-dev
에이전트 상태 감지 휴리스틱 튜닝 기법
자체적으로 구축한 커스텀 에이전트 스크립트나 특수한 프롬프트 기호를 사용하는 도구의 경우 Herdr의 기본 상태 파서가 Blocked 상태를 놓칠 수 있다.
이때는 .config/herdr/config.toml 파일의 휴리스틱 파싱 규칙에 커스텀 프롬프트 패턴을 추가하여 감지 정확도를 높일 수 있다.
[parser.custom_agent]
prompt_patterns = ["Select an option:", "Confirm execution [Y/n]?", "User input required >"]
working_patterns = ["Thinking...", "Executing command...", "Generating diff..."]
이 설정을 추가해 두면 커스텀 에이전트가 Select an option: 문구를 출력하는 즉시 Herdr 상태 바가 Blocked ✋ 상태로 변경되어 빠른 대응이 가능해진다.
자주 묻는 질문 (FAQ)
Q. Herdr 세션이 예기치 않게 종료되었을 때 로그나 이전 터미널 버퍼를 복구할 수 있나요?
A. 가능하다. Herdr는 각 패널의 링 버퍼(Ring Buffer) 로그를 ~/.local/share/herdr/logs/에 자동 기록한다. herdr logs -t <session_name> 명령어로 이전 터미널 버퍼 조회가 가능하다.
Q. 팁: 멀티 에이전트 사용 시 토큰 비용 폭주를 막는 방법이 있나요?
A. 각 패널에서 에이전트를 가동할 때 무제한 루프 옵션을 끄고 단계별 승인 모드(Interactive Mode)를 유지해야 한다. Herdr의 Blocked 상태 알림을 적극 활용하여 에이전트의 오작동이나 낭비를 사전에 통제하는 것을 권장한다.
📝 정리
이번 글에서 다룬 핵심 내용이다.
- [x] 3패널 구성을 활용한 역할 분담형 AI 에이전트 병렬 오케스트레이션
- [x] SSH 원격 접속 환경에서의 세션 지속성 확보 및 원격 재접속 기법
- [x] 커스텀 에이전트 지원을 위한
.config/herdr/config.toml휴리스틱 튜닝 - [x] 링 버퍼 로그 복구 및 토큰 비용 관리 실전 팁
Herdr 사용법 시리즈는 여기까지다. 개념 이해부터 실전 오케스트레이션까지 익혔으니, 이제 직접 복수의 AI 에이전트를 효율적으로 다뤄볼 일만 남았다.
