OpenRouter Blog출처 게시일2026-10-28 08:00 UTC+8

Claude Code 사용량 한도에 도달했나요? 계속 코딩하는 방법

Claude Code 사용량 한도에 도달하면 OpenRouter API 키로 Claude Code를 실행하여 계속 코딩할 수 있습니다. OpenRouter를 통해 Claude Code는 동일한 Claude 모델로 토큰 단위 지불 API 키에서 실행되며 5시간 창이 없습니다.

Claude Code 사용량 한도에 도달하면 OpenRouter API 키로 Claude Code를 실행하여 계속 코딩할 수 있습니다. OpenRouter를 통해 Claude Code는 동일한 Claude 모델로 토큰 단위 지불 API 키에서 실행되며 5시간 창이 없습니다. 환경 변수 세 개를 설정하고, 플랜이 초기화되면 플랜으로 다시 전환합니다.

이 설정은 Claude Code로 테스트했습니다. 아래의 출력과 비용은 해당 실행에서 나온 것입니다.

요약

Claude 플랜에는 5시간 한도와 주간 한도가 있습니다. OpenRouter API 키에는 어느 것도 없습니다. 대신 사용한 토큰에 대해 지불합니다.
가장 빠른 설정 방법은 Ori Harness입니다: ori claude 는 해당 세션 동안 브라우저 로그인으로 OpenRouter에서 Claude Code를 시작하며, 붙여넣을 키가 없습니다.
수동으로 하려면 환경 변수 세 개가 Claude Code를 OpenRouter로 가리키게 합니다. 우리는 이를 claude-or이라는 셸 함수에 넣었으므로, 일반 claude 은(는) 여전히 플랜을 사용합니다.
Claude Sonnet 5.5부터 시작하세요. 전형적인 짧은 Claude Code 세션은 Sonnet 5.5에서 $0.16, Opus 5.5에서 $0.31, Haiku 5.5에서 1센트 미만이 듭니다.
Claude Code가 출력하는 비용을 신뢰하지 마세요. 테스트에서 $0.008로 청구된 실행에 대해 $0.375를 표시했습니다. 대신 키 또는 Activity 페이지에서 확인하세요.
플랜이 초기화되면 다시 claude 을(를) 입력하세요. 되돌릴 것이 없습니다.

Claude Code가 사용량 한도에 도달하는 이유는?

Claude 플랜에는 동시에 작동하는 두 가지 한도가 있습니다. 첫 번째는 첫 프롬프트 후 5시간 후에 초기화됩니다. 두 번째는 7일마다 초기화됩니다. Anthropic은 어느 쪽에 대해서도 정확한 프롬프트 수를 공개하지 않습니다. Claude Code는 일반 채팅보다 훨씬 많은 토큰을 사용하므로 작업 도중에 소진될 수 있습니다. 그렇게 되면 Claude Code가 멈추고 한도가 초기화되는 시간을 알려줍니다. Anthropic의 사용량 한도 도움말 문서 에서 두 한도를 설명합니다.

OpenRouter API 키는 이런 방식으로 작동하지 않습니다. 사용한 각 토큰에 대해 지불하며, 크레딧이 있는 한 계속 진행할 수 있습니다.

가장 빠른 방법: Ori Harness를 통해 Claude Code 실행

Ori Harness 는 이미 기기에 있는 Claude Code를 OpenRouter 설정이 적용된 상태로 시작합니다. 설치하고 이를 통해 Claude Code를 시작하세요:

curl -fsSL https://openrouter.ai/labs/ori/install.sh | bash
ori claude --model anthropic/claude-sonnet-5.5

Ori는 브라우저를 열어 OpenRouter 계정으로 로그인할 수 있게 합니다. OAuth를 사용하므로 생성하거나 붙여넣을 키가 없습니다. ori claude 으로 시작한 세션만 OpenRouter에서 실행되므로, 일반 claude 은(는) 계속 플랜을 사용하며, 플랜이 초기화되면 claude 을(를) 입력하여 다시 전환합니다. 사용량은 OpenRouter 청구서에 반영됩니다. 조직에 소속되어 있다면 계정에 예산 한도가 있는 가드레일 이 지출 상한을 정하며, OpenRouter는 이를 Ori 세션에도 적용합니다.

아래 단계는 API 키와 셸 함수로 수동으로 동일한 작업을 수행합니다. 자체 크레딧 한도가 있는 키를 원하고 어떤 계정에서든 작동하도록 하려면 이를 사용하세요. 4단계의 비용 조언은 어느 쪽이든 적용됩니다.

1단계: OpenRouter API 키 발급 및 한도 설정

키를 생성합니다. API 키 페이지 그리고 크레딧 한도를 설정하세요. 우리는 $4로 설정했습니다. 이렇게 하면 긴 세션도 $4 이상을 지출할 수 없습니다. 크레딧 한도는 OpenRouter에서 지출을 통제하는 여러 방법 중 하나입니다. 팀 전체의 AI 지출을 관리하기 위한 우리의 가이드 나머지를 포괄한다.

한도를 확인하려면 API에 키에 대해 문의하세요:

curl https://openrouter.ai/api/v1/key \
  -H "Authorization: Bearer $OPENROUTER_API_KEY"

응답에서 중요한 부분은 다음과 같습니다:

{
  "data": {
    "limit": 4,
    "limit_remaining": 4,
    "usage": 0
  }
}

The limit_remaining number는 키에 남아 있는 금액이 얼마인지 알려줍니다. 이 확인은 언제든지 실행할 수 있습니다. 요청 후 새 잔액이 표시되기까지 몇 초가 걸릴 수 있습니다.

2단계: 키로 전환하는 명령 추가

변수를 셸 프로필에 추가할 수도 있지만, 그러면 모든 Claude Code 세션이 사용자의 키에 비용을 청구하게 됩니다. 우리는 사용자의 평소 claude 플랜을 계속 사용하기 위한 명령이므로, 대신 변수들을 작은 셸 함수에 넣었습니다. 다음을 추가하세요. ~/.zshrc 또는 ~/.bashrc:

claude-or() {
  ANTHROPIC_BASE_URL="https://openrouter.ai/api" \
  ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY" \
  ANTHROPIC_API_KEY="" \
  ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-5.5" \
  ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-5.5" \
  ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-5.5" \
  CLAUDE_CODE_SUBAGENT_MODEL="anthropic/claude-haiku-5.5" \
  claude "$@"
}

처음 세 줄이 중요한 부분입니다:

ANTHROPIC_BASE_URL Claude Code에게 요청을 우리에게 보내도록 지시합니다.
ANTHROPIC_AUTH_TOKEN 당신의 OpenRouter 키를 보관합니다.
ANTHROPIC_API_KEY 비어 있어야 합니다. 그렇지 않으면 Claude Code가 대신 Anthropic에 로그인을 시도할 수 있습니다.

나머지 네 줄은 선택 사항입니다. 이 줄들은 Claude Code에 Sonnet, Opus, Haiku에 사용할 Claude 모델을 지정해 줍니다. 또한 Claude Code가 스스로 시작하는 더 작은 보조 작업인 서브에이전트(sub-agent)를 Haiku 5.5로 보냅니다.

이 변수들은 직접 입력할 때만 적용됩니다 claude-or파일을 저장하고 새 터미널을 열어 함수가 준비되도록 합니다.

3단계: Claude Code가 사용자의 키를 사용하고 있는지 확인

본격적인 작업을 시작하기 전에, Claude Code가 요청을 사용자의 요금제가 아닌 OpenRouter로 보내고 있는지 확인하세요. 가장 빠른 방법은 짧은 프롬프트를 하나 보내고 어떤 모델이 응답했는지 확인하는 것입니다. 터미널에서 다음을 실행하세요:

claude-or --model sonnet -p "Reply with exactly: ok" --output-format json

우리의 대응 중에서 중요한 부분은 다음과 같습니다:

{
  "is_error": false,
  "result": "ok"
}

응답은 오류 없이 돌아왔습니다. 해당 modelUsage 전체 출력의 field는 응답한 모델의 이름을 나타내며, 우리의 실행에서 그 값은 다음과 같았습니다. anthropic/claude-sonnet-5.5. 동일한 프롬프트를 --model haiku, 그리고 modelUsage 명명된 anthropic/claude-haiku-5.5.

그런 다음 1단계의 키 확인을 다시 실행하십시오. 만약 usage 올라갔다면 요청이 요금제가 아닌 사용자의 키로 청구된 것입니다. 올라가지 않았다면 Claude Code가 변수를 인식하지 못한 것입니다. 새 터미널을 열고 다시 시도해 보세요.

4단계: 비용을 낮게 유지하기

키 기반 과금에서는 메시지마다 비용을 지불합니다. 표에는 세 가지 Claude 5.5 모델에 대한 우리의 가격이 나와 있습니다. 또한 OpenRouter에서 두 개에서 아홉 개 메시지로 구성된 실제 Claude Code 세션의 중앙값 비용도 함께 표시되어 있습니다.

모델	1M 입력 토큰당 가격	출력 토큰 1M당 가격	세션당 중앙값 비용 (2~9개 메시지)
Claude Opus 5.5	$4.00	$20.00	$0.305
Claude Sonnet 5.5	$2.00	$10.00	$0.155
Claude Haiku 5.5	$0.10	$0.50	$0.007

2026년 10월 21일 기준 가격입니다. 세션 비용은 당사의 세션 비용 데이터셋 2026년 10월 18일까지의 30일을 다룬다.

Sonnet 5.5로 시작하세요. 세션당 비용이 Opus 5.5의 약 절반이며 대부분의 일상적인 코딩을 처리합니다. 문제가 어려울 때는 /model opus 완료하면 다시 전환할 수 있습니다. 저희 API를 기반으로 직접 앱을 만들 경우, 다음과 같은 것도 할 수 있습니다 요청을 자동으로 더 강력한 모델로 이동시킵니다 더 저렴한 모델이 자신의 답변에 확신이 없을 때 말입니다.

모든 새 세션은 Claude Code 자체 지침과 도구 목록 약 28,000 토큰으로 시작합니다(우리가 Claude Code 2.1.307에서 실행했을 때는 28,156이었으며, 이 수치는 버전마다 달라집니다). 이 내용은 첫 요청 시 프롬프트 캐시에 기록되므로, 3단계에서 한 단어짜리 프롬프트는 Sonnet 5.5에서 약 $0.07, Haiku 5.5에서는 0.5센트 미만의 비용이 듭니다.

하위 에이전트는 Haiku에서 저렴하게运行됩니다. 우리가 Sonnet 5.5에게 하위 에이전트를 시작하도록 요청했을 때, 메인 에이전트는 Sonnet 5.5에서, 하위 에이전트는 함수 설정에 따라 Haiku 5.5에서 실행되었습니다.

Haiku는 작은 수정 작업도 스스로 처리할 수 있습니다. 우리는 Haiku 5.5에 버그 두 개와 실패하는 테스트 세 개가 있는 쇼핑 카트 파일을 제공했습니다. Haiku는 두 버그를 모두 수정했고 세 테스트가 모두 통과했으며, 이번 실행에 대해 $0.008가 청구되었습니다.

Claude Code가 출력하는 비용은 믿지 마세요. 해당 Haiku 실행에서 Claude Code는 $0.375로 보고했지만, 실제로는 $0.008이 청구되었습니다. Claude Code는 세션 비용을 Anthropic의 자체 가격표로 계산하며, OpenRouter 모델 이름을 인식하지 못할 때는 추정합니다. 실제 지출액을 확인하려면 다음을 확인하세요. limit_remaining Step 1 명령어를 사용하거나, 또는 여러분의를 여세요. 활동 페이지.

5단계: 플랜이 초기화되면 다시 전환하기

플랜의 한도가 초기화되면 claude 대신 claude-or을 입력하세요. OpenRouter 설정은 함수 내부에만 존재하므로 다른 것은 변경할 필요가 없습니다. 테스트에서 일반 claude 이(가) 플랜의 모델로 응답했으며, OpenRouter 키의 사용량은 변하지 않았습니다.

API 키가 소진되면 어떻게 되나요?

키가 크레딧 한도에 도달하거나 계정의 크레딧이 부족해지면, 요청이 모델에 도달하기 전에 중단하고 오류를 반환합니다. 이 오류에는 이유를 알려주는 limit_source 필드가 포함되어 있습니다:

openrouter_key_limit 은(는) 키가 한도를 모두 사용했음을 의미합니다.
openrouter_credits 은(는) 계정에 크레딧이 없음을 의미합니다.

계속 진행하려면 API 키 페이지에서 키의 한도를 올리거나 계정에 크레딧을 추가하세요. 저희의 limits page 에서는 팀 관리자가 설정할 수 있는 한도를 포함해 모든 종류의 한도를 설명합니다.

자주 묻는 질문

OpenRouter에는 Claude Code 사용 한도가 있나요?

5시간 또는 주간 한도는 없습니다. 유일한 한도는 지출과 관련된 것입니다. 즉, 보유한 크레딧, 키에 설정한 한도, 팀 관리자가 설정한 예산입니다.

모델이 제 Claude 플랜과 동일한가요?

네. Anthropic의 Claude 모델입니다. 저희는 Anthropic과 Amazon Bedrock, Google Vertex 같은 클라우드 제공업체로부터 모델을 받으며, 한 제공업체에 문제가 있으면 요청을 다른 제공업체로 보냅니다. Claude Code의 경우 Anthropic을 첫 번째 선택 제공업체로 설정할 것을 권장합니다. Claude Code는 Anthropic에서만 확실히 작동이 보장되기 때문입니다.

한도에 도달하면 더 저렴한 모델을 사용할 수 있나요?

네. Sonnet 5.5는 세션당 Opus 5.5의 약 절반 비용이 들고, Haiku 5.5는 세션당 1센트 미만입니다. 또한 함수의 변수 중 하나에 다른 모델을 넣을 수도 있습니다. 많은 사람들이 OpenRouter를 통해 Claude Code에서 다른 모델을 사용합니다. 이번 달 GLM 5.3 Flash는 저희 앱 페이지의 Claude Code, Claude Opus 5.5 이후에 제공됩니다. 다만 Claude Code는 Claude 모델을 위해 만들어졌으므로, 다른 모델을 사용할 경우 먼저 작은 작업으로 시험해 보세요. 자신의 코드에서 저희 API를 호출하는 경우 다음과 같이 할 수도 있습니다 대체 모델 목록 표시 따라서 첫 번째 모델이 실패하면 요청이 두 번째 모델로 이동합니다. 요청당 지불 비용을 낮추는 더 많은 방법은 다음을 참조하세요: OpenRouter에서 가장 저렴한 LLM 추론에 관한 우리의 가이드.

Claude Code 사용량 한도는 언제 초기화되나요?

해당 5시간 제한은 해당 기간 내 첫 번째 프롬프트로부터 5시간 후에 초기화됩니다. 주간 제한은 시작 후 7일이 지나면 초기화됩니다. Claude Code는 제한에 걸렸을 때 초기화 시간을 표시하므로 언제 입력할 수 있는지 알 수 있습니다. claude 다시 말입니다.

남은 사용량을 어떻게 확인하나요?

Claude 플랜에서는 Claude Code가 사용을 중단시킬 때 한도가 초기화되는 시점을 알려줍니다. OpenRouter에서는 확인하세요 limit_remaining 함께 GET /api/v1/key, 또는 Activity 페이지를 여세요.

다음 단계

저희의 Claude Code 설정 가이드 에는 작업 중 비용을 보여주는 상태 표시줄을 포함한 전체 설정 방법이 담겨 있습니다. 한도에 도달했을 때만이 아니라 매일 OpenRouter를 Claude Code와 함께 사용하고 싶다면, 저희의 Claude Code 튜토리얼 이 과정을 안내해 드립니다. 키를 관리하지 않고 OpenRouter에서 실행하려면, Ori Harness 가 한 번의 명령으로 Claude Code 또는 다른 에이전트 CLI를 시작합니다. 팀을 위해 이를 설정하는 경우, 워크스페이스 예산 을 통해 각 팀의 지출 한도를 정할 수 있습니다.

원문 출처

OpenRouter Blog

원문 읽기

내용 안내

원문 발행 및 권리는 출처에 있습니다.

기계 번역 · 원문을 참고하세요