본문 바로가기

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

Windows에서 Codex CLI 여러 계정 사용하기: PowerShell 계정 전환과 세션 공유

Codex CLI를 여러 ChatGPT 계정으로 사용할 때마다 로그아웃과 로그인을 반복할 필요는 없다. Windows에서도 CODEX_HOME 환경변수와 PowerShell 함수를 이용하면 공식 Codex CLI 하나로 계정별 인증을 분리하고 cx1, cx2, cx3 명령으로 전환…

Windows에서 Codex CLI 여러 계정 사용하기: PowerShell 계정 전환과 세션 공유 대표 이미지

Codex CLI를 여러 ChatGPT 계정으로 사용할 때마다 로그아웃과 로그인을 반복할 필요는 없다. Windows에서도 CODEX_HOME 환경변수와 PowerShell 함수를 이용하면 공식 Codex CLI 하나로 계정별 인증을 분리하고 cx1, cx2, cx3 명령으로 전환할 수 있다.

이 글은 Windows 11의 PowerShell을 기준으로 설명한다. 별도 AI 코딩 하네스나 비공식 계정 관리 프로그램은 사용하지 않는다. 마지막에는 기존 %USERPROFILE%\.codex\sessions를 여러 계정에서 참조하는 실험적 세션 공유 방법도 다룬다.

주의: 여러 계정은 각 서비스의 약관과 사용량 정책에 맞게 사용해야 한다. 계정별 인증 분리와 세션 파일 공유는 서로 다른 기능이며, 파일을 공유하더라도 다른 계정에서 대화를 정상 재개하거나 해당 계정으로 과금·사용량 집계되는 것은 보장되지 않는다.

1. Codex CLI 설치 확인

PowerShell을 열고 다음을 실행한다.

codex --version

설치되어 있지 않다면 Node.js와 npm을 설치한 뒤:

npm install -g @openai/codex

이 글의 예시는 세 계정을 work, personal, team으로 구분한다. 계정 이름은 필요에 맞게 변경하면 된다.

2. 계정별 CODEX_HOME 생성

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

디렉터리 구조:

%USERPROFILE%\
├── .codex\                 # 기존 Codex 설정 및 세션
├── .codex-work\            # 계정 1
├── .codex-personal\        # 계정 2
└── .codex-team\            # 계정 3

기존 .codex는 삭제하거나 변경하지 않는다.

3. 계정별 로그인

PowerShell에서 각 명령을 개별적으로 실행한다.

$env:CODEX_HOME = Join-Path $HOME '.codex-work'
codex login

$env:CODEX_HOME = Join-Path $HOME '.codex-personal'
codex login

$env:CODEX_HOME = Join-Path $HOME '.codex-team'
codex login

# 이후 기본 환경변수 제거 (기존 기본 Codex 사용에 영향 없도록)
Remove-Item Env:CODEX_HOME -ErrorAction SilentlyContinue

로그인 브라우저에서 매번 의도한 ChatGPT 계정이 선택되었는지 확인한다. 브라우저의 기존 로그인 상태 때문에 같은 계정으로 로그인될 수 있다.

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

PowerShell 프로필 경로를 확인한다.

$PROFILE

프로필 파일이 없으면 생성하고 편집기로 연다.

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

파일 맨 아래에 다음 코드를 추가한다.

# Codex CLI: 계정별 인증 분리
function Invoke-CodexAccount {
    param(
        [Parameter(Mandatory)]
        [string]$Account,
        [Parameter(ValueFromRemainingArguments)]
        [string[]]$CodexArgs
    )

    $previousHome = $env:CODEX_HOME
    try {
        $env:CODEX_HOME = Join-Path $HOME ".codex-$Account"
        & codex @CodexArgs
    }
    finally {
        if ($null -eq $previousHome) {
            Remove-Item Env:CODEX_HOME -ErrorAction SilentlyContinue
        }
        else {
            $env:CODEX_HOME = $previousHome
        }
    }
}

function cxwork     { Invoke-CodexAccount 'work' @args }
function cxpersonal { Invoke-CodexAccount 'personal' @args }
function cxteam     { Invoke-CodexAccount 'team' @args }

# 숫자 단축 명령
function cx1 { cxwork @args }
function cx2 { cxpersonal @args }
function cx3 { cxteam @args }

저장 후 현재 PowerShell에 적용한다.

. $PROFILE

참고: Windows PowerShell 5.1과 PowerShell 7은 $PROFILE 경로가 다를 수 있다. 실제로 Codex를 실행하는 셸에서 위 설정을 수행한다. 실행 정책 때문에 프로필을 불러오지 못하면 조직의 보안 정책을 확인하고, 무작정 실행 정책을 완화하지 않는다.

이제 다음처럼 사용한다.

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

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

함수는 실행하는 동안에만 CODEX_HOME을 변경하고 종료 후 이전 값을 복구한다. 따라서 다른 PowerShell 명령의 환경에 불필요한 영향을 주지 않는다.

5. 동일한 프로젝트에서 계정 전환하기

Set-Location 'C:\dev\example-project'
cx1

Codex를 종료한 뒤 동일 디렉터리에서:

cx2

프로젝트 파일과 Git 변경 사항은 그대로 유지된다. 대화 기록은 기본적으로 각 CODEX_HOME에 분리되므로, 여기까지만 설정하면 기존 대화가 자동으로 이어지지는 않는다.

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

Codex CLI는 일반적으로 CODEX_HOME\sessions에 대화 기록을 저장한다. Windows에서는 디렉터리 정션(junction) 을 이용해 세 계정의 sessions가 기존 %USERPROFILE%\.codex\sessions를 가리키게 만들 수 있다.

%USERPROFILE%\
├── .codex\sessions\            ← 공유 원본 (기존 세션 유지)
├── .codex-work\sessions         ─┐
├── .codex-personal\sessions     ─┼→ .codex\sessions\
└── .codex-team\sessions         ─┘

중요: 이 방식은 공식적인 계정 간 세션 이전 기능이 아니다. Codex 버전에 따라 세션 목록을 관리하는 별도 DB나 인증 상태 때문에 재개가 실패할 수 있다. 또한 auth.json이나 CODEX_HOME 전체를 공유해서는 안 된다.

6.1. 모든 Codex 프로세스 종료

작업 중인 Codex를 모두 정상 종료한다. 세션 파일을 쓰는 중에 링크를 변경하지 않는다.

6.2. 안전한 백업 및 정션 생성

다음 코드를 예를 들어 link-codex-sessions.ps1로 저장한다. 기존 세션 폴더를 삭제하지 않고 백업 디렉터리로 이동한 후 정션을 만든다. 이미 링크가 있거나 예상치 못한 파일이 있으면 중단한다.

$ErrorActionPreference = 'Stop'

$shared = Join-Path $HOME '.codex\sessions'
$accounts = @('work', 'personal', 'team')
$backup = Join-Path $HOME ("codex-sessions-backup-{0}" -f (Get-Date -Format 'yyyyMMdd-HHmmss'))

# 공유 원본이 실제 디렉터리인지 확인
$source = Get-Item -LiteralPath $shared -ErrorAction Stop
if (-not $source.PSIsContainer -or ($source.Attributes -band [IO.FileAttributes]::ReparsePoint)) {
    throw "공유 원본은 일반 디렉터리여야 합니다: $shared"
}

# 모든 대상 경로를 먼저 확인
foreach ($name in $accounts) {
    $homeDir = Join-Path $HOME ".codex-$name"
    if (-not (Test-Path -LiteralPath $homeDir -PathType Container)) {
        throw "계정 디렉터리가 없습니다: $homeDir"
    }
    $target = Join-Path $homeDir 'sessions'
    if (Test-Path -LiteralPath $target) {
        $item = Get-Item -LiteralPath $target -Force
        if ($item.Attributes -band [IO.FileAttributes]::ReparsePoint) {
            throw "이미 링크 또는 정션입니다: $target"
        }
        if (-not $item.PSIsContainer) {
            throw "디렉터리가 아닌 대상이 있습니다: $target"
        }
    }
}

New-Item -ItemType Directory -Path $backup | Out-Null
Copy-Item -LiteralPath $shared -Destination (Join-Path $backup 'original') -Recurse

foreach ($name in $accounts) {
    $homeDir = Join-Path $HOME ".codex-$name"
    $target = Join-Path $homeDir 'sessions'

    if (Test-Path -LiteralPath $target) {
        Move-Item -LiteralPath $target -Destination (Join-Path $backup $name)
    }

    New-Item -ItemType Junction -Path $target -Target $shared | Out-Null
    Write-Host "LINKED: $target -> $shared"
}

Write-Host "백업 위치: $backup"

PowerShell에서 해당 파일을 실행한다.

.\link-codex-sessions.ps1

이 스크립트는 기존 각 계정의 세션을 공유 원본으로 병합하지 않는다. 기존 세션은 백업 폴더에 남는다. 일부 대상에서 정션 생성이 실패하면 이전 단계에서 생성된 정션이 남을 수 있으므로, 출력 내용을 확인하고 아래 복원 절차를 따른다.

6.3. 정션 확인

Get-Item "$HOME\.codex-work\sessions", `
         "$HOME\.codex-personal\sessions", `
         "$HOME\.codex-team\sessions" | `
    Select-Object FullName, LinkType, Target

세 경로의 LinkType이 Junction이고 Target이 기존 .codex\sessions인지 확인한다.

6.4. 세션 재개 테스트

계정 1에서 테스트 대화를 만든 뒤 Codex를 종료한다.

cx1

계정 2에서 기존 세션을 찾아본다.

cx2 resume --all

세션 ID를 알고 있다면:

cx2 resume <SESSION_ID>

세션 목록에 나타나는지뿐 아니라 새 계정의 인증으로 실제 요청이 처리되는지도 확인해야 한다. 재개에 실패하면 이 구성을 실사용에 투입하지 않는 편이 좋다.

6.5. 정션 해제 및 복원

모든 Codex를 종료하고, 스크립트가 출력한 실제 백업 경로를 지정한다.

$backup = Join-Path $HOME 'codex-sessions-backup-YYYYMMDD-HHMMSS' # 수정
$accounts = @('work', 'personal', 'team')

foreach ($name in $accounts) {
    $target = Join-Path $HOME ".codex-$name\sessions"
    if (Test-Path -LiteralPath $target) {
        $item = Get-Item -LiteralPath $target -Force
        if ($item.LinkType -eq 'Junction') {
            # 정션 자체만 제거. 원본 공유 디렉터리는 건드리지 않음.
            $item.Delete()
        }
        else {
            throw "정션이 아닌 대상이 존재합니다: $target"
        }
    }

    $saved = Join-Path $backup $name
    if (Test-Path -LiteralPath $saved -PathType Container) {
        Move-Item -LiteralPath $saved -Destination $target
    }
}

절대 주의: 정션을 해제할 때 Remove-Item -Recurse로 공유 원본 내부 파일을 지우는 방식은 사용하지 않는다. 위 예시는 정션 객체만 삭제한다. 공유를 시작한 후 새로 생성된 세션은 기존 .codex\sessions에 남으므로, 필요한 기록이 있는지 확인한다.

7. 운영 시 주의사항

  • auth.json은 계정별로 분리한다. 인증 토큰을 다른 계정 폴더에 복사하거나 공유하지 않는다.
  • 같은 세션을 여러 Codex 인스턴스에서 동시에 열지 않는다.
  • 세션 파일을 공유해도 대화 재개 및 계정 전환의 정상 동작은 보장되지 않는다.
  • Windows PowerShell과 PowerShell 7의 프로필 경로가 다를 수 있다.
  • Windows Defender, 회사 보안 정책 또는 파일 동기화 소프트웨어가 정션 접근을 제한할 수 있다.
  • CLI를 업데이트한 후에는 로그인 상태와 세션 재개를 다시 검증한다.
  • 장기 작업은 Git 커밋과 작업 요약을 남겨 세션 복구에 대비한다.

마무리

Windows에서 Codex CLI 계정 여러 개를 관리하는 가장 단순한 방법은 CODEX_HOME을 계정별로 분리하고 PowerShell 함수 cx1, cx2, cx3를 등록하는 것이다. 공식 CLI를 그대로 사용할 수 있고 외부 하네스가 필요 없다.

기존 .codex\sessions를 정션으로 공유하는 것은 선택적인 실험적 구성이다. 파일 수준의 공유는 가능하지만 다른 계정에서 대화를 정상 재개할 수 있는지, 실제 요청이 어느 계정으로 처리되는지는 반드시 직접 확인해야 한다.

참고


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

댓글 0

첫 댓글을 남겨 주세요.