Claude Code 세션을 동시에 수십 개 실행할 때를 위한 윈도우 타일링 도구 제작
요약
여러 개의 Claude Code 세션을 효율적으로 관리하기 위해 개발된 Windows용 창 타일링 도구 AgentGrid를 소개합니다. 기존의 통합형 앱 방식과 달리 실제 OS 창을 그리드 형태로 정렬하여 멀티 에이전트 작업 환경을 최적화합니다.
핵심 포인트
- 단축키를 통해 여러 Claude Code 창을 모니터 크기에 맞춰 즉시 그리드 형태로 정렬
- Chrome Remote Desktop 환경에서도 작동하도록 Ctrl+Alt 단축키 사용
- 별도의 복잡한 설정 없이 PowerShell과 AutoHotkey만으로 실행 가능
- 프로젝트 피커 기능을 갖춘 AgentDev와 연동하여 특정 폴더에서 에이전트 즉시 실행 가능
솔직히 말씀드릴게요, 전부 다 직접 쓰기 귀찮아서 Claude에게 이 포스트를 작성하게 했습니다. 요약하자면(TLDR), 이것은 모든 Claude 창을 타일링(tiling)하는 단축키이자 PowerShell에서 Claude를 빠르게 여는 단축키입니다 (또한 특정 폴더로 cd 하거나 해당 폴더에서 PowerShell을 열 필요 없이, 작업하려는 프로젝트에서 Claude를 더 쉽게 열 수 있도록 도와주는 명령어도 있습니다. 더 구체적인 내용은 이 리포지토리(repo)에서 확인하실 수 있습니다).
만약 여러분이 여러 개의 Claude Code 에이전트를 병렬로 실행한다면, 그 난장판을 잘 아실 겁니다. 10~15개의 별도 터미널 창이 여기저기 흩어져 있고, 서로 겹쳐 있으며, 절반은 밑에 깔려 있고, 여러분을 기다리고 있는 창을 찾기 위해 끊임없이 Alt-Tab을 눌러야 하죠.
제가 찾은 모든 "여러 Claude Code 세션 관리" 도구들은 tmux pane, Electron 그리드, 웹 대시보드처럼 모든 에이전트를 하나의 앱 창 안에 몰아넣는 방식으로 이 문제를 해결하려 했습니다. 저는 그걸 원하지 않았습니다. 저는 실제의 분리된 터미널 창들을 그대로 유지하고 싶었습니다. 그리고 일반적인 Windows 타일링 창 관리자(WMs)들(komorebi, GlazeWM 등)은 방대한 설정이 필요하고, 모든 것을 타일링하며, 그들의 Win-key 단축키는 제가 개발 서버에 접속할 때 사용하는 Chrome Remote Desktop(CRD) 상에서는 작동조차 하지 않습니다.
그래서 저는 AgentGrid를 만들었습니다. 이것은 여러분이 이미 가지고 있는 실제 OS 창들을 정렬해 줍니다.
기능
- Ctrl+Alt+T - 모든 에이전트 창을 모니터 전체에 깔끔한 그리드(grid) 형태로 즉시 타일링하고, (키보드 포커스를 뺏지 않고) 모두 맨 앞으로 가져옵니다.
- 모니터 독립성 + 항상 읽기 좋은 크기 - 대상 셀 크기를 기준으로 각 모니터에 맞춰 그리드 크기를 조정하므로, 노트북, 1080p, 울트라와이드, 4K 또는 서로 다른 세 개의 모니터를 사용하더라도 창이 읽기 좋은 크기를 유지합니다. 각 화면을 편안한 용량만큼 채우며, 억지로 구겨 넣는 대신 다음 화면으로 넘깁니다.
- Ctrl+Alt+C - 새로운 에이전트 창을 엽니다 (에이전트 종류에 구애받지 않음: claude, codex, aider 등 설정한 무엇이든 가능).
- Chrome Remote Desktop 호환 - Win-key 조합은 CRD에서 먹혀버리기 때문에 Ctrl+Alt 단축키를 사용합니다.
- 선택 사항인 워밍 데몬(warm daemon)을 통해 거의 즉각적인 실행이 가능합니다. 시작하는 데 설정(config)이 전혀 필요 없습니다.
PowerShell과 AutoHotkey 외에는 별도의 의존성(deps)이 필요하지 않습니다.
함께 사용할 수 있는 도구인 AgentDev도 있습니다. dev 명령어를 입력하면 화살표 키로 프로젝트를 선택할 수 있는 프로젝트 피커(project picker)가 나타나며, 프로젝트를 선택하면 에이전트(agent)가 해당 위치에서 실행되어 그리드(grid)에 자동으로 배치됩니다.
솔직한 주의사항: Windows 전용이며, 클래식 콘솔 창(classic console windows)을 대상으로 합니다(각 에이전트는 하나의 Windows Terminal 내 탭이 아닌, 각각 별도의 powershell/pwsh 창에서 실행됩니다). 또한 초기 단계(v0.1)입니다.
두 프로젝트 모두 MIT 라이선스입니다:
- AgentGrid: https://github.com/toyuvalo/agentgrid
- AgentDev: https://github.com/toyuvalo/agentdev
피드백을 기다립니다 - 이 도구는 개인적인 용도로 시작되었으며, 다른 분들에게도 유용할지 알고 싶습니다:
- 사용 중인 모니터 구성은 어떠하며, 한 번에 몇 개의 에이전트를 실행하시나요?
- Windows Terminal(탭) 지원이 추가된다면 사용하실 의향이 있으신가요?
- Mac/Linux 사용자라면, 현재 이 용도로 무엇을 사용하고 계신가요?
submitted by /u/FblthpphtlbF
[link] [comments]
AI 자동 생성 콘텐츠
본 콘텐츠는 r/ClaudeAI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기