본문 바로가기

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

macOS에서 Claude Code 여러 계정 사용하기: cl1, cl2, cl3으로 간편하게 전환

별도 도구 없이 CLAUDE_CONFIG_DIR와 zsh 함수만으로 macOS에서 Claude Code 여러 계정을 cl1, cl2, cl3으로 전환하는 방법.

macOS에서 Claude Code 여러 계정 사용하기: cl1, cl2, cl3으로 간편하게 전환 대표 이미지

요약: 별도 하네스나 계정 관리 도구 없이, Claude Code의 CLAUDE_CONFIG_DIR 환경변수와 macOS의 zsh 함수만으로 여러 계정의 로그인 상태를 독립적으로 유지할 수 있다. 계정 간 대화 세션 자체는 자동 공유되지 않는다.

왜 여러 계정을 분리할까?

개인용, 업무용 등 Claude Code 계정을 여러 개 사용하는 경우 매번 로그아웃하고 다시 로그인하는 것은 번거롭다. CLAUDE_CONFIG_DIR를 계정마다 다르게 지정하면 각 계정의 인증 정보, 설정, 대화 기록을 별도 위치에 저장할 수 있다.

이 글에서는 macOS의 기본 셸인 zsh와 공식 Claude Code CLI만 사용한다. 예시 계정은 세 개지만 두 개만 필요하다면 세 번째 설정을 생략하면 된다.

1. 설치 확인

터미널에서 Claude Code가 설치되어 있는지 확인한다.

claude --version

설치되어 있지 않다면 Claude Code 공식 설치 안내를 확인한다. 공식 설치 스크립트를 사용하는 방법은 다음과 같다.

curl -fsSL https://claude.ai/install.sh | bash

설치 스크립트는 실행 전 출처와 내용을 확인하는 것이 좋다.

2. 계정별 설정 디렉터리 준비

기존 ~/.claude는 그대로 두고 새로운 계정용 디렉터리를 만든다.

mkdir -p \
  "$HOME/.claude-account1" \
  "$HOME/.claude-account2" \
  "$HOME/.claude-account3"

구성 예시:

~/
├── .claude/             # 기존 기본 환경 (변경하지 않음)
├── .claude-account1/    # 계정 1
├── .claude-account2/    # 계정 2
└── .claude-account3/    # 계정 3

CLAUDE_CONFIG_DIR는 해당 Claude Code 프로세스에 사용할 설정 디렉터리를 지정한다. 각 디렉터리의 인증 정보와 설정을 서로 복사하지 않는다.

3. zsh 단축 명령 등록

macOS 터미널에서 다음 파일을 편집한다.

nano ~/.zshrc

파일 끝에 다음 함수를 추가한다.

# Claude Code - Multi Account (macOS)

cl1() {
    CLAUDE_CONFIG_DIR="$HOME/.claude-account1" claude "$@"
}

cl2() {
    CLAUDE_CONFIG_DIR="$HOME/.claude-account2" claude "$@"
}

cl3() {
    CLAUDE_CONFIG_DIR="$HOME/.claude-account3" claude "$@"
}

저장 후 적용한다.

source ~/.zshrc

여기서 "$@"는 함수에 전달한 모든 CLI 인수를 원래 형태대로 claude에 전달한다. CLAUDE_CONFIG_DIR=... claude 문법은 해당 명령에만 환경변수를 적용하므로, 터미널 전체의 환경변수를 변경하지 않는다.

4. 각 계정 로그인

각 명령을 차례로 실행하고 서로 다른 Claude 계정으로 로그인한다.

cl1
cl2
cl3

한 계정의 초기 로그인이 끝나면 Claude Code를 종료한 뒤 다음 명령을 실행한다. 브라우저가 기존 계정으로 자동 로그인한다면 브라우저 프로필을 분리하거나 로그인 계정을 확인한다.

Claude Code 내부에서 /status를 입력하면 현재 로그인 및 실행 환경을 확인할 수 있다. 계정이 의도대로 분리되었는지 각각 확인하자.

5. 실제 사용법

같은 프로젝트에서 서로 다른 계정으로 Claude Code를 실행할 수 있다.

cd ~/projects/my-app

cl1  # 계정 1로 작업
cl2  # 계정 2로 작업
cl3  # 계정 3로 작업

기존 세션을 재개하는 명령도 계정별로 동일하다.

cl1 --continue    # 계정 1의 현재 프로젝트 최근 대화 이어가기
cl2 --resume      # 계정 2의 세션 선택
cl3 --resume      # 계정 3의 세션 선택

단, --continue와 --resume은 각 계정의 설정 디렉터리에 저장된 세션을 대상으로 한다. cl1의 대화를 cl2에서 자동으로 이어받는 것은 아니다.

6. Codex CLI와 함께 사용한다면

Codex CLI도 여러 계정으로 분리했다면 명령을 다음처럼 통일할 수 있다.

도구 계정 1 계정 2 계정 3 설정 분리 환경변수
Claude Code cl1 cl2 cl3 CLAUDE_CONFIG_DIR
Codex CLI cx1 cx2 cx3 CODEX_HOME

이 구성은 기존 CLI를 그대로 실행하는 셸 함수일 뿐, 별도 AI 코딩 하네스를 설치하는 방식이 아니다.

7. 계정 간 세션도 공유할 수 있을까?

기본 설정에서는 공유되지 않는다. Claude Code는 프로젝트별 대화 기록을 각 설정 디렉터리의 projects/ 등에 저장할 수 있지만, 버전에 따라 저장 구조와 메타데이터가 달라질 수 있다.

디렉터리를 심볼릭 링크로 연결하는 방식은 가능성을 실험할 수 있으나, 계정 간 세션 재개가 공식적으로 보장되는 기능은 아니다. 대화 이외의 프로젝트 상태까지 공유되거나 충돌할 위험도 있다.

안정성을 우선한다면 다음 방식이 낫다.

  1. 동일한 Git 작업 디렉터리에서 계정별 Claude Code를 실행한다.
  2. 계정을 바꾸기 전에 변경 파일을 확인하고 작업 상태를 커밋하거나 기록한다.
  3. 새 계정에서 CLAUDE.md, Git diff, 테스트 결과와 작업 메모를 참고해 이어간다.
  4. 같은 파일을 여러 Claude Code 인스턴스가 동시에 수정하지 않도록 한다.

프로젝트 파일을 공유하는 것과 대화 세션을 공유하는 것은 별개의 문제다.

8. API 키 환경변수 확인

Claude 구독 계정으로 로그인하려는 경우 API 키 환경변수가 예상치 않게 설정되어 있지 않은지 확인한다.

if [ -n "${ANTHROPIC_API_KEY:-}" ]; then
    echo "ANTHROPIC_API_KEY is set"
else
    echo "ANTHROPIC_API_KEY is not set"
fi

API 키가 설정되어 있다면 인증 방식과 과금 경로에 영향을 줄 수 있다. 구독 로그인만 사용하려는 터미널에서는 필요에 따라 다음처럼 해제한다.

unset ANTHROPIC_API_KEY

API 키 값을 화면이나 블로그에 출력하지 말고, 회사 환경의 관리형 인증 정책이 있다면 해당 정책을 우선한다.

9. 문제 해결

cl1: command not found

~/.zshrc를 저장했는지 확인하고 다시 적용한다.

source ~/.zshrc

type cl1

서로 다른 명령인데 같은 계정으로 로그인된다

각 계정의 CLAUDE_CONFIG_DIR가 서로 다른지 함수 정의를 확인한다.

type cl1
type cl2
type cl3

브라우저의 자동 로그인 계정도 확인한다. 필요하다면 해당 계정의 Claude Code에서 로그아웃하고 올바른 계정으로 다시 로그인한다.

이전 대화가 보이지 않는다

계정별 설정 디렉터리가 분리되어 있으므로 정상일 수 있다. 기존 기본 환경 ~/.claude에 있던 세션은 새 계정 디렉터리에 자동으로 나타나지 않는다.

새 계정에서 설정이나 플러그인이 보이지 않는다

설정 디렉터리도 분리되므로 필요한 설정을 계정별로 구성해야 한다. 인증 파일을 통째로 복사하지 않는다.

10. 보안 및 운영 시 주의사항

  • 각 계정의 인증 파일과 설정 디렉터리를 Git 저장소에 커밋하지 않는다.
  • 개인 계정과 회사 계정의 소스코드·대화·설정은 조직 정책에 맞게 분리한다.
  • 서로 다른 계정으로 사용량 제한을 우회하는 자동화는 관련 서비스 약관과 사용 정책을 확인한다.
  • 로그인 분리는 공식 환경변수 기반이지만, 계정 간 대화 공유나 무중단 전환은 보장되지 않는다.

마무리

macOS에서 Claude Code 계정 여러 개를 사용할 때는 CLAUDE_CONFIG_DIR와 짧은 zsh 함수만으로도 충분하다.

cl1                # 계정 1
cl2                # 계정 2
cl3                # 계정 3

cl1 --continue     # 계정 1 최근 대화 재개
cl2 --resume       # 계정 2 세션 선택
cl3 --version      # Claude Code 버전 확인

로그인은 분리하고, 프로젝트 파일은 필요에 따라 공유한다. 이것이 별도 프로그램 없이 여러 Claude Code 계정을 운용하는 가장 단순한 출발점이다.


참고 자료


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

댓글 0

첫 댓글을 남겨 주세요.