BlackHole1/aswap
BlackHole1/aswap has 33 GitHub stars and 4 forks. GitHot measured 0 stars in 24 hours, 0 in 7 days, and +4 in 15 days. Last checked 2026-11-20 21:12 UTC. Last push 2026-11-18.
측정된 스타 증가
- in 24h
- 0
- in 7 days
- 0
- in 15 days
- +4
- in 1 month
- 기록 수집 중
서로 겹치는 기간의 순증가량이며 일별 합계가 아닙니다. 측정값이 없으면 비워 둡니다. 스타는 관심도를 나타내며 품질을 보장하지 않습니다.
소개
Multi-account switcher for Claude Code and Claude Desktop: claude-swap (cswap) plus a maintained patch series.
개발 도구docs/readme/README.ko.md
Originalaswap
English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Русский | Français | Español

claude-swap으로 Claude Code 계정을 전환합니다. 여기에 꾸준히 관리되는 수정 사항과 기능을 더했습니다.
cswap은 여러 Claude 계정을 관리합니다. 계정별 사용량을 추적하고, 남은 할당량이 가장 많은 계정으로 전환할 수 있습니다. aswap은 수정하지 않은 업스트림 소스로 cswap을 빌드하고, 그 위에 소수의 패치를 적용합니다. 모든 cswap 명령은 기존과 똑같이 동작합니다.
이름은 account swap의 줄임말입니다.
설치
uv tool install aswap # 또는: pipx install aswap
aswap --version
aswap은 모든 cswap 명령을 받습니다. 업스트림 cswap과 나란히 설치되며, 기존 설치는 건드리지 않습니다.
aswap을 cswap 이름으로도 실행하려면 다음과 같이 합니다.
aswap link # aswap 옆에 cswap 런처 추가
aswap unlink # 런처 제거
aswap link는 aswap 설치가 만든 cswap 런처만 교체합니다. 업스트림 cswap을 교체하려면 먼저 제거(uv tool uninstall claude-swap)하거나 --force를 지정하세요.
업그레이드하려면 aswap upgrade를 실행합니다. aswap을 설치한 방식에 따라 uv tool upgrade 또는 pipx upgrade를 호출합니다.
aswap이 추가하는 기능
필요할 때 사용량 새로고침
cswap refresh [account ...]는 사용량을 즉시 가져오며, 계정을 하나씩 처리합니다. 사용량 제한에 걸린 계정은 서버가 다음 재시도를 허용하는 시각을 표시합니다.

계정별 Claude Desktop 창
Claude Desktop은 한 번에 하나의 로그인만 유지합니다. cswap desktop 2는 계정 2를 자체 로그인을 가진 별도 창으로 열고, cswap desktop --all은 모든 계정을 엽니다. 각 창의 Code 탭에는 같은 로컬 세션이 표시됩니다(Windows 제외). 이 방식은 guise를 따릅니다.

계정별 Chrome 프로필
Claude in Chrome은 cswap switch로 선택한 계정이 아니라 브라우저의 claude.ai 로그인을 사용합니다(업스트림 #256). cswap chrome 2는 Chrome 프로필의 별도 사본에서 계정 2를 엽니다. 그 안의 확장 프로그램은 계정 2로 동작하고, 기본 브라우저는 기존 로그인을 그대로 유지합니다.

cswap chrome --sync 2는 현재 Chrome 프로필을 계정 2에 다시 복사합니다. 먼저 해당 창을 닫으세요.cswap config set chrome.followSwitch true를 설정하면cswap switch시 해당 계정의 브라우저를 앞으로 가져옵니다.cswap config set chrome.appPath <path>로 Edge나 Brave 같은 다른 Chromium 브라우저를 사용할 수 있습니다.
대화 기록 공유
cswap run은 기본적으로 모든 계정이 하나의 대화 기록을 공유합니다. 계정을 전환한 뒤에도 claude --resume으로 이전 대화를 찾을 수 있습니다(업스트림 #239). 계정별로 기록을 따로 두려면 cswap config set run.shareHistory false를 실행하세요. Windows에서는 지원하지 않습니다.
버그 수정
- 오래된 계정 설정.
~/.claude.json이 여전히 계정 B를 가리키는데 키체인에는 계정 A의 토큰이 있으면, 업스트림은 A에 다시 로그인하라고 요청하고 B의 갱신을 멈춥니다. aswap은 현재 사용 중인 토큰을 소유한 계정을 따릅니다. - 기록 파일 손실. 업스트림은 프로필의 기록을
~/.claude로 병합할 때 이름이 같은 파일을 비교하지 않고 삭제합니다. 이 때문에 세션이나memory/MEMORY.md가 사라질 수 있습니다. aswap은 내용이 다른 파일을history-conflicts/아래에 따로 보관합니다. - 버전과 업그레이드.
--version, 업데이트 확인,upgrade는claude-swap패키지에 하드코딩되어 있습니다. aswap은 자신이 설치된 패키지를 사용합니다.
빌드 방식
upstream.json은 업스트림 커밋 하나를 고정합니다. bun run setup은 해당 커밋을 수정 없이 cswap/에 클론한 뒤, patches/의 모든 패치를 patches/.patches에 나열된 순서대로 git am으로 적용합니다. 이는 Electron이 Chromium과 Node 패치에 사용하는 구조를 따릅니다. 각 diff는 작고 읽기 쉽게 유지되며, 새 업스트림으로 옮기는 작업은 패치 시리즈를 리베이스하는 것으로 끝납니다.
| 패치 | 변경 내용 |
|---|---|
| 현재 자격 증명의 소유자 따르기 | 수정: 오래된 계정 설정 |
| 설치된 배포 패키지 따르기 | 수정: 버전과 업그레이드 |
| 필요할 때 사용량 새로고침 | 기능: cswap refresh |
| 병합 시 기록 파일 보존 | 수정: 기록 파일 손실 |
| 하나의 대화 기록 공유 | 기능: 대화 기록 공유 |
| 계정별 Claude Desktop 열기 | 기능: cswap desktop |
| 계정별 Chrome 열기 | 기능: cswap chrome |
각 패치는 단일 커밋이며, 커밋 메시지에 업스트림의 문제가 설명되어 있습니다. 소스에서 빌드하거나 패치 작업을 하려면 CONTRIBUTING.md를 참고하세요.
라이선스
claude-swap과 같은 MIT 라이선스입니다. LICENSE를 참고하세요.