herdr로 Claude Code와 Codex 터미널 세션 묶기

개요

터미널에서 여러 에이전트 작업을 돌리면, 어떤 프로세스가 멈췄고 어디까지 진행됐는지 한눈에 보기 어렵습니다. 저는 이 점이 성가시다고 느낍니다. herdr는 터미널 pane을 한곳에 묶고 상태를 보여주는 Rust 기반 도구입니다. 공식 GitHub 저장소와 v0.7.4 릴리스 노트를 확인했습니다. 직접 실행하지는 않았습니다.

README에 적힌 구조는 명확합니다. 각 에이전트 pane은 실행 중, 막힘, 종료 상태를 표시하고, ctrl+b q로 떼어낸 뒤 herdr로 다시 붙습니다. SSH에서도 재접속할 수 있습니다. Codex CLI나 Claude Code를 대신하지 않고 여러 작업 창을 관리합니다.

1. 작동 방식

• 에이전트 pane: 개별 CLI의 순수 입출력을 담은 터미널입니다.
• 분리된 세션: 연결을 해제한 상태에서도 백그라운드에서 그대로 진행됩니다.
• 소켓 API: 다른 에이전트가 새 pane을 만들고 결과를 기다리는 자동화 지점입니다.
• 플러그인: 화면 배치와 업무 흐름을 덧붙이는 구조입니다.

단일 코딩 도구만 가끔 켠다면 추가 도구가 될 뿐입니다. 저장소 수정과 테스트 창을 여러 개 열고 세션을 오래 유지할 때 쓸 만합니다. herdr는 창을 정리하고, 에이전트는 각 pane 안에서 코드를 수정합니다.

사전 준비 사항

• macOS나 Linux 배포판에서 curl을 이용해 시작합니다.
• 패키지 매니저를 쓰는 환경이라면 brew install herdr로 가능합니다.
• Windows 환경은 아직 베타 단계 설치 경로가 지정되어 있습니다.
• 설치 스크립트를 실행하기 전에 사내 실행 정책과 대상 주소를 확인해주시면 됩니다.

1.1. 구동 방법

기본 설치 명령어는 다음과 같습니다.

curl -fsSL https://herdr.dev/install.sh | sh

이후 실제 디렉터리에서 herdr를 기동합니다.

herdr

창에서 에이전트를 시작하고 조작합니다. 마우스 드래그, 단축키, plugin 활용법은 README에 나옵니다. 지원 에이전트 목록은 공식 문서에서 확인해주시면 됩니다.

1. 재접속 확인

작업 중인 화면은 ctrl+b q로 분리합니다. 다시 붙습니다. 다른 터미널에서 herdr를 실행하면 이전 상태가 열립니다. README는 세션이 재시작 뒤에도 남는다고 설명합니다. 운영 환경에서는 세션 저장 정책을 따로 확인하는 편이 낫습니다.

적용 대상

같은 프로젝트에 여러 에이전트를 병렬 배치할 때 쓸모가 큽니다. CLI 출력을 직접 보려는 개발자에게 맞습니다. 하나의 질문이나 짧은 설정 변경에는 Codex CLI 또는 Claude Code만으로 충분합니다. 라이선스가 AGPL-3.0-or-later이므로 조직 도입 전에는 조건을 검토해야 합니다. 컨테이너 작업도 같은 서버에 둔다면 Docker 설치 글을 활용하시면 됩니다.

마무리

설치를 마친 뒤 버전을 확인합니다.

herdr --version

정상 실행이 확인되면 멀티플렉서 세션 준비가 모두 끝난 상태입니다.