본문 바로가기

← Insights 공유 · 5분 · 읽음 16 · 추천 0 · 댓글 0

Windows에서 Claude Code 여러 계정 사용하기: PowerShell 계정 전환과 세션 관리

Windows PowerShell에서 CLAUDE_CONFIG_DIR로 Claude 계정별 로그인을 분리하고 cl1, cl2, cl3 명령으로 전환하는 방법.

대상: Windows 11 · PowerShell 7 또는 Windows PowerShell 5.1 · 공식 Claude Code CLI
목표: Claude 계정별 로그인 상태를 분리하고 cl1, cl2, cl3 명령으로 전환한다. 같은 프로젝트 파일을 사용하면서 세션을 안전하게 관리한다.
원칙: 별도 AI 코딩 하네스나 비공식 계정 스위처를 설치하지 않는다.

핵심 요약

Claude Code는 공식 환경변수 **CLAUDE_CONFIG_DIR**를 지원한다. 기본 경로는 ~/.claude이며, 이를 바꾸면 설정·인증·세션 기록·플러그인을 별도 디렉터리에 보관할 수 있다. 따라서 각 계정의 로그인 상태를 유지한 채 명령어로 전환할 수 있다.

Codex CLI의 CODEX_HOME과 개념은 비슷하지만, Claude Code에서는 CLAUDE_CONFIG_DIR를 사용한다.

계정 예시 설정 디렉터리 단축 명령
Work %USERPROFILE%\.claude-work cl1, clwork
Personal %USERPROFILE%\.claude-personal cl2, clpersonal
Team %USERPROFILE%\.claude-team cl3, clteam

계정이 두 개라면 세 번째 항목은 생략해도 된다. 각 계정의 이용 약관과 조직 정책을 준수하자.

1. Claude Code CLI 설치

공식 설치 안내: https://code.claude.com/docs/en/setup

이미 설치되어 있다면 다음 명령으로 확인한다.

claude --version

설치 방법은 버전에 따라 변경될 수 있으므로 공식 문서에서 Windows용 설치 명령을 확인한다. 기존 CLI를 그대로 사용해도 된다.

2. 계정별 디렉터리 만들기

$names = @('work', 'personal', 'team')
foreach ($name in $names) {
    New-Item -ItemType Directory -Force -Path (Join-Path $HOME ".claude-$name") | Out-Null
}

결과:

C:\Users\YourName\
├── .claude\                # 기존 Claude Code 환경 (그대로 보존)
├── .claude-work\           # Work 계정
├── .claude-personal\       # Personal 계정
└── .claude-team\           # Team 계정

3. 계정별 로그인

PowerShell에서 계정마다 별도로 로그인한다.

$env:CLAUDE_CONFIG_DIR = Join-Path $HOME '.claude-work'
claude

Claude Code에서 /login을 실행하고 Work 계정으로 인증한다. 종료한 다음 다른 계정으로 반복한다.

$env:CLAUDE_CONFIG_DIR = Join-Path $HOME '.claude-personal'
claude
# Claude Code 내부에서 /login 실행
$env:CLAUDE_CONFIG_DIR = Join-Path $HOME '.claude-team'
claude
# Claude Code 내부에서 /login 실행

로그인 후 Claude Code 내부의 **/status**에서 사용 중인 계정과 인증 방식을 확인한다. 브라우저가 기존 계정을 자동 선택하면 별도 브라우저 프로필을 사용한다.

중요: ANTHROPIC_API_KEY 환경변수가 설정되어 있으면 Claude 구독 로그인보다 API 키가 우선 사용될 수 있으며 별도 API 요금이 발생할 수 있다. 구독 계정을 사용할 때는 $env:ANTHROPIC_API_KEY 값을 확인한다.

4. PowerShell 프로필에 계정 전환 함수 등록

현재 사용자·호스트의 PowerShell 프로필을 연다.

if (-not (Test-Path $PROFILE)) {
    New-Item -ItemType File -Force -Path $PROFILE | Out-Null
}
notepad $PROFILE

아래 내용을 추가한다. 함수가 종료되면 이전 환경변수를 복원하므로, 다른 CLI 실행에 영향을 최소화한다.

# Claude Code multi-account
function Invoke-ClaudeAccount {
    param(
        [Parameter(Mandatory)] [string] $Name,
        [Parameter(ValueFromRemainingArguments)] [string[]] $ClaudeArgs
    )

    $oldValue = [Environment]::GetEnvironmentVariable('CLAUDE_CONFIG_DIR', 'Process')
    try {
        $env:CLAUDE_CONFIG_DIR = Join-Path $HOME ".claude-$Name"
        & claude @ClaudeArgs
    }
    finally {
        if ($null -eq $oldValue) {
            Remove-Item Env:CLAUDE_CONFIG_DIR -ErrorAction SilentlyContinue
        }
        else {
            $env:CLAUDE_CONFIG_DIR = $oldValue
        }
    }
}

function clwork     { Invoke-ClaudeAccount work @args }
function clpersonal { Invoke-ClaudeAccount personal @args }
function clteam     { Invoke-ClaudeAccount team @args }

function cl1 { clwork @args }
function cl2 { clpersonal @args }
function cl3 { clteam @args }

적용:

. $PROFILE

cl1 등이 이미 다른 명령으로 사용되고 있다면 다른 접두사를 선택한다. PowerShell 5.1과 7은 서로 다른 $PROFILE 경로를 사용할 수 있으므로 실제 사용하는 셸에서 등록한다.

5. 사용 예시

cd C:\projects\my-app

cl1                    # Work 계정으로 새 대화
cl2                    # Personal 계정으로 새 대화
cl3                    # Team 계정으로 새 대화

cl1 --continue         # Work 계정의 현재 프로젝트 최근 세션
cl2 --resume           # Personal 계정의 세션 선택
cl3 --version          # CLI 버전 확인

Claude Code 내부에서 /status로 로그인 계정을 확인할 수 있다. 세션 재개는 각 설정 디렉터리에 저장된 기록을 기준으로 한다.

6. 세션 공유: 무엇이 가능할까?

동일한 프로젝트 파일 공유와 동일한 대화 세션 공유는 구별해야 한다.

구분 결과 권장
같은 프로젝트 폴더에서 계정별 CLI 실행 Git·소스 파일·프로젝트의 CLAUDE.md 공유 권장
계정별 --continue / --resume 각 계정의 자체 세션 재개 권장
대화 내용 요약을 파일로 인계 계정 변경 시 작업 맥락 전달 권장
.claude-work/projects 등을 Junction으로 묶기 세션 파일 일부 공유를 시도할 수 있으나 지원 보장 없음 비권장·실험적

CLAUDE_CONFIG_DIR 아래에는 인증과 세션이 함께 포함된다. 전체 설정 디렉터리를 Junction으로 연결하면 계정 분리 자체가 깨질 수 있으므로 절대 전체 폴더를 공유하지 않는다.

권장: 프로젝트 기반 인계

프로젝트 루트에 CLAUDE.md로 공통 개발 규칙을 정리하고, 필요할 때 HANDOFF.md에 다음을 기록한다.

# 작업 인계

- 목표: 로그인 화면 리팩터링
- 완료: 컴포넌트 분리, 테스트 12개 추가
- 진행 중: 접근성 오류 수정
- 다음 단계: npm test 실행 후 실패 항목 수정
- 주의: src/auth/session.ts 변경사항 확인

계정 1에서 작업을 마치고 계정 2로 전환할 때:

cl2

Claude Code에 다음처럼 지시한다.

CLAUDE.md와 HANDOFF.md를 읽고, 현재 Git diff를 확인한 뒤
중단된 작업을 이어서 진행해줘.

이 방식은 대화의 내부 상태를 완전히 이전하지는 않지만, 계정별 인증을 안전하게 유지하면서 작업을 재개하기 쉽다.

실험적 방법: 프로젝트 세션 저장소 연결

Claude Code의 CLI 세션 기록은 일반적으로 각 설정 디렉터리 아래 projects/에 저장된다. 파일 시스템 수준에서 이 디렉터리를 공유하는 아이디어는 있지만, 다른 계정에서 동일한 대화를 안정적으로 재개하는 공식 지원 기능으로 간주해서는 안 된다. 버전별 세션 인덱스, 설정, 인증, 파일 쓰기 충돌 때문에 예상대로 동작하지 않을 수 있다.

특히 Windows Junction을 사용하려면 모든 Claude Code 프로세스를 종료하고 기존 디렉터리를 별도로 백업해야 한다. 실제 계정의 중요한 세션에는 적용하지 말고 테스트 계정과 테스트 프로젝트에서 먼저 검증한다. 이 글에서는 안전한 기본 구성에 집중하기 위해 Junction 자동화 명령은 제공하지 않는다.

7. 계정 변경 시 점검 항목

  1. cl1과 cl2 실행 후 각각 /status에서 올바른 계정인지 확인한다.
  2. ANTHROPIC_API_KEY가 의도치 않게 설정되어 있지 않은지 확인한다.
  3. 동일한 프로젝트 파일을 수정하는 여러 세션은 가급적 동시에 실행하지 않는다. 병렬 작업이 필요하면 Git worktree로 작업 디렉터리를 분리한다.
  4. 계정별 --resume이 기존 대화를 보여주는지 확인한다.
  5. 다른 계정의 대화가 자동으로 보인다고 가정하지 않는다.
  6. 계정별 로그인 자격 증명 파일을 복사하거나 공개 저장소에 커밋하지 않는다.

8. 자주 묻는 질문

Q. CLAUDE_CONFIG_DIR는 공식 기능인가?
A. 그렇다. Anthropic의 공식 환경변수 문서에 여러 계정을 나란히 실행하는 용도로 소개되어 있다.

Q. 계정 1의 사용량이 끝나면 계정 2로 자동 전환되나?
A. 아니다. 이 글은 수동 전환 가이드다. 자동 전환과 동일 대화의 완전한 복원은 보장하지 않는다.

Q. 기존 %USERPROFILE%\.claude는 어떻게 되나?
A. 그대로 남는다. 기존 환경을 첫 번째 계정으로 활용하고 싶다면 첫 번째 함수의 경로만 $HOME\.claude로 변경할 수 있다.

Q. Windows와 macOS 모두 같은 개념인가?
A. 그렇다. macOS/Linux에서도 CLAUDE_CONFIG_DIR로 계정별 환경을 분리할 수 있다. 다만 셸 함수는 zsh/bash 문법으로 작성해야 한다.

참고 자료


결론: Claude Code 다중 계정 전환은 별도 하네스 없이 공식 CLAUDE_CONFIG_DIR와 PowerShell 함수만으로 구현할 수 있다. 다만 계정 간 대화 세션 공유는 계정별 로그인 분리와 별개의 문제다. 안정성을 우선한다면 프로젝트 파일·CLAUDE.md·작업 인계 문서를 공유하는 방식을 추천한다.


이 글은 위키독스 블로그에 처음 실었습니다.

댓글 0

첫 댓글을 남겨 주세요.