기타 2026-05-27 4KB 읽기 5분

크라우니코드 프롬프트 캐싱 — 검증 완료, 실제 적용 대기

요약

llm-bridge.한선 (한선씨로 작성된 LLM 윤활유)에 Anthropic API 프롬프트 캐싱이 정확하게 적용된 것을 검증 완료. 실제 토큰 캐시 동작은 ANTHROPIC_API_KEY 크레딧 충전 후 확인 가능.

검증 결과

항목	상태	비고
한선씨 컴파일	✓ OK	CrownyTVM crowny run 정상 실행
환경값 함수 (`chomp` trim)	✓ OK	`printenv` 끝 줄바꿈 제거
시스템 프롬프트 로드	✓ OK	4058자 / 토큰 캐시 최소(2048) 초과
JSON body 조립	✓ OK	`cache_control: ephemeral` 포함 확인
API 엔드포인트 호출	✓ OK	api.anthropic.com 응답 수신
학습DB 환류	✓ OK	`~/.crownycode/학습.dat` 항목 추가 확인
실제 토큰 캐시	⏸ 대기	크레딧 부족으로 호출 차단 (You've hit your monthly spend limit)

body 구조 검증 (실제 전송 내용)

json{
  "model": "claude-haiku-4-5-20251001",
  "max_tokens": 1024,
  "system": [{
    "type": "text",
    "text": "<4058자 한선씨 규칙·키워드·함정·예제>",
    "cache_control": {"type": "ephemeral"}    ← ★ 캐싱 적용
  }],
  "messages": [{"role": "user", "content": "intent: ...\n설명: ..."}]
}

4계층 위치

[3] 오리지널 (/Users/ef/Downloads/CrownyTVM/crownycode-agent) — 영향 없음
[1] 작업중 (/Users/ef/Downloads/CrownyTVM/crownycode-working) — 모든 변경 격리됨
[2] 개선된 — 비어있음 (promote 대기)

작업 산출물 (작업중 폴더만)

파일	형식	줄수	역할
`llm-bridge.한선`	한선씨	399	LLM 호출 (캐시 적용, bash 대체)
`llm-bridge.sh`	bash	약 250	bash 버전 (캐시 적용, 백업/폴백)
`prompts/hanseon_system.txt`	text	168줄 / 4058자	캐시될 시스템 프롬프트
`router.sh`	bash	271	라우터 (한선씨 변환 미완)
`slash-feedback.sh`	bash	296	슬래시 환류 (한선씨 변환 미완)

다음 단계 (사용자 결정 대기)

A. 실제 캐시 검증 (필요시 크레딧 충전 후)

bashcd /Users/ef/Downloads/CrownyTVM/crownycode-working
CROWNYCODE_INTENT="더하기" \
CROWNYCODE_DESC="두 숫자 합 출력" \
CROWNYCODE_SYS_PROMPT="$(pwd)/prompts/hanseon_system.txt" \
crowny run llm-bridge.한선

# 1차 호출 후 5분 내 2차 호출 → [캐시 히트] 표시 확인
# ~/.crownycode/cache_stats.log 에 input|cache_read|cache_create|output 누적

B. promote 결정 (검증 통과 후)

bash# 명시적 사용자 승인 후에만 실행
/Users/ef/kpscode/quadcode.sh verify        # 검증
/Users/ef/kpscode/quadcode.sh promote        # [1]→[2]
/Users/ef/kpscode/quadcode.sh promote original  # [2]→[3] (안정성 확인 후)

이론적 비용 절감

Haiku 4.5 단가 (input $0.80 / output $4.00 / cache_read $0.08 / cache_write $1.00 per MTok):

첫 호출 (cache miss): 4058 토큰 × $1.00 = $0.004 (캐시 생성)
반복 호출 (cache hit): 4058 토큰 × $0.08 = $0.00032
호출당 절감: ~$0.00295 (약 90%, system 부분만)

세션당 10회 호출 시: 약 $0.029 절감. 일 100회 시: 일 $0.30 / 월 $9 절감 추정.

잔여 이슈

router.한선 / slash-feedback.한선 변환 미완 (bash 버전만 동작)
실제 토큰 캐시 측정 대기 (크레딧 필요)
chomp 함수: 다른 한선씨 스크립트와 공유 가능 (std/에 추가 검토)
한선씨 함정 발견: 끝 키워드, 반환 다음 변수 재선언 시 KwFinally 충돌 — 메모리 함정 사전에 추가 권고