Claude Code 프로필 관리 오픈소스 5선

Claude Code의 멀티 계정 전환, 설정 프로필 관리, 구독 분리를 해결하는 오픈소스 도구 비교

왜 필요한가

Claude Code는 기본적으로 하나의 계정/설정만 지원한다. 개인/회사 구독 분리, 용도별 설정(quickfix, full-stack-dev), 20 스킬 제한 회피, 클라우드 IDE 동기화 등의 니즈가 있는 파워유저에게 프로필 관리 도구가 필수적이다.

핵심 메커니즘

모든 도구가 공통으로 활용하는 Claude Code의 공식 기능:

  • CLAUDE_CONFIG_DIR 환경변수: 설정 디렉토리를 분리하면 Claude Code가 SHA-256 해시로 독립 keychain entry를 생성
  • OAuth 토큰 백업/복원: 자격증명을 프로필별로 저장해두고 스왑

도구 비교

1. claude-swap (realiti4) — ⭐️ 63, Python, MIT

가장 인기 있는 멀티 계정 스위처

uv tool install claude-swap
cswap --add-account    # 현재 계정 저장
cswap --switch         # 다음 계정으로 로테이션
cswap --switch-to user@example.com  # 특정 계정으로 전환
cswap --list           # 전체 계정 + 사용량
  • OAuth 토큰 백업/복원 방식
  • macOS (Keychain), Windows (Credential Manager), Linux (파일) 지원
  • Python 3.12+ 필요
  • https://github.com/realiti4/claude-swap ^[raw/articles/github-realiti4-claude-swap]

2. clausona (larcane97) — ⭐️ 6, TypeScript, MIT

공유 환경 유지 + 계정만 분리

clausona init          # 기존 계정 자동 감지
clausona use work      # 프로필 전환
csn use work           # 단축 alias
  • MCP 서버, 플러그인, 권한은 심볼릭링크로 공유
  • 계정만 독립적으로 관리
  • 인터랙티브 TUI 대시보드
  • 프로필별 비용/토큰 사용량 추적
  • macOS + zsh 전용
  • https://github.com/larcane97/clausona ^[raw/articles/github-larcane97-clausona]

3. claude-profile (diranged) — ⭐️ 1, Go, Apache-2.0

투명 래퍼 — Claude Code 수정 없이 동작

claude-profile create work
claude-profile create personal
claude-profile -P work              # claude 명령을 투명하게 래핑
alias workclaude='claude-profile -P work'
  • CLAUDE_CONFIG_DIR 환경변수만 설정 (Claude Code 공식 기능)
  • 프로필별 독립 keychain entry → 동시 실행 가능
  • Claude Code를 직접 수정/해킹하지 않음
  • Shell alias로 자연스러운 워크플로우
  • Go 바이너리 (Linux/macOS/Windows, amd64/arm64)
  • https://github.com/diranged/claude-profile ^[raw/articles/github-diranged-claude-profile]

4. ccp (samhvw8) — ⭐️ 0, Go, v0.27.0

Central Hub 기반 풀 컨피그 관리 — 20 스킬 제한 해결

ccp init                          # 기존 ~/.claude 마이그레이션
ccp profile create dev -i         # 인터랙티브 프로필 생성
ccp use quickfix                  # 프로필 전환
# ~/.claude → ~/.ccp/profiles/quickfix (symlink)

구조:

~/.ccp/
├── hub/           # 스킬, 에이전트, 훅, 룰의 중앙 저장소
├── profiles/
│   ├── default/   # 마이그레이션된 기존 설정
│   ├── quickfix/
│   └── full-stack-dev/
  • 프로필 = 엔진(런타임 설정) + 컨텍스트 2레이어 구성
  • Hub의 컴포넌트를 심볼릭링크로 재사용 (single source of truth)
  • CLAUDE.md@path/file.md 임포트를 자동 추적
  • mise/direnv로 프로젝트별 프로필 자동 활성화
  • 구독/API 프록시 전환도 환경변수로 지원
  • 릴리스 43개, 활발하게 개발 중
  • https://github.com/samhvw8/claude-code-profile ^[raw/articles/github-samhvw8-ccp]

GitHub Gist 클라우드 동기화

bun install -g @link-assistant/claude-profiles
claude-profiles --store work      # 현재 설정을 Gist에 저장
claude-profiles --restore personal # 다른 프로필 복원
claude-profiles --list
  • GitHub Gist(secret)에 프로필 암호화 저장
  • 머신 간 설정 동기화 (회사 PC ↔ 집 PC)
  • GitPod, GitHub Codespaces 등 클라우드 IDE에 최적
  • macOS + Linux 지원
  • gh CLI (gist 권한) 필요
  • https://github.com/link-assistant/claude-profiles ^[raw/articles/github-link-assistant-claude-profiles]

비교표

관점claude-swapclausonaclaude-profileccpclaude-profiles
언어PythonTypeScriptGoGoJavaScript
주용도계정 전환계정+공유설정계정분리풀 컨피그클라우드 동기화
별점63★6★1★0★3★
설정 공유✓ (symlink)✓ (hub)
TUI
동시실행
클라우드 동기화✓ (Gist)
스킬 관리
macOS
Linux
Windows

추천 시나리오

상황추천 도구
개인/회사 구독만 분리claude-swap
macOS에서 MCP/플러그인 공유clausona
여러 프로필 동시 실행claude-profile
용도별 스킬/에이전트 관리ccp
여러 머신 간 설정 동기화claude-profiles

관련 노트