[VS Code/Antigravity] 코덱스(Codex) 계정 2개 한 클릭으로 전환하기: Codex Account Switch 사용법

BynMaster

개발 작업이나 프로젝트를 진행할 때 AI 코딩 보조 도구인 코덱스(Codex)를 활용하다 보면, 주간 사용량 한도(Quota)에 빠르게 도달하여 개발 작업 흐름이 갑작스럽게 끊기는 경험을 자주 하게 됩니다. 이러한 한도 제약을 극복하고 연속적인 개발 환경을 유지하기 위해 2개 이상의 Codex 계정을 병행하여 운용하는 개발자들이 늘어나고 있습니다.

하지만 계정을 전환할 때마다 기존 계정에서 로그아웃하고 새 계정으로 로그인하는 과정을 반복하는 것은 상당한 번거로움과 시간 소모를 유발합니다. 이번 글에서는 VS Code 및 Google Antigravity IDE 환경에서 사이드바 클릭 한 번으로 간편하게 Codex 계정을 스위칭하고, 실시간 잔여 토큰 한도까지 모니터링할 수 있는 Codex Account Switch 확장 프로그램의 핵심 기능과 상세 사용법을 안내해 드립니다.

1. Codex Account Switch 확장 프로그램 개요 및 필요성

Codex Account Switch는 VS Code 및 Google Antigravity IDE 내부에서 복수의 Codex 계정을 효율적이고 안전하게 관리할 수 있도록 지원하는 전용 개발자 확장 프로그램입니다.

기존에는 계정별 잔여 한도를 확인하거나 계정을 교체하려면 시스템 터미널을 통해 일일이 인증 명령어를 입력해야 하는 불편함이 있었습니다. Codex Account Switch를 활용하면 IDE 좌측 액티비티 바(Activity Bar)에 전용 뷰가 추가되어, 저장된 계정 목록과 프로바이더 정보를 한눈에 조회할 수 있으며 클릭 한 번으로 활성 계정을 즉시 스위칭할 수 있습니다.

2. Codex Account Switch 5가지 핵심 주요 기능

Codex Account Switch 확장 프로그램이 제공하는 강력한 5가지 핵심 기능은 다음과 같습니다.

  • 사이드바(Activity Bar) 전용 뷰 제공: 저장된 모든 Codex 계정과 연동된 프로바이더 목록을 체계적으로 시각화하여 보여줍니다. 현재 활성화되어 있는 계정 정보는 물론, 계정별 이메일 주소, 요금제 플랜, 잔여 주간 Quota(할당량)를 한자리에서 빠르게 조회할 수 있습니다.
  • 실시간 Quota 모니터링 및 자동 리프레시: 계정 목록 뷰와 하단 상태 표시줄(Status Bar)을 통해 잔여 한도를 실시간으로 모니터링합니다. 백그라운드에서 지정된 주기 간격으로 계정 쿼터를 순차적으로 자동 갱신하므로 매번 수동으로 조회할 필요가 없습니다. 또한 만료가 임박한 액세스 토큰은 백그라운드 자동 로테이션(Background Auto-rotation)으로 재발급되어 안정적인 연결을 유지합니다.
  • 다중 창 공유 캐시(Shared Local Cache) 지원: 여러 개의 VS Code 또는 Antigravity 창을 동시에 실행해 두었을 때, 최근에 조회된 Quota 결과 데이터를 로컬 캐시로 공유합니다. 이를 통해 동일 계정에 대한 불필요하고 과도한 API 요청을 사전에 차단해 줍니다.
  • 계정 백업 및 복구(JSON Import/Export): 등록된 모든 계정 인증 및 설정 정보를 JSON 파일 형태로 안전하게 내보내거나 불러올 수 있습니다. 새로운 PC로 개발 환경을 이전하거나 설정을 이관할 때 매우 유용하게 사용할 수 있습니다.
  • 보안 암호화 및 인증 상태 재로드: 저장되는 계정 정보는 로컬 저장소 암호화를 통해 안전하게 보호됩니다. 계정을 스위칭한 후 Codex 확장이 변경된 인증 상태를 정확히 인식할 수 있도록 개발자에게 창 새로고침(Reload Window) 프롬프트를 자동으로 제공합니다.

3. 사전 설치 조건 및 환경 설정

Codex Account Switch 확장 프로그램을 원활하게 사용하기 위해서는 사전에 아래 2가지 기본 요건이 갖춰져 있어야 합니다.

  1. Codex CLI 설치: 운영체제 시스템 쉘 환경(Terminal / Command Prompt / PowerShell)에 codex CLI 도구가 전역 설치되어 있어야 정상적으로 구동됩니다.
  2. 계정별 최초 로그인 완료: 확장 프로그램에 추가하려는 각 계정으로 최초 1회 codex login 명령을 성공적으로 수행하여 기본 인증 토큰을 생성해 두어야 합니다.

4. 명령어 사용법 및 상세 설정 옵션 가이드

IDE 환경에서 커맨드 팔레트를 호출하여 명령어를 실행하거나, 설정 메뉴에서 사용자 환경에 맞춰 동작 방식을 변경할 수 있습니다.

주요 커맨드 팔레트 명령어 (Ctrl + Shift + P / Cmd + Shift + P):

  • Codex Account Switch: Add Account: 현재 로그인되어 있는 Codex 계정을 목록에 저장합니다.
  • Codex Account Switch: Switch Account: 저장된 계정 목록 중 사용할 보조 계정으로 원클릭 전환합니다.
  • Codex Account Switch: Refresh Quota: 현재 계정의 잔여 한도 정보를 즉시 새로고침합니다.
  • Codex Account Switch: Export Accounts / Import Accounts: 계정 목록 데이터를 JSON 파일로 내보내거나 복원합니다.

환경 설정(Settings) 옵션 상세:

설정 항목: codex-account-switch.quotaRefreshInterval (기본값: 30)
백그라운드 Quota 자동 갱신 주기를 초 단위(최소 5초)로 지정합니다. 등록된 계정들을 순차적으로 자동 조회합니다.

설정 항목: codex-account-switch.showStatusBar (기본값: true)
IDE 하단 상태 표시줄(Status Bar)에 현재 활성 계정의 Quota 잔여량을 표시할지 여부를 선택합니다.

설정 항목: codex-account-switch.reloadWindowAfterSwitch (기본값: prompt)
계정 전환 완료 후 창 새로고침 동작 방식(prompt: 확인 팝업, always: 자동 재로드)을 지정합니다.

설정 항목: codex-account-switch.authDirectory (기본값: 빈 값)
auth_{name}.json 파일이 저장될 커스텀 디렉토리 경로를 지정하며, 빈 값인 경우 기본 Codex 설정 경로를 사용합니다.

5. 계정 2개 이상 운용 시 생산성 200퍼센트 올리는 꿀팁

Codex Account Switch를 보다 스마트하게 활용하여 개발 흐름이 끊기지 않도록 관리하는 2가지 팁을 공유합니다.

첫째, IDE 하단 상태 표시줄의 잔여량 비율을 실시간으로 확인하는 습관을 들이는 것이 좋습니다. 주간 한도가 10퍼센트 미만으로 떨어지면 미리 계정 스위처 뷰에서 클릭 한 번으로 보조 계정으로 스위칭하여, 코드 작성 도중 한도 초과 오류로 작업이 중단되는 상황을 미연에 방지할 수 있습니다.

둘째, 계정을 교체할 때마다 매번 창 새로고침 프롬프트 창이 뜨는 것이 번거롭다면 설정에서 reloadWindowAfterSwitch 옵션을 always로 변경해 보세요. 계정 선택 즉시 자동으로 Window가 재로드되어 더욱 매끄럽고 빠른 쾌적한 개발 환경을 누릴 수 있습니다.

6. 오픈소스 저장소 및 관련 링크

Codex Account Switch는 오픈소스 프로젝트로 운영되고 있으며, GitHub 저장소를 통해 전체 소스코드 확인 및 기능 제보가 가능합니다.

7. 마치며

Codex 계정을 2개 이상 운용하면서 매번 수동 로그아웃과 로그인을 되풀이하는 과정은 집중력을 해치고 생산성을 크게 저하시킵니다. 이번에 소개해 드린 Codex Account Switch 확장을 설치해 두면 사이드바 및 상태 바에서 잔여 토큰 조회부터 계정 교체까지 일괄적으로 처리할 수 있습니다. 한도 부족 걱정 없는 끊김 없는 개발 환경을 구축하고 싶으신 분들께 강력히 추천합니다.

Similar Posts