나는 어리석은 일에 토큰을 많이 소모하고 있었다
Source: Dev.to
토큰 소모 문제
많은 사용자들이 Claude가 예상보다 훨씬 빠르게 토큰을 소비한다는 점을 눈치챘습니다. Anthropic은 최근 피크 시간대에 5시간 세션 제한을 강화한다고 발표했으며, 이에 따라 토큰이 어디에 사용되는지 자세히 살펴보게 되었습니다.
주된 원인은 불필요한 파일 읽기였습니다: 락 파일, 빌드 산출물, node_modules, 커버리지 보고서, 그리고 다양한 미디어 파일 등. Claude가 코드베이스를 탐색할 때마다 이러한 파일들에 토큰을 소모하게 됩니다.
.claudeignore 파일 사용하기
Claude가 관련 없는 파일을 읽지 않도록 프로젝트 루트에 .claudeignore 파일을 생성합니다. 이는 .gitignore와 동일하게 동작하여 Claude에게 일치하는 경로를 건너뛰라고 알려줍니다.
# Dependencies
node_modules/
.pnp.*
# Build artifacts
.next/
out/
build/
dist/
# Lock files (huge, no value to read)
package-lock.json
pnpm-lock.yaml
yarn.lock
# Minified bundles
*.min.js
*.min.css
# Generated code
next-env.d.ts
*.tsbuildinfo
# Caches
.cache/
__pycache__/
coverage/
# Environment / secrets
.env*
.vercel/
# Large non-code files
*.gif
*.mov
*.mp4
*.png
*.jpg이 파일을 두면 Claude는 패턴에 일치하는 파일이나 디렉터리를 무시하게 되며, 파일 탐색 시 토큰 낭비를 크게 줄일 수 있습니다.
CLAUDE.md를 간결하게 유지하기
CLAUDE.md는 매 대화 시작 시 컨텍스트에 로드되므로, 그 크기가 토큰 사용량에 직접적인 영향을 미칩니다. 약 150줄 정도의 간결한 문서를 목표로 하세요. 포함해야 할 내용은 다음과 같습니다:
- 아키텍처 핵심
- 주요 컨벤션
- 흔히 발생하는 실수
문서를 소설처럼 길게 만들지 마세요; 한 줄씩 추가될 때마다 모든 상호작용에 토큰 비용이 더해집니다.
토큰 사용량 모니터링
Max 플랜을 사용 중인데도 토큰이 빨리 소진되는 느낌이 든다면, Claude가 실제로 무엇을 읽고 있는지 확인해 보세요. 흔히 발생하는 실수는 매 탐색 시 큰 락 파일(예: pnpm-lock.yaml)을 무심코 전달하는 경우입니다. .claudeignore 파일을 활용하고 CLAUDE.md를 간결하게 유지하면 이러한 문제를 완화할 수 있습니다.
결론
불필요한 파일을 무시하고 컨텍스트 문서를 다듬음으로써 토큰 소비를 크게 줄이고 Anthropic의 세션 제한 내에서 작업을 지속할 수 있습니다.