클로드코드 15-costs

1. 비용 관리

참고: 토큰 사용량 추적, 팀 지출 제한, 비용 절감 전략

1.1. 비용 추적

1.1.1. /usage 명령어

현재 세션의 상세 토큰 사용량 통계를 제공한다.

Total cost:            $0.55
Total duration (API):  6m 19.7s
Total duration (wall): 6h 33m 10.2s
Total code changes:    0 lines added, 0 lines removed

참고: Session 블록의 비용은 API 사용자용이다. Claude Max/Pro 구독자는 구독에 포함되므로 청구 목적으로는 해당되지 않는다.

1.1.2. Claude Console

Claude Console에서 workspace spend limits를 설정하고 사용량 보고서를 확인할 수 있다.

1.2. 팀 비용 관리

1.2.1. Rate Limit 권장사항

- 팀 규모: 사용자당 TPM: 사용자당 RPM
- 1-5명: 200k-300k: 5-7
- 5-20명: 100k-150k: 2.5-3.5
- 20-50명: 50k-75k: 1.25-1.75
- 50-100명: 25k-35k: 0.62-0.87
- 100-500명: 15k-20k: 0.37-0.47
- 500명+: 10k-15k: 0.25-0.35

참고: TPM/RPM은 조직 레벨로 적용되며, 개인이 일시적으로 더 많이 사용할 수 있다.

1.2.2. Agent Team 비용

Agent team은 teammate 수만큼 컨텍스트 윈도우가 증가하므로 토큰 사용량도 비례한다.

- Sonnet을 teammate용으로 사용
- 팀 규모를 작게 유지
- Spawn 프롬프트를 집중적으로 작성
- 작업 완료 후 팀 정리

1.3. 비용 절감 전략

1.3.1. 컨텍스트 관리

- /clear: 관련 없는 작업으로 전환할 때 새로 시작
- /compact: 컨텍스트가 가득 찰 때 요약
- CLAUDE.md에 Compact Instructions 추가:

# Compact instructions
When you are using compact, please focus on test output and code changes

1.3.2. 모델 선택

- Sonnet이 대부분의 코딩 작업을 잘 처리하며 Opus보다 저렴하다.
- 복잡한 아키텍처 결정에만 Opus를 사용한다.
- 간단한 subagent 작업에는 model: haiku를 지정한다.

1.3.3. MCP 서버 최적화

- 사용하지 않는 서버는 /mcp에서 비활성화
- 가능하면 CLI 도구(gh, aws 등)를 MCP 대신 사용
- Tool schemas는 deferred by default

1.3.4. Hook과 Skill로 전처리

데이터를 Claude가 보기 전에 hook으로 필터링한다.

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "hooks": [{
        "type": "command",
        "command": "~/.claude/hooks/filter-test-output.sh"
      }]
    }]
  }
}

1.3.5. 지시사항을 CLAUDE.md에서 Skill로 이동

CLAUDE.md는 매 세션 로드되지만, skill은 호출 시에만 로드된다. 특정 워크플로우 지시사항은 skill로 이동해 기본 컨텍스트를 줄인다.

1.3.6. Extended Thinking 조정

- /effort 또는 /model에서 effort level을 낮춘다.
- /config에서 thinking을 비활성화
- MAX_THINKING_TOKENS=8000으로 예산 제한

1.3.7. Subagent로 장황한 작업 위임

테스트 실행, 문서 가져오기, 로그 처리 등은 subagent에게 맡겨 상세 출력이 주 컨텍스트에 남지 않게 한다.

1.3.8. 구체적인 프롬프트

- ❌ "improve this codebase"
- ✅ "add input validation to the login function in auth.ts"

1.3.9. Plan Mode 사용

복잡한 작업 전에 Plan mode(Shift+Tab)로 접근 방식을 먼저 제안받아 잘못된 방향으로 인한 비용 낭비를 방지한다.

1.4. 백그라운드 토큰 사용

Claude Code는 유휴 상태에서도 약간의 토큰을 사용한다.

- 대화 요약화 (claude --resume 기능용)
- /usage 등 상태 확인 명령어

일반적으로 세션당 $0.04 이하.