Claudectl: Claude Code를 위한 Windows 워크스페이스 관리자

Claudectl은 Windows 환경에서 Claude Code의 가장 큰 페인 포인트(pain point)인 프로젝트 전환 시 컨텍스트(context)를 잃어버리는 문제를 해결합니다. pipx install claudectl을 통해 설치하여 세션 브라우징, CLAUDE.md 스캐폴딩(scaffolding), 프로젝트별 MCP/M 모델 설정을 사용할 수 있습니다.

핵심 요약 (Key Takeaways)

• Claudectl은 Windows에서 Claude Code의 가장 큰 페인 포인트(pain point)인 프로젝트 전환 시 컨텍스트(context)를 잃어버리는 문제를 해결합니다.
• pipx install claudectl을 통해 설치하여 세션 브라우징, CLAUDE.md 스캐폴딩(scaffolding), 프로젝트별 MCP/M 모델 설정을 사용할 수 있습니다.

변경 사항 — Windows용 Claude Code 워크스페이스 관리자

Claude Code는 사용자의 작업을 채팅(chat)의 집합으로 취급합니다. 단일 프로젝트라면 괜찮습니다. 하지만 세 개의 리포지토리(repo) 사이를 전환하거나, 새로운 팀원을 온보딩하거나, 일주일 만에 프로젝트를 다시 방문하는 순간, 여러분은 컨텍스트(context) 손실과 싸워야 합니다. 세션은 쌓여가고, CLAUDE.md 파일은 오래되어 쓸모없게 됩니다. MCP 서버들은 동기화가 어긋나기 시작합니다.

이때 등장한 것이 claudectl입니다. 개발자 Babar Muhammad가 만든 오픈 소스(open-source) 워크스페이스 관리자로, Windows Claude Code 사용자들을 위해 특화되어 제작되었습니다. 이 도구는 Claude Code의 CLI를 터미널 UI로 감싸서, 모든 프로젝트를 지속 가능하고 검색 가능하며 설정 가능한 워크스페이스(workspace)로 취급합니다.

주요 기능 — 네 가지 기둥

1. 형편없지 않은 세션 관리 (Session Management)

Claudectl의 메인 화면은 세션 브라우저입니다. 모든 Claude Code 프로젝트와 세션이 최신순으로 정렬됩니다. R을 눌러 이름을 변경하고, D를 눌러 삭제하며, F를 눌러 세션을 포크(fork)할 수 있습니다. 핵심 기능은 무엇일까요? 바로 **★/☆ 단축키를 이용한 빠른 재개(Quick-resume)**입니다. 주요 세션에 표시를 해두고 모든 프로젝트를 가로질러 즉시 다시 작업할 수 있습니다. 이름이나 미리보기를 통해 실시간으로 세션을 검색할 수 있는 필터 기능도 제공합니다.

2. 실제로 유지되는 프로젝트 메모리

이 부분이 바로 claudectl이 CLAUDE.md 문제를 해결하는 지점입니다. 두 가지 접근 방식이 있습니다:

• 스캐폴딩 (Scaffold, C 키): git 리포지토리(repo), 최근 커밋(commit), README, 이전 세션 주제로부터 기계적으로 프로젝트 컨텍스트(context)를 구축합니다. AI 비용이 들지 않으며 반복 작업이 빠릅니다.
• AI 생성 (AI generation, A 키): Claude가 코드베이스(codebase)를 심층 분석하여 포괄적인 CLAUDE.md를 작성하거나 업데이트합니다. 내용이 작성되기 전에 사용자가 검토할 수 있습니다.

또한 프로젝트별 **시스템 프롬프트 (S 키)**를 지원합니다 — 매 실행 시 주입될 프롬프트를 AI로 생성하거나 직접 편집할 수 있습니다. 이는 "이 모노레포(monorepo)의 테스트 스위트는 주의해서 다뤄주세요"와 같은 지침이 세션이 바뀌어도 유지됨을 의미합니다.

3. 한눈에 보는 MCP 인식 기능

Claudectl은 시작 시 푸터(footer)에 연결된 MCP 서버들을 표시합니다. 더 중요한 점은, 어떤 MCP 서버의 도구(tools)라도 분석하여 글로벌 ~/.claude/CLAUDE.md에 문서를 작성할 수 있다는 것입니다. 이를 통해 Claude는 모든 세션에서 해당 도구들을 인지하게 됩니다. 어떤 MCP 서버가 어떤 역할을 하는지 잊어버릴 일이 더 이상 없습니다.

4. 프로젝트별 실행 제어

Claude를 실행하기 전에 다음 항목을 선택할 수 있습니다:

• 추론 노력 수준 (Reasoning effort: low/medium/high)
• 모델 오버라이드 (Model override: Opus 4.6, Sonnet 4.6 등)
• Claude 환경에 주입할 추가 PATH 항목

마지막 선택 사항은 프로젝트별로 기억됩니다. 이는 아키텍처 작업에는 Opus를 사용하고, 빠른 리팩터링(refactor)에는 Sonnet을 사용하고자 하는 팀에게 매우 유용합니다.

설정 — 두 개의 명령

pipx install claudectl
claudectl

요구 사항: Python 3.10 이상, Windows 10 또는 11, Claude Code CLI 설치됨 (%USERPROFILE%/.local/bin/claude.exe 또는 PATH에서 자동 감지).

사용 시점

• 멀티 프로젝트 개발자: 매일 3개 이상의 저장소(repo)를 전환하며 세션 컨텍스트(context)를 잃는 것을 싫어하는 경우.
• 팀의 신규 멤버 온보딩: 스캐폴딩(scaffolded)된 CLAUDE.md 파일은 신입 개발자에게 즉각적인 프로젝트 컨텍스트를 제공합니다.
• MCP 중심 워크플로우: 여러 MCP 서버를 실행하며 어떤 서버가 연결되어 있는지 가시성을 확보하고 싶은 경우.
• 모델 실험: 설정 파일을 수정하지 않고 프로젝트별로 Opus 4.6과 Sonnet 4.6 사이를 빠르게 전환하고 싶은 경우.

주의 사항

현재는 Windows 전용입니다. Linux 및 macOS 사용자는 기다리거나 직접 기여해야 합니다. 또한, 이는 Anthropic의 제품이 아닌 커뮤니티 도구이므로, 미흡한 부분이 있을 수 있으며 공식 지원이 제공되지 않습니다.

결론

Claudectl은 Windows 환경에서 Claude Code의 가장 큰 페인 포인트(pain point)인 프로젝트 간 컨텍스트 손실 문제를 해결합니다. 하나 이상의 프로젝트를 관리하고 있다면 지금 바로 설치하세요. 세션 브라우저 하나만으로도 컨텍스트를 전환할 때마다 30초를 절약할 수 있으며, 이는 금방 큰 차이를 만들어냅니다.

출처: github.com

원래 게재된 곳: gentic.news