클로드 코드 리미터: 공유 구독용 셀프 호스팅 속도 제한기

해결하는 문제

여러 개발자가 사용 제어 없이 하나의 Claude Code Max 구독을 공유할 때, 단일 사용자가 너무 많은 프롬프트를 보내면(예: 1시간에 50개 프롬프트) Anthropic의 속도 제한을 모두 소진하여 다른 모든 사용자가 하루 동안 접근이 차단될 수 있습니다. 이를 방지할 수 있는 내장된 방법은 없습니다.

기능

모델별 할당량 — 예: 사용자당 opus: 5/일, sonnet: 25/일, haiku: 50/일
크레딧 예산 — 모든 모델에 걸친 단일 일일 예산(opus = 10 크레딧, sonnet = 3, haiku = 1). 사용자가 지출 방식을 결정합니다.
24시간 슬라이딩 윈도우 — 자정 초기화 게임 방지
시간대 규칙 — 비싼 모델을 업무 시간으로 제한
실시간 대시보드 — 실시간 사용량 피드, 사용자별 분석, 사용량 차트
킬 스위치 — 사용자의 접근을 즉시 취소하고 원격으로 강제 로그아웃
변조 방지 — managed-settings.json 적용, 파일 권한, 무결성 검사 워치독, 서버 측 추적을 포함한 6개 보안 계층

작동 방식

설정:

서버 자체 호스팅 — VPS, 클라우드 또는 네트워크에서 단일 Docker 명령어로 실행
대시보드에 사용자 추가 — 이름, 제한, 크레딧 예산 설정 → 설치 코드 획득
각 머신에 설치 — sudo npx @howincodes/claude-code-limiter setup --code CLM-xxx --server https://your-server
완료 — 후크가 Claude Code의 managed-settings.json을 통해 모든 프롬프트에 대해 제한을 확인합니다(최우선 순위 구성, 사용자가 재정의할 수 없음)

사용자 경험: 사용자가 제한을 초과하면 다음과 같은 메시지를 보게 됩니다: "일일 opus 제한에 도달했습니다. 오늘 5/5 프롬프트 사용했습니다. 오늘 전체 사용량: opus: 5/5 (0 남음) sonnet: 12/25 (13 남음) haiku: 3/50 (47 남음) 크레딧 잔액: 15/100 다른 모델로 전환하거나 나중에 다시 시도하세요."

기술적 세부사항

클라이언트 후크: npm 종속성 없음, Node.js 내장 모듈만 사용. allowManagedHooksOnly: true로 managed-settings.json에 설치되어 사용자가 우회 후크를 추가할 수 없습니다.
서버: Express + SQLite + 바닐라 JS 대시보드. 단일 Docker 컨테이너, 단일 볼륨 마운트.
오프라인 가능: 후크가 제한을 로컬에 캐시하여 서버에 접근할 수 없을 때도 작동하며, 온라인 상태가 되면 동기화합니다.
실패 시 차단: 누군가 설정 파일을 삭제하면 모든 프롬프트가 차단됩니다(허용되지 않음).