Claude Code 토큰 사용량을 확인하고 줄이는 법
업데이트 September 27, 2026 · 최초 게시 September 27, 2026
/usage로 Claude Code가 무엇을 소모하는지 보고, /context로 컨텍스트 창을 무엇이 채우는지 확인하십시오. 지출을 줄이려면 컨텍스트를 작게 유지하십시오. 작업 사이마다 비우고, effort 수준을 낮추고, 장황한 출력을 주 대화 밖에 두십시오. Claude Code는 요청마다 전체 대화를 다시 보내기 때문에 컨텍스트가 다른 무엇보다 중요합니다. 당사 로그에서 토큰의 96%는 에이전트가 자신의 컨텍스트를 다시 읽는 데 쓰였습니다.
이 페이지는 사용량을 보여 주는 명령어, 사용량을 가장 크게 바꾸는 설정, 그리고 토큰이 실제로 어디로 가는지를 다룹니다. 팁은 Anthropic의 비용 문서에서 가져왔습니다. 수치는 당사 자체 Claude Code 로그와 공개된 벤치마크에서 나왔습니다.
Claude Code 토큰 사용량은 어떻게 확인합니까?
/usage: 현재 세션의 토큰 수와 추정 비용, 프롬프트 캐시(prompt cache) 줄을 보여 줍니다. Pro, Max, Team, Enterprise 플랜에서는 플랜 사용량 막대도 보여 줍니다. 또한 지난 24시간 또는 7일 동안 스킬, 서브에이전트, 플러그인, MCP 서버, 예약된 루프가 플랜을 얼마나 쓰는지 분해해 보여 줍니다./context: 지금 컨텍스트 창을 무엇이 차지하는지, 무엇을 줄일지에 대한 힌트와 함께 보여 줍니다./insights: 최근 세션과 시간·토큰이 새는 지점을 정리한 HTML 보고서를 작성합니다.- 상태 줄(status line): 스크립트로 모든 프롬프트에 비용, 사용 중인 컨텍스트, 5시간 및 7일 플랜 사용 비율을 표시할 수 있습니다. 상태 줄 문서를 보십시오.
- claude.ai Settings > Usage: 플랜 한도와 사용 크레딧 지출을 보여 주며, 다른 기기에서의 사용도 포함합니다.
Pro 또는 Max 플랜에서 /usage의 달러 금액은 실제로 지불하는 금액이 아니라, 그 세션을 API 정가로 계산했을 때의 비용입니다. 그래도 세션이 얼마나 무거운지 나타내는 단일 지표로는 가장 좋습니다.
Claude Code 토큰은 실제로 어디로 갑니까?
대부분 컨텍스트를 다시 읽는 데 씁니다. 모든 요청은 전체 대화를 싣고, 모든 도구 호출은 결과를 담은 또 다른 요청을 보냅니다. 당사 Claude Code 로그 전체에서 70억 캐시 읽기 토큰은 전체 토큰의 96%였고, API 환산 청구액 $6,986의 절반이었습니다. 출력 토큰, 즉 사용자가 보는 부분은 전체 양의 1% 미만이었습니다.
그래서 하루 종일 열어 둔 세션에서 던진 한 줄짜리 질문도 싸지 않습니다. 하루치 맥락을 통째로 끌고 가기 때문입니다. 플랜별 토큰 페이지에 전체 내역이 있습니다. Max 20x 한 주는 약 19억 토큰, Max 5x 세션은 약 39M 토큰입니다.
Claude Code 토큰 사용량은 어떻게 줄입니까?
사용량에 가장 크게 영향을 주는 변경들을, 대략 효과가 큰 순서로 정리했습니다.
- 관련 없는 작업 사이에 비우십시오.
/clear는 새 컨텍스트를 시작하며 비용이 들지 않습니다. 나중에 예전 세션을/resume하려면 먼저/rename을 쓰십시오. - effort 수준을 낮추십시오. Artificial Analysis 실행에서 Opus 5.5 한 작업은 max effort에서 $5.98, medium에서 $1.34가 들었습니다. 설정 하나로 4.5배 차이입니다.
/effort로 바꿉니다. 자세한 내용은 effort 수준별 비용 페이지를 보십시오. - 모델을 작업에 맞추십시오. Anthropic은 대부분의 코딩에 Sonnet을, 어려운 설계나 여러 단계 작업에 Opus를 권장합니다.
/model로 바꾸고, 단순한 서브에이전트에는model: haiku를 설정하십시오. - 세션 중간에 긴 휴식을 피하십시오. 프롬프트 캐시는 구독에서 1시간, 사용 크레딧이나 API 키에서 5분 동안 유지됩니다. 만료 후 돌아오면 전체 컨텍스트를 정가로 다시 처리하게 됩니다.
- 시끄러운 출력을 주 컨텍스트 밖에 두십시오. 테스트 실행, 로그 읽기, 문서 가져오기는 서브에이전트에 맡겨 요약만 돌아오게 하십시오. 훅(hook)으로 10,000줄짜리 로그를 Claude가 보기 전에 오류 줄만 걸러 낼 수도 있습니다.
- 시작 시 로드되는 것을 줄이십시오. CLAUDE.md는 약 200줄 이하로 유지하고, 워크플로 전용 지침은 필요할 때만 로드되는 스킬로 옮기십시오. 쓰지 않는 MCP 서버는
/mcp로 끄십시오. 같은 일을 하는 CLI 도구(예:gh)가 있으면 그것을 우선하십시오. - 구체적으로 요청하고 먼저 계획하십시오. “이 코드베이스를 개선해”라고 하면 Claude는 전부 훑습니다. 계획 모드(Shift+Tab)는 잘못된 접근을 전체 구현 비용이 들기 전에 잡아냅니다.
- 백그라운드 작업을 감시하십시오. 예약된 루프, 에이전트 팀원, 유휴 서브에이전트는 전체 컨텍스트를 계속 보냅니다. 팀원이 계획 모드로 돌 때 에이전트 팀은 일반 세션의 약 7배 토큰을 씁니다.
/compact는 토큰을 절약합니까?
이후 요청에서만 절약되며, 큰 컨텍스트를 압축하는 것 자체가 큰 요청입니다. /compact는 요약을 위해 대화 전체를 읽습니다. 이력이 필요 없다면 /clear가 더 쌉니다. 필요하다면 지시문과 함께 /compact(예: /compact keep the API changes and failing tests)를 쓰면 중요한 내용을 남길 수 있습니다. /autocompact로 자동 압축 임계값을 더 일찍 설정할 수도 있습니다.
개발자 한 명당 Claude Code 비용은 얼마입니까?
Anthropic은 엔터프라이즈 배포 기준 활성 개발자 1인당 하루 약 $13, 월 $150~$250이라고 밝혔고, 사용자의 90%는 하루 $30 미만이라고 했습니다. 이는 API 요율로 청구된 금액입니다. 구독의 경우 질문은 어느 플랜의 한도에 먼저 닿느냐가 됩니다. Claude Max 주간 한도 페이지는 Max 20x 한 주를 API 환산 약 $1.86k 사용량으로 평가합니다.
팀은 Claude Code 사용량을 어떻게 추적합니까?
- Team 및 Enterprise 플랜: 조직 분석의 지출 보고서에서 사용자별 CSV로 볼 수 있습니다. Enterprise에는 분석 API도 있습니다. 지출 한도는 관리자 설정에서 정합니다.
- API(Claude Console): Console의 사용량 페이지와 워크스페이스별 지출 한도.
- 모든 설정:
CLAUDE_CODE_ENABLE_TELEMETRY=1을 설정하면 사용자별 토큰과 비용 지표를 OpenTelemetry로 자체 스택에 내보낼 수 있습니다. 모니터링 문서를 보십시오.
계약 요율로 지불한다면, 관리형 설정 modelPricing으로 /usage와 OpenTelemetry의 비용 수치를 정가 대신 계약 내용과 맞출 수 있습니다.
출처
- Claude Code 문서: 비용을 효과적으로 관리하기
- Claude Code 문서: 상태 줄
- Claude Code 문서: 사용량 모니터링
- Artificial Analysis: 모델 벤치마크와 작업당 비용
관련 글
이 내용을 현재 스택에 적용하고 싶으신가요? 공급업체 청구서, 게이트웨이 로그, 주요 워크플로를 가져오시면 비용 요인과 절감 경로를 정리해드립니다. 무료 감사 예약 →