Repolode
karanb192

karanb192/cache-tax

Claude Code에서 쉬는 동안 프롬프트 캐시를 유지하고, 캐시가 만료된 상태로 메시지를 보내기 전 재작성 비용을 추정하는 모드입니다.

스타
347
포크
51
열린 이슈
20
마지막 커밋
18시간 전

어떤 프로젝트인가요?

Cache Tax는 프롬프트 캐시가 만료된 뒤 긴 세션을 재개할 때 발생하는 비용을 다루는 Claude Code 모드입니다. 쉬기 전에 /keepwarm 명령으로 제한된 시간 동안의 유지 창을 설정하면, 그동안 세션을 포크한 인스턴스가 일정 간격으로 작은 핑을 보내 캐시된 컨텍스트를 유지합니다. 핑은 유지 창이 활성화된 동안에만 전송되며, 캐시 조회 결과 캐시가 더 이상 유지되고 있지 않으면 중단됩니다.

큰 컨텍스트가 있는 세션의 캐시가 만료된 상태로 돌아오면, 모드는 처음 입력하는 일반 메시지를 한 번 보류하고 캐시를 다시 작성하는 데 드는 예상 비용을 표시합니다. 메시지를 다시 보내면 정상적으로 진행되며, /clear를 사용하면 메모를 바탕으로 새로 시작할 수 있습니다. 프롬프트 위의 상태 행에는 캐시 유지 상태, 다음 핑 시점, 마지막 조회 결과가 표시됩니다. 요금 추정에는 모델별 정가가 사용되며, 구독 요금제에서는 이 비용이 추가 청구되지 않는다고 안내합니다.

핵심 기능

  • 01정해진 시간 동안 주기적으로 핑을 보내 프롬프트 캐시를 유지합니다
  • 02캐시가 만료된 상태로 메시지를 보내기 전에 재작성 예상 비용을 표시하고, 메시지를 한 번 보류할 수 있습니다
  • 03캐시 조회 결과 캐시가 만료된 것으로 확인되면 자동으로 캐시 유지를 중단합니다
  • 04/cache-tax 상태 명령과 프롬프트 위의 상태 행을 제공합니다
  • 05마켓플레이스에서 Claude Code 플러그인으로 설치할 수 있습니다

활용 사례

  • 점심이나 회의 때문에 긴 코딩 세션을 잠시 중단하면서 컨텍스트 전체를 다시 작성하는 비용을 피할 때
  • 오래된 세션을 재개할지, 요약 메모를 바탕으로 새로 시작할지 결정할 때
  • API 키 과금 방식으로 Claude Code를 장시간 사용할 때 캐시 상태와 비용을 확인할 때

빠른 시작

  1. 1

    마켓플레이스 추가

    claude plugin marketplace add karanb192/claude-code-mods
  2. 2

    cache-tax 플러그인 설치

    claude plugin install cache-tax@claude-code-mods
  3. 3

    Claude Code를 다시 시작하거나 열려 있는 세션에서 플러그인 다시 불러오기

    /reload-plugins
  4. 4

    워밍 세션에서 keepwarm을 6시간 동안 활성화

    /keepwarm

사용 전 알아둘 점

  • Claude Code 2.1.287 이상이 필요하며, ping이 실행되려면 Claude Code가 계속 실행 중이어야 합니다.
  • keepwarm ping이 발생할 때마다 토큰이 소모되므로 무료가 아닙니다.
  • API-key 및 클라우드 제공업체 세션은 캐시가 기본적으로 5분간 유지되므로 promptCacheTtl을 "1h"로 설정해야 합니다.

포함된 컬렉션

토픽

#claude-code#prompt-caching#llm-cost#cli-plugin#typescript#claude-code-plugin#claude-mods#function-hooks

자주 묻는 질문

cache-tax은(는) 무엇인가요?
Claude Code에서 쉬는 동안 프롬프트 캐시를 유지하고, 캐시가 만료된 상태로 메시지를 보내기 전 재작성 비용을 추정하는 모드입니다. Cache Tax는 프롬프트 캐시가 만료된 뒤 긴 세션을 재개할 때 발생하는 비용을 다루는 Claude Code 모드입니다. 쉬기 전에 /keepwarm 명령으로 제한된 시간 동안의 유지 창을 설정하면, 그동안 세션을 포크한 인스턴스가 일정 간격으로 작은 핑을 보내 캐시된 컨텍스트를 유지합니다. 핑은 유지 창이 활성화된 동안에만 전송되며, 캐시 조회 결과 캐시가 더 이상 유지되고 있지 않으면 중단됩니다.
cache-tax은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
cache-tax은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
cache-tax은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. cache-tax의 마지막 커밋은 2026년 11월 5일입니다.
cache-tax은(는) 어디에 사용할 수 있나요?
점심이나 회의 때문에 긴 코딩 세션을 잠시 중단하면서 컨텍스트 전체를 다시 작성하는 비용을 피할 때 오래된 세션을 재개할지, 요약 메모를 바탕으로 새로 시작할지 결정할 때 API 키 과금 방식으로 Claude Code를 장시간 사용할 때 캐시 상태와 비용을 확인할 때
cache-tax는 어떻게 설치하나요?
마켓플레이스 추가: claude plugin marketplace add karanb192/claude-code-mods cache-tax 플러그인 설치: claude plugin install cache-tax@claude-code-mods Claude Code를 다시 시작하거나 열려 있는 세션에서 플러그인 다시 불러오기: /reload-plugins 워밍 세션에서 keepwarm을 6시간 동안 활성화: /keepwarm
cache-tax은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/karanb192/cache-tax

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트