Claude Code 요금 폭탄의 원인 (그리고 해결 방법)

영상 흐름

1. 0100:00

   토큰 비용과 새 채팅

   새 메시지마다 대화 컨텍스트가 포함되므로, 채팅이 길어지고 이전에 읽은 파일이 많을수록 이후 메시지의 비용이 늘어날 수 있습니다. 새 작업에는 `/clear`를 사용하세요. `/rename`을 사용하면 이전 채팅을 찾아 다시 열 수 있습니다.

   Claude Code
2. 0201:19

   캐시 재사용 및 만료

   Claude Code는 변경되지 않은 채팅 컨텍스트를 캐시에서 재사용해 일반적인 읽기 비용의 일부만 청구할 수 있지만, 모델을 바꾸면 전체를 다시 읽어야 합니다. 안내된 캐시 유지 시간은 월간 요금제에서 약 1시간, API 또는 추가 크레딧 사용 시 5분입니다.

   Claude CodeBuilding effective agents
3. 0303:17

   커넥터, 긴 결과, 서브에이전트

   Claude Code는 필요할 때만 커넥터 세부 정보를 불러오고, 매우 긴 결과는 별도로 저장하며, 서브에이전트의 결과는 짧은 요약으로 반환합니다. 커넥터와 서브에이전트에도 토큰 비용이 발생하므로, 서브에이전트는 대규모의 복잡한 작업에서 주로 유용합니다.

   Claude CodeSlackGitHub
4. 0404:22

   compact가 유용한 경우와 채팅을 지우거나 인계할 경우

   `/compact`는 채팅을 읽어 요약을 만드므로 비용을 줄이는 지름길은 아닙니다. 거의 가득 찬 채팅을 계속해야 하거나 관련 프로젝트를 다음 단계로 이어갈 때 사용하세요. 관련 없는 작업에는 `/clear`, 잘못 진행된 경우에는 `/rewind`를 사용하세요. 새 채팅에서 계속해야 하는 작업이라면 인계 문서에 필요한 세부 정보를 보존할 수 있습니다.

   Claude CodeHandoff document
5. 0507:04

   캐시 만료 후 재읽기와 모델 변경

   캐시가 만료된 뒤에는 다음 메시지에서 전체 채팅을 정가로 다시 읽습니다. 최근 Claude Code 버전은 만료 전에 오랫동안 유휴 상태였던 큰 채팅을 compact할 수 있지만, 그래도 전체를 다시 읽어야 하며 세부 정보가 빠질 수 있습니다. Opus와 Sonnet 사이를 전환해도 다시 읽기가 필요하므로, 작업을 시작하기 전에 모델을 선택하고 그대로 사용하면 추가 비용을 피할 수 있습니다.

   Claude CodeOpusSonnet
6. 0609:06

   시작 컨텍스트와 도구를 간결하게 유지하기

   `CLAUDE.md`는 채팅을 시작할 때마다 읽히므로 200줄 미만으로 유지하고, 작업별 파일을 안내하는 색인으로 사용하세요. 스킬은 필요할 때 지침을 불러오고 스크립트를 사용해 반복 계산을 로컬에서 수행할 수 있습니다. 사용하지 않는 커넥터는 `/mcp`로 비활성화하고, `/context`로 컨텍스트를 확인하며, `/doctor`로 설정 문제를 점검하세요.

   CLAUDE.mdClaude Code skillsClaude Code
7. 0711:26

   테스트 출력이 컨텍스트에 들어가기 전에 줄이기

   긴 테스트 출력은 채팅에 여러 줄을 추가하고 이후 메시지에서 다시 읽히게 할 수 있습니다. 훅을 사용해 테스트 결과를 필터링하면 Claude가 통과한 모든 줄 대신 실패한 항목만 확인할 수 있습니다.

   Claude Code hooksClaude Code
8. 0812:02

   경제적인 기본값과 구체적인 대상 선택

   Opus와 확장 사고는 일반적인 작업에 필요한 것보다 비용이 더 들 수 있으므로, 빌드에는 Sonnet을 사용하고 간단한 작업에는 낮은 노력 설정을 사용하세요. 계획 모드는 변경을 시작하기 전에 접근 방식을 정하는 데 도움이 됩니다. 체크아웃 파일처럼 대상을 구체적으로 지정하면 관련 없는 파일을 읽지 않게 할 수 있지만, 프롬프트만 짧게 써서는 Claude가 읽는 컨텍스트가 크게 줄지 않습니다.

   Claude CodeOpusSonnet
9. 0913:14

   일주일 동안 사용량 확인하기

   작업 중에는 모델 하나를 사용하고, 캐시가 유효할 때 계속 진행하며, 작업이 끝나면 채팅을 지워 캐시를 효과적으로 활용하세요. 공간이 필요할 때만 compact를 사용하세요. 일주일간 변경 사항을 적용하기 전후에 `/usage`를 확인하세요. 사용량이 줄면 월간 요금제에서 더 여유 있게 사용할 수 있거나 API 비용이 줄어듭니다.

   Claude Code