macOS에서 Codex CLI 여러 계정 사용하기: 로그인 분리부터 세션 공유까지
Codex CLI를 여러 ChatGPT 계정으로 사용하는 경우, 매번 로그아웃하고 다시 로그인하는 과정이 번거롭다. macOS에서는 CODEX_HOME 환경변수와 zsh 함수만으로 계정별 인증을 분리하고 빠르게 전환할 수 있다.
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
첫 댓글을 남겨 주세요.
Google로 로그인하고 댓글 남기기