Claude Code가 자체 사용량 제한을 인지하게 만들었습니다

요약

Claude Code(CLI)는 Anthropic API의 속도 제한 헤더를 모델 자체에 노출하지 않아, 개발자가 현재 할당량 사용량을 인지하기 어렵다는 문제를 발견했습니다. 이를 해결하기 위해 작성자는 Claude Code와 Anthropic API 사이에 로컬 HTTP 프록시를 구축하여 모든 `anthropic-ratelimit-*` 헤더를 가로채고 모델이 접근할 수 있도록 했습니다. 이 프록시는 순수 Node.js 표준 라이브러리로 구성되었으며, 사용량 수준에 따라 Claude의 동작을 자동으로 조정하는 규칙까지 제공합니다.

핵심 포인트

• Claude Code는 API 속도 제한 정보를 내부적으로만 처리하며, 모델 자체에는 할당량 소모 상태를 노출하지 않습니다.
• Anthropic은 모든 추론 응답에 통합 풀(unified pool) 기반의 속도 제한 헤더(`anthropic-ratelimit-*`)를 반환합니다. Sonnet 사용량 바는 실제 분리된 제한을 반영하지 않으며, Opus와 동일한 풀을 소모합니다.
• 작성자는 로컬 HTTP 프록시를 구축하여 이 속도 제한 헤더들을 가로채고 Claude Code에 전달함으로써 모델이 현재 할당량을 인지하도록 만들었습니다.
• 프록시는 npm 의존성이 없는 순수 Node.js 표준 라이브러리로 작성되었으며, 운영체제별 서비스 설치 방법(Windows/macOS/Linux)을 제공합니다.