Skip to content
프로젝트

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

Original

aswap

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Русский | Français | Español

cswap list: two accounts with their 5h, 7d and per-model usage, then cswap switch 2

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 ...]는 사용량을 즉시 가져오며, 계정을 하나씩 처리합니다. 사용량 제한에 걸린 계정은 서버가 다음 재시도를 허용하는 시각을 표시합니다.

cswap refresh: one account refreshed, the other rate limited with the server retry time

계정별 Claude Desktop 창

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

cswap desktop --all opening one Claude Desktop window per account, then cswap desktop listing both as open

계정별 Chrome 프로필

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

cswap chrome 2 opening a copy of the stock Chrome profile for account 2, cswap chrome 1 opening account 1, then cswap chrome listing both as open
  • 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를 참고하세요.