Claude와 Codex의 고질적인 문제를 해결한 리포지토리

CChase AI
컴퓨터/소프트웨어창업/스타트업AI/미래기술

스크립트

00:00:00Claude code와 codecs를 동시에 사용하거나, 여러 코딩 에이전트를 조합해서 사용하시는 분이라면
00:00:046개, 7개, 8개씩 터미널을 띄워놓고 작업하는 게 얼마나 고통스러운지 잘 아실 겁니다.
00:00:09이 모든 터미널을 동시에 모니터링해야 하는 것도 모자라서
00:00:14무엇을 먼저 확인해야 할지 파악하는 것도 일이죠. 작업 도중에 실수로 창을 닫기라도 하면 정말 끔찍하죠.
00:00:19하지만 이 모든 문제를 해결해 줄 오픈 소스 도구가 있습니다.
00:00:22가볍고 Mac과 Windows 모두에서 작동하는 도구인데요,
00:00:27오늘 그 사용법을 정확히 알려드리겠습니다. 바로 Herder라는 도구입니다.
00:00:31Herder는 터미널 멀티플렉서입니다. 즉, 여러 터미널을
00:00:35한 화면에서 제어할 수 있다는 뜻이죠. 예를 들면 이런 모습입니다. 상단에 Claude code 터미널 2개,
00:00:39왼쪽 아래에 open code, 그리고 우측 하단에는 codecs가 떠 있습니다.
00:00:44Herder가 주는 이점은 크게 세 가지입니다. 첫째, 정리 정돈. 둘째, 여러 탭을 쉽게
00:00:49모니터링할 수 있는 기능. 그리고 셋째, 지속성입니다. 정리 정돈 측면에서 보면,
00:00:54데스크톱에 터미널 창을 마구 띄워놓고 작업하는 것보다 훨씬 효율적입니다.
00:01:00에이전트 중심적인 도구이기도 하죠. 왼쪽을 보시면 여러
00:01:05에이전트 목록이 나옵니다. 모니터링 측면에서는 각 에이전트가 작동 중인지,
00:01:10작업이 끝났는지, 아니면 멈춰 있는지 정확히 확인할 수 있습니다. 셋째, 지속성에 대해 말하자면,
00:01:14어떤 탭에서 앱의 특정 기능을 작업하고 있다고 가정해 보죠.
00:01:19실수로 창을 닫더라도 작업은 멈추지 않습니다. 사실 Herder는
00:01:25서버처럼 작동하기 때문에 창을 닫아도 백그라운드에서 계속 실행되며,
00:01:30언제든 쉽게 다시 불러올 수 있습니다. 이 세 가지 기능을 자세히 살펴보기 전에,
00:01:34많은 분이 궁금해하실 만한 질문을 먼저 다뤄보겠습니다. “Tmux나 Cmux와는 무엇이 다른가요?”
00:01:39Tmux는 수년 동안 사용되어 왔고, 여러 터미널을 한 곳에서 제어한다는 점에서
00:01:44본질적으로 같은 역할을 합니다. 하지만 Tmux와 비교했을 때 Herder는 에이전트 중심적입니다.
00:01:48왼쪽의 에이전트 탭을 보세요. 앞서 언급했듯이 이 기능을 통해 어떤 에이전트가 실행 중인지,
00:01:53사용자의 입력을 기다리는지, 작업이 완료되었는지 쉽게 파악할 수 있습니다.
00:01:59따라서 터미널 2~4개뿐만 아니라 5, 6, 7, 8개, 심지어 눈에 보이지 않는 터미널까지
00:02:05제어하기 매우 쉽습니다. Tmux는 기본적으로 그런 기능을 제공하지 않죠.
00:02:09Cmux와 비교했을 때 가장 큰 차이점은 지속성,
00:02:14그리고 Windows에서도 쉽게 사용할 수 있다는 점입니다. 지속성이라는 건,
00:02:18작업 중에 창을 닫아버려도 백그라운드에서 계속 실행된다는 뜻이죠.
00:02:22심지어 휴대폰이나 SSH를 통해 다시 접속할 수도 있습니다. Herder의 장점과
00:02:27기존 도구와의 차이점에 대한 간략한 설명이었습니다. 이제 설치와 사용법에 대해 이야기해 보죠.
00:02:31설치는 매우 쉽습니다. 코드 한 줄이면 됩니다.
00:02:36herder.dev나 Herder GitHub 페이지에 가시면 설치 명령어를 찾을 수 있습니다.
00:02:41여기에 있는 이 명령어를 복사해서 터미널에 붙여넣기만 하면 됩니다. 처음부터 같이 해볼까요?
00:02:47설치를 마친 후, 터미널을 열고 'Herder'라고 입력하세요.
00:02:52그럼 스페이스, 에이전트, 그리고 실제 터미널 세 가지를 볼 수 있습니다.
00:02:56일반 터미널처럼 작동합니다. 여기서 Claude code를 열면, 짜잔, 바로 실행되죠.
00:03:03이제 Claude가 에이전트 목록에 추가된 것을 볼 수 있습니다. 스페이스란 무엇일까요?
00:03:09스페이스를 일종의 '프로젝트'라고 생각하시면 됩니다. 지금 저는 chase라는 프로젝트 안에 있는 거고요.
00:03:16여기서 새 프로젝트를 만들 수 있습니다. 이름을 바꿔볼까요? 'web design'이라고 하고 저장하겠습니다.
00:03:23Herder의 또 다른 멋진 점은 마우스로 클릭해서 제어할 수 있다는 겁니다. 키보드 단축키에만 의존하지 않아도 돼요.
00:03:32웹 디자인 테스트라는 새 프로젝트를 만들고 그 안에서 Claude code를 실행해 보겠습니다.
00:03:37이제 메인 스페이스와 웹 디자인 스페이스가 생겼습니다.
00:03:42보시다시피 에이전트 둘 다 목록에 표시되네요. 서로 다른 작업을 수행할 수 있습니다.
00:03:48터미널을 직접 열어보지 않아도 에이전트가 무엇을 하는지, 어디까지 진행됐는지 확인할 수 있죠.
00:03:53즉, 스페이스는 가장 높은 수준의 폴더 같은 개념입니다.
00:03:56각 스페이스 내부에는 패인(pane), 에이전트, 탭이 존재합니다.
00:04:01지금 chase 스페이스의 1번 탭에 있습니다. 탭을 추가하고 이름을 원하는 대로 바꿀 수 있죠.
00:04:10일반 터미널이나 PowerShell에서 새 탭을 여는 것과 비슷합니다.
00:04:13Claude를 다시 열면 탭이 두 개가 됩니다. 간단하죠? 왼쪽 목록에서 확인할 수 있습니다.
00:04:19이제 각 탭 안에 여러 개의 패인을 띄울 수 있습니다.
00:04:24마우스 우클릭 후 'split right(오른쪽으로 분할)'를 선택해 보겠습니다.
00:04:30이제 Codex를 열면, chase 스페이스의 1번 탭 안에 Claude code와 Codex가 나란히 나타납니다.
00:04:38정리하자면 스페이스는 프로젝트 폴더, 그 안의 하위 폴더는 탭,
00:04:45그리고 각 탭 안에서 원하는 만큼 많은 에이전트를 가동할 수 있는 구조입니다.
00:04:52예를 들어, 첫 번째 탭은 리서치용으로 이름을 바꾸겠습니다.
00:04:59여기가 리서치를 수행하는 공간이고, Claude와 Codex를 사용하고 있습니다.
00:05:02두 번째 탭은 개발 서버 전용으로 사용하려고 합니다.
00:05:09네. 이곳은 순전히 개발 서버를 만지거나 하는 용도로만 사용할 겁니다.
00:05:13맞아요. 이렇게 하면 아주 깔끔하게 정리해서 각각 다른 버킷에 담아둘 수 있죠.
00:05:18이 모든 건 수많은 터미널과 에이전트가 뒤섞여 발생하는 혼란을 막기 위함입니다.
00:05:22스페이스로 크게 분류하고, 탭으로 세부 프로젝트를 나누고,
00:05:26왼쪽 에이전트 탭을 통해 진행 상황을 실시간으로 확인하는 거죠.
00:05:33Claude와 Codex가 서로 대화할 때 특히 유용합니다.
00:05:38보통 헤드리스(headless) 방식으로 작업이 진행되어
00:05:43Claude가 만든 Codex 인스턴스가 뒤에서 데이터를 주고받을 때
00:05:47실제로 무슨 일이 일어나는지 보기가 힘들거든요.
00:05:53하지만 Herder를 사용하면 그 과정을 눈으로 직접 볼 수 있습니다.
00:05:58예를 들어, 제 기술 중에는 Claude code와 Codex가 번갈아 가며
00:06:04계획을 수립하는 작업이 있습니다. 의견이 일치할 때까지 반복하죠.
00:06:07원래는 보이지 않는 곳에서 처리되지만, Herder를 사용하면 전체 과정을 확인하기 매우 쉽습니다.
00:06:12직접 보여드릴게요. 자, 웹 앱 개발 계획을 세우는 데
00:06:17Codex 리뷰 기술을 사용하여 가상의 계획을 만들어 보세요.
00:06:26계획을 세우고 Codex를 사용해 실행까지 진행합니다.
00:06:32Herder 기술을 사용하여 back and forth 과정이 보이도록
00:06:38새 패인을 만들어 주세요. 'Herder 기술'이라고 언급한 게 들리셨나요?
00:06:44이 기술은 에이전트에게 Herder 제어 방법을 알려줍니다.
00:06:51에이전트가 직접 패인을 나누거나 공간을 새로 만들 수 있죠.
00:06:56사용자가 일일이 조직할 필요가 없습니다. 설치 방법은
00:07:01터미널에 코드 한 줄만 붙여넣으면 됩니다. Herder GitHub에서 'agent skills' 항목을 확인하세요.
00:07:07참고로 Herder를 위한 플러그인 마켓플레이스도 있습니다.
00:07:12링크를 따라가시면 벌써 많은 분이 애드온을 만들고 있는 것을 볼 수 있습니다.
00:07:17작업이 진행되는 동안 다른 기능도 보여드릴게요. 왼쪽의 노란색
00:07:23움직임은 에이전트가 열심히 작업 중이라는 뜻입니다.
00:07:27메뉴의 설정에서 테마, 사운드, 통합 기능 등을 변경할 수 있고요.
00:07:32패인을 우클릭하면 이름 변경, 분할, 확대/축소 등 다양한 작업이 가능합니다.
00:07:38오른쪽을 보시면 Claude code와 Codex가 대화하는 게 보이시죠?
00:07:43Claude가 계획을 보내고, Codex가 검토 결과를 보냅니다.
00:07:49계획에 대한 문제점들이 실시간으로 나열되는 걸 보실 수 있습니다.
00:07:53보이지 않는 곳에서 혼자 진행되는 게 아니라 실시간으로 확인이 가능하죠.
00:08:00수정된 계획이 다시 전송됩니다. 계속 이런 식으로 반복해서 최상의 계획을 도출하게 됩니다.
00:08:04이제 지속성을 확인해 볼까요? 에이전트들이 작업 중이죠?
00:08:10터미널을 완전히 종료해 보겠습니다.
00:08:14그래도 작업은 백그라운드에서 계속 진행됩니다.
00:08:19PowerShell을 띄우고 다시 Herder를 실행해 보겠습니다.
00:08:24보시다시피 그대로 돌아가고 있죠. 아주 훌륭합니다.
00:08:30컴퓨터만 켜져 있다면 작업이 유지됩니다. 노트북을 덮어도
00:08:38절전 모드로 들어가지 않게 설정해 두면 에이전트가 계속해서 일하게 할 수 있죠.
00:08:43작업을 중단하고 싶으면 우클릭 후 close pane을 누르면 됩니다.
00:08:47스페이스도 우클릭해서 한꺼번에 종료할 수 있고요.
00:08:51마지막으로 단축키에 대해 말씀드릴게요. 메뉴의 keybinds에서 확인 가능합니다.
00:08:56앞서 말씀드린 대로 마우스로도 대부분 조작 가능합니다.
00:09:00키보드를 선호하신다면 Tmux와 비슷합니다. 'control + B'가 기본 접두사 모드예요.
00:09:06그 이후에 여러 조합을 사용할 수 있습니다. 예를 들어
00:09:11'prefix + V'를 누르면 수직으로 분할됩니다. 즉, 'control + B'를 누르고 'V'를 입력하는 거죠.
00:09:16컨트롤 B를 누르면 제 시스템이 '아, Herder를 조작하려는구나'라고 인식합니다.
00:09:22그 상태에서 V를 누르면, 보세요. 분할됐죠?
00:09:27물론 마우스 우클릭으로 하는 게 더 편할 수도 있습니다.
00:09:34이 정도면 Herder의 90%는 다 설명해 드린 것 같습니다.
00:09:39휴대폰 연동 같은 추가 기능들도 있습니다.
00:09:42하지만 진정한 가치는 다양한 에이전트를 한곳에서 모니터링하고
00:09:47조직화하는 데 있습니다. Claude code 내부의 에이전트 뷰도 좋지만,
00:09:52Codex나 다른 도구들을 함께 사용하려면 이런 통합 도구가 필수죠.
00:09:56지속성 기능 덕분에 작업 중에 터미널을 실수로 닫아도 안심할 수 있습니다.
00:10:01오픈 소스이니 자유롭게 사용해보세요. Mac과 Windows 모두 지원합니다.
00:10:06직접 써보시고 어떠셨는지 알려주세요. 다들 즐거운 코딩 되시길 바랍니다.
00:10:12지속성이라는 측면이 정말 마음에 듭니다. 저도 예전에 작업 도중에 터미널을 실수로
00:10:17닫아버린 적이 있거든요. 오픈 소스 도구라 무료로 사용 가능하고, 아까 말했듯이 Windows와 Mac 모두 지원합니다.
00:10:23한번 사용해 보시고 의견 알려주세요. 그럼 다들 다음에 또 뵙겠습니다.

핵심 요약

Herder를 사용하면 여러 코딩 에이전트를 하나의 스페이스 내에서 효율적으로 조직화하고, 터미널 창을 닫아도 작업이 유지되는 지속성을 확보할 수 있습니다.

하이라이트

  • Herder는 여러 터미널을 하나의 화면에서 관리하고 모니터링할 수 있게 해주는 오픈 소스 터미널 멀티플렉서입니다.

  • 서버 방식으로 작동하여 터미널 창을 실수로 닫더라도 백그라운드에서 작업이 중단 없이 유지됩니다.

  • 좌측 에이전트 목록을 통해 각 에이전트의 작동 상태와 작업 진행 상황을 실시간으로 확인할 수 있습니다.

  • Windows와 Mac 환경을 모두 지원하며, 마우스 클릭으로 패인 분할 및 관리가 가능합니다.

  • 에이전트가 패인을 나누거나 공간을 새로 만드는 등의 Herder 제어 기술을 직접 수행할 수 있도록 설정할 수 있습니다.

타임라인

Herder 도입 배경 및 장점

  • 여러 코딩 에이전트를 동시에 사용할 때 발생하는 터미널 관리의 복잡성과 실수 위험을 해결합니다.
  • 정리 정돈, 실시간 에이전트 모니터링, 작업의 지속성을 핵심 기능으로 제공합니다.
  • 서버 기반 구동 방식을 통해 터미널 창 종료 시에도 백그라운드에서 프로세스가 유지됩니다.

다수의 터미널을 동시에 띄워놓고 모니터링하는 작업 환경의 고통을 완화하기 위해 설계되었습니다. 에이전트 목록을 통해 현재 작업 중인 상태를 명확히 파악할 수 있으며, 애플리케이션 기능을 작업하던 중 창을 닫아도 데이터 손실 없이 다시 불러올 수 있습니다.

기존 도구와 차별점

  • Tmux와 달리 에이전트 중심의 인터페이스를 갖추어 실행 중인 에이전트와 입력을 기다리는 상태를 쉽게 구분합니다.
  • Cmux 대비 Windows 환경에서의 사용성이 뛰어나고 작업 지속성 기능이 강화되었습니다.
  • 원격 접속이나 SSH를 통해 작업 환경을 다시 불러오는 기능을 지원합니다.

기존의 터미널 멀티플렉서 도구들이 가진 한계를 보완했습니다. 에이전트 탭 기능을 통해 다수의 터미널뿐만 아니라 보이지 않는 백그라운드 작업까지 제어하기 용이합니다.

설치 및 공간 조직화 방법

  • 공식 GitHub 페이지에서 제공하는 명령어를 통해 한 줄로 간단히 설치할 수 있습니다.
  • 스페이스는 프로젝트 단위, 탭은 하위 프로젝트, 패인은 개별 작업 창으로 계층적 구조를 가집니다.
  • 마우스 우클릭을 통해 직관적으로 패인을 분할하고 에이전트를 배치할 수 있습니다.

설치 직후 터미널에 'Herder'를 입력하여 실행합니다. 프로젝트 성격에 따라 스페이스를 나누어 작업 공간을 분리하고, 각 스페이스 내부에서 필요에 따라 여러 탭과 패인을 생성하여 코딩 환경을 깔끔하게 유지할 수 있습니다.

에이전트 협업 확인 및 고급 기능

  • Claude와 Codex 같은 에이전트가 협업하는 전체 과정을 실시간 화면으로 관찰할 수 있습니다.
  • 에이전트가 직접 Herder를 제어할 수 있는 기술을 추가하여 자동화된 환경 구성이 가능합니다.
  • Control+B 접두사를 이용한 단축키 제어와 마우스 기반의 조작을 모두 지원합니다.

에이전트 간의 데이터 교환 및 계획 수립 과정을 시각화하여 문제점 파악 및 최적화를 돕습니다. 노트북 절전 모드 설정 시 컴퓨터가 켜져 있는 한 백그라운드 작업이 계속 진행되며, 플러그인 마켓플레이스를 통해 기능을 확장할 수도 있습니다.

커뮤니티 글

모든 글 보기