토큰 예산 조언자 (TBA)
Claude가 답변하기 전에 응답 흐름을 가로채어 사용자에게 응답 깊이에 대한 선택을 제공합니다.
사용 시기
- 사용자가 응답의 길이나 세부 수준을 제어하고 싶어할 때
- 사용자가 토큰, 예산, 깊이, 응답 길이를 언급할 때
- 사용자가 "짧게", "tl;dr", "간략히", "25% 깊이", "완전히" 등을 말할 때
- 사용자가 깊이/세부 수준을 미리 선택하고자 할 때
트리거하지 마세요: 사용자가 이 세션에서 이미 레벨을 설정한 경우(자동 유지), 또는 답변이 한 줄로 끝나는 경우.
작동 방식
1단계 — 입력 토큰 추정
저장소의 표준 컨텍스트 예산 휴리스틱을 사용하여 프롬프트의 토큰 수를 대략적으로 추정합니다.
컨텍스트 예산과 동일한 보정 가이드를 사용하세요:
- 일반 텍스트:
단어 수 × 1.3 - 코드 위주 또는 혼합/코드 블록:
문자 수 / 4
혼합된 내용은 지배적인 콘텐츠 유형을 기준으로 추정 휴리스틱을 유지합니다.
2단계 — 복잡성에 따른 응답 크기 추정
프롬프트를 분류한 다음, 승수 범위를 적용하여 전체 응답 창을 구합니다:
| 복잡성 | 승수 범위 | 예시 프롬프트 |
|---|---|---|
| 단순 | 3배 – 8배 | "X가 뭐예요?", 예/아니오, 단일 사실 |
| 중간 | 8배 – 20배 | "X는 어떻게 작동하나요?" |
| 중간-높음 | 10배 – 25배 | 컨텍스트가 있는 코드 요청 |
| 복잡 | 15배 – 40배 | 다중 분석, 비교, 아키텍처 |
| 창의 | 10배 – 30배 | 이야기, 에세이, 서술형 글쓰기 |
응답 창 = input_tokens × mult_min 부터 input_tokens × mult_max 까지 (단, 모델의 설정된 출력 토큰 한도를 초과하지 마세요).
3단계 — 깊이 옵션 제시
답변하기 전에 실제 추정된 숫자를 사용하여 이 블록을 제시하세요:
프롬프트 분석 중...
입력: ~[N] 토큰 | 유형: [유형] | 복잡성: [레벨] | 언어: [언어]
깊이 레벨을 선택하세요:
[1] 핵심 (25%) -> ~[토큰] 직접 답변만, 서문 없음
[2] 보통 (50%) -> ~[토큰] 답변 + 컨텍스트 + 예시 1개
[3] 상세 (75%) -> ~[토큰] 대안을 포함한 전체 답변
[4] 완전 (100%) -> ~[토큰] 모든 것, 제한 없음
어떤 레벨? (1-4 또는 "25% 깊이", "50% 깊이", "75% 깊이", "100% 깊이" 입력)
정밀도: 휴리스틱 추정 약 85-90% 정확도 (±15%).
레벨별 토큰 추정 (응답 창 내):
- 25% →
min + (max - min) × 0.25 - 50% →
min + (max - min) × 0.50 - 75% →
min + (max - min) × 0.75 - 100% →
max
4단계 — 선택한 레벨로 응답
| 레벨 | 대상 길이 | 포함 | 생략 |
|---|---|---|---|
| 25% 핵심 | 최대 2-4문장 | 직접 답변, 핵심 결론 | 컨텍스트, 예시, 뉘앙스, 대안 |
| 50% 보통 | 1-3단락 | 답변 + 필요한 컨텍스트 + 예시 1개 | 심층 분석, 예외 사례, 참고 자료 |
| 75% 상세 | 구조화된 응답 | 여러 예시, 장단점, 대안 | 극단적인 예외 사례, 모든 참고 자료 |
| 100% 완전 | 제한 없음 | 모든 것 — 전체 분석, 모든 코드, 모든 관점 | 없음 |
단축키 — 질문 생략
사용자가 이미 레벨을 지정했다면, 묻지 않고 즉시 그 레벨로 응답하세요:
| 사용자 입력 | 레벨 |
|---|---|
| "1" / "25% 깊이" / "짧게" / "간략 답변" / "tl;dr" | 25% |
| "2" / "50% 깊이" / "보통 깊이" / "균형 답변" | 50% |
| "3" / "75% 깊이" / "상세 답변" / "철저한 답변" | 75% |
| "4" / "100% 깊이" / "완전 답변" / "전체 심층 분석" | 100% |
사용자가 세션 초반에 레벨을 설정했다면, 변경하지 않는 한 이후 응답에 대해 자동으로 유지하세요.
정밀도 참고
이 스킬은 휴리스틱 추정 방식을 사용합니다 — 실제 토크나이저가 아닙니다. 정확도 약 85-90%, 변동 ±15%. 항상 고지 사항을 표시하세요.
예시
트리거 예시
- "먼저 짧은 버전을 줘."
- "네 답변에 토큰이 몇 개나 들어갈까?"
- "50% 깊이로 응답해줘."
- "요약 말고 완전한 답변을 원해."
- "짧은 버전 먼저 주고 나중에 상세하게 줘."
트리거하지 않는 예시
- "JWT 토큰이 뭐예요?"
- "체크아웃 흐름이 결제 토큰을 사용해요."
- "이거 정상인가요?"
- "리팩터를 완료하세요."
- 사용자가 세션에 대해 이미 깊이를 선택한 후의 후속 질문
출처
TBA — Token Budget Advisor for Claude Code의 독립형 스킬입니다. 원본 프로젝트에는 Python 추정기 스크립트도 포함되어 있지만, 이 저장소는 스킬을 자체 포함 휴리스틱 전용으로 유지합니다.