Claude Code 토큰 사용량 줄이기

Claude Code 토큰 사용량을 줄이려면 모델이 매 턴마다 처리해야 하는 작업을 제어하세요. 요청이 긴 대화, 여러 파일 읽기, 명령 출력, 프로젝트 지침, 도구 정의 및 그 뒤에 있는 확장된 사고를 전달하는 경우 짧은 대답은 여전히 ​​비용이 많이 들 수 있습니다.

유용한 목표는 하나의 응답에서 가장 적은 토큰이 아닙니다. 이는 연구, 편집, 테스트, 수정 및 인적 검토를 포함하여 허용된 변경에 대한 최저 총 비용입니다.

이 가이드에서는 /usage, /context, /clear, /compact, /model, /effort 및 /mcp와 같은 최신 Claude Code 컨트롤을 사용합니다. 이는 API 청구 세션에 가장 직접적으로 적용됩니다. 구독 계획은 요청별 송장이 아닌 허용 창을 사용하지만 동일한 맥락 습관은 허용이 더 오래 지속되는 데 도움이 될 수 있습니다.

Claude Code가 채팅 답변보다 더 많은 토큰을 사용하는 이유

Claude Code는 단일 프롬프트와 단일 응답이 아닌 에이전트입니다. 작업 세션에는 다음이 포함될 수 있습니다.

• 귀하의 프롬프트와 관련된 모든 이전 차례;
• Claude가 저장소를 탐색하는 동안 읽는 파일;
• 명령, 테스트, 컴파일러 및 도구 출력;
• CLAUDE.md, 적용 가능한 프로젝트 규칙 및 호출 기술;
• MCP 서버의 도구 정의 및 결과;
• 계획, 확장된 사고, 생성된 코드 및 설명;
• 하위 에이전트 요약 및 후속 수정 사항.

컨텍스트는 누적됩니다. 오래된 로그나 관련 없는 설계 논의가 대화에 남아 있으면 나중에 차례가 되면 다시 처리할 수 있습니다. 신속한 캐싱은 반복되는 콘텐츠의 가격을 낮출 수 있으며, Claude Code는 컨텍스트 제한에 가깝게 기록을 자동으로 압축하지만, 관련 없는 자료를 영원히 보관할 이유는 없습니다.

이는 실제적인 작업 순서로 이어집니다.

1. 하나의 대표적인 작업을 측정합니다.
2. 관련 없는 컨텍스트를 제거합니다.
3. 스탠딩 지침 및 도구 오버헤드를 줄입니다.
4. 광범위한 탐색과 시끄러운 출력을 방지합니다.
5. 의도적으로 모델과 노력을 선택하십시오.
6. 완료된 작업을 다시 측정하세요.

느낌이 아닌 기준점부터 시작하세요

최적화하기 전에 /usage를 실행하세요. API 사용자의 경우 세션 블록은 모델별 토큰 사용량과 표준 정가 요금에 따른 현지 비용 추정치를 보고합니다. 해당 견적에는 게이트웨이 프로모션 또는 계약 요금이 포함되지 않을 수 있으므로 공급자의 청구서를 재정적 정보 소스로 사용하세요.

/context를 실행하여 현재 컨텍스트 창을 차지하는 것이 무엇인지 확인하세요. 여기에서는 추측을 유지하는 대신 대규모 CLAUDE.md, 호출된 기술 또는 도구 오버헤드가 표시됩니다.

세션에서 OmniaKey를 사용하는 경우 해당 로컬 진단을 사용 대시보드와 비교하세요. 요청된 모델, 입력 및 출력 토큰, 캐시 메타데이터, 대기 시간, 실제 호출당 비용을 기록합니다. 잔고 및 사용 가이드에는 계정 잔액, 키캡, 사용 기록이 설명되어 있습니다.

전후 확인을 위해 반복 가능한 작업 하나를 선택합니다. 기록:

관련되지 않은 두 세션을 비교하지 마십시오. 오타 수정과 익숙하지 않은 마이그레이션은 유용한 토큰 벤치마크를 제공하지 않습니다.

1. 관련 없는 작업 간 지우기

가장 가치 있는 습관은 가장 간단하기도 합니다. 다음 작업에 현재 대화가 필요하지 않을 때 /clear를 사용하세요.

나중에 필요할 수 있는 세션을 지우기 전에 이름을 지정하십시오.

/rename auth-refresh-investigation
/clear

이전 세션은 /resume를 통해 계속 사용할 수 있습니다. 현재 Claude Code는 또한 /clear 이후에 /usage에 표시된 세션 총계를 재설정하므로 다음 작업을 별도로 측정하기가 더 쉽습니다.

삭제해야 하는 좋은 이유는 다음과 같습니다.

• 백엔드 버그에서 관련 없는 마케팅 카피로 이동
• 기능을 마무리하고 새 저장소 영역을 시작합니다.
• 가정이 잘못된 접근 방식을 포기합니다.
• 더 이상 결정에 영향을 미치지 않는 여러 개의 큰 로그를 가지고 있습니다.

단순히 컨텍스트 미터가 이동했다는 이유만으로 삭제하지 마세요. 작업이 여전히 진행 중인 경우 확인된 사실과 결정을 먼저 보존하거나 명시적인 지침으로 대화를 압축하세요.

2. 장시간 작업 중에 의도적으로 컴팩트

/compact는 이전 기록을 요약하므로 나중에 더 작은 표현으로 작업할 수 있습니다. 살아남아야 하는 항목의 이름을 지정하는 명령을 추가합니다.

/compact Preserve the acceptance criteria, changed files, failing test output, and unresolved decisions.

이는 긴 구현에 대한 일반적인 요약보다 안전합니다. 프로젝트 전체에 동일한 보존 규칙이 적용되는 경우 CLAUDE.md에 짧은 압축 지침을 배치할 수도 있습니다.

압축은 구독 사용량 재설정과 동일하지 않으며 컨텍스트 경고는 청구 한도 경고가 아닙니다. 압축은 대화에 남아 있는 내용을 관리합니다. 플랜 수당을 추가하거나 API 잔액을 충전하지 않습니다.

작업이 여전히 일관성이 있지만 현재 상태로 가는 경로가 복잡할 때 사용하세요. 작업 자체가 변경된 경우에는 /clear를 사용하세요.

3. 작업 시작 전에 로드되는 컨텍스트 축소

Claude Code는 세션 시작 시 프로젝트 지침을 읽습니다. 유용한 지침은 실수를 방지합니다. 모든 세션에 복사된 핸드북은 작업에 필요한지 여부에 관계없이 컨텍스트를 소비합니다.

Anthropic의 현재 지침에서는 CLAUDE.md를 간결하게 유지하고 전문적인 워크플로를 필요에 따라 로드되는 기술로 이동할 것을 권장합니다. 좋은 루트 파일에는 다음이 포함됩니다.

• 변경 사항을 확인하는 명령;
• 저장소별 아키텍처 경계;
• 불분명한 환경 제약;
• 일반 언어 기본값과 다른 규칙입니다.

긴 API 튜토리얼, 일회성 마이그레이션 런북, 도메인 참조 자료를 다른 곳으로 이동하세요. 모든 세션에 포함시키는 대신 해당 기술에 연결하거나 집중 기술로 패키지화하세요.

MCP 서버도 비슷한 절충안을 만듭니다. /mcp를 실행하고 사용하지 않는 서버를 비활성화하십시오. Claude Code는 기본적으로 전체 도구 정의를 연기하지만 이름과 호출된 스키마는 여전히 컨텍스트를 차지합니다. 간단한 작업의 경우 gh, aws 또는 sentry-cli와 같은 집중형 CLI는 넓은 도구 표면을 로드하는 것보다 상황 효율적일 수 있습니다.

가지치기 후 /context를 다시 확인하세요. 시작 공간이 변경되지 않은 경우 추가 구성을 편집하기 전에 실제 큰 기여자를 찾으십시오.

4. 검색 루프를 피할 수 있을 만큼 작업 범위를 좁힙니다.

"이 저장소 개선"은 검사를 초대합니다. 제한된 프롬프트는 증거로 직접 이동할 수 있습니다.

Fix the 401 after token refresh in src/api/auth.ts.
Preserve the public response shape.
Add a regression test for an expired access token with a valid refresh token.
Run the focused auth test and the type checker.

프롬프트는 증상, 가능한 파일, 계약 및 증거를 식별합니다. Claude는 필요할 때 종속성을 검사할 수 있지만 전체 코드베이스를 읽지 않는 이유가 있습니다.

정말 복잡한 작업의 경우 편집하기 전에 계획을 세우세요. 짧은 연구 및 계획 단계를 통해 잘못된 아키텍처에 대한 비용이 많이 드는 구현을 방지할 수 있습니다. 한 줄의 올바른 위치 수정의 경우 계획에 오버헤드가 발생할 수 있습니다. 불확실성이 현실일 때 사용하세요.

코스가 일찍 정확합니다. Claude가 잘못된 문제를 해결하고 있다면 큰 패치가 생성되도록 두고 패치를 취소해야 하는 이유를 설명하는 대신 턴을 중지하세요. /rewind는 이전 대화와 코드 체크포인트를 복원할 수 있습니다.

출력 계약은 다음에도 도움이 됩니다.

• 결정을 이끌어 내십시오.
• 변경된 파일과 확인 결과만 나열합니다.
• 프롬프트를 반복하지 마십시오.
• 구현 전에 누락된 정보를 요청합니다.
• 잘라내기가 필요한 증거를 숨기지 않는 경우에만 아티팩트를 제한하십시오.

짧은 산문은 일부 출력 토큰을 저장합니다. 탐색과 재작업을 피하면 일반적으로 더 많은 비용을 절약할 수 있습니다.

5. 도구 및 테스트 출력에 집중 유지

대규모 명령 출력이 작업 컨텍스트에 들어갑니다. 변경 사항을 증명할 수 있는 가장 좁은 명령을 선호합니다.

pnpm vitest run tests/unit/auth.test.ts
rg -n "FAIL|ERROR" test-output.log
git diff --check

단지 토큰을 줄이기 위해 실패를 숨기지 마십시오. 실패한 어설션, 관련 스택 프레임, 명령 종료 상태 및 원인을 진단하기에 충분한 주변 출력을 유지합니다. 반복되는 진행률 표시줄, 성공적인 테스트 목록 및 관련되지 않은 수천 개의 로그 줄을 삭제하세요.

안정적인 전처리는 스크립트나 후크에 속합니다. Anthropic의 비용 가이드는 Claude가 보기 전에 매우 큰 테스트 로그를 필터링하는 예를 제공합니다. 검토된 작은 필터는 모델이 실행될 때마다 동일한 노이즈 패턴을 재발견하도록 요청하는 것보다 더 안정적입니다.

많은 파일 읽기가 필요한 연구의 경우 제한된 하위 에이전트는 기본 대화에서 자세한 탐색을 방지하고 짧은 결과를 반환할 수 있습니다. 이는 컨텍스트를 분리합니다. 하위 에이전트에는 자체 컨텍스트가 있으므로 더 적은 총 토큰 수를 보장하지 않습니다. 주요 작업에서 요약 내용을 반복해서 읽는 것을 방지할 때 사용하세요.

6. 일치 모델 및 결정에 대한 노력

모델 선택에 따라 속도와 필요한 시도 횟수가 모두 변경됩니다. Claude Sonnet 5는 실용적인 일일 시작점이고, Claude Haiku 4.5는 좁은 반복 작업에 적합하며, Claude Opus 5는 아키텍처, 모호성 또는 오류 비용이 높을 때 정당화하기가 더 쉽습니다.

의도적으로 전환하려면 /model를 사용하십시오. Claude Code 모델 가이드는 더 완전한 작업 라우팅 정책을 제공합니다.

확장된 사고 토큰은 API 경로에서 출력 토큰으로 청구됩니다. 간단하고 잘 지정된 작업의 경우 /effort를 사용하여 노력을 줄이고 결과가 여전히 통과하는지 측정하세요. 어려운 계획이나 익숙하지 않은 디버깅의 경우 너무 적은 노력으로 저장 내용이 지워지는 재시도가 발생할 수 있습니다.

모든 작업을 가장 저렴한 모델로 라우팅하지 말고 정책을 최적화라고 부르세요. 수정 및 부채 검토를 포함하여 승인된 결과당 비용을 비교합니다.

7. 사용량 감소 후 금융 가드레일 추가

지출 한도는 토큰 소비를 줄이지 않습니다. 루프, 키 유출 또는 예상치 못한 워크로드로 인해 요청이 계속 전송되는 경우 재정적 피해를 제한합니다.

OmniaKey를 사용하면 API 키 대시보드에서 로컬 개발, 자동화, 공유 워크로드를 위한 별도의 키를 생성할 수 있습니다. 각 키에 해당 기능에 맞는 한도를 부여한 다음 키를 올리기 전에 사용법을 검토하세요. 별도의 키를 사용하면 어디에서나 하나의 무제한 자격 증명보다 귀속 및 취소가 더 명확해집니다.

순서가 중요합니다:

1. 불필요한 컨텍스트 및 재시도를 제거합니다.
2. 일반적인 작업 비용을 측정합니다.
3. 정당한 차이보다 한도를 설정합니다.
4. 워크로드가 해당 경계를 넘으면 경고하거나 중지합니다.

한도가 너무 낮으면 비용 문제가 작업 중간 실패로 바뀔 뿐입니다. 사용량 검토가 없는 한도는 한도에 도달했다는 것만 알려줍니다.

10 분 Claude Code 토큰 감사

하나의 실제 세션에서 다음 체크리스트를 사용하십시오.

1. /usage를 실행하고 모델별 사용량을 기록합니다.
2. /context를 실행하고 피할 수 있는 최대 기여자를 식별합니다.
3. 현재 작업이 이전 대화와 관련이 없는 경우 /clear를 사용하세요.
4. CLAUDE.md를 줄이세요; 전문 지침을 주문형 기술로 이동합니다.
5. /mcp를 사용하여 사용되지 않는 MCP 서버를 비활성화합니다.
6. 광범위한 프롬프트를 파일, 증상, 경계 및 승인 확인으로 대체합니다.
7. 실패를 숨기지 않고 집중 테스트를 실행하고 반복 출력을 필터링합니다.
8. 작업 난이도에 따라 /model와 /effort를 사용하세요.
9. 동일한 작업 클래스를 반복하고 완료된 작업 비용을 비교합니다.
10. 정상 범위를 알고 나면 키별 캡을 추가하세요.

한 번에 하나 또는 두 개의 변수를 변경하십시오. 세션을 지우고, 모델을 변경하고, 노력을 덜고, 작업을 동시에 다시 작성하면 어떤 변경이 도움이 되었는지 알 수 없습니다.

일반적인 실수

짧은 답변만 요구

이렇게 하면 눈에 보이는 출력이 줄어들지만 파일 읽기, 기록, 도구 및 생각은 그대로 유지됩니다. 유용하지만 가장 큰 레버는 거의 없습니다.

작업에 여전히 필요한 컨텍스트 삭제

제약조건이 누락되면 추측과 재작업이 발생합니다. 지우거나 압축하기 전에 검증된 결정을 보존합니다.

캐시 적중을 사용량이 0인 것으로 처리

프롬프트 캐싱을 사용하면 반복 입력 가격을 낮출 수 있지만 캐시된 토큰은 여전히 사용량 계산에 표시됩니다. 반복되는 상황을 유용하게 유지하고 실제 청구 기록을 확인하세요.

모든 작은 질문에 하위 에이전트 사용

각 하위 에이전트에는 자체 시작 및 작업 컨텍스트가 있습니다. 제한된 대용량 탐색을 위임합니다. 현재 세션에서 작은 로컬 질문에 답하세요.

한도와 최적화를 혼동하기

키 캡은 경계에서 지출을 중지합니다. 해당 경계 아래의 요청을 더 효율적으로 만들지는 않습니다.

자주 묻는 질문

답변이 짧을 때 Claude Code 토큰 사용량이 높은 이유는 무엇입니까?

요청에는 최종 텍스트보다 훨씬 큰 대화 기록, 프로젝트 지침, 파일, 명령 출력, 도구 및 생각이 포함될 수 있습니다. 답변 길이로 판단하기보다는 /context 및 /usage를 확인하세요.

/clear는 이전 Claude Code 세션을 삭제합니까?

새로운 세션이 시작됩니다. 중요한 작업의 이름을 먼저 바꾸고 /resume를 사용하여 나중에 보존된 세션으로 돌아갑니다.

/compact는 항상 청구서를 줄여 주나요?

이는 향후 턴으로 전달되는 기록을 줄여 나중에 입력 사용량을 낮출 수 있습니다. 순 효과는 세션이 지속되는 기간과 요약이 보존하는 내용에 따라 달라지므로 /usage 및 청구 대시보드를 통해 확인하세요.

토큰을 저장하려면 항상 Haiku를 사용해야 합니까?

아니요. 좁은 작업에는 더 저렴한 모델이 경제적일 수 있지만 반복적으로 실패한 시도는 성공적인 Sonnet 또는 Opus 턴보다 더 많은 비용이 들 수 있습니다. 작업별로 라우팅하고 승인된 결과를 측정합니다.

API 키 지출 한도가 토큰 사용량을 줄일 수 있습니까?

아니요. 요청이 사용량을 소비한 후에 지출이 제한됩니다. 캡을 더 작은 맥락, 집중된 프롬프트, 신중한 모델 노력 및 호출별 검토와 결합합니다.

출처

• Anthropic: Claude Code 비용 관리
• Anthropic: Claude Code 컨텍스트 창 탐색
• Anthropic: Claude Code 모범 사례
• Anthropic: Claude Code 모델 구성 및 노력
• Anthropic: 프롬프트 캐싱
• OmniaKey 잔액 및 사용 문서

사실 확인된 2026년 8월 8일. Claude Code 명령, 모델 동작 및 청구서 표면이 변경되었습니다. 생산 예산을 설정하기 전에 연결된 자사 문서와 실제 사용 기록을 확인하세요.