Orca에서 Claude Code 세션을 여러 개 띄워 놓고 일하다 보면, 꼭 제일 바쁠 때 리미트가 찹니다. 그래서 만들었습니다. 리미트가 차기 전에 세션을 알아서 여유 있는 계정으로 옮겨 주고, 모든 계정의 남은 사용량을 한 화면에 보여 주는 도구, claude-account-rotator입니다.
npm install -g claude-account-rotator
rotator status --watch먼저 결론부터 말하면, 이제 저는 계정을 손으로 바꾸지 않습니다. 대시보드를 한 번 띄워 두고, 세션이 다른 계정으로 넘어가면 넘어간 대로 하던 일을 계속하게 둡니다.
불편한 점은 세 가지였습니다.
리미트가 찰 때마다 계정을 손으로 바꿔야 했습니다. 작업이 한창일 때 세션이 멈추면, 계정을 고르고 세션을 다시 열고 하던 얘기를 다시 꺼내야 했습니다. 세션이 여러 개면 이걸 여러 번 합니다.
어느 계정에 얼마나 남았는지 알 수가 없었습니다. 계정이 몇 개씩 되니 "이 계정은 5시간 한도가 얼마 남았지? 주간 한도는?"을 한눈에 볼 방법이 없었습니다. 바꿔 놓고 보니 그 계정도 거의 찬 상태인 경우가 꽤 있었습니다.
계정 로테이션이 가끔 제대로 안 먹었습니다. 바꿨다고 생각했는데 세션은 여전히 예전 계정에 붙어 있어서, 결국 손으로 다시 확인하고 다시 바꾸는 일이 생겼습니다.
세 가지 모두 "사람이 계속 지켜보고 있어야 한다"는 게 문제였습니다. 그래서 지켜보는 일을 프로그램에 맡기기로 했습니다.
rotator status --watch를 켜면 터미널에 계정별 5시간·주간·Fable 사용량이 막대와 남은 시간으로 나옵니다. 1초마다 다시 그려지고, 터미널 폭에 맞춰 늘었다 줄었다 합니다. 아래는 예시 화면입니다(계정 이름은 가짜입니다).
│ │ 계정 │ 그룹 │ 5시간 │ 주간 │ 세션 │
│ * │ alice │ TEAM 1 │ ████████▒ 89% · 1시간 21분 뒤 │ ████▒▒▒▒▒ 45% · 6일 2시간 뒤 │ 1 │
│ │ carol │ TEAM 1 │ ▒▒▒▒▒▒▒▒▒ 0% │ ██▒▒▒▒▒▒▒ 28% · 2일 5시간 뒤 │ 0 │
│ │ bob │ TEAM 2 │ █████████ 100% · 21분 뒤 │ ███▒▒▒▒▒▒ 37% · 6일 뒤 │ 0 │아래쪽에는 지금 돌고 있는 세션 목록이 붙고, 세션마다 "유휴 시 전환 → carol"처럼 다음에 무엇을 할지가 한 줄로 나옵니다. 사용량은 계정당 30초에 한 번만 조회하고, 여러 화면이 같은 결과를 나눠 씁니다. 조회가 잠깐 실패해도 마지막 값을 그대로 보여 줘서 표가 비지 않습니다.
기준은 두 단계입니다.
85% (soft): 세션이 쉬고 있을 때만, 여유가 충분한 계정으로 옮깁니다. 작업 중인 답변은 끊지 않습니다.
95% (hard): 작업 중이어도 가장 여유 있는 계정으로 옮깁니다.
옮기는 방법은 사람이 하던 것과 같습니다. 세션에 /exit를 보내고, 다른 계정 폴더로 claude --resume을 다시 실행한 뒤 "계정 전환으로 세션이 재시작됐어. 중단된 작업을 이어서 진행해줘."라는 한 줄을 넣어 줍니다. 대화 기록은 그대로 이어집니다.
"여유 있는 계정"을 고르는 게 생각보다 까다로웠습니다. 5시간 한도 3%·주간 93%인 계정과, 5시간 81%·주간 62%인 계정 중 어디가 나을까요? 숫자만 보면 앞쪽이 위험해 보이지만, 주간 한도의 1%는 5시간 한도로 치면 몇 배나 큽니다. 그래서 주간 사용량을 5시간 단위로 바꿔서 비교합니다(실제로 재 보니 대략 6배였습니다). 모든 계정이 꽉 찼을 때는 가장 먼저 풀리는 계정으로 옮겨 놓고 기다리게 했습니다.
제가 제일 신경 쓴 부분입니다. 엉뚱한 창에 글자를 치는 도구는 없느니만 못하니까요.
확인이 하나라도 실패하면 아무것도 입력하지 않습니다. 창, 프로세스, 계정, 화면 상태를 모두 확인한 뒤에야 키를 보냅니다. 입력창에 제가 쓰던 글이 남아 있으면 기다립니다.
세션의 계정은 그 프로세스의 환경 변수에서만 읽습니다. Orca 화면에 보이는 선택 계정을 믿지 않으니, "바꿨는데 안 바뀐" 상태를 바로 알아챕니다.
결과를 모르는 전환은 다시 보내지 않습니다. 중간에 꺼졌으면 "결과 모름"으로 표시하고 사람이 보게 둡니다.
Orca가 먼저 세션을 다시 띄운 경우도 알아보고, 그 세션에 이어서 하라는 한 줄만 보내 줍니다.
쉬고 있는 계정의 로그인 토큰도 Claude Code와 같은 방식으로 미리 갱신해 둬서, 옮겨 갔더니 토큰이 만료돼 있는 일을 줄였습니다.
테스트는 지금 1866개이고, main에 머지될 때마다 CI가 돌고 npm 배포까지 자동으로 됩니다.
Ran 1866 tests in 9.266s
OK (skipped=3)macOS 기준으로 이렇게 시작하면 됩니다. Orca에 추가해 둔 Claude 계정을 알아서 찾기 때문에 따로 설정할 건 없습니다.
npm install -g claude-account-rotator
rotator doctor # 이 Mac에서 돌아가는지 점검
rotator status --watch # 대시보드만, 아무것도 바꾸지 않음
rotator daemon --dry-run # 무엇을 할지만 보여 줌
rotator install # 백그라운드에서 자동 전환 시작솔직하게 적어 두면 아직 부족한 점도 있습니다.
Orca 1.4.224 이상, 폴더 방식 계정이 필요합니다. 실제로 돌려 본 건 Orca 1.4.241입니다.
Windows는 대시보드·백그라운드 실행까지 되고, 실행 중인 세션 전환은 실험 기능입니다. 그것도 CI에서만 확인했고 실제 Windows 기기에서는 아직 못 돌려 봤습니다.
Claude Code 화면 문구를 읽어서 동작하는 부분이 있어서, Claude Code가 크게 바뀌면 전환이 안전하게 멈출 수 있습니다(엉뚱하게 동작하지 않고 멈추는 쪽으로 만들었습니다).
저처럼 Orca에서 계정 여러 개를 돌려 쓰고 계신다면 한번 써 보시고, 안 되는 부분은 이슈로 알려 주세요.