Claude Code에서 업무용 및 개인용 계정을 분리할 때 발생하는 CLAUDE.md 혼재 문제

Mac 한 대에서 Claude Code의 계정 두 개를 사용하고 싶을 때가 있습니다. 예를 들어, 회사 팀(Team) 플랜과 개인 맥스(Max) 플랜 같은 경우입니다.

• 계정을 바꿀 때마다 로그아웃하고 다시 로그인하는 것이 번거롭습니다.
• 회사용 MCP 서버나 CLAUDE.md의 규칙이 개인 작업에도 영향을 미칩니다.
• 대화 기록이 한 곳에 섞여서 관리하기 어렵습니다.

환경 변수 CLAUDE_CONFIG_DIR을 사용해 Claude Code의 설정 폴더를 계정별로 분리하면 이러한 문제를 해결할 수 있습니다.

CLAUDE_CONFIG_DIR=~/.claude-work claude

다만, 홈 디렉토리 아래 리포지토리에서 사용할 경우, ~/.claude/CLAUDE.md가 '프로젝트 지침'으로 섞여 들어가서 리포지토리의 AGENTS.md를 읽지 못하게 되는 함정이 있습니다. 본문에서는 분리 방법과 실제로 확인한 이 함정의 내용 및 방지 방법을 소개합니다.

CLAUDE_CONFIG_DIR로 폴더 분리하기

1. Claude Code는 평소에 ~/.claude와 ~/.claude.json에 설정 및 로그인 정보를 저장합니다. 여기에 CLAUDE_CONFIG_DIR을 지정하여 실행하면, 대신 지정된 폴더를 사용하게 됩니다.

# 업무용 폴더로 로그인하기 (브라우저가 열림)
CLAUDE_CONFIG_DIR=~/.claude-work claude auth login

매번 입력하는 것이 번거로우므로, 쉘 설정(예: ~/.zshrc)에 별칭을 추가해 두면 편리합니다.

alias claude-work='CLAUDE_CONFIG_DIR="$HOME/.claude-work" claude'

현재 어떤 폴더를 사용하고 있는지 확인하려면 claude auth status를 사용하면 됩니다.

$ CLAUDE_CONFIG_DIR=~/.claude-work claude auth status
{
"loggedIn": true,
...

업무용 폴더로 한 번 실행한 후에는 다음과 같이 되었습니다. 평소에 홈 디렉토리 바로 아래에 생성되는 .claude.json도 이 폴더 안에 생성할 수 있습니다.

$ ls -a ~/.claude-work
. .. .claude.json CLAUDE.md backups plugins projects sessions skills

(CLAUDE.md는 확인을 위해 직접 넣어둔 것입니다.)

settings.json, CLAUDE.md, skills 및 MCP 설정, 대화 기록(projects/)은 이 폴더의 것을 사용하므로 계정별로 분리됩니다.

~/.claude/CLAUDE.md가 섞여 들어가고 AGENTS.md가 사라지다

2. 함정: 다음과 같이 세 가지 규칙을 배치하여 확인해 보았습니다.

~/repo에서 Claude Code를 실행하고 Claude에게 전달된 규칙을 살펴보니 다음과 같았습니다.

업무용 폴더로 실행했음에도 불구하고, 개인의 규칙이 들어가고 리포지토리의 AGENTS.md가 사라져 있었습니다.

왜 발생하는가

Claude Code는 작업 폴더에서 부모 폴더를 거슬러 올라가며 <폴더>/.claude/CLAUDE.md를 프로젝트 지침으로 읽습니다. 리포지토리가 홈 디렉토리 아래에 있으면, 경로를 따라가다가 홈을 지나게 되므로 ~/.claude/CLAUDE.md가 '홈이라는 프로젝트의 지침'으로 인식됩니다.

평소에는 ~/.claude/CLAUDE.md

자신의 설정의 CLAUDE.md이므로, 곤란하지 않습니다. 설정 폴더를 ~/.claude-work로 바꿨을 때만, 다른 계정의 규칙으로 섞여 들어옵니다.

게다가 프로젝트의 CLAUDE.md가 발견된 것으로 처리되어, 리포지토리의 AGENTS.md가 읽히지 않게 됩니다. ~/.claude/CLAUDE.md를 지우자, AGENTS.md는 읽히기 시작했습니다.

다른 것도 확인해 보았습니다.

~/.claude 안의 내용 | 작업용 폴더에서 실행했을 때 | |
---|---|
CLAUDE.md | 섞임 |
rules/ 안의 규칙 | 섞임 |
skills/ ・agents/ ・commands/ | 섞이지 않음 |

리포지토리가 홈 디렉토리 밖에 있을 때는, ~/.claude/CLAUDE.md는 섞이지 않았고, AGENTS.md도 읽혔습니다.

claudeMdExcludes로 제외하기

3. 방지 방법: 작업용 폴더의 settings.json에 claudeMdExcludes로 제외할 파일을 작성합니다.

{
"claudeMdExcludes": [
"/Users/<당신>/.claude/CLAUDE.md",
...
}

작성한 후에는 이렇게 되었습니다.

CLAUDE.md를 제외하자, AGENTS.md도 돌아왔습니다. rules/**를 작성하지 않으면, rules/ 안의 규칙은 계속 섞인 상태였습니다.

개인의 규칙 중 업무에서도 사용하고 싶은 것이 있다면, ~/.claude-work/CLAUDE.md에도 적어둡니다.

추가 정보: tanacode의 프로파일

Claude Code 작업을 옆에서 확인하는 macOS 앱 'tanacode'를 만들고 있습니다. tanacode에는 이 글의 분류 방식을 그대로 사용하는 '프로파일'이 있습니다.

• 계정란 메뉴의 '프로파일 추가…'에서 이름・색상・설정 폴더(기본값은 ~/.claude-<이름>)를 정해서 추가합니다. '로그인…'으로 터미널의 claude auth login을 실행합니다 - 해당 프로파일로 실행되는 Claude Code와 터미널 셸에, CLAUDE_CONFIG_DIR을 전달합니다 - 추가한 프로파일로 실행되는 Claude Code에는 이 글의 claudeMdExcludes(~/.claude/CLAUDE.md와 ~/.claude/rules/**)를 --settings로 전달합니다 - 세션 목록・사용량 게이지・앱 내 브라우저 로그인(Cookie)도 프로파일별로 분리합니다
• 전환해도 다른 프로파일의 세션은 백그라운드에서 계속 작동합니다. 확인 대기나 새로운 응답이 있으면, 계정란에 점이 찍힙니다. 알림에는 프로파일 이름이 붙습니다.
  
  
  tanacode のアカウント欄。「会社」と「個人」の 2 つのプロファイルがメニューに並び、プロファイルの追加と管理の項目がある

맺음말

CLAUDE_CONFIG_DIR로 계정을 분리하면, 해당 폴더의 settings.json에 claudeMdExcludes를 작성해 두면 규칙이 섞이지 않고, AGENTS.md도 읽힙니다.

토론