Claude Code에서 다중 계정을 사용하시나요? CLAUDE_CONFIG_DIR로 각 계정에 고유한 세션, Memory 및 로그인을 부여하는 방법 (2026)

계정을 변경하는 가장 간단한 방법은 로그아웃하고 다시 로그인하는 것입니다. Anthropic은 /logout을 다음과 같이 설명합니다: "로그아웃하면 첫 실행 설정 상태도 재설정되므로 다음에 claude를 실행할 때 로그인 및 설정 과정을 다시 안내합니다."

세션 중간에 전환할 수도 있습니다. Anthropic의 대화형 모드 문서는 대화 주체가 바뀌는 방식 중 하나로 "/login으로 계정을 전환하는 경우"를 나열합니다.

두 경로 모두 동일한 제한이 있습니다. 자격 증명은 변경되지만, 기본적으로 동일한 구성 디렉토리인 ~/.claude를 계속 사용합니다. 세션 기록, auto memory, 사용자 수준 설정 및 플러그인은 그대로 유지됩니다. 다음 계정은 동일한 로컬 파일을 이어받게 됩니다.

가끔 전환하는 경우에는 괜찮을 수 있습니다. 하지만 두 계정 모두 로그인 상태를 유지하려면 Anthropic 문서에서 설명하는 별도의 디렉토리를 사용해야 합니다.

Anthropic의 환경 변수 참조에서는 CLAUDE_CONFIG_DIR를 "구성 디렉토리(기본값: ~/.claude)를 재정의"하는 방법으로 설명하며, "모든 설정, 세션 기록 및 플러그인은 이 경로 아래에 저장됩니다"라고 덧붙입니다.

.claude 디렉토리 가이드는 더 광범위합니다. 변수를 설정하면 "이 페이지의 모든 ~/.claude 경로는 대신 해당 디렉토리 아래에 위치하게 됩니다." 여기에는 평소 홈 디렉토리에 위치하는 .claude.json도 포함됩니다.

실제로 구성 디렉토리에는 다음이 포함됩니다:

• 로그인 정보. 아래에서 설명하는 자격 증명.
• 세션 기록. --resume 및 /resume이 읽는 projects/ 아래의 트랜스크립트. Claude Code 세션 기록을 찾는 가이드에서 레이아웃을 다룹니다.
• Auto memory. Anthropic의 memory 문서는 각 프로젝트의 auto memory를 <config dir>/projects/<project>/memory/ 아래에 둡니다.
• 사용자 수준 지침 및 설정. 사용자 CLAUDE.md, 사용자 규칙 및 settings.json.
• 플러그인. 설치된 플러그인 및 관련 데이터.

프로젝트 파일은 다릅니다. 저장소의 CLAUDE.md, .claude/settings.json 및 .mcp.json은 저장소 내에 존재하므로, 이를 여는 모든 계정이 해당 파일을 읽게 됩니다.

Anthropic의 예제는 쉘 별칭(alias)을 사용합니다. Bash 또는 Zsh의 경우 ~/.bashrc 또는 ~/.zshrc에 추가하세요:

alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'

이 별칭을 사용하면 claude는 ~/.claude에서 개인 계정을 유지하고, claude-work는 ~/.claude-work에서 업무용 계정을 사용합니다. Anthropic은 새 터미널을 열고 claude-work를 처음 실행하면 "Claude Code가 새 디렉토리에 대한 로그인 및 설정 과정을 안내합니다"라고 설명합니다.

설정이 제대로 작동하도록 돕는 문서상의 두 가지 세부 사항은 다음과 같습니다:

• 설정 파일에서 절대 경로 사용. "CLAUDE_CONFIG_DIR과 같이 경로를 받는 변수의 경우 절대 경로를 작성하십시오". Claude Code는 여기서 ~를 확장하지 않습니다.
• 프로젝트 설정에는 적용 안 됨. 이 변수는 프로젝트 및 로컬 설정에서 무시되므로, 저장소가 사용자의 계정을 대신 전환할 수 없습니다.

새 디렉토리가 가져오지 않는 것

새 디렉토리에는 기존 파일이 포함되지 않습니다. 이것이 의도된 바이지만, 업무용 계정에서는 개인 사용자 수준의 CLAUDE.md, 사용자 설정, 플러그인 또는 개인 계정에서 구축한 auto memory를 볼 수 없음을 의미합니다. 두 계정에서 동일한 개인 기본 설정을 원한다면 필요한 사용자 수준 파일을 두 번째 디렉토리에 복사하세요. 세션 기록과 auto memory는 분리하려는 목적이므로 그대로 두십시오.

Anthropic의 자격 증명 섹션은 디렉토리가 로그인을 분리하는 방식을 설명합니다. Linux 및 Windows에서 자격 증명은 구성 디렉토리의 .credentials.json에 저장됩니다. macOS에서는 키체인(Keychain)에 저장되며, 변수가 이 또한 변경합니다. Claude Code는 "macOS 키체인 항목을 해당 디렉토리에 매핑하므로, 다른 CLAUDE_CONFIG_DIR을 사용하는 세션은 다른 항목을 읽습니다."

따라서 두 개의 디렉토리는 두 개의 별도 로그인을 의미하며, 두 계정 모두 로그인 상태가 유지됩니다.

분리되지 않는 단 한 가지 종류의 로그인

한 가지 예외가 있으며 Anthropic은 이를 명시하고 있습니다. "별도의 디렉토리를 사용하더라도 API 키가 없는 두 개의 Claude Console 로그인은 분리되지 않습니다. Claude Code가 이러한 종류의 로그인을 구성 디렉토리 외부에 저장하기 때문입니다."

이 키가 없는 Console 로그인은 별도의 Anthropic 구성 디렉토리에 Anthropic 프로필로 저장됩니다. Anthropic은 이를 사용하기 전에 알아두어야 할 부작용을 덧붙입니다: "Claude Code는 머신에 저장된 모든 claude.ai 로그인에서 사용자를 로그아웃시킵니다." 키가 없는 Console 로그인과 claude.ai 로그인을 혼용하는 경우, 각 로그인 후 /status를 확인하세요.

API 키가 구독을 우선할 수 있음

자격 증명에는 순서가 있습니다. 환경 변수에 ANTHROPIC_API_KEY가 설정되어 있으면 /login을 통한 구독 로그인보다 우선합니다. Anthropic은 다음과 같이 경고합니다: "활성 Claude 구독이 있더라도 환경에 ANTHROPIC_API_KEY가 설정되어 있으면, 승인 후 Claude Code는 API 키를 사용합니다." 어떤 자격 증명이 사용 중인지 확인하려면 /status를 실행하세요. 두 가지 모두 구성된 경우 사용되지 않는 항목에 표시가 됩니다.

두 번째 디렉토리를 설정한다고 해서 아무것도 이동되지 않습니다. 분리 전에 실행한 세션은 저장되었던 디렉토리(기본적으로 ~/.claude)에 auto memory와 함께 그대로 남습니다.

따라서 한동안 ~/.claude에서 업무용 계정을 사용하다가 ~/.claude-work를 생성했다면, 이전 업무 세션은 여전히 개인 디렉토리 아래에 있습니다. 이를 재개하려면 해당 세션이 포함된 디렉토리로 Claude Code를 시작하세요. Anthropic의 세션 가이드는 구성 디렉토리 내에서 세션 선택기 중에 Ctrl+A를 누르면 그 아래의 모든 프로젝트 디렉토리에 있는 세션이 나열되어 세션이 어디서 실행되었는지 기억나지 않을 때 도움이 된다고 언급합니다.

보관 기간도 디렉토리별로 적용됩니다. Claude Code는 cleanupPeriodDays(기본값 30일)에 설정된 일수가 지나면 오래된 트랜스크립트를 삭제합니다. 사용자 설정에서 이를 설정했다면 해당 파일은 하나의 디렉토리에 속합니다. 다른 디렉토리의 사용자 설정에서도 다시 설정하지 않으면 두 번째 계정의 오래된 세션은 기본 일정에 따라 정리됩니다.

VS Code

쉘 별칭은 터미널에 입력하는 명령만 변경하므로 확장 프로그램에는 영향을 주지 않습니다. 확장 프로그램의 environmentVariables 설정에서 변수를 설정할 수 있지만 한 가지 규칙이 있습니다: "CLAUDE_CONFIG_DIR 항목은 값이 절대 경로일 때만 적용됩니다. 확장 프로그램은 ~를 확장하지 않으며 상대 값은 무시합니다." 확장 프로그램에는 계정 전환(Switch account) 화면도 있습니다. 변경 로그에 따르면 취소 버튼을 누르면 현재 계정으로 세션에 복귀합니다.

Claude Desktop

Desktop의 로컬 Code 세션은 CLI와 동일한 구성 파일을 읽습니다. Desktop이 다른 디렉토리를 가리키게 하려면 Anthropic은 개발 서버용 변수를 설정하는 위치 중 하나에 CLAUDE_CONFIG_DIR를 설정한 다음 Desktop을 종료하고 다시 열라고 설명합니다. 최근 릴리스에서는 터미널과 데스크톱 앱이 서로 다른 계정으로 로그인되었을 때 발생하던 두 가지 문제를 해결했으므로, 두 방식을 병행한다면 둘 다 최신 상태로 유지하세요.

클라우드 세션

클라우드 세션은 claude.ai 계정에 속합니다. "클라우드 세션은 항상 구독 자격 증명을 사용합니다." 클라우드와 터미널 간에 세션을 이동하려면 양쪽에서 동일한 계정을 사용해야 합니다. 텔레포트(teleport)의 경우 Anthropic의 요구 사항은 "클라우드 세션에서 사용된 것과 동일한 claude.ai 계정으로 인증되어야 합니다"입니다. 업무 세션을 텔레포트하려면 먼저 업무용 계정 디렉토리로 Claude Code를 시작하세요. Claude Code가 머신 간에 기억을 잃는 이유에 대한 가이드에서 클라우드 세션이 전달하는 내용을 다룹니다.

매번 로그아웃하고 로그인하기. 작동은 하지만 하나의 구성 디렉토리를 유지하므로 두 계정이 로컬 기록과 auto memory를 공유하게 됩니다.

/login이 이전 계정의 세션을 지울 것이라고 기대하기. 자격 증명만 변경됩니다. 트랜스크립트는 동일한 디렉토리에 남습니다.

상대 경로 사용하기. 설정 파일과 VS Code 확장 프로그램에서 CLAUDE_CONFIG_DIR에는 절대 경로가 필요합니다.

디렉토리로 두 개의 키 없는 Console 로그인을 분리하기. Anthropic은 디렉토리가 이들을 분리해주지 않는다고 명시합니다.

ANTHROPIC_API_KEY를 설정된 채로 두기. 승인되면 구독 로그인보다 우선권을 갖습니다.

1단계: 분리할 항목 결정

세션 기록, auto memory, 로그인 정보 등 분리해야 할 부분과 개인 기본 설정 등 일치해야 할 부분을 결정합니다. 설정을 시작하기 전에 각 그룹에 해당하는 파일을 기록해 두세요.

2단계: 두 번째 디렉토리 및 별칭 생성

Anthropic의 예제와 같은 별칭을 추가하고, 새 터미널을 열어 한 번 실행하여 두 번째 계정에 로그인합니다. VS Code 및 Desktop에서는 각 프로그램이 환경 변수를 읽는 위치에 동일한 절대 경로를 설정합니다.

3단계: 기록이 아닌 공유 기본 설정 복사

양쪽 모두에서 사용하고 싶은 사용자 수준 CLAUDE.md 및 설정을 복사합니다. 프로젝트 폴더는 각 계정의 트랜스크립트와 auto memory를 보관하므로 별도로 유지하세요. Claude Code worktrees 및 memory 가이드에서 auto memory가 저장소에 매핑되는 방식을 설명합니다.

별도의 디렉토리를 사용하면 각 계정의 세션과 auto memory를 분리할 수 있습니다. 하지만 그 대가로 관례나 장기 프로젝트의 상태와 같이 양쪽 모두에서 필요한 일부 context가 한 곳에만 존재하게 됩니다.

MemoryLake는 이러한 공유된 사실들을 사용자가 관리하는 한 곳에 보관하여 ChatGPT, Claude Code, Codex 등 연결된 어시스턴트들이 사용할 수 있게 해주는 memory 레이어입니다.

사용자는 자신의 언어로 직접 항목을 작성합니다. 구성 디렉토리, Claude Code 세션, CLAUDE.md 파일, auto memory, 자격 증명 또는 공급업체의 저장소에서 데이터를 읽거나 쓰거나 삭제하지 않습니다. CLAUDE_CONFIG_DIR 및 Claude Code의 로그인은 Anthropic이 설명하는 방식 그대로 계속 작동합니다.

1단계: API 키 생성

로그인하고 대시보드에서 키를 생성합니다. 이 키는 MemoryLake 워크스페이스에 속하며 Claude 계정과는 별개입니다.

2단계: 첫 번째 memory 업로드

해결책의 1단계에서 정한 공유 기본 설정과 두 계정 모두에 필요한 프로젝트 결정 사항부터 시작하세요. 항목당 하나의 포인트로 작성하고, 업무 관련 내용은 먼저 회사의 정책을 확인하세요.

3단계: AI 및 에이전트 연결

각 계정의 Claude Code와 사용하는 다른 어시스턴트들을 연결하세요. 어떤 디렉토리에서 시작하든 동일한 항목을 사용할 수 있습니다.

첫 번째 차이점은 더 이상 로그아웃할 필요가 없다는 것입니다. 각 계정은 로그인 상태를 유지하며, 입력하는 별칭에 따라 계정이 선택됩니다.

두 번째는 실질적인 분리입니다. 업무 세션과 업무 auto memory는 업무 디렉토리에 남고, 개인적인 것들은 사용자의 디렉토리에 남습니다.

세 번째는 중복 감소입니다. 두 계정 모두에서 필요한 사실들을 두 세트의 파일에 수동으로 복사할 필요가 없습니다. Codex도 사용하신다면, Claude Code와 Codex를 함께 사용하는 가이드에서 도구 간 context 공유 방법을 다룹니다.

계정당 하나의 디렉토리. Claude Code를 시작할 때 CLAUDE_CONFIG_DIR를 설정하세요.

쉘 외부에서는 절대 경로 사용. 설정 파일과 VS Code는 ~를 확장하지 않습니다.

전환 후 /status 확인. 사용 중인 계정과 자격 증명을 보여줍니다.

불필요한 API 키 해제. 승인된 ANTHROPIC_API_KEY는 구독 로그인보다 우선합니다.

키 없는 Console 로그인에 디렉토리를 의존하지 말 것. 디렉토리 외부에 저장됩니다.

클라우드 작업 시 계정 일치. 텔레포트에는 동일한 claude.ai 계정이 필요합니다.

이전 세션 주의. 오랫동안 유휴 상태였던 세션을 재개하면 한도가 많이 소모될 수 있습니다. 재개 사용량 경고 가이드에서 그 이유를 설명합니다.

Claude Code는 /logout 및 /login으로 계정을 전환하지만, 이는 하나의 구성 디렉토리를 유지하므로 두 계정이 로컬 기록과 auto memory를 공유하게 됩니다. 두 계정 모두 로그인 상태를 유지하면서 분리하려면 Anthropic의 해답은 계정당 별도의 CLAUDE_CONFIG_DIR를 사용하는 것입니다. 각 디렉토리는 고유한 설정, 세션 기록 및 로그인을 가지며, macOS에서는 고유한 키체인 항목을 가집니다.

예외 사항에 주의하세요: 키 없는 Console 로그인, 환경의 ANTHROPIC_API_KEY, 그리고 VS Code 및 설정 파일에서의 절대 경로 규칙입니다. 두 계정 모두에서 필요한 context는 어느 디렉토리에도 속하지 않는 곳에 보관하세요.