앤트로픽이 공식으로 여는 사용량 API 는 조직의 API 사용분만 다루고 관리자 키가 필요하며 개인 계정은 쓸 수 없다고 문서에 적혀 있어서, 구독자가 보는 5시간·주간 사용률에는 공식 통로가 없어요. 그래서 사용률을 띄우는 도구들은 문서에 없는 api.anthropic.com/api/oauth/usage 를 30분 간격으로 불러오거나 응답에 딸려 오는 anthropic-ratelimit-unified-5h·7d 계열 헤더를 읽는데, 앤트로픽 공식 속도 제한 문서의 응답 헤더 표에는 이 헤더들이 한 줄도 없어요. 9월 7일 올라온 이슈 하나는 이 값이 0.0~1.0 인지 0~100 인지 자료마다 달라 실제 헤더를 받아 확인하기 전에는 구현을 못 하겠다고 적어 뒀는데, 불러와서 받는 JSON 은 0~100 을 쓰고 헤더는 0~1 로 읽어 100 을 곱하는 도구가 같은 주에 함께 올라왔어요.
용어 풀이
- API
- 프로그램끼리 정해진 규칙으로 데이터를 주고받는 창구
- JSON
- 데이터를 이름과 값의 짝으로 적는 문자 형식
- OAuth
- 비밀번호를 넘기지 않고 접근 권한만 건네주는 인증 방식
운영자 인사이트
사용률로 자동화를 멈추거나 사내 대시보드를 만들고 있다면 이 값은 앤트로픽이 보증하지 않는 자리예요. 0.5 가 50% 인지 0.5% 인지에 따라 차단 시점이 100배 어긋나니 스케일은 문서 대신 실제 응답으로 확인해 고정하고, 범위를 벗어난 값은 그냥 넘기지 말고 오류로 잡아 두세요.
여러 관점으로 보기
- 앤트로픽 공식 사용량 API 가 여는 범위 공식 사용량·비용 API 는 조직의 API 사용분을 다루고 관리자 키나 org:admin 토큰을 요구해요. 문서 첫머리에 '개인 계정은 쓸 수 없다'고 적혀 있어서 구독 사용률을 여기서 받을 길은 없어요. Anthropic
- 공식 응답 헤더 표에 없는 값 속도 제한 문서가 적어 둔 응답 헤더는 요청 수·토큰 수·입력·출력·우선 등급 계열이 전부예요. 5시간·주간 사용률을 담은 unified 계열 헤더도, 구독자에게 걸리는 두 창의 수치도 이 표에 없어요. Anthropic
- 클로드 코드는 받아만 두고 남기지 않아요 앤트로픽 저장소에 올라온 요청글은 '앤트로픽 API 가 매 요청마다 unified-5h 계열을 돌려주는데 클로드 코드가 받고도 저장하지 않는다'고 적었어요. 그래서 상태 표시줄은 값을 다시 받아 오려고 /usage 를 또 불러야 해요. GitHub
- 헤더를 직접 뜯어본 기록 4월 1일 글은 프록시를 세워 5h·7d·7d_sonnet 세 창의 사용률이 0.0~1.0 실수로, 어느 창이 걸리는지 알려 주는 항목까지 함께 온다고 적었어요. 화면의 막대는 그걸 줄여 보여 주는 값이고, 앤트로픽은 이 헤더들을 공개 문서로 설명하지 않아요. Claude Code Camp
- 같은 주에 헤더로 갈아탄 다른 도구 9월 6일 병합된 변경은 계정을 여럿 굴릴 때 조회만으로는 사용량을 알 수 없어 이미 받아 둔 응답 헤더를 쓰기로 했어요. 여기서는 사용률을 0~1 로 읽어 100 을 곱해 저장해요. GitHub