Rihpig

Posted on May 14 • Originally published at apidog.com

클로드 코드 주간 한도 50% 증가: Pro, Max, 팀 사용자 추가 할당 활용법 (7월 13일까지)

Anthropic은 Claude Code 주간 사용량 제한을 50% 인상했습니다. 이 변경은 즉시 적용되며 7월 13일 오후 6시 PDT(7월 14일 오전 1시 GMT)까지 유지됩니다. 적용 대상은 모든 유료 요금제(Pro, Max, Team, 시트 기반 Enterprise)이며, Claude Code가 실행되는 모든 환경(CLI, IDE 확장 프로그램, 데스크톱 앱, 웹)에 동일하게 적용됩니다. 별도 신청은 필요 없습니다.

오늘 Apidog을 사용해 보세요

이번 변경은 기존 사용량 증가 위에 추가됩니다. Anthropic은 지난주 5시간 제한을 두 배로 늘렸고, 이번에는 주간 제한을 50% 올렸습니다. 즉, 단기 세션 한도는 2배, 주간 한도는 1.5배가 되었으며 가격 인상은 없습니다.

이 글에서는 다음을 구현 관점에서 정리합니다.

Claude Code의 5시간 제한과 주간 제한이 무엇인지
50% 증가가 실제 개발 워크플로우에 어떤 영향을 주는지
향후 8주 동안 어떤 작업을 Claude Code로 옮기면 좋은지
Apidog을 활용한 API 설계 및 테스트 워크플로우에 어떻게 연결할 수 있는지

주간 제한은 무엇이며, 50% 증가는 어떤 의미인가요?

Claude Code 유료 요금제에는 크게 두 종류의 사용량 제한이 있습니다.

5시간 제한

5시간 동안 사용할 수 있는 토큰의 롤링 한도입니다. 긴 디버깅 세션, 기능 구현, 리팩토링처럼 한 번에 오래 실행되는 작업에서 주로 도달합니다. Anthropic은 이 제한을 지난주에 두 배로 늘렸습니다.
주간 제한

일주일 동안 사용할 수 있는 전체 토큰 한도입니다. 여러 날 동안 Claude Code를 집중적으로 사용하는 사용자가 주로 도달하는 제한입니다. 이번에 50% 증가한 항목이 바로 이 주간 제한입니다.

정확한 토큰 수는 요금제별로 다르며 고정 값으로 공개되어 있지 않습니다. Anthropic은 가용 용량에 따라 제한을 조정할 수 있습니다.

실무적으로는 다음과 같이 이해하면 됩니다.

Pro 사용자는 주간 한도 경고에 도달하기 전까지 더 많은 작업을 실행할 수 있습니다.
Max 사용자는 큰 코드베이스에서 며칠간 이어지는 리팩토링이나 에이전트 작업을 더 안정적으로 수행할 수 있습니다.
Team 및 시트 기반 Enterprise 사용자는 시트당 50% 증가가 적용됩니다. 예를 들어 10개 시트를 사용하는 팀이라면 조직 전체 주간 용량도 함께 증가합니다.

사용량은 기존과 동일한 위치에서 확인할 수 있습니다.

/usage

확인 위치:

Claude Code CLI의 /usage 명령
IDE 확장 프로그램 상태 표시줄
웹 계정 설정 페이지

Anthropic이 지금 이 조치를 취하는 이유

이번 변경에는 두 가지 배경이 있습니다.

첫째, 용량 확보입니다. Anthropic은 2026년 1분기와 2분기 동안 새로운 컴퓨팅 자원을 공격적으로 확보해 왔습니다. 여유 용량이 생기면 기존 유료 사용자에게 더 많은 사용량을 제공하는 것이 플랫폼 사용률과 충성도를 높이는 효과적인 방법입니다.

둘째, 경쟁 환경입니다. Codex는 몇 주 전 /goal 자율 에이전트 루프를 출시했고, OpenAI도 개발자 플랜의 속도 제한을 조정하고 있습니다. 여러 AI 코딩 도구를 병행하기 시작한 팀을 붙잡기 위한 방어적 조치로 볼 수 있습니다.

단, 이 증가는 임시입니다. 7월 13일 오후 6시 PDT 이후 제한이 영구화될지, 기존 수준으로 돌아갈지, 중간 수준으로 조정될지는 아직 발표되지 않았습니다.

50% 증가는 실제로 무엇을 가능하게 하는가?

“더 많이 쓸 수 있다”는 설명만으로는 부족합니다. 개발자 관점에서는 어떤 작업을 더 안정적으로 실행할 수 있는지가 중요합니다.

1. 더 긴 에이전트 실행

5시간 제한 2배 증가와 주간 제한 50% 증가는 긴 에이전트 작업에 직접적인 영향을 줍니다.

예를 들어 /goal 자율 루프를 사용해 복잡한 리팩토링을 실행할 때, 이전에는 중간에 5시간 제한이나 주간 제한에 걸려 작업이 멈추는 경우가 많았습니다.

이제는 다음과 같은 작업을 더 현실적으로 시도할 수 있습니다.

목표:
- billing 모듈의 중복 validation 로직 제거
- 기존 테스트가 모두 통과해야 함
- public API 응답 스키마는 변경하지 말 것
- 변경 후 affected package의 테스트를 실행할 것

이처럼 성공 조건이 명확한 작업을 Claude Code에 맡기고, 중간 개입 없이 완료까지 실행할 가능성이 높아졌습니다.

2. 더 큰 코드베이스 컨텍스트 사용

Claude Code의 성능은 코드베이스의 어느 정도를 컨텍스트로 유지할 수 있는지에 크게 좌우됩니다.

주간 여유 공간이 늘어나면 다음 작업이 쉬워집니다.

더 넓은 디렉토리 범위를 컨텍스트로 로드
모노리포의 여러 패키지를 함께 분석
수동으로 파일 범위를 줄이는 작업 감소
대규모 리팩토링 전후 영향 범위 확인

기존에 “이 모노리포는 Claude Code로 다루기 너무 크다”고 판단했다면, 이번 기간 동안 다시 테스트해볼 가치가 있습니다.

3. 다중 에이전트 워크플로우

Ruflo처럼 Claude Code 위에서 동작하는 다중 에이전트 오케스트레이터는 하나의 작업에 대해 여러 Claude 인스턴스를 실행하고 결과를 병합합니다.

이 방식은 강력하지만 호출량이 빠르게 증가합니다.

예시:

Agent 1: API handler 구현
Agent 2: 테스트 케이스 작성
Agent 3: 타입 오류 및 lint 수정
Agent 4: 문서 업데이트

이전에는 이런 패턴이 실험용에 가까웠다면, 이번 한도 증가로 일상적인 개발 워크플로우에 더 가깝게 사용할 수 있습니다.

4. MCP 서버 사용 확대

Claude Code는 MCP(Model Context Protocol)를 통해 외부 도구를 호출할 수 있습니다. MCP 호출도 사용량에 포함되기 때문에, 이전에는 여러 MCP 서버를 연결하면 한도 부담이 컸습니다.

이번 증가는 다음과 같은 MCP 기반 워크플로우를 더 실용적으로 만듭니다.

데이터베이스 스키마 조회
API 테스트 실행
브라우저 자동화
GitHub 이슈 분류
문서 생성
CI 실패 원인 분석

예를 들어 Claude Code에서 다음과 같은 흐름을 구성할 수 있습니다.

1. GitHub 이슈 읽기
2. 관련 코드 탐색
3. API 스펙 확인
4. 테스트 실행
5. 실패 원인 수정
6. PR 설명 작성

Claude Code에서 MCP 서버 설정 중 구성 오류가 발생한다면 잘못된 custom3p 엔터프라이즈 구성 수정을 참고하면 일반적인 원인을 확인할 수 있습니다.

향후 8주 동안 할 일

7월 13일까지 늘어난 한도를 활용하려면 단순히 더 많이 쓰는 것보다, 그동안 미뤄둔 고비용 워크플로우를 검증하는 것이 좋습니다.

1. 미뤄둔 에이전트 워크플로우 구현

기존 한도 때문에 시도하지 못했던 작업을 지금 구현해 보십시오.

2. 부수 작업을 Claude Code로 옮기기

그동안 수동으로 처리하던 작업도 Claude Code로 옮겨볼 수 있습니다.

예:

AGENTS.md 작성
코드 리뷰 체크리스트 생성
MCP 서버 구성 파일 작성
OpenAPI 사양 초안 생성
테스트 케이스 보강
마이그레이션 가이드 작성

특히 AGENTS.md 파일 작성 가이드는 Claude Code가 프로젝트 규칙을 더 잘 따르게 만드는 데 도움이 됩니다.

예시 구조:

# AGENTS.md

## Project conventions

- Use TypeScript strict mode.
- Do not change public API response formats without updating OpenAPI.
- Run unit tests before finalizing changes.

## Commands

- Install: `pnpm install`
- Test: `pnpm test`
- Lint: `pnpm lint`

## API workflow

- Update OpenAPI spec first.
- Implement handlers after contract changes.
- Add integration tests for new endpoints.

3. 새 한도를 기준으로 실제 사용량 측정

이번 한도가 영구적이라고 가정하고 일상 업무를 Claude Code 중심으로 진행해 보십시오.

측정하면 좋은 항목:

주간 사용량을 얼마나 소진하는지
어떤 작업에서 가장 많은 토큰을 쓰는지
5시간 제한과 주간 제한 중 어느 쪽에 먼저 도달하는지
Max 업그레이드가 필요한지
다른 AI 코딩 도구와 분산할 필요가 있는지

CLI에서는 주기적으로 다음 명령을 확인하면 됩니다.

/usage

API 작업에는 어떻게 적용되는가

백엔드 및 플랫폼 엔지니어에게 가장 큰 기회는 API 작업입니다.

Claude Code는 다음 작업에 강합니다.

API 핸들러 작성
OpenAPI 사양 생성
계약 불일치 디버깅
통합 테스트 작성
요청/응답 스키마 정리
에러 케이스 보강

하지만 이 작업들은 코드 컨텍스트와 도구 호출이 많아 토큰을 많이 사용합니다. 이번 한도 증가는 API 워크플로우에 특히 유리합니다.

계약 우선 API 워크플로우 예시

다음 방식으로 Claude Code와 Apidog을 함께 사용할 수 있습니다.

Apidog에서 API 계약을 설계합니다.

엔드포인트, 요청 스키마, 응답 스키마, 예시 페이로드를 정의합니다.
OpenAPI 사양을 내보냅니다.

이 파일을 Claude Code에 컨텍스트로 제공합니다.
Claude Code에서 /goal을 실행합니다.

   목표:
   - openapi.yaml에 정의된 모든 endpoint 구현
   - 기존 라우팅 구조 유지
   - Apidog 테스트 케이스가 모두 통과해야 함
   - 응답 스키마는 OpenAPI와 일치해야 함

Apidog CLI 테스트를 실행해 실제 계약과 구현이 일치하는지 확인합니다.
실패한 테스트 결과를 Claude Code에 다시 제공하고 수정 루프를 반복합니다.

예시 프롬프트:

Apidog 테스트 결과에서 실패한 케이스를 기준으로 구현을 수정해 주세요.
OpenAPI 스펙은 변경하지 말고, 서버 구현만 계약에 맞게 수정하세요.
수정 후 관련 테스트 명령을 실행하고 결과를 요약하세요.

이 방식의 핵심은 Claude Code가 임의로 만든 계약이 아니라, Apidog에 정의된 실제 API 계약을 기준으로 구현과 테스트를 반복한다는 점입니다.

AI 에이전트를 활용한 계약 우선 API 작업은 설계 우선 API 워크플로우 가이드에서 더 자세히 확인할 수 있습니다.

Apidog을 아직 사용해 보지 않았다면 Apidog을 다운로드하고, 이번에 늘어난 Claude Code 할당량으로 설계 우선 API 워크플로우를 테스트해 보십시오.

무료 Claude API 액세스는 어떻게 되나요?

Claude Code 유료 요금제를 사용하지 않는 경우, 무료 Claude API 액세스 가이드를 참고할 수 있습니다.

단, 이는 Claude Code의 유료 할당량과는 별개입니다. 이번 50% 증가는 다음 요금제에만 적용됩니다.

Pro
Max
Team
시트 기반 Enterprise

Anthropic API를 직접 호출하는 사용량 제한에는 적용되지 않습니다.

이번 변경으로 변하지 않는 것

이번 업데이트는 사용량 한도 증가일 뿐입니다. 다음 항목은 변경되지 않습니다.

직접 API 사용자를 위한 Claude API 속도 제한
요금제 가격
Claude Code의 기능 자체
엔터프라이즈 시트 기반 요금제의 청구 구조

즉, 새로운 기능이 추가된 것은 아닙니다. 가치는 늘어난 사용량을 어떤 워크플로우에 투입하느냐에 달려 있습니다.

FAQ

50% 증가는 정확히 언제 종료되나요?

2026년 7월 13일 오후 6시 PDT, 즉 7월 14일 오전 1시 GMT에 종료됩니다. 이후 상한선에 대해서는 Anthropic이 발표하지 않았습니다. 별도 공지가 없다면 기본 수준으로 돌아간다고 가정하는 것이 안전합니다.

활성화하기 위해 별도로 해야 할 일이 있나요?

아니요. 이미 계정에 적용되어 있습니다. Claude Code CLI에서 /usage 명령으로 상태를 확인하면 됩니다.

/usage

50% 증가는 5시간 제한에도 적용되나요?

아니요. 50% 증가는 주간 제한에 적용됩니다. 5시간 제한은 그 전 주에 별도로 2배 증가했습니다. 두 변경은 7월 13일까지 동시에 적용됩니다.

기간 중에 다른 요금제로 업그레이드하면 어떻게 되나요?

Anthropic은 이에 대해 구체적인 지침을 발표하지 않았습니다. 기존 사용량 기간의 동작 방식에 따르면, 업그레이드 시점부터 새 요금제의 인상된 제한이 적용될 가능성이 높지만 공식적으로 확정된 내용은 아닙니다.

이 변경이 Anthropic API 플랜에도 적용되나요?

아니요. 이 변경은 Claude Code 요금제(Pro, Max, Team, 시트 기반 Enterprise)에만 적용됩니다. Anthropic API를 직접 호출하는 경우 속도 제한은 별도로 관리되며 변경되지 않았습니다.

이 변경은 영구적인가요?

알 수 없습니다. Anthropic은 7월 13일까지의 임시 기간으로 명시했습니다. 따라서 앞으로 8주를 실제 사용량을 측정하고, 더 높은 한도가 업무에 필요한지 검증하는 기간으로 활용하는 것이 좋습니다.

DEV Community