AI 해결 노트 · 2026-09-17 · 실측 2026-09-17

Codex CLI 로그인 상태 확인하기 — codex login status와 사용량 보는 곳(/status, /usage)

한 줄로

로그인 여부는 codex login status 한 줄로 확인됩니다. 저희 PC에서는 Logged in using ChatGPT가 나왔습니다. 사용량은 대화 화면 안의 /status, /usage로 보도록 공식 문서에 적혀 있고, 확인한 도움말에는 사용량 명령이 없었습니다.

이 PC의 ~/.codex에서는 auth.json이라는 파일 이름을 확인했습니다. 내용과 실제 인증 저장 위치는 확인하지 않았습니다.

이런 분께

codex가 로그인된 상태인지, 어떤 방식으로 로그인됐는지 확인하고 싶은 분
로그인을 다시 하기 전에 지금 상태부터 보고 싶은 분
남은 사용량을 어디서 보는지 찾는 분

실측 환경

항목	값
OS	Windows 11 Home (10.0.26200)
셸	Git Bash
codex	`codex-cli 0.153.4`
`CODEX_HOME` 환경변수	미설정이거나 빈 값(`CODEX_HOME=unset` 출력)
로그인 방식	ChatGPT 계정 (아래 출력 기준)

codex login과 codex logout은 이 글을 쓰면서 한 번도 실행하지 않았습니다.

1. 도움말에서 상태 확인 명령 찾기

codex --help의 명령 목록에 로그인 관련 줄이 두 개 있습니다.

  login             Manage login
  logout            Remove stored authentication credentials

codex login --help의 하위 명령 목록에는 status와 help가 있습니다.

Usage: codex login [OPTIONS] [COMMAND]

Commands:
  status  Show login status
  help    Print this message or the help of the given subcommand(s)

같은 도움말에는 로그인 방법 옵션으로 --with-api-key, --with-access-token, --device-auth가 보입니다. codex login은 로그인을 관리하는 명령이라, 상태만 볼 때는 status를 꼭 붙여 치는 것이 안전합니다(옵션 없이 쳤을 때의 동작은 이번에 돌려 보지 않았습니다).

2. `codex login status` 실행

codex login status

Logged in using ChatGPT

종료 코드는 0이었습니다. 계정 이메일은 출력되지 않았습니다. 기록을 보면 표준출력은 비어 있고, 이 문구는 표준오류(stderr) 쪽에 찍혔습니다. 그러니 스크립트에서 codex login status > status.txt처럼 표준출력만 받으면 문구를 놓치게 됩니다(이 형태로 따로 돌려 보지는 않았습니다). 2>&1을 붙이거나 종료 코드로 판단하세요.

로그인하지 않은 codex에서는 어떻게 나오는지도 봤습니다. WSL Ubuntu에 임시로 깐 codex 0.154.0에서 같은 명령을 돌린 결과입니다. 설치 과정과 버전 확인은 Codex CLI WSL(Ubuntu) 설치에 적었습니다.

Not logged in

이때 종료 코드는 1이었습니다. 이번 기록에서는 로그인된 윈도우 환경에서 0, 로그인되지 않은 WSL 환경에서 1이 나왔습니다. 다른 실패 상황(네트워크 오류 등)의 종료 코드는 확인하지 않았습니다.

3. 더 넓게 보는 `codex doctor`

codex --help에는 doctor Diagnose local Codex installation, config, auth, and runtime health도 있습니다. 요약만 보는 옵션으로 돌렸습니다.

codex doctor --summary --no-color --ascii

인증과 관련된 줄은 이렇게 나왔습니다(전체 출력 중 일부).

Configuration
  [ok] config       loaded
  [ok] auth         auth is configured
  [ok] mcp          1 server (1 stdio) · 0 disabled
...
Connectivity
  [ok] network      no proxy env vars
  [ok] websocket    connected (HTTP 101 Switching Protocols) · 15s timeout
  [ok] reachability active provider endpoints are reachable over HTTP
...
22 ok | 1 idle | 3 notes | 1 warn | 0 fail degraded

auth is configured는 인증 정보가 있다는 뜻까지만 알려 줍니다. 로그인 방식은 codex login status 쪽이 더 분명했습니다. doctor에는 --json(Emit a redacted machine-readable report) 옵션도 있지만 이번에는 쓰지 않았습니다.

4. 인증 파일은 어디에 있나

도움말은 설정 파일 위치를 ~/.codex/config.toml로, 프로필 파일 위치를 $CODEX_HOME/<name>.config.toml로 적고 있습니다. 이 PC는 CODEX_HOME이 설정되지 않았거나 빈 값이어서 홈 폴더의 .codex를 봤습니다. 이 PC의 ~/.codex를 이름만 나열했고, 파일 내용은 열지 않았습니다.

ls -1Ap "$HOME/.codex"

인증과 설정에 해당하는 이름만 추리면 이렇습니다.

auth.json
auth.json.bak_20260908
config.toml
config.toml.bak-20260804
installation_id
version.json

그 밖에 sessions/, log/, history.jsonl, 여러 .sqlite 파일 등이 같은 폴더에 있었습니다. auth.json이 로그인 정보가 저장되는 파일로 보입니다(이름으로 판단했고 내용은 확인하지 않음). auth.json.bak_20260908이라는 이름도 보였습니다. 누가 만들었는지와 내용은 확인하지 않았으니, 인증 정보가 들어 있을 수 있다고 보고 다루는 편이 안전합니다. 이 폴더를 통째로 공유하거나 다른 PC로 복사하지 마세요.

5. 사용량은 어디서 보나

codex --help, codex login --help에는 사용량이나 요금 한도를 보여 주는 명령이 없었습니다. 공식 문서의 슬래시 명령 목록에 해당 항목이 있습니다.

https://developers.openai.com/codex/cli/slash-commands → https://learn.chatgpt.com/docs/developer-commands?surface=cli 로 이동(2026-09-17 확인). 문서 원문:

/status Display session configuration and token usage. Confirm the active model, approval policy, writable roots, and remaining context capacity.
/usage View account token usage or use a rate-limit reset. Inspect daily, weekly, or cumulative ChatGPT token activity from inside the TUI.

같은 페이지에서 /status Show the chat ID, context usage, and rate limits.라는 문구도 나왔습니다. 어느 화면용 목록인지는 이번에 뽑은 발췌만으로는 알 수 없습니다.

정리하면, codex를 인자 없이 실행해 대화 화면(TUI)을 연 다음 /status나 /usage를 입력하는 방식입니다. 이번에는 대화 화면을 열지 않았으므로 두 명령의 실제 출력은 싣지 않습니다.

결과

확인 방법	이 PC 결과	비고
`codex login status`	`Logged in using ChatGPT`, 종료 코드 0	stderr로 출력
같은 명령, 로그인 안 된 WSL codex	`Not logged in`, 종료 코드 1	WSL 설치 글의 기록
`codex doctor --summary`	`[ok] auth auth is configured`	22 ok, 0 fail
`~/.codex`	`auth.json`, `config.toml` 등 존재	이름만 확인
사용량	확인한 `codex --help`, `codex login --help`에는 사용량 명령이 없음. 공식 문서에는 TUI의 `/status`, `/usage`	실행 안 함

실패한 것

사용량 숫자는 얻지 못했습니다. 대화 화면을 여는 방식이라 이번 실측 범위(비대화형)에서 빠졌습니다.

확인하지 않은 것

/status, /usage의 실제 화면과 숫자는 보지 않았습니다.
API 키 방식(--with-api-key)으로 로그인한 경우 codex login status가 어떤 문구를 내는지 확인하지 않았습니다.
auth.json의 내용과 구조는 열어 보지 않았습니다.
codex doctor --json 출력과, 가려진(redacted) 항목이 무엇인지는 확인하지 않았습니다.
맥·리눅스, codex 0.153.4 외 버전의 login status 문구는 확인하지 않았습니다(리눅스는 로그인 안 된 경우만 봄).