서론

Claude Code는 Anthropic이 제공하는 터미널 기반의 AI 코딩 에이전트입니다. 채팅 형식으로 지시하면, 코드 읽기/쓰기, 실행, Git 작업 등을 에이전트가 자율적으로 수행해 주는 도구이며, CLI 외에도 VS Code / JetBrains 확장, 데스크톱 앱, 웹 버전(claude.ai/code)에서도 이용할 수 있습니다.

업무상 지원 대응이나 정보 관련 태스크 등 여러 용도로 Claude Code를 사용하다 보면, '인증된 계정', '대화 기록', '설정'이 모두 한데 묶여서 사용 목적을 넘나들 때 정보가 뒤섞이는 경우가 생길 수 있습니다.

Claude Code는 환경 변수 CLAUDE_CONFIG_DIR로 설정 디렉토리를 전환할 수 있기 때문에, 이를 활용하여 용도별로 완전히 독립된 Claude Code 프로파일을 만드는 방법을 실제로 구축한 절차와 함께 정리합니다.

목표

• macOS에서 Claude Code를 여러 '페르소나'로 사용하고 싶다
• 프로파일마다 인증 정보, 대화 기록, 설정을 완벽하게 분리하고 싶다
• 다만, 언어별 코딩 규칙 등 '공유하고 싶은 스킬'은 한 곳에서 관리하여 어떤 프로파일에서도 사용할 수 있도록 하고 싶다

이번에 만든 프로파일은 다음과 같이 3가지입니다.

1. 셸 별칭(Alias) 등록

~/.zshrc에 각각의 프로파일 전용 디렉토리를 가리키는 CLAUDE_CONFIG_DIR를 설정한 별칭을 추가합니다.

echo 'alias claude-support='"'CLAUDE_CONFIG_DIR="$HOME/.claude-profiles/support" claude'"'' >> ~/.zshrc
source ~/.zshrc
claude-support

echo 'alias claude-info='"'CLAUDE_CONFIG_DIR="$HOME/.claude-profiles/info" claude'"'' >> ~/.zshrc
source ~/.zshrc
claude-info

claude-support와 claude-info는 각각 독립된 CLAUDE_CONFIG_DIR를 가지므로, 로그인하는 계정, 대화 기록, 설정이 프로파일 간에 완벽하게 분리됩니다. 각 별칭은 최초 실행 시 해당 프로파일용 개별 로그인(계정 선택)이 필요합니다.

2. 스킬 디렉토리 공유 (심볼릭 링크)

언어별 코딩 규칙을 정의한 Skill(Claude Code의 사용자 지정 지시/지식 기반 메커니즘)은 공통 자산으로 ~/.claude/skills/에 그대로 두고, 각 프로파일에서는 심볼릭 링크로 참조하도록 했습니다.

이를 통해 스킬의 실체는 한 곳에서 관리하면서도 어떤 프로파일에서든 같은 내용을 이용할 수 있습니다. 업데이트 역시 링크 원본 1곳을 편집하는 것만으로 완료됩니다.

mkdir -p ~/.claude-profiles/support/skills ~/.claude-profiles/info/skills
ln -sfn ~/.claude/skills/ruby-coding-rules ~/.claude-profiles/support/skills/ruby-coding-rules
ln -sfn ~/.claude/skills/ruby-coding-rules ~/.claude-profiles/info/skills/ruby-coding-rules
...

대상 스킬은 ruby-coding-rules / c-coding-rules / rust-coding-rules의 3가지입니다.

3. 디렉토리 구성 (최종 형태)

~/.claude/
└── skills/
├── ruby-coding-rules/ ← 스킬 실체 (정)
...

마치며

CLAUDE_CONFIG_DIR와 쉘 에일리어스 (Shell Alias), 심볼릭 링크 (Symbolic Link)라는 검증된 기술의 조합만으로, Claude Code를 용도별로 안전하게 구분하여 사용할 수 있는 환경을 구축할 수 있었습니다.

보충 설명으로, 향후 운용 시 유의하면 좋을 점들을 정리해 둡니다.

• 새로운 프로파일을 추가할 경우, 마찬가지로 CLAUDE_CONFIG_DIR를 변경하는 에일리어스를 추가하고, skills 디렉토리에 동일한 심볼릭 링크를 연결하면 기존 스킬을 그대로 재사용할 수 있습니다.
• 스킬의 내용을 업데이트할 때는 ~/.claude/skills/ 하위의 실체를 편집하면 되며, 각 프로파일 측의 심볼릭 링크를 개별적으로 업데이트할 필요는 없습니다.
• 프로파일마다 인증, 대화 로그, 설정 (settings.json 등)이 독립적이므로, 업무 내용의 혼재를 피하고 싶거나 서로 다른 조직·계약 단위로 계정을 분리하고 싶을 때 유효한 구성입니다.
• ln -sfn은 기존 링크가 있더라도 덮어쓰기 때문에, 재실행해도 안전(멱등성, Idempotent)합니다.

비슷한 과제를 가진 분들에게 도움이 되기를 바랍니다.

Discussion