Claude Code 프로필 관리 도구 claudectx 공개

실용적 조언

복잡한 코딩은 Opus 모델과 전체 권한 프로필로, 단순 문서화는 Haiku 모델과 읽기 전용 프로필로 나누어 실행하라.
새로운 프로필을 적용하기 전 --dry-run 플래그를 사용하여 설정된 MCP 서버와 권한이 올바른지 확인하라.

섹션별 상세

기존 Claude Code는 전역 설정을 공유하여 서로 다른 작업에 최적화된 환경을 동시에 사용하기 어려웠다. claudectx는 각 프로필에 모델, MCP 서버, 권한 설정을 격리하여 저장하고 실행 시 이를 주입하는 방식으로 작동한다. 이를 통해 터미널 두 개에서 각각 다른 설정의 세션을 독립적으로 실행하는 것이 가능하다.

코딩 작업에는 고성능 모델인 Opus를 사용하고 문서화 작업에는 비용 효율적인 Haiku를 사용하는 이원화 전략이 제시됐다. 코딩 세션에는 전체 권한과 필요한 MCP 서버를 할당하고 문서 세션에는 읽기 전용 권한만 부여하여 보안과 비용을 동시에 최적화했다. 실제 테스트 결과 두 세션 간의 설정 간섭이나 데이터 유출 없이 독립적인 작동이 확인됐다.

bash

claudectx run coding # terminal 1 - Opus, full permissions
claudectx run docs   # terminal 2 - Haiku, read-only

서로 다른 프로필을 사용하여 독립적인 Claude Code 세션을 동시에 실행하는 예시

사용자가 실행 전 설정을 검토할 수 있도록 --dry-run 플래그를 제공한다. 이 기능은 실제 세션을 시작하지 않고 생성된 실행 명령어를 텍스트로 출력하여 어떤 설정이 적용되는지 사전에 파악하게 돕는다. 이는 복잡한 MCP 서버 연결이나 권한 설정이 포함된 프로필을 안전하게 관리하는 데 유용하다.

용어 해설

모델 컨텍스트 프로토콜(MCP): — Model Context Protocol의 약자로, AI 모델이 외부 데이터 소스나 도구와 표준화된 방식으로 상호작용할 수 있게 해주는 개방형 프로토콜이다. 이를 통해 서로 다른 AI 에이전트와 서버 간의 연결성을 확보하고 데이터 접근 권한을 체계적으로 관리할 수 있다.
드라이 런(Dry Run): — 실제 코드를 실행하거나 시스템에 변경을 가하기 전에, 예상되는 결과를 미리 시뮬레이션하여 확인하는 절차이다. 이 아티클에서는 실제 Claude Code 세션을 시작하기 전 설정된 명령어를 미리 출력하여 의도대로 작동하는지 검증하는 용도로 사용된다.
문맥 전환(Context Switching): — 작업자가 수행 중인 업무에서 다른 업무로 전환할 때 발생하는 인지적 비용과 시간 손실을 의미한다. 개발자가 코딩 도중 문서 작성을 위해 환경을 바꾸는 과정에서 발생하는 생산성 저하를 방지하는 것이 이 도구의 핵심 목적이다.

언급된 도구

claudectx추천링크

Claude Code 프로필 관리 및 세션 격리 실행 도구

Claude Code중립

터미널 기반 AI 코딩 에이전트

언급된 리소스

GitHubclaudectx GitHub Repository