ndycode/codex-multi-auth

codex-multi-auth: 공식 Codex CLI를 위한 다중 계정 OAuth

codex-multi-auth는 공식 @openai/codex CLI를 위한 다중 계정 OAuth 관리자입니다. Codex CLI 사용자에게 명시적인 ChatGPT 계정 로그인, 계정 전환, 상태 확인, 로컬 진단, 프로젝트 범위 저장소, 그리고 기본 활성화된 런타임 Responses 순환을 제공하며, 공식 codex 바이너리를 대체하지 않습니다. 계정 관리에는 codex-multi-auth...를 사용하고, 선택적 포워딩 래퍼를 의도적으로 사용할 때만 codex-multi-auth-codex...를 사용하세요.

계정 상태를 시각적으로 확인할 수 있고, 더 안전한 복구 명령어, 그리고 요청을 전달하는 Codex 세션을 위한 루프백 전용 런타임 순환 프록시가 필요한 로컬 Codex CLI 다중 계정 워크플로우가 필요할 때 사용하세요.

[!NOTE]

레거시 스코프 프리릴리스 패키지 @ndycode/codex-multi-auth는 마이그레이션 전용입니다.

모든 새 설치에는 codex-multi-auth를 사용하세요.

제공 기능

• 전용 codex-multi-auth... 명령어 모음을 통한 Codex CLI 다중 계정 OAuth 관리
• 명시적인 ChatGPT 계정 로그인, 저장된 계정 목록, 계정 전환, 상태 확인, 진단
• 래퍼를 통해 세션을 시작할 때 선택적으로 사용할 수 있는 공식 Codex CLI 명령어를 위한 codex-multi-auth-codex... 포워딩 래퍼
• 상태 인식 계정 선택, 할당량 예측, 자동 장애 조치, 플래그된 계정 복구
• ~/.codex/multi-auth/projects/<project-key>/... 아래의 프로젝트 범위 계정 저장소 (저장소별 워크플로우)
• 계정 작업, 설정, 검색, 단축키를 위한 대화형 터미널 대시보드
• 운영 신뢰도를 위한 Forecast, Report, Fix, Doctor, Verify, Monitor, Rotation 명령어
• 로컬 사용 원장, 예산 가드, 계정 정책 제어, 라우팅 프로필, 모델/계정 기능 보기
• codex-multi-auth status / codex-multi-auth report의 런타임 카운터, 예산/쿨다운 상태, 다중 인증 프로브 가시성
• 전달된 Codex CLI/앱 세션 내에서 실시간 계정 순환을 위한 기본 활성화 루프백 Responses 프록시
• 해시된 로컬 클라이언트 토큰으로 보호되는 /health, /v1/models, /v1/responses를 위한 선택적 루프백 전용 로컬 브리지
• 공식 앱 바이너리를 패치하지 않는 되돌릴 수 있는 패키지된 Codex 앱 바인드 및 사용자 수준 런처 라우팅 도우미
• 세션 선호도, 실시간 계정 동기화, 사전 새로고침, 선제적 할당량 연기 제어
• 엄격한 런타임 처리와 문서화된 오류 계약을 갖춘 Codex 지향 요청/프롬프트 호환성
• 설치, 구성, 문제 해결, 업그레이드, 공개 API, 저장소 경로, 릴리스 노트에 대한 안정적인 문서

개발자가 사용하는 이유

codex-multi-auth는 로컬 Codex 계정 상태를 시각적으로 확인하고 복구할 수 있게 만듭니다. 하나의 불투명한 인증 파일 대신, 명명된 계정 풀, 결정론적 계정 전환, 상태 인식 선택, 자동화를 위한 JSON 진단, 그리고 오래되었거나 손상된 로컬 상태를 위한 안전한 복구 명령어를 제공합니다. 아키텍처는 개인 개발 워크플로우를 위해 설계되었습니다: 자격 증명은 로컬에 유지되고, 런타임 순환은 루프백 전용이며, 공식 Codex 설치 경로가 codex 명령어를 계속 소유합니다.

현재 아키텍처 개요

codex-multi-auth는 이제 세 가지 별개의 글로벌 바이너리를 제공합니다:

이 패키지는 글로벌 codex 바이너리를 게시하지 않습니다. codex를 공식 OpenAI 설치 경로가 소유하도록 유지하고, 이 패키지의 포워딩 래퍼를 의도적으로 사용할 때만 codex-multi-auth-codex...를 사용하세요.

<details open> <summary><b>약관 및 사용 고지</b></summary>

[!CAUTION]

이 프로젝트는 OAuth 계정 자격 증명을 사용하며 개인 개발 용도로만 사용해야 합니다.

>

이 패키지를 사용함으로써 다음을 인정합니다:

- 이는 독립적인 오픈 소스 프로젝트이며, 공식 OpenAI 제품이 아닙니다.

- 사용 및 정책 준수에 대한 책임은 사용자에게 있습니다.

- 프로덕션/상업용 워크로드의 경우 OpenAI Platform API를 사용하세요.

</details>

설치

<details open> <summary><b>사용자용</b></summary>

옵션 A: 표준 설치

npm i -g codex-multi-auth

옵션 B: 레거시 스코프 프리릴리스에서 마이그레이션

npm uninstall -g @ndycode/codex-multi-auth
npm i -g codex-multi-auth

옵션 C: 연결 확인

codex --version은 공식 Codex CLI에 접근 가능한지 확인합니다. codex-multi-auth --version은 설치된 관리자 패키지 버전을 확인합니다. codex-multi-auth-codex --version은 선택적 포워딩 래퍼 진입점입니다.

codex --version
codex-multi-auth --version
codex-multi-auth status

codex가 PATH에 있기만 하면 공식 설치 경로는 무엇이든 괜찮습니다: npm i -g @openai/codex, brew install --cask codex, 또는 공식 릴리스 바이너리.

</details>

<details> <summary><b>LLM 에이전트용</b></summary>

단계별

1. 글로벌 패키지 설치:

• npm i -g codex-multi-auth

1. codex-multi-auth login으로 첫 로그인 흐름 실행
2. codex-multi-auth status 및 codex-multi-auth check로 상태 확인
3. codex-multi-auth forecast --live로 라우팅 확인

확인

codex-multi-auth status
codex-multi-auth check

</details>

빠른 시작

설치 및 로그인:

npm i -g @openai/codex
npm i -g codex-multi-auth
codex-multi-auth login

이미 Homebrew 또는 릴리스 바이너리를 통해 공식 네이티브 CLI를 설치했다면, 다음만 필요합니다:

npm i -g codex-multi-auth
codex-multi-auth login

관리자와 새 계정 확인:

codex-multi-auth status
codex-multi-auth check

다음 명령어 사용:

codex-multi-auth list
codex-multi-auth switch 2
codex-multi-auth forecast --live

브라우저 실행이 차단된 경우, docs/getting-started.md의 대체 로그인 경로를 사용하세요. 원격 또는 헤드리스 셸의 경우 codex-multi-auth login --device-auth를 선호합니다.

명령어 도구 모음

여기서 시작

일상 사용

복구

고급

안정성 동작

• 모든 계정이 속도 제한에 걸렸을 때 전체 풀 재시도는 기본적으로 비활성화됨
• 활성 요청은 제한된 아웃바운드 요청 예산을 사용하여 하나의 프롬프트가 전체 풀을 무한정 순회하지 못하도록 함
• 반복적인 계정 간 5xx 버스트는 공격적인 순환을 계속하는 대신 짧은 쿨다운을 트리거함
• 사전 새로고침은 백그라운드 새로고침 버스트를 줄이기 위해 분산됨
• codex-multi-auth status는 텍스트 출력에 최근 런타임 요청 메트릭을 표시하고, codex-multi-auth report --json은 기계 판독 가능한 쿨다운/런타임 스냅샷을 노출함

대시보드 단축키

메인 대시보드

계정 세부 정보

저장소 경로

CODEXMULTIAUTH_DIR=<path>로 루트를 재정의할 수 있습니다.

구성

• ~/.codex/multi-auth/settings.json
• 또는 사용자 정의 루트가 설정된 경우 CODEXMULTIAUTH_DIR/settings.json

기본 구성 루트:

선택된 런타임/환경 재정의:

변경 후 구성 확인:

codex-multi-auth status
codex-multi-auth check
codex-multi-auth forecast --live

Responses 백그라운드 모드는 옵트인 상태로 유지됩니다.