macOS에서 Claude Code 다중 계정 완벽 정복하기: 인증 번거로움 해결부터 자동화까지

claude-codemultiple-accountsmacosoauthclaude-config-dirdirenvapi-keyaccount-switching

개발 업무를 진행하다 보면 회사 업무용 계정과 개인 사이드 프로젝트용 계정을 분리하거나, Claude Code의 토큰 한도(Rate limit) 관리 때문에 여러 개의 Claude 계정을 전환해가며 사용해야 하는 경우가 많습니다.

하지만 Claude Code(claude CLI)는 기본적으로 단일 설정 경로(~/.claude)와 시스템 기본 브라우저 인증을 사용하기 때문에, 계정을 전환할 때마다 매번 브라우저에서 로그아웃/로그인을 반복하는 치명적인 인증 번거로움이 발생합니다.

본 포스트에서는 이러한 인증 마찰을 깔끔하게 해소하고, macOS에서 여러 Claude 계정을 매끄럽게 운용하는 완벽한 가이드를 정리해 드립니다.

1. 인증 번거로움의 원인과 핵심 해결책

왜 자꾸 기존 계정으로 자동 로그인될까?

Claude Code에서 로그인(claude login 또는 /login)을 시도하면 터미널이 기본 브라우저를 자동으로 실행합니다. 이때 브라우저에 이미 특정 계정(예: 개인 계정)으로 세션이 유지되어 있다면, 선택지 없이 기존 계정으로 자동 인증되는 꼬임 현상이 발생합니다.

이 문제를 해결하는 가장 확실한 방법은 두 가지입니다.

해결책 A: 브라우저 프로필(Profile) 분리 + URL 직접 복사 (추천)

기본 브라우저로 자동 열리는 창을 무시하고, 각 계정이 로그인되어 있는 브라우저 프로필을 활용하는 방식입니다.

  1. 브라우저 프로필 생성: 구글 크롬(Chrome), Arc, Edge 등에서 회사용 프로필과 개인용 프로필을 미리 만들어두고 각각의 계정으로 로그인해 둡니다.
  2. 인증 링크 직접 복사: Claude CLI 인증 진행 시 터미널에 표시되는 OAuth 인증 URL을 복사합니다.
  3. 지정 프로필에 붙여넣기: 회사 계정 설정 중이라면 Chrome의 회사용 프로필 창을 열어 해당 URL을 붙여넣고 인증을 완료합니다.

TIP: 터미널에서 브라우저가 자동으로 열리는 것을 원치 않는 경우, 환경 변수 설정이나 시크릿 창(Incognito)을 활용하여 자동 로그인을 방지할 수 있습니다.

해결책 B: API Key 직접 주입 방식 (OAuth 인증 생략)

웹 브라우저를 통한 OAuth 로그인 과정 자체가 귀찮다면, Anthropic Console에서 발급받은 API Key를 환경 변수로 직접 주입하여 인증 과정을 아예 패스할 수 있습니다.

  • 각 계정의 Anthropic Console에서 API Key 발급
  • 셸 설정 파일(~/.zshrc)에 계정별 API Key를 환경 변수로 등록
# OAuth 로그인 절차 없이 API 키로 즉시 인증
export ANTHROPIC_API_KEY="sk-ant-api03-..."

2. macOS 다중 계정 설정 실전 가이드

Claude Code는 공식적으로 CLAUDE_CONFIG_DIR 환경 변수를 지원합니다. 이 변수를 활용하면 계정별로 독립된 설정 폴더를 지정할 수 있습니다.

방법 1: Shell Alias 조합 (가장 깔끔하고 권장하는 방식)

터미널 탭별로 서로 다른 계정을 동시에 띄워두고 사용할 수 있는 최적의 방법입니다.

1단계: 계정별 독립 디렉터리 생성

mkdir -p ~/.claude-work
mkdir -p ~/.claude-personal

2단계: ~/.zshrc 파일에 Alias 및 인증 세팅 등록

zsh 설정 파일(~/.zshrc)을 열고 아래 코드를 추가합니다.

# ~/.zshrc 하단에 추가

# [회사 계정]
alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'

# [개인 계정]
alias claude-personal='CLAUDE_CONFIG_DIR=~/.claude-personal claude'

변경 사항을 적용합니다.

source ~/.zshrc

3단계: 계정별 최초 1회 인증 (트러블슈팅 반영)

  • 회사 계정 최초 인증:
    1. 터미널에 claude-work 입력 후 실행
    2. /login 입력 후 터미널에 출력되는 인증 URL 복사
    3. 회사 계정이 로그인되어 있는 브라우저(회사용 프로필)에 URL 붙여넣기 후 승인
  • 개인 계정 최초 인증:
    1. 새 터미널 탭에서 claude-personal 입력 후 실행
    2. /login 입력 후 터미널에 출력되는 인증 URL 복사
    3. 개인 계정이 로그인되어 있는 브라우저(개인용 프로필)에 URL 붙여넣기 후 승인

결과: 최초 1회만 설정해 두면, 이후에는 claude-work와 claude-personal 명령어로 재인증 없이 각각의 계정 세션을 즉시 불러올 수 있습니다.

방법 2: direnv를 활용한 프로젝트별 자동 계정 전환

특정 디렉터리(폴더)에 이동(cd)하기만 하면 해당 프로젝트에 맞는 계정이 자동으로 로드되도록 만드는 방법입니다.

  1. direnv 설치 및 셸 등록:
brew install direnv
echo 'eval "$(direnv hook zsh)"' >> ~/.zshrc
source ~/.zshrc
  1. 회사 프로젝트 폴더에 .envrc 파일 생성:
cd ~/projects/company-project
echo "export CLAUDE_CONFIG_DIR=$HOME/.claude-work" > .envrc
direnv allow
  1. 작동 확인:

해당 폴더로 이동하면 direnv: loading .envrc 메시지와 함께 자동으로 회사 계정 환경이 적용됩니다. 이제 그냥 claude만 입력해도 회사 계정으로 작동합니다.

방법 3: 다중 계정 스위처 도구 활용 (사용량 모니터링 포함)

터미널 명령어 구분이 번거롭거나 실시간 사용 한도(Rate Limit) 모니터링이 필요한 경우 오픈소스 스위처를 활용할 수 있습니다.

① Claude Switcher (macOS 상단 메뉴바 앱)

  • 설치: brew install --cask Symbioose/tap/claude-switcher
  • 특징: macOS 상단 메뉴바에서 클릭 한 번으로 계정을 전환할 수 있으며, 5시간/7일 사용량 한도를 시각적으로 보여줍니다. 세션 한도 초과 시 등록된 다음 계정으로 자동 전환(Auto-switch)하는 기능도 갖추고 있습니다.

② claude-swap (CLI 전용 스위처)

  • 설치: uv tool install claude-swap (또는 pipx install claude-swap)
  • 특징: cswap add [계정이름]으로 계정을 등록한 뒤 cswap switch로 손쉽게 계정을 교체합니다.

3. 요약 및 방식별 비교

구현 방식인증 번거로움 해소 방식추천 대상 및 유즈케이스
Shell Alias + 프로필 분리계정별 지정 브라우저 프로필에 URL 복사/붙여넣기터미널 탭마다 서로 다른 계정을 동시에 띄워두고 싶을 때
API Key 주입 방식OAuth 로그인 과정 자체를 생략 (ANTHROPIC_API_KEY)브라우저 인증 과정 없이 깔끔하게 API 기반으로 쓰고 싶을 때
direnv 자동 전환폴더 진입 시 해당 계정 환경 변수 자동 적용회사/개인 프로젝트 폴더가 명확히 구분되어 있을 때
메뉴바/CLI 스위처키체인 저장 세션 교체 및 자동 로테이션토큰 한도 초과(Rate Limit) 대응 및 사용량 모니터링이 필요할 때

💡 한 줄 요약

Claude Code의 다중 계정 핵심은 CLAUDE_CONFIG_DIR 디렉터리 분리와 웹 브라우저 프로필을 맞춘 OAuth URL 직접 붙여넣기입니다. 위 가이드 중 자신에게 맞는 워크플로우를 선택해 세팅해 두면 계정 전환 스트레스 없이 쾌적하게 개발에 집중할 수 있습니다.

Related