claude-code
Claude Code 통합의 중심 플러그인입니다. 패널 속 Claude 세션을 감지해 상태줄 배지·토큰 회계·자동 개입(전송 에러 재시도)까지 담당합니다. 한도 뒤 이어 가기는 Claude Code 가 스스로 합니다(autoContinueAtUsageLimit).
무엇을 하나
Claude 가 도는 패널을 자동 감지해 상태(◐ 작업중/○ 대기) 탭 글리프와 상태줄 토큰 배지를 붙입니다. 토큰 사용량은 화면 스크랩이 아니라 ~/.claude/*.jsonl 트랜스크립트 회계가 권위 출처라 cache_read 까지 정확합니다. 일시 전송 에러(API error·rate limit)는 1분 뒤 '계속'을 자동 주입합니다(auto-retry). 토큰 리밋 뒤 이어 가기는 Claude Code 가 스스로 합니다.
주요 명령
| 명령 | 설명 |
|---|---|
claude-settings | Claude 설정 팝업 — 세션종료 토큰화면·화면 깨짐 자동 완화·auto 모드 자동 «예»·프롬프트 단위 클리어·장기턴/반복 경고 |
claude-token-log | 토큰 사용량 팝업 — 기간(시/일/주/월)·세션·한도·경고 탭 + 실측 한도·5h창 (상태줄 토큰 배지 클릭). 여러 머신을 합쳤을 때만 머신 탭이 하나 더 붙습니다 |
usage-panel | /usage 한도 막대 그래프 팝업 (별칭 usage-limits·limits) |
claude-usage | 그림자 /usage 질의 — 숨은 세션으로 실 세션/주간 한도를 갱신 (별칭 usage) |
claude-token-period · claude-token-sessions · claude-token-machines | 토큰 사용량을 기간별(시/일/주/월)·세션별·원산지 머신별 총계와 막대로 (별칭 token-period·token-sessions·token-machines). GUI 클라이언트용이며, 터미널 클라이언트에서는 claude-token-log 의 같은 탭을 씁니다 |
claude-warn-history | 경고 이력 — 날짜별로 접었다 펴는 목록 (별칭 claude-warns·warn-history). GUI 클라이언트용이며, 터미널 클라이언트에서는 claude-token-log 의 경고 탭을 씁니다 |
claude-token-account | 활성 패널의 Claude 계정을 손으로 지정 — claude-token-account <이름>, 빈 값 = 자동 |
claude-token-sync | 여러 머신 토큰 사용량 동기화 — status | on <URL> | off | enroll <코드> | invite | adopt <코드> | now | resync |
model | 모델·컨텍스트 변경 팝업 (상태줄 모델 배지 클릭) |
claude-detail | 플랜 전문·거부 사유 판 — 마지막 플랜과 마지막으로 막힌 호출을 읽습니다 (별칭 plan-detail, GUI 는 esc v) |
prompt-clear | 프롬프트 단위 클리어 모드 — 완료마다 문서화+/clear |
auto-retry | 전송 에러 시 1분 뒤 '계속' 자동 주입 on/off |
claude-auto-redraw | 화면 깨짐 자동 완화 — off | idle | corruption(끔 / 완료마다 재출력 / 깨짐 감지 시만), 기본 off (별칭 auto-redraw) |
claude-auto-yes | auto 모드 패널이 yes/no 를 물으면 이미 선택돼 있는 맨 «Yes» 만 Enter 로 확정 on/off, 기본 off (별칭 auto-yes) |
auto-token-on-exit | Claude 세션이 끝나는 순간 그 패널에 토큰·한도 요약을 흘려보내기 on/off(기본 on, 별칭 auto-token). 팝업이 아니라 패널 출력이라 스크롤백에 그대로 남습니다 |
prompt-clear-message | 프롬프트 단위 클리어가 /clear 전에 넣는 문서화 지시문 문구를 바꿉니다(설정 파일에 영속) |
prompt-clear-queue | 클리어 사이클마다 하나씩 꺼내 쓸 다음 프롬프트 대기열(별칭 pc-queue) — 인자 없이 = 지금 쌓인 목록 팝업, -c = 비우기, 그 밖의 문구 = 큐에 추가(모드가 꺼져 있으면 자동으로 켜집니다) |
claude-token-debug | 토큰 회계 진단 로그(<sock>.tokendbg.jsonl) on/off — 과소집계 원인을 가리는 진단용, 기본 off |
명령은 ESC → : 프롬프트에서 실행합니다. 값 선택지가 있는 명령(prompt-clear·auto-retry·claude-auto-redraw·claude-auto-yes·claude-token-debug)은 ? 명령 목록에서 고르면 선택 팝업이 뜹니다. 토글은 인자 없이 실행하면 켜짐/꺼짐이 뒤집히고(claude-auto-redraw 는 다음 모드로 순환), auto-token-on-exit 처럼 선택지가 없는 토글은 선택 팝업 없이 그렇게만 동작합니다.
화면
메모
원격 페더레이션 패널에서도 동작합니다(프롬프트 클리어 토글·토큰 팝업은 원격 서버로 릴레이). 토큰 DB 는 claude-tokens.db(SQLite), 실측 한도는 그림자 /usage 질의로 갱신합니다. 세부 항목은 Claude Code 연동·토큰 사용량 챕터 참고.
끄기 · 제거
:plugins 관리 팝업에서 끄거나(가역), pytmuxlib/plugins/claude-code/
디렉토리를 지우면(delete-to-disable) 명령·자동완성·메뉴 어디에도 나타나지 않고 조용히
사라집니다. 코어는 영향받지 않습니다. ← 플러그인 개요