Anthropic의 문서화되지 않은 OAuth 속도 제한 풀은 Claude Code 시스템 프롬프트가 필요합니다

LLM 프록시를 구축하는 개발자는 Anthropic의 OAuth 토큰에 대한 속도 제한 처리가 헤더나 토큰 유형이 아닌 시스템 프롬프트 내용에 따라 달라진다는 사실을 발견했습니다.

문제점

개발자는 다음과 같은 작동하는 설정을 가지고 있었습니다:

• authToken이 포함된 Anthropic SDK
• 베타 헤더 (claude-code-20250219, oauth-2025-04-20)
• user-agent: claude-cli/2.1.75
• x-app: cli

Haiku는 잘 작동했지만, Sonnet은 재시도 후 헤더나 속도 제한 헤더 없이 단순히 "message": "Error"와 함께 지속적인 429 속도 제한 오류를 반환했습니다. 한편, 동일한 서버에서 동일한 OAuth 토큰을 사용하는 AI 에이전트(OpenClaw 실행 중)는 Sonnet 4.6에 문제가 없었습니다.

해결책

OpenClaw의 Anthropic 제공자 소스(@mariozechner/pi-ai)를 검토한 후, 개발자는 다음 코드를 발견했습니다:

// OAuth 토큰의 경우 Claude Code 신원을 반드시 포함해야 함
if (isOAuthToken) {
    params.system = [{
        type: "text",
        text: "You are Claude Code, Anthropic's official CLI for Claude.",
    }];
}

이 한 줄을 프록시에 추가하자마자 Sonnet 속도 제한 오류가 즉시 해결되었습니다.

작동 방식

API는 시스템 프롬프트가 Claude Code로 식별되는지 여부에 따라 요청을 Claude Code 속도 제한 풀(일반 API 풀과 별도이며 더 높음)로 라우팅합니다. 이 동작은 SDK 문서나 API 문서에 명시되어 있지 않습니다.

실용적인 해결 방법

Anthropic OAuth 토큰을 사용하면서 설명하기 어려운 429 오류가 발생한다면, 시스템 프롬프트에 "You are Claude Code, Anthropic's official CLI for Claude."를 추가하세요.