클로드 코드(Claude Code) 한계 문제 드디어 해결

하이라이트

• 클로드 프로 플랜은 5시간당 약 45개, 맥스 플랜은 225개, 맥스 20배 플랜은 900개의 메시지 제한을 적용한다.

• 오퍼스(Opus) 모델은 소네트(Sonnet)보다 약 3배 많은 토큰을 소비하여 메시지 제한 수치를 더 빠르게 소모한다.

• Claude.md 파일은 프로젝트 전체에 적용되는 범용 지침만 포함하여 300줄 미만으로 유지하는 것이 토큰 효율에 유리하다.

• 리와인드(rewind) 명령이나 ESC 키를 두 번 누르는 동작으로 잘못된 구현 시점을 삭제하여 컨텍스트 비대화를 방지한다.

• 프롬프트 캐싱 비활성화를 거짓(false)으로 설정하면 반복되는 시스템 프롬프트나 대화 접두사에 대한 토큰 비용을 절감한다.

• 생각(thinking) 기능을 완전히 비활성화하면 모델의 내부 추론 단계를 생략하고 즉시 응답을 생성하여 컨텍스트 공간을 확보한다.

타임라인

1. 00:00 - 03:02

   클로드 요금제별 메시지 제한 및 작동 원리

   5시간의 창은 첫 메시지를 보내는 시점부터 시작하며 사용하지 않는 시간에도 계속 흐른다. 오퍼스 모델은 소네트 대비 3배의 컴퓨팅 자원을 사용하여 토큰 소모가 극심하다. 앤스로픽은 사용자가 몰리는 피크 시간대에 세션 제한을 더 공격적으로 적용하여 가용성을 조절한다.

   • 유료 요금제는 5시간 단위의 시간 창 내에서 보낼 수 있는 메시지 수가 정해져 있다.
   • 프로 플랜은 5시간당 45개, 맥스 플랜은 225개의 메시지를 제공하며 기기 구분 없이 합산된다.
   • 작업의 복잡도가 높거나 오퍼스 모델을 사용하면 실제 제공 메시지 수보다 훨씬 빨리 제한에 도달한다.
2. 03:03 - 04:47

   내부 오류 및 컨텍스트 비대화 문제

   클로드 코드의 내부 구조 분석 결과, 잘린 응답이나 오류 메시지가 포함된 기록이 재시도 시 함께 전송되는 문제가 발견되었다. 이는 대화가 길어질수록 요청당 토큰 사용량을 기하급수적으로 늘리는 원인이 된다. 공식적인 제한 외에도 이러한 내부적인 토큰 낭비 요소가 산재한다.

   • 레이트 리밋 발생 시 생성된 부분 응답이 컨텍스트에 남아 토큰을 무의미하게 점유한다.
   • 불필요하게 주입되는 기술 목록(skill listings)은 실제 작업 효율 대비 컨텍스트 공간만 낭비한다.
3. 04:48 - 06:40

   세션 내 토큰 절약을 위한 핵심 명령과 전략

   클로드는 매 메시지마다 시스템 프롬프트와 이전 대화 전체를 다시 보내기 때문에 세션 관리가 필수적이다. 리와인드(rewind) 명령은 잘못된 코드 생성 시점을 삭제하여 모델이 오류가 포함된 과거 데이터를 참조하지 않게 차단한다. 초기에 기획(planning)에 토큰을 투자하면 나중에 발생할 대규모 코드 수정과 그에 따른 토큰 낭비를 방지한다.

   • 작업 단계가 바뀔 때는 clear 명령으로 이전 컨텍스트를 완전히 삭제한다.
   • 기존 맥락 유지가 필요하다면 compact 명령을 통해 전체 대화를 요약본으로 압축한다.
   • 사이드 질문은 by the way 명령을 사용하여 메인 세션 컨텍스트에 영향을 주지 않고 해결한다.
4. 06:41 - 09:55

   프로젝트 구조화 및 Claude.md 최적화

   자동 생성된 Claude.md 파일은 종종 중복되고 불필요한 정보를 포함하므로 수동 편집이 권장된다. 데이터베이스 스키마와 같은 상세 문서는 별도 파일로 분리하고 Claude.md에서 링크만 걸어 필요할 때만 호출하게 한다. 특정 세션에서만 필요한 지침은 '시스템 프롬프트 추가' 플래그를 사용하여 영구적인 컨텍스트 비대화를 막는다.

   • Claude.md 파일은 300줄 미만으로 작성하여 모델의 집중도와 토큰 효율을 높인다.
   • AI가 이미 알고 있는 일반적인 프레임워크 실행 명령어나 파일 아키텍처 설명은 삭제한다.
   • 영역별 규칙 파일(Rules)을 분리하여 클로드가 현재 작업 중인 경로의 정보만 로드하게 설계한다.
5. 09:56 - 13:19

   모델 설정 및 백그라운드 프로세스 제어

   생각(thinking) 기능을 끄면 추론 과정에 드는 토큰을 아끼고 즉각적인 답변을 얻을 수 있다. .claud 폴더의 설정값 조정을 통해 드림(dream)이나 메모리 리팩토링 같은 백그라운드 작업을 중단시킬 수 있다. 최대 출력 토큰 수를 수동으로 제한함으로써 모델이 지나치게 긴 응답을 생성하여 제한 수치를 깎아먹는 상황을 통제한다.

   • 단순 작업은 하이쿠(Haiku) 모델을 사용하고 노력(effort) 수준을 낮게 설정한다.
   • 프롬프트 캐싱을 활성화하여 반복 구간에 대한 비용 발생을 억제한다.
   • 자동 메모리와 백그라운드 인덱싱 작업을 비활성화하여 유휴 시간의 토큰 소모를 차단한다.