클로드 코드와 코덱스 프롬프트 캐시: 비용 계산과 사용량 확인

프롬프트 캐시는 AI에 이미 보낸 자료의 계산 결과를 서버가 잠시 보관했다가 다시 쓰는 기능입니다. 클로드 코드나 코덱스에서 같은 자료를 여러 번 참고하면 입력 처리 비용과 첫 응답까지의 대기 시간이 줄어듭니다.

API는 프로그램이 AI 서비스를 불러 쓰는 연결 방식입니다. 아래의 달러 계산은 쓴 만큼 청구되는 API 요금 기준이고, 월 구독의 사용 한도와는 따로 봅니다.

같은 자료를 왜 다시 계산하나요?

AI에게 회의록을 주고 요약을 부탁한 뒤 담당자별 할 일을 물었다고 하겠습니다. 두 번째 답변에도 회의록과 앞선 대화가 필요합니다. 모델은 대화를 스스로 기억하지 않기 때문에, 도구가 요청할 때마다 답변에 필요한 자료를 다시 묶어 보냅니다. 이렇게 이번 요청에서 모델이 참고하는 내용을 컨텍스트라고 합니다.

컨텍스트에는 대화 내용 말고도 프로젝트 규칙과 사용할 수 있는 도구의 설명이 들어갑니다. 긴 대화는 요약하거나 필요한 부분만 불러와 보내기도 합니다.

캐시는 요청의 앞부분부터 일치하는 내용을 재사용합니다. 이를 프리픽스 매치(prefix match)라고 합니다. 요청 중간의 내용이 바뀌면 바뀐 지점부터 뒤는 다시 계산하고, 그 앞은 캐시에서 읽습니다.

캐시가 적중했다는 말은 재사용할 입력 계산을 찾았다는 뜻입니다. 캐시는 입력 계산만 재사용하고 이전 답변을 복사해 돌려주지 않으므로, 새 답변의 출력 비용은 그대로 듭니다.

아래는 앤트로픽이 캐시를 처음 발표할 때 실은 사례입니다. 10만 토큰 자료를 바탕으로 대화할 때 첫 응답 대기가 11.5초에서 2.4초로 줄었습니다.

고정 입력 비용 계산하기

토큰은 모델이 글을 처리하는 단위이고, 한글 한 글자가 꼭 한 토큰은 아닙니다. 여기서는 같은 앞부분 12만 토큰을 30번 보내는 경우를 계산합니다. 질문 한 번에도 도구 호출로 요청이 여러 번 나가므로, 대화 30번과 API 요청 30번은 같지 않습니다.

예제는 Claude Opus 5의 일반 API 단가를 씁니다. 2026년 10월 4일 기준 100만 토큰당 입력 단가는 캐시 없이 처리하면 5달러, 1시간 캐시에 저장하면 10달러, 캐시에서 읽으면 0.50달러입니다. 출력과 도구 비용은 뺐습니다.

12만 토큰을 1시간 캐시에 한 번 저장하면 120000 ÷ 1000000 × 10 = 1.20달러, 같은 부분을 캐시에서 한 번 읽으면 120000 ÷ 1000000 × 0.50 = 0.06달러입니다. 이 두 값으로 저장 횟수에 따라 비용이 어떻게 달라지는지 계산하면 이렇습니다.

가장 비싼 36달러는 캐시를 쓰지 않은 경우가 아니라 매번 1시간 캐시 저장 비용을 낸 경우입니다. 캐시가 만료된 뒤 같은 자료를 다시 보내면 저장 단가가 다시 붙어서, 캐시를 아예 쓰지 않은 18달러보다도 비싸집니다. 요청이 10번이라면 한 번 저장하고 아홉 번 읽어 1.20 + 9 × 0.06 = 1.74달러, 매번 저장하면 12달러입니다.

처음 저장할 때 더 비싼 이유와 손익분기점

Claude Opus 5에서는 5분 캐시 저장이 일반 입력의 1.25배, 1시간 저장이 2배이고 읽기는 0.1배입니다. 저장할 때 더 내고, 다시 읽을 때 훨씬 적게 내는 구조입니다. 일반 입력 한 번을 1로 놓고 비교하면 이렇습니다.

이 조건에서는 처음 저장한 요청까지 포함해 5분 캐시는 총 두 번, 1시간 캐시는 총 세 번 쓸 때부터 일반 입력보다 쌉니다. 한 번만 쓰는 자료는 저장 단가만큼 더 냅니다.

클로드 코드에서 변경이 적용되는 시점

클로드 코드는 캐시를 자동으로 관리합니다. 작업 중에 무엇을 바꾸느냐에 따라 캐시를 다시 쓰는지와 새 내용이 언제 반영되는지가 다릅니다. 2026년 10월 4일 공식 문서 기준입니다.

클로드 코드에서 바꾼 것과 캐시

바꾼 것	앞부분 캐시 재사용	새 내용이 반영되는 때
같은 자료로 후속 질문	제공	바로
모델 변경	제공하지 않음	바로 새 모델의 캐시로 다시 계산
최상위 CLAUDE.md 수정	제공	다음 /clear, /compact 또는 재시작
/compact로 대화 요약	시스템 지침만	바로 요약한 대화로 다시 시작
MCP 서버 변경	도구 설명을 넣는 방식에 따라	–

/clear는 현재 대화를 비우고, /compact는 대화를 요약해 이어 갑니다. 두 명령 모두 대화에서 내용을 빼는 동작이며, 서버의 캐시는 그대로 둡니다.

규칙 파일에서 잘못된 내용을 찾았다면 캐시 때문에 고치기를 미루지 않습니다. 규칙을 고치고 /compact나 /clear로 새 내용을 불러옵니다. 실행 전에 끝낸 일과 남은 일을 대화에 한두 줄 적어 두면 요약 뒤에도 맥락이 이어집니다.

MCP 서버를 바꿨을 때 다시 계산하는 범위는 도구 설명을 요청 앞부분에 처음부터 넣는 설정인지, 필요할 때 불러오는 설정인지에 따라 다릅니다.

캐시 보존 시간

캐시를 보관하는 시간을 TTL(Time To Live)이라고 부릅니다. 도구와 결제 방식에 따라 기본값이 다릅니다.

보존 시간은 마지막으로 캐시를 쓴 때부터 다시 셉니다. 창을 열어 두기만 해서는 캐시가 갱신되지 않고, 캐시를 유지하려고 의미 없는 질문을 보내면 그만큼 사용량이 늘어납니다. 쉬었다가 돌아오면 남은 작업과 참고 자료가 맞는지 먼저 보고 이어 갑니다.

GPT-5.6 Sol의 캐시 단가

코덱스에서 쓰는 GPT-5.6 Sol의 2026년 10월 4일 공식 모델 문서 단가입니다. 이 단가는 프로모션 가격이며 최소 2026년 11월 21일까지 적용된다고 안내돼 있습니다.

같은 모델이라도 한 요청의 입력이 27만 2천 토큰을 넘으면 단가가 바뀌므로, 비용을 계산할 때는 모델 이름과 함께 입력 길이도 봅니다.

이미 쓰는 도구에서 사용량 확인하기

CLI는 명령어로 프로그램을 쓰는 방식입니다. Claude Code나 Codex CLI를 실행한 뒤, AI와 대화하는 입력란에 아래 명령을 입력하고 Enter를 누릅니다.

Claude Code

> /context

현재 참고 자료가 컨텍스트 공간을 얼마나 차지하는지 표시

> /usage

세션 비용, 구독 사용 한도, 활동 통계 표시
Prompt cache (main) 항목에 캐시 통계

v2.1.251 이상에서 첫 API 응답 뒤에 나옵니다

Codex에서는 /status를 입력하면 현재 모델과 세션 설정, 컨텍스트 사용량이 나옵니다. Claude Code의 /cost는 /usage와 같은 명령입니다. Prompt cache (main)은 주 대화의 통계이고 하위 에이전트의 사용량은 들어 있지 않습니다. 명령이나 항목이 보이지 않으면 /help로 지금 버전에서 쓸 수 있는 명령을 봅니다.

/context가 보여 주는 컨텍스트는 이번 요청에 들어가는 참고 자료의 크기이고, /usage의 구독 한도는 일정 기간 쓸 수 있는 양입니다. 둘은 따로 움직여서, 컨텍스트가 절반 찼다고 한도도 절반 쓴 것은 아닙니다. 앞 예제에서 36달러가 2.94달러의 약 12배였지만, 구독 한도가 줄어드는 정도는 이 계산이 아니라 /usage 화면의 값으로 봅니다.

작업을 이어갈지 결정하는 기준

캐시를 아끼는 것보다 다음 작업에 앞선 자료가 필요한지가 먼저입니다.

대화를 이어 갈 때와 새로 열 때

상황	대화 이어 가기	새 대화 열기
같은 회의록으로 할 일 정리	제공	제공하지 않음
앞에서 고친 코드에 기능 추가	제공	제공하지 않음
전혀 다른 프로젝트의 질문	제공하지 않음	제공
잘못 읽은 자료가 대화에 쌓임	제공하지 않음	제공

응답이 느린 원인에는 캐시 말고도 모델의 추론, 도구 실행, 네트워크와 서비스 상태가 있습니다. 비용보다 먼저 볼 것은 AI가 올바른 자료로 필요한 작업을 하고 있는지입니다.

Sources

• Prompt caching with Claude
• Claude API 프롬프트 캐시
• Claude API 가격
• Claude Code 캐시 동작
• Claude Code 비용과 사용량
• Claude Code 명령
• OpenAI 프롬프트 캐시
• GPT-5.6 Sol 모델
• Codex 명령