Skip to content

Latest commit

 

History

History
86 lines (58 loc) · 4.96 KB

File metadata and controls

86 lines (58 loc) · 4.96 KB

CLI Account Switcher

🌐 English

Microsoft Store에서 다운로드

CLI Account Switcher 스크린샷

CLI Account Switcher는 AI 코딩 도구의 인증 계정을 관리하기 위한 Windows 데스크톱 유틸리티입니다. Codex, Claude Code, Z.ai, OpenCode Go, Ollama 계정을 지원합니다.

앱은 저장된 계정 목록을 자체 로컬 앱 데이터 폴더에 보관하고 선택한 인증 문서를 해당 도구의 로컬 인증 파일에 기록해 활성 계정을 전환합니다.

하이라이트

  • 작업 표시줄 실시간 사용량: 선택한 서비스의 활성 계정 5시간/7일 사용량을 Windows 작업 표시줄에서 바로 계속 확인합니다 (OpenCode Go는 월간 사용량도 표시).
  • 페이스메이커 보기: 현재 사용 속도가 리셋 시점까지의 이상적인 페이스보다 빠른지 느린지 한눈에 확인해 속도를 조절하거나 계정을 전환할 타이밍을 잡을 수 있습니다.

주요 기능

  • 지원되는 로그인 및 가져오기 방식으로 Codex, Claude Code, Z.ai, OpenCode Go, Ollama 계정을 추가합니다.
  • 계정 화면에서 지원되는 CLI의 활성 계정을 전환합니다.
  • 지원되는 계정의 플랜과 잔여 사용량 정보를 확인합니다.
  • Windows 작업 표시줄에서 활성 계정 사용량을 실시간으로 조회하고 새로 고칩니다.
  • 페이스메이커 지표로 현재 사용 페이스가 리셋 주기 안에서 여유로운지, 너무 빠른지 비교합니다.
  • 하나의 Windows 앱에서 Codex, Claude Code, Z.ai, OpenCode Go, Ollama 계정을 함께 관리합니다.
  • 전체 창을 열지 않고 트레이 아이콘을 눌러 활성 계정의 남은 사용량을 빠르게 확인합니다.
  • 계정 사용량을 새로 고치고 만료된 계정을 감지합니다.
  • 저장된 계정을 백업하고 복원합니다.

화면 구성

  • 대시보드: 활성 계정 요약, 평균 잔여 사용량, 사용량이 낮은 계정 목록을 보여줍니다.
  • 계정: 검색과 플랜 필터를 지원하는 계정 목록에서 전환, 새로 고침, 이름 변경, 삭제, 백업, 복원을 수행합니다.
  • 작업 표시줄 사용량: 5시간/7일 잔여 사용량, 페이스메이커 비교, 수동 새로 고침을 제공하는 상시 표시 사용량 뷰입니다 (OpenCode Go는 월간 사용량도 표시).
  • 트레이 아이콘 팝업: 트레이 아이콘을 눌러 활성 계정의 사용량을 빠르게 확인하고 새로 고칩니다.
  • 설정: 언어, 테마, 시작 프로그램, 업데이트 확인, 새로 고침 간격, 경고 임계값, 알림, 설정 가져오기/내보내기를 관리합니다.
  • 정보: 앱 버전과 서드파티 라이선스 정보를 보여줍니다.

기본 사용 흐름

  1. 계정 화면에서 하나 이상의 계정을 추가합니다.
  2. 앱이 계정을 검증한 뒤 플랜과 사용량 정보를 확인합니다.
  3. 사용할 계정을 선택해 해당 CLI의 활성 계정으로 전환합니다.
  4. 실행 중인 세션이 새 인증 파일을 읽도록 안내가 표시되면 해당 도구를 다시 시작합니다.
  5. 다른 Windows 설치 환경으로 계정이나 설정을 옮길 때 백업/내보내기 기능을 사용합니다.

계정 전환은 선택한 도구의 로컬 인증 파일을 덮어씁니다. 해당 파일을 직접 관리하거나 다른 도구와 함께 사용 중이라면 먼저 백업해 두세요.

요구 사항

  • Windows 10 버전 1809 이상.
  • 개발 환경: .NET 10 SDK, Windows App SDK, WinUI/MSIX 도구가 포함된 Visual Studio.

개발 정보

저장소는 세 프로젝트로 구성됩니다.

프로젝트 설명
CliAccountSwitcher.WinUI 패키징된 WinUI 3 데스크톱 앱입니다.
CliAccountSwitcher.Api Codex, Claude Code, Z.ai, OpenCode Go, Ollama 인증, 사용량, 모델, API 클라이언트 도우미를 담당합니다.
CliAccountSwitcher.Api.Sample Codex와 Claude Code API 동작을 확인하기 위한 콘솔 샘플 프로젝트입니다.

WinUI 앱은 net10.0-windows10.0.26100.0을 대상으로 하며, NativeAOT 게시와 MSIX 도구를 사용하고 x86, x64, ARM64 패키지 번들을 지원합니다.

게시 프로필은 CliAccountSwitcher.WinUI/Properties/PublishProfiles에 있습니다.

현지화

현재 앱에는 다음 언어 리소스가 포함되어 있습니다.

  • 영어 (en-US)
  • 한국어 (ko-KR)
  • 일본어 (ja-JP)
  • 중국어 간체 (zh-Hans)
  • 중국어 번체 (zh-Hant)

감사의 글

  • 이 프로젝트는 OpenAI Codex의 도움을 받아 생성되었습니다.
  • isxlan0/Codex_AccountSwitch에서 영감을 받았습니다.
  • 고품질 WinUI 컨트롤을 제공한 DevWinUI 프로젝트에 감사드립니다.

라이선스

이 프로젝트는 MIT License를 따릅니다.