본문 바로가기

← Insights 공유 · 4분 · 읽음 17 · 추천 0 · 댓글 0

macOS에서 Codex CLI 여러 계정 사용하기: 로그인 분리부터 세션 공유까지

Codex CLI를 여러 ChatGPT 계정으로 사용하는 경우, 매번 로그아웃하고 다시 로그인하는 과정이 번거롭다. macOS에서는 CODEX_HOME 환경변수와 zsh 함수만으로 계정별 인증을 분리하고 빠르게 전환할 수 있다.

macOS에서 Codex CLI 여러 계정 사용하기: 로그인 분리부터 세션 공유까지 대표 이미지

Codex CLI를 여러 ChatGPT 계정으로 사용하는 경우, 매번 로그아웃하고 다시 로그인하는 과정이 번거롭다. macOS에서는 CODEX_HOME 환경변수와 zsh 함수만으로 계정별 인증을 분리하고 빠르게 전환할 수 있다.

이 글에서는 공식 Codex CLI만 사용한다. 별도의 AI 코딩 하네스나 서드파티 계정 관리 프로그램은 설치하지 않는다. 마지막에는 기존 ~/.codex/sessions를 여러 계정에서 참조하는 실험적인 세션 공유 방식도 소개한다.

주의: 여러 계정을 사용하는 경우 각 서비스의 이용 약관과 사용량 정책을 준수해야 한다. 이 글의 구성은 계정 관리 편의를 위한 것이며, 사용량 제한을 우회하는 동작이나 계정 간 대화 재개의 성공을 보장하지 않는다.

1. 사전 준비

macOS의 기본 셸인 zsh를 기준으로 설명한다.

codex --version

Codex CLI가 없다면 Node.js와 npm을 준비한 뒤 설치한다.

npm install -g @openai/codex

기존에 사용하던 ~/.codex는 보존한다. 예시에서는 세 개의 계정을 work, personal, team으로 구분한다. 실제 계정 이름에 맞게 바꾸면 된다.

2. 계정별 CODEX_HOME 생성

mkdir -p \
  "$HOME/.codex-work" \
  "$HOME/.codex-personal" \
  "$HOME/.codex-team"

예상 구조는 다음과 같다.

~/
├── .codex/             # 기존 Codex 환경 및 세션 저장소
├── .codex-work/        # 계정 1
├── .codex-personal/    # 계정 2
└── .codex-team/        # 계정 3

각 디렉터리에는 독립적인 로그인 상태와 설정을 유지한다.

3. 계정별 로그인

각 명령을 순서대로 실행하고, 브라우저에서 서로 다른 ChatGPT 계정으로 로그인한다.

CODEX_HOME="$HOME/.codex-work" codex login
CODEX_HOME="$HOME/.codex-personal" codex login
CODEX_HOME="$HOME/.codex-team" codex login

브라우저에서 기존 계정이 자동 선택된다면 별도 브라우저 프로필을 이용한다. 로그인 상태는 다음과 같이 확인한다.

CODEX_HOME="$HOME/.codex-work" codex login status
CODEX_HOME="$HOME/.codex-personal" codex login status
CODEX_HOME="$HOME/.codex-team" codex login status

login status는 로그인 여부를 확인하는 용도다. 출력만으로 세 계정의 실제 신원이 서로 다른지 확정할 수 있는 것은 아니므로 최초 로그인 시 브라우저 계정을 확인하자.

4. zsh 함수로 짧게 실행하기

~/.zshrc에 다음 함수를 추가한다.

# Codex CLI: 계정별 실행
cxwork() {
    CODEX_HOME="$HOME/.codex-work" codex "$@"
}

cxpersonal() {
    CODEX_HOME="$HOME/.codex-personal" codex "$@"
}

cxteam() {
    CODEX_HOME="$HOME/.codex-team" codex "$@"
}

# 숫자 단축 명령
cx1() { cxwork "$@"; }
cx2() { cxpersonal "$@"; }
cx3() { cxteam "$@"; }

적용한다.

source ~/.zshrc

이제 원하는 계정을 바로 실행할 수 있다.

cx1                     # Work 계정
cx2                     # Personal 계정
cx3                     # Team 계정

cx1 login status
cx2 resume --last
cx3 --help

함수에서 "$@"를 사용하므로 CLI 옵션이 그대로 전달된다. 또한 CODEX_HOME=... codex 형태는 현재 셸의 환경변수를 영구적으로 바꾸지 않는다.

5. 같은 프로젝트에서 계정 전환하기

cd ~/projects/example
cx1

작업을 종료한 뒤 같은 디렉터리에서 다른 계정을 실행한다.

cx2

프로젝트의 소스코드와 Git 작업 트리는 그대로다. 그러나 기본적으로 대화 세션은 계정별 CODEX_HOME에 저장되므로 자동으로 이어지지 않는다. 계정 간에 대화 내용을 넘겨야 한다면 작업 요약을 작성해 새 세션에 전달하는 방식이 가장 예측 가능하다.

6. 선택 사항: 기존 ~/.codex/sessions 공유하기 (실험적)

Codex CLI는 일반적으로 CODEX_HOME/sessions에 세션 파일을 저장한다. 각 계정의 sessions 경로를 기존 ~/.codex/sessions로 연결하면 동일한 세션 파일을 참조하도록 구성할 수 있다.

단, 이는 공식적인 계정 간 세션 이전 기능이 아니다. Codex 버전에 따라 세션 인덱스·상태 DB·인증 캐시 등이 별도로 관리될 수 있고, 다른 계정에서 resume이 실패하거나 원래 계정의 인증을 사용할 가능성도 있다. 실제로 사용량이 어느 계정에 반영되는지 별도로 확인해야 한다.

6.1. 실행 중인 Codex 종료 및 백업

모든 Codex CLI 프로세스를 종료한 후 아래 스크립트를 실행한다. 기존 디렉터리는 삭제하지 않고 이동하여 보관한다. 이미 링크가 있거나 대상 경로가 예상과 다르면 덮어쓰지 않고 중단한다.

cat > /tmp/codex-link-sessions.sh <<'SCRIPT'
#!/bin/bash
set -euo pipefail

shared="$HOME/.codex/sessions"
accounts=(work personal team)
backup="$HOME/codex-sessions-backup-$(date +%Y%m%d-%H%M%S)"

if [[ ! -d "$shared" || -L "$shared" ]]; then
  echo "ERROR: 일반 디렉터리인 $shared 가 필요합니다." >&2
  exit 1
fi

# 모든 경로를 먼저 검사해 중간 실패 가능성을 줄인다.
for name in "${accounts[@]}"; do
  home="$HOME/.codex-$name"
  target="$home/sessions"
  [[ -d "$home" ]] || { echo "ERROR: $home 없음" >&2; exit 1; }
  [[ ! -L "$target" ]] || { echo "ERROR: $target 은 이미 링크" >&2; exit 1; }
  if [[ -e "$target" && ! -d "$target" ]]; then
    echo "ERROR: $target 이 디렉터리가 아님" >&2
    exit 1
  fi
done

mkdir -p "$backup"
ditto "$shared" "$backup/original"

for name in "${accounts[@]}"; do
  home="$HOME/.codex-$name"
  target="$home/sessions"
  if [[ -d "$target" ]]; then
    mv "$target" "$backup/$name"
  fi
  ln -s "$shared" "$target"
  echo "$target -> $shared"
done

echo "백업 위치: $backup"
SCRIPT

bash /tmp/codex-link-sessions.sh

이 스크립트는 기존 계정별 세션을 공유 디렉터리로 병합하지 않는다. 각각의 이전 세션은 백업 디렉터리에 보관된다. ~/.codex/sessions가 없으면 먼저 기존 Codex 환경에서 세션을 생성하거나 경로를 확인해야 한다.

6.2. 링크 확인

ls -ld \
  ~/.codex-work/sessions \
  ~/.codex-personal/sessions \
  ~/.codex-team/sessions

모두 ~/.codex/sessions의 실제 절대 경로를 가리켜야 한다.

6.3. 세션 재개 테스트

테스트용 Git 프로젝트에서 계정 1로 대화를 생성하고 종료한다.

cx1

그다음 계정 2에서 세션 목록을 확인한다.

cx2 resume --all

목록에 없으면 원래 세션 ID를 이용한 직접 재개를 시험한다.

cx2 resume <SESSION_ID>

성공 여부는 대화가 보이는지뿐 아니라 새 계정으로 실제 요청이 처리되는지까지 확인해야 한다. resume --last는 각 버전의 세션 검색 동작에 따라 원하는 세션을 고르지 못할 수 있으므로, 처음에는 명시적인 세션 ID를 추천한다.

6.4. 문제가 생기면 복원

모든 Codex를 종료하고, 위 스크립트가 출력한 백업 디렉터리를 확인한다. 예를 들어 ~/codex-sessions-backup-YYYYMMDD-HHMMSS에 백업이 있다면 다음처럼 복원한다.

BACKUP="$HOME/codex-sessions-backup-YYYYMMDD-HHMMSS"  # 실제 경로로 수정

for name in work personal team; do
  target="$HOME/.codex-$name/sessions"
  if [[ -L "$target" ]]; then
    rm "$target"  # 링크만 삭제하며 공유 원본은 삭제하지 않음
  fi
  if [[ -d "$BACKUP/$name" && ! -e "$target" ]]; then
    mv "$BACKUP/$name" "$target"
  fi
done

공유 시작 후 생성된 세션은 ~/.codex/sessions에 남아 있다. 복원 전에 필요한 새 세션이 있는지 확인하자.

7. 운영 시 주의사항

  • auth.json 또는 CODEX_HOME 전체를 계정 간 공유하지 않는다. 인증 정보는 각 계정에 독립적으로 유지한다.
  • 동일한 세션을 여러 Codex 프로세스에서 동시에 열지 않는다. 세션 파일이나 상태 DB가 충돌할 수 있다.
  • sessions 심볼릭 링크는 파일 접근을 공유할 뿐, 계정 간 세션 이전을 보장하지 않는다.
  • config.toml의 모델, MCP, 신뢰 설정 등은 계정마다 다를 수 있다. 필요한 설정만 검토해 적용한다.
  • CLI 업데이트 후에는 resume 동작과 인증 계정을 다시 검증한다.
  • 장시간 작업은 Git 커밋과 작업 요약 파일로 복구 가능하게 만든다.

마무리

가장 단순하고 안정적인 부분은 CODEX_HOME을 계정별로 나누고 cx1, cx2, cx3 함수로 전환하는 것이다. 이 방식은 Codex CLI 자체를 교체하지 않으며, 별도 하네스를 요구하지 않는다.

반면 계정 간 세션 공유는 실험적이다. 기존 ~/.codex/sessions를 심볼릭 링크로 연결하면 파일은 공유되지만, 인증 전환과 세션 재개가 현재 CLI 버전에서 실제로 작동하는지 반드시 검증해야 한다.

참고


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

댓글 0

첫 댓글을 남겨 주세요.