Claude Code, Codex CLI, Gemini CLI 및 Antigravity CLI 계정 통합 관리 도구 (aisw)
요약
AI Switcher (aisw)는 Claude Code, Codex CLI, Gemini CLI 등 여러 코딩 에이전트의 로그인 정보를 통합 관리하고 프로필 간 전환을 용이하게 하는 도구입니다. 이 도구는 각 에이전트별로 다른 인증 저장 방식을 해결하며, 잘못된 계정 사용을 막아 개발 환경의 안정성을 높여줍니다.
핵심 포인트
- 여러 코딩 에이전트의 로그인 정보를 통합 관리 가능
- 잘못된 계정 활성화 및 실행을 사전에 차단 (작업 공간 가드레일)
- OS 키링 등 다양한 인증 저장 방식을 아우르는 전환 기능 제공
- 셸 후크를 통해 컨텍스트 불일치 시 경고/거부 메커니즘 구현
하나의 명령어로 Claude Code, Codex CLI, Gemini CLI 및 Antigravity CLI 계정을 전환하세요.
aisw
(AI Switcher)는 각 코딩 에이전트 로그인 정보를 이름 지정된 프로필로 저장하고 로그아웃하지 않고 그 사이를 전환하며, auth.json을 복사하거나 숨겨진 설정을 편집할 필요가 없습니다. 이 도구는 네 가지 에이전트를 한 번에 모두 전환할 수 있으며, 잘못된 계정이 활성화된 상태에서 레포지토리 내의 에이전트 실행을 거부합니다. 로컬에서 작동하며, 별도의 계정, 원격 측정(telemetry) 또는 프록시가 필요 없습니다.
두 개의 계정을 하나의 장치에서. 업무용과 개인용 Claude Code 또는 Codex 로그인을 사용하면 서로 덮어쓰게 되며, 전환할 때마다 로그아웃하고 다시 로그인해야 합니다.각 에이전트는 인증 정보를 다르게 저장합니다. Claude Code는 macOS Keychain 또는 .credentials.json을 사용하고, Codex CLI는 CODEX_HOME/auth.json을 사용하며, Gemini CLI는 ~/.gemini를 사용합니다. 이 파일들을 수동으로 복사하면 토큰 새로고침이 깨집니다.잘못된 레포지토리의 잘못된 계정. 개인 로그인이 클라이언트 레포지토리에서 실행되는 것을 막아주는 것은 없습니다.
이미 가지고 있는 로그인 정보를 가져오거나, OAuth 로그인 또는 API 키를 통해 다른 계정을 추가하고, 백업을 먼저 만든 후 전환할 수 있습니다. 모든 전환은 쓰기 작업에 실패하면 롤백됩니다. 프로필 추가 →
컨텍스트(context)는 에이전트별로 하나의 프로필을 단일 이름 아래에 매핑합니다. 심지어 프로필 이름이 다르더라도 그렇습니다. aisw context use는 이들을 모두 함께 이동시키거나, 아무것도 이동시키지 않습니다.
프로필, 컨텍스트 및 작업 공간 규칙 →
폴더, 레포지토리 또는 GitHub 조직을 컨텍스트에 바인딩할 수 있습니다. 셸 후크(shell hook)를 사용하면, 불일치하는 경우 claude, codex, gemini 또는 agy가 실행되는 것을 경고하거나 거부하며, 문제를 해결하는 명령어를 출력합니다.
작업 공간 가드레일 →
# Homebrew (macOS, Linux)
brew install burakdede/tap/aisw
# 셸 설치 프로그램 (macOS, Linux)
...
Windows 바이너리와 체크섬은 릴리스 페이지에서 확인할 수 있습니다. AI Switcher Desktop과 VS Code 및 Cursor 확장 기능은 동일한 프로필을 사용합니다.
# 셸 후크를 설치하고 가지고 있는 로그인 정보를 가져옵니다.
aisw init
# OAuth 로그인 또는 API 키로 계정을 추가합니다.
...
새 에이전트 세션을 시작하려면 전환해야 합니다. 실행 중인 프로세스는 시작된 계정을 유지합니다. 빠른 시작 가이드에서는 각 단계를 안내합니다.
| 도구 | 바이너리 | 인증 방식 | 플랫폼 |
|---|---|---|---|
| Claude Code | claude | OAuth, API key | macOS, Linux, Windows |
| Codex CLI | codex | ChatGPT 로그인, API key | macOS, Linux, Windows |
| Gemini CLI | gemini | Enterprise Google 로그인, Vertex AI, API key | macOS, Linux, Windows |
| Antigravity CLI | agy | OAuth, API key | macOS, Linux, Windows |
도구별 저장소(storage), 상태 모드 및 제한 사항은 지원되는 도구(Supported tools)에 나와 있습니다.
- 프로필은
~/.aisw/아래에 존재하며, 비밀 정보는 OS 키링(Keychain, Secret Service, Credential Manager) 또는0600파일에 저장됩니다. - 스위치(switch)는 백업 후 각 에이전트가 이미 읽는 위치에 자격 증명(credentials)을 하나의 트랜잭션으로 기록합니다. 작동 방식은 → - 모든 명령어는
--json을 사용하며 안정적인 종료 코드(stable exit codes)를 사용하므로,aisw verify는 CI 게이트 역할을 합니다. 자동화 → - 아무것도 기기를 벗어나지 않습니다. 보안 →
문서 · 명령어 · 가이드 · FAQ · 문제 해결
- aipets: 모든 aisw 프로필의 Claude Code / Codex 할당량(quota)을 타마고치 스타일의 애완동물로 보여주고, 원클릭 전환 및 추가/제거 기능을 제공하는 macOS 메뉴 바 위젯(SwiftBar)입니다.
MIT.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub AI Tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기