A CLI to store and switch between multiple OpenAI Codex accounts — works with the Codex CLI, VS Code extension, and Codex App, with usage state and account aliases.OpenAI Codex 계정을 여러 개 저장해 두고 명령 하나로 전환하는 CLI — Codex CLI·VS Code 확장·Codex App에서 쓰며, 계정별 사용량 조회와 별칭(alias) 관리까지 된다.
A CLI to store and switch between multiple OpenAI Codex accounts — works with the Codex CLI, VS Code extension, and Codex App, with usage state and account aliases.
Use “Copy original” above to copy the complete, unchanged entry. Switch to Korean to read the full curator notes.
한 줄
Codex 계정 여러 개를 등록해 두고 codex-auth switch로 활성 계정을 바꿔 쓰는 도구. 계정마다 사용량 상태를 조회하고, 별칭을 붙이거나 auth 파일을 import/export해 머신 간 이전까지 할 수 있다. claude-swap의 Codex 버전이라고 보면 된다.
EN: Switch the active Codex account interactively, with usage state, aliases, and auth import/export.
언제 쓰는가
Codex 계정을 업무용/개인용 등 여러 개로 나눠 쓰고 빠르게 전환하고 싶을 때
계정별 사용량과 활성 상태를 한눈에 확인하고 싶을 때 (list --live, list --active)
다른 머신으로 계정 자격증명을 옮기거나 백업하고 싶을 때 (import/export)
설치
# 전역 설치npm install -g @loongphy/codex-auth# 설치 없이 한 번만npx @loongphy/codex-auth list
계정 추가를 쉽게 하려면 Codex CLI도 함께 두는 것을 권장: npm install -g @openai/codex
기본 사용
codex-auth login # codex login 실행 후 현재 계정 등록codex-auth list # 저장된 계정·사용량 상태codex-auth list --active # 현재 활성 계정만codex-auth switch # 활성 계정 대화형 전환codex-auth switch 02 # 행 번호로 바로 전환codex-auth alias set 2 work # 계정에 별칭 부여codex-auth import auth.json --alias personal
함정
Codex CLI·App 사용자는 전환 후 클라이언트 재시작 필요 (재시작 없는 자동 전환은 포크 codext 사용)
app 명령은 실험적 — 공식 Codex App 변경에 따라 동작 안 하거나 앱을 깨뜨릴 수 있음
문서는 v0.3.x 기준 — 설치 버전이 낮으면 일부 명령이 없을 수 있다 (@next로 알파 시도, v0.2.x 다운그레이드 시 registry.json의 schema_version 수동 조정)
## 한 줄
Codex 계정 여러 개를 등록해 두고 `codex-auth switch`로 활성 계정을 바꿔 쓰는 도구. 계정마다 사용량 상태를 조회하고, 별칭을 붙이거나 auth 파일을 import/export해 머신 간 이전까지 할 수 있다. claude-swap의 Codex 버전이라고 보면 된다.
*EN: Switch the active Codex account interactively, with usage state, aliases, and auth import/export.*
## 언제 쓰는가
- Codex 계정을 업무용/개인용 등 여러 개로 나눠 쓰고 빠르게 전환하고 싶을 때
- 계정별 사용량과 활성 상태를 한눈에 확인하고 싶을 때 (`list --live`, `list --active`)
- 다른 머신으로 계정 자격증명을 옮기거나 백업하고 싶을 때 (`import`/`export`)
## 설치
```bash
# 전역 설치
npm install -g @loongphy/codex-auth
# 설치 없이 한 번만
npx @loongphy/codex-auth list
```
계정 추가를 쉽게 하려면 Codex CLI도 함께 두는 것을 권장: `npm install -g @openai/codex`
## 기본 사용
```bash
codex-auth login # codex login 실행 후 현재 계정 등록
codex-auth list # 저장된 계정·사용량 상태
codex-auth list --active # 현재 활성 계정만
codex-auth switch # 활성 계정 대화형 전환
codex-auth switch 02 # 행 번호로 바로 전환
codex-auth alias set 2 work # 계정에 별칭 부여
codex-auth import auth.json --alias personal
```
## 함정
- Codex CLI·App 사용자는 전환 후 **클라이언트 재시작** 필요 (재시작 없는 자동 전환은 포크 `codext` 사용)
- `app` 명령은 **실험적** — 공식 Codex App 변경에 따라 동작 안 하거나 앱을 깨뜨릴 수 있음
- 문서는 v0.3.x 기준 — 설치 버전이 낮으면 일부 명령이 없을 수 있다 (`@next`로 알파 시도, v0.2.x 다운그레이드 시 `registry.json`의 `schema_version` 수동 조정)