Claude 메모리 기능 추가 비용 발생 여부와 요금 체계
Claude 메모리 기능 자체에 별도 비용은 없으나 기억된 텍스트가 입력 토큰으로 재전송되어 요금이 발생합니다. 프롬프트 캐싱 활용 여부와 API 사용량에 따른 실제 청구 원리를 상세히 설명합니다.
Claude의 memory 기능에는 추가 비용이 발생합니까?
Claude의 memory 기능 자체에는 별도의 가격이 부과되지 않는다. Anthropic이 공개한 요금은 입력 1 million tokens당 요금과 출력 1 million tokens당 요금으로 구성되며, prompt caching에는 별도 요금이 적용된다. 이 가운데 memory token이라는 항목은 없다. memory 자체를 저장하는 데는 Claude API(application programming interface) 비용이 들지 않는다. memory tool은 클라이언트 측에서 동작하고, 파일은 사용자가 소유한 storage에 저장되기 때문이다.
다만 memory는 청구 금액에 영향을 줄 수 있다. 기억된 사실은 Claude가 읽는 request 안에 포함될 때만 답변을 바꾼다. 기억한다는 것은 해당 내용을 다시 전송한다는 뜻이다. 이 텍스트는 input tokens로 전송되며, cached 상태가 아니면 모델의 일반 input 요금이 적용된다. 비용을 결정하는 요소는 2가지다. 매 turn마다 다시 전송하는 기억된 텍스트의 token 수와, 다시 전송한 텍스트를 prompt cache에서 제공할 수 있는지 여부다.
Pro, Max 또는 Ultra subscription에서는 plan에 포함된 한도 내 사용량에 token별 요금이 부과되지 않는다. 이 경우 memory는 비용이 아니라 사용량 allowance를 소모한다. 하지만 usage credits를 활성화하고 한도를 초과하면 달라진다. request가 pay-as-you-go 방식으로 전환되고, 표준 API 요금으로 청구되며, subscription 요금과 별도로 결제된다. 따라서 그 시점부터는 지나치게 큰 memory block에 다시 비용이 발생한다. 아래의 mechanism은 동일하다. 달라지는 것은 단위뿐이다. allowance는 유한하므로, 매 turn에 어느 정도의 memory를 포함할지 결정하기 전에 Claude Pro의 비용과 한도가 적용되기 시작하는 지점을 알아두는 것이 좋다. Usage-based Claude Enterprise는 다시 다르게 적용된다. seat 요금에 더해 모든 token을 API 요금으로 측정해 청구하기 때문이다. 따라서 지나치게 큰 memory block은 allowance가 아니라 다시 비용이 된다. Seat-based Enterprise plan에는 usage allowance가 포함되며, member가 포함된 한도에 도달한 뒤에는 usage credits를 사용할 수 있다. 이는 contract 갱신 시 usage-based billing으로 전환되는 legacy plan이다. memory를 정리해 사용량을 더 저렴한 plan의 한도 아래로 충분히 낮출 수 있다면, Max 또는 Ultra에서 Pro로 변경하기를 후속 조치로 검토할 수 있다. 실제로 비교하려는 대상이 Anthropic의 tier가 아니라 provider 간 요금이라면, 현재 요금 기준으로 Claude의 plan과 ChatGPT를 비교하기부터 시작하면 된다.
각 Claude 인터페이스에서 "메모리"가 의미하는 바
세 가지 별도의 제품이 이 용어를 공유하고 있으며, 이들을 혼동하는 것이 이 질문이 혼란스럽게 느껴지는 주된 이유입니다.
Claude API의 메모리 도구. tools 배열에 항목 하나를 추가하고 직접 작성한 코드에서 파일 작업을 구현합니다.
{"type": "memory_20250818", "name": "memory"}2026년 10월 기준으로 이 도구는 Messages API에서 베타 헤더가 필요 없으며, 모든 Claude 4 및 이후 모델에서 작동합니다. 이는 클라이언트 측에서 처리됩니다. Claude가 view /memories와 같은 작업을 요청하면 사용자가 제어하는 저장소에 대해 핸들러가 이를 실행하고, 그 결과를 tool_result 블록으로 반환합니다. Anthropic은 파일을 보관하지 않으므로 전송할 저장소 비용이 발생하지 않습니다. 대신 왕복 요청에 대한 비용을 지불합니다. 도구 정의는 모든 요청마다 전송되며, 반환된 파일 내용은 그 시점부터 대화에 계속 유지됩니다.
Anthropic은 해당 오버헤드의 고정 부분을 공개합니다. 2026년 10월 문서화된 바와 같이, auto 도구 선택을 사용하는 Claude Opus 5의 경우 도구 사용 시스템 프롬프트는 286 토큰입니다. 이는 메모리 도구 여부와 관계없이 도구가 존재할 때마다 요청당 한 번 지불됩니다.
Claude Code. 세션이 시작될 때마다 두 가지 메커니즘이 로드됩니다. CLAUDE.md 파일에는 사용자가 작성한 지침이 포함됩니다. 자동 메모리는 ~/.claude/projects/<project>/memory/ 하위에서 Claude가 스스로를 위해 작성한 메모를 보관합니다. MEMORY.md의 처음 200줄 또는 25KB 중 먼저 도달하는 제한까지만 로드되며, 그 옆의 주제 파일들은 시작 시점이 아닌 필요할 때 읽어옵니다. 시작 시 로드된 모든 내용은 해당 세션의 이후 모든 요청이 포함하는 접두사의 일부가 됩니다. 메모리는 구독을 사용할 경우 포함된 사용 허용량을 소모하며, 사용 크레딧 기능을 켠 상태에서 제한을 초과하면 사용 크레딧을 소모합니다. Console 또는 클라우드 제공업체를 통해 Claude Code는 조직에 토큰당 비용이 청구되며, 메모리 컨텍스트도 해당 과금 방식을 따릅니다. 세션 간 Claude Code가 메모리를 불러오는 방법에서 파일별 로드 순서를 다룹니다.
웹상의 Claude. claude.ai에서 메모리는 사용자가 대화할 때 Claude가 작성하고 업데이트하는 항목들의 집합이며, 각 프로젝트마다 메모리 공간이 있습니다. 프로젝트 메모리는 기본적으로 계정 메모리와 함께 사용됩니다. 완전히 분리하려면 프로젝트 페이지에서 Use account memory를 끄십시오. Settings > Your Claude > Manage next to Your memory에서 저장된 내용을 확인하거나, 이전 레이아웃의 경우 Settings > Memory에서 확인할 수 있으며, 메모리 토글을 통해 Pause memory 또는 Reset memory를 선택할 수 있습니다. 메모리는 Free 플랜에서도 사용할 수 있습니다. 사용량이 포함된 유료 플랜의 경우 메모리는 사용 제한을 소모하며, 사용 크레딧 기능을 켠 상태에서 제한을 초과하면 사용 크레딧을 소모합니다. 사용량 기반 Enterprise 플랜은 API 요율에 따라 청구됩니다.
기억된 텍스트가 입력 토큰으로 과금되는 이유
Messages API는 상태를 저장하지 않습니다. 호출 사이에 아무것도 유지하지 않으므로, 클라이언트는 매번 전체 대화 내용을 전송하고 모델은 이를 다시 읽습니다. 메모리도 이 규칙의 예외가 아닙니다. 메모리는 동일한 요청 내에 포함된 또 하나의 텍스트 블록일 뿐입니다.
이 구분은 모든 응답의 usage 객체에서 확인할 수 있습니다.
"usage": {
"input_tokens": 412,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 18240,
"output_tokens": 236
}input_tokens은 캐시에서 읽어오지도 않았고 캐시를 생성하는 데 사용되지도 않은 토큰만을 계산하며, 실제로는 마지막 캐시 중단점 이후의 토큰을 의미합니다. 요청에 대한 총 입력량은 cache_read_input_tokens와 cache_creation_input_tokens, 그리고 input_tokens을 합한 값입니다. 3턴 전에 Claude가 열었던 메모리 파일은 그 이후 매 턴마다 해당 총합 내에 포함됩니다. 이 데이터는 캐시된 접두사가 유지되는 동안에는 cache_read_input_tokens에 해당하며, 접두사가 다시 작성될 때는 cache_creation_input_tokens에, 캐시되지 않았을 때는 input_tokens에 해당합니다. 동일한 텍스트라도 가격은 다르게 책정됩니다. 입력 토큰과 출력 토큰은 가격이 다릅니다, 그리고 다시 재생된 메모리는 입력 측에 포함됩니다.
사용 중인 토큰 수를 직접 확인하는 방법
블로그 게시물이나 이 문서에 적힌 수치를 그대로 믿지 마십시오. 본인의 메모리 블록을 직접 측정해야 합니다. 토큰 계산은 무료이며 자체적인 속도 제한이 있으므로 측정에 비용이 들지 않습니다.
curl https://api.anthropic.com/v1/messages/count_tokens \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "content-type: application/json" \
-H "anthropic-version: 2023-06-01" \
-d '{
"model": "claude-opus-5",
"system": "You are a scientist",
"messages": [{"role": "user", "content": "Hello, Claude"}]
}'응답은 { "input_tokens": 14 }과 같은 하나의 숫자로 표시됩니다. 메모리 텍스트를 system 필드에 붙여넣고 한 번 실행한 뒤, 텍스트 없이 다시 한 번 실행하십시오. 그 차이가 매 턴마다 메모리가 소모하는 비용입니다. 두 가지 주의 사항이 있습니다. 이 수치는 추정치이며, Anthropic이 시스템 최적화를 위해 추가하는 토큰은 사용자에게 청구되지 않습니다. 또한 실제로 사용할 모델을 기준으로 계산하십시오. Claude 4.7 이후 버전은 새로운 토크나이저를 사용하여 동일한 텍스트에 대해 약 30퍼센트 더 많은 토큰을 생성하기 때문입니다.
Claude Code 내부에서는 별도의 curl 명령 없이도 동일한 질문에 답을 얻을 수 있습니다.
/context는 메모리 파일을 포함하여 현재 로드된 항목을 보여주므로, 입력을 시작하기 전에 컨텍스트 윈도우에서 차지하는 비중을 확인할 수 있습니다./memory은 CLAUDE.md 파일 목록을 나열하고 자동 메모리 폴더를 엽니다./usage는 캐시 읽기 및 캐시 쓰기를 포함한 세션 총계를 출력합니다.- 상태 표시줄을 통해 컨텍스트 윈도우 사용량을 지속적으로 표시할 수 있으므로, 사용량이 증가하는 과정을 실시간으로 볼 수 있습니다.
/usage 세션 블록은 다음과 같이 표시됩니다.
Total cost: $0.55
Total duration (API): 6m 20s
Total duration (wall): 6h 33m 10s
Total code changes: 0 lines added, 0 lines removed
Usage by model:
claude-sonnet-4-6: 1.2k input, 5.3k output, 940.0k cache read, 50.0k cache write ($0.55)마지막 줄을 주의 깊게 읽으십시오. 940.0k 캐시 읽기 수치는 대화 내용과 메모리 전체가 매 턴마다 캐시 요율로 다시 전송되고 있음을 의미합니다. 1.2k 입력 수치는 캐시 항목을 생성하는 데 사용되지 않은 캐시되지 않은 입력만을 나타냅니다. Claude Code는 관리자가 modelPricing 관리 설정을 통해 계약 요금을 설정하지 않은 경우, 정가 기준으로 달러 금액을 로컬에서 계산합니다. 따라서 이는 추정치이며 실제 청구서와 다를 수 있습니다. Claude Console의 사용량 페이지에 표시된 수치가 공식 기준입니다.
그런 다음 비교를 직접 수행하십시오. 일반 세션과 자동 메모리를 끈 세션, 이렇게 두 개의 새 세션에서 동일한 첫 질문을 던져보십시오.
CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 claude각 세션에서 /context을 실행하여 메모리 파일 항목을 비교하십시오. 그 차이가 작업을 시작하기도 전에 매 세션 시작 시 누적된 메모리가 소모하는 비용입니다. Claude Code 토큰 사용량에 대한 전체 분석 문서를 위 두 수치와 함께 읽어보는 것을 권장합니다.
토큰 100만 개당 메모리 재생 비용은 얼마인가?
프롬프트 캐싱을 사용하면 같은 메모리 블록도 요청 시점에 따라 비용이 10배까지 달라질 수 있다. Anthropic은 캐시 요금을 각 모델의 기본 입력 가격에 대한 배수로 공개하므로, 달러 가격이 변해도 이 관계는 유지된다.
이 차트의 데이터
[
{
"label": "Base input",
"price_multiple": 1
},
{
"label": "5 minute cache write",
"price_multiple": 1.25
},
{
"label": "1 hour cache write",
"price_multiple": 2
},
{
"label": "Cache read",
"price_multiple": 0.1
}
]대부분의 모델에서 캐시 읽기 비용은 기본 입력 가격의 0.1배다. 최신 모델은 더 저렴하게 읽는다. Claude Opus 5.5와 Claude Sonnet 5.5에서는 기본 가격의 0.05배이고, Claude Fable 5.1, Claude Mythos 5.1, Claude Fable 5.2, Claude Mythos 5.2에서는 기본 가격의 0.025배다. 5분 수명의 항목을 기록하는 비용은 기본 가격의 1.25배이고, 1시간 수명의 항목을 기록하는 비용은 기본 가격의 2배다. Anthropic의 가격 페이지에는 손익분기점이 명시되어 있다. 5분 수명에서는 캐시를 한 번 읽은 뒤부터, 1시간 수명에서는 캐시를 두 번 읽은 뒤부터 캐싱이 이득이다. 프롬프트 캐싱 가이드 자체에는 손익분기 수치가 없지만, 읽기 요금이 더 저렴해져도 두 횟수는 바뀌지 않는다. 읽기 비용이 회수해야 하는 금액은 기록 시 추가 비용이기 때문이다. 프롬프트 캐싱의 손익분기점은 메모리를 어디에 둘지 결정하기 전에 계산해야 하는 값이다.
이 배수로 재생 횟수를 산술적으로 계산할 수 있다. 다음 블록은 위에 공개된 배수를 사용한 계산이며, 실제 운영 환경을 측정한 결과가 아니다. 100회 요청 세션에서 메모리 블록의 비용을 세 가지 방식으로 계산한다. 결과는 기본 입력 요금만 적용했을 때 과금되는 토큰 수로 환산했다.
이 차트의 데이터
[
{
"label": "4,000 tokens, never cached",
"base_rate_equivalent_tokens": "400,000"
},
{
"label": "4,000 tokens, 1 write and 99 reads",
"base_rate_equivalent_tokens": "44,600"
},
{
"label": "1,000 tokens, 1 write and 99 reads",
"base_rate_equivalent_tokens": "11,150"
}
]4,000토큰 메모리 블록이 100회 요청 모두에서 캐시 적중에 실패하면 400,000개의 기본 요금 기준 토큰을 사용한 것과 같은 비용이 청구된다. 같은 블록을 5분 수명의 캐시 항목으로 한 번 기록하고 99회 읽으면 44,600개의 기본 요금 기준 토큰을 사용한 것과 같다. 크기를 1/4로 줄이고 캐싱을 유지하면 11,150개의 기본 요금 기준 토큰을 사용한 것과 같다. 3개 행에서 기능은 변경되지 않았다. 변경된 것은 재생 동작뿐이다. 이 행은 표준 0.1배 읽기 요금을 사용한다. 읽기 비용이 0.05배인 Claude Opus 5.5 또는 Claude Sonnet 5.5에서는 캐시된 4,000토큰 블록이 24,800토큰으로 줄어들고, Claude Fable 5.1에서는 14,900토큰으로 줄어든다. 이 값은 여전히 금액이 아니라 토큰 수다. 토큰 수를 월별 청구 금액으로 환산하는 방법은 모델의 100만 토큰당 요금을 한 번 곱하는 것이다. 이 요금은 사용하는 모델이 결정한다. 따라서 에이전트가 Claude Fable 5에서 실행된다면 공개된 100만 토큰당 요금과 해당 모델에 적합한 작업을 기준으로 계산해야 한다. 비용을 줄이기 위해 에이전트를 더 작은 모델에서 실행한다면, 메모리를 늘리기 전에 100K 토큰을 초과해 증가하는 프롬프트에 Claude Haiku 5.5가 매기는 요금을 확인해야 한다. 재생되는 메모리가 요청을 해당 기준 이상으로 밀어 올리기 때문이다. 공급자가 모델만큼이나 아직 결정되지 않았다면 Claude의 API와 ChatGPT에서 같은 작업을 계산한 비용에서 그 곱셈이 서로 다르게 적용되는 지점을 확인할 수 있다. 메모리를 많이 사용하는 에이전트에서는 이 비용의 입력 측면이 크게 작용한다.
두 번째 행은 이후 99개 요청이 각각 캐시 항목이 아직 유효한 동안 도착한다고 가정한다. 실제 청구액이 대부분 잘못 계산되는 원인은 바로 이 가정이다.
중단 후 같은 질문에 더 많은 비용이 드는 이유는 무엇입니까?
캐시 항목에는 수명이 있으며, 해당 항목을 쓰거나 읽는 요청에서 시간이 시작됩니다. API 기본값은 5분입니다. 1시간 옵션의 비용은 위에 표시된 쓰기 비용의 2배입니다. Claude Code에서는 포함된 사용량 범위에서 1시간 구독 기본값이 주 대화와 선택한 일부 도우미 요청에 적용됩니다. 더 긴 수명을 선택하지 않으면 하위 에이전트에는 5분이 적용됩니다. 사용량 크레딧을 사용하기 시작하면 주 대화의 수명이 5분으로 줄어듭니다. API 키 또는 클라우드 제공업체를 사용하는 경우에도 기본값은 5분입니다. ENABLE_PROMPT_CACHING_1H=1를 설정하면 사용량 크레딧을 사용하는 동안에도 1시간 수명이 유지됩니다. Claude Code v2.1.242부터는 promptCacheTtl 설정을 1h로 지정해도 주 대화에서 동일하게 적용됩니다. 같은 버전부터 subagentPromptCacheTtl를 1h로 지정하면 주 대화 외부의 요청에 더 긴 수명을 선택합니다.
따라서 점심시간 동안 열어 둔 세션에 한 줄짜리 질문을 입력했는데 비용이 많이 드는 이유는 자리를 비운 동안 캐시 항목이 만료되었기 때문입니다. 메모리를 포함한 전체 접두사가 캐시 쓰기 요금으로 다시 처리되고 캐시에 다시 기록됩니다. 중단 시간이 그 비용을 결정합니다.
이 내용을 추측으로 믿지 않고 직접 확인할 수 있습니다. Pro, Max, Ultra, Team 또는 Enterprise 요금제에서는 /usage 분석에 최근 사용량의 10 percent 이상을 차지한 동작이 표시됩니다. 긴 컨텍스트와 캐시 누락도 이름으로 표시됩니다. Claude Code v2.1.251부터는 /usage의 세션 블록에도 Prompt cache (main) 행이 추가됩니다. 이 행에는 캐시에서 제공된 입력의 비율, 누락 횟수, 현재 캐시가 준비된 상태인지가 표시됩니다. API에서는 조용한 시간 이후 첫 요청에서 cache_creation_input_tokens이 접두사의 전체 크기로 다시 증가하는지 확인하면 됩니다.
캐시를 조용히 무효화하는 요인
캐시된 접두부는 순서가 정해져 있다. 도구, 시스템, 메시지 순서다. 한 수준을 변경하면 해당 수준과 그 뒤의 모든 항목이 무효화된다. 도구 정의를 편집하면 전체 캐시가 폐기된다. 시스템 프롬프트를 편집하면 시스템 캐시와 메시지 캐시가 폐기된다.
시스템 프롬프트에 메모리를 저장하고 에이전트가 학습할 때마다 이를 다시 작성하는 경우가 바로 이 함정에 해당한다. 다시 작성할 때마다 그 뒤에 있는 모든 내용의 캐시 사본이 폐기되므로, 다음 요청에서는 전체 내용을 다시 기록하는 비용을 지불한다. 안정적인 자료는 앞쪽에 배치하고 변경하지 않아야 한다. 변경이 잦은 자료는 메시지 목록의 뒤쪽에 배치해야 무효화 비용을 줄일 수 있다.
두 번째로 더 조용한 문제가 있다. 각 모델에는 캐시할 수 있는 접두부의 최소 길이가 있다. 2026년 10월에 게시된 내용에 따르면 Claude Opus 5는 512 tokens, Claude Sonnet 5는 1,024 tokens, Claude Haiku 4.5는 4,096 tokens다. Anthropic의 문서에는 이보다 짧은 요청이 어떻게 처리되는지도 명시되어 있다. 최소 길이보다 짧은 요청은 캐시 없이 처리되며 오류는 반환되지 않는다. 따라서 cache_control로 표시한 메모리 파일도 해당 중단점까지의 전체 접두부가 최소 길이보다 짧으면 아무 작업도 하지 않고 조용히 무시된다. 확인할 수 있는 증상은 프롬프트에 중단점이 분명히 있는데도 cache_creation_input_tokens가 0으로 유지되는 것이다.
더 이상 가치가 없는 메모리 정리하기
모든 메모리 라인은 해당 라인을 포함하는 매 턴마다 토큰 비용을 발생시킵니다. 따라서 각 라인이 최근 답변을 변경하는 데 기여했는지 확인해야 합니다. Claude Code는 이러한 제한 사항을 명확하게 정의합니다. CLAUDE.md 파일은 200라인 미만으로 유지하십시오. 파일이 길어지면 더 많은 컨텍스트를 소비하게 되어 Claude가 지침을 안정적으로 따를 가능성이 낮아집니다. MEMORY.md는 로드 시점에 처음 200라인 또는 25KB로 제한됩니다. 이 제한을 초과하는 내용은 다음 세션 시작 시 삭제되므로, 인덱스가 너무 크면 로드된 부분만 컨텍스트를 차지하고 나머지는 읽히지 않은 채 남게 됩니다.
파일 크기를 작게 유지하는 두 가지 습관이 있습니다. 세부 정보는 인덱스에서 제거하여 별도의 주제 파일로 옮기십시오. Claude는 이러한 파일을 시작 시점이 아닌 필요할 때 읽어 들입니다. 워크플로우 지침은 CLAUDE.md에서 제거하여 스킬로 옮기십시오. 스킬은 호출될 때만 로드됩니다. 프런트매터로 시작하는 메모리 파일의 경우, Claude Code는 버전 2.1.214 이상에서 modified 필드에 ISO 8601 타임스탬프 형식으로 기록 시간을 저장합니다. 이 타임스탬프는 정보가 최신 상태인지 확인하는 가장 빠른 방법입니다. 오래된 에이전트 메모리 정리하기에서 검토 과정을 더 자세히 다룹니다.
모든 내용을 컨텍스트에 로드하는 것보다 검색이 효율적인 경우
메모리 도구는 적시(just-in-time) 검색을 지원하기 위해 존재합니다. 에이전트는 모든 내용을 미리 로드하는 대신 학습한 내용을 기록하고, 작업에 필요할 때만 파일을 읽어 들입니다. 이는 연산 방식을 변화시킵니다. 파일 읽기는 필요할 때 내용을 추가하고 이후 요청에서도 컨텍스트에서 제거되기 전까지 유지되지만, 영구적으로 로드된 블록은 매 턴마다 비용이 발생하기 때문입니다.
위의 두 차트에서 간단한 규칙을 도출할 수 있습니다. 거의 모든 턴에서 사용하는 텍스트는 안정적인 캐시 접두사(stable cached prefix)에 두어야 합니다. 20번의 턴 중 한 번 정도 사용하는 텍스트는 view 호출 뒤에 두는 것이 적절합니다. 손익분기점은 Anthropic의 과금 정책이 아닌, 사용자의 재사용(replay) 횟수에 따라 달라집니다.
API에서는 플랫폼이 대화를 정리하도록 설정할 수도 있습니다. 컨텍스트 편집(context editing)은 대화가 설정한 임계값을 넘으면 오래된 도구 결과를 삭제합니다. 이 기능은 현재 베타 상태이므로, 이를 사용하는 요청에는 context-management-2025-06-27 베타 헤더가 필요합니다.
{
"edits": [
{
"type": "clear_tool_uses_20250919",
"trigger": {"type": "input_tokens", "value": 30000},
"keep": {"type": "tool_uses", "value": 3},
"clear_at_least": {"type": "input_tokens", "value": 5000}
}
]
}기본값은 입력 토큰 100,000개와 도구 사용 3회 유지입니다. 기능을 활성화하기 전에 캐싱과의 상호작용을 확인하십시오. 콘텐츠를 삭제하면 삭제 지점에서 캐시된 접두사가 무효화되므로, 다음 요청 시 캐시 쓰기 비용이 발생합니다. 이것이 clear_at_least이 존재하는 이유입니다. 이 설정은 삭제로 인한 절감 효과가 쓰기 비용을 정당화할 만큼 커질 때까지 삭제를 보류합니다. 응답은 context_management 아래에 cleared_tool_uses 및 cleared_input_tokens과 함께 정확히 어떤 일이 발생했는지 보고하므로, 이 교환은 이론적인 것이 아니라 측정 가능합니다. Claude Code에서 컨텍스트 윈도우 관리하기에서도 동일한 개념을 코딩 세션에 적용합니다.
별도 항목으로 과금되는 것
Memory 자체에는 별도 요금이 없지만, 실제로 별도 요금이 부과되는 기능도 있으므로 어떤 기능인지 알아둘 필요가 있다. 다음은 2026년 10월 기준으로 공개된 Claude API 요금이다. 일부 작업은 완전히 무료이며, Claude API 테스트 크레딧을 사용하면 신규 사용자가 API를 시험해 볼 수 있다. Anthropic의 요금 FAQ에는 신규 사용자에게 API 테스트용 무료 크레딧이 제공된다고만 적혀 있고, 금액은 공개되어 있지 않다. Max, Ultra 및 Team 구독자도 월별 API 크레딧을 받는다. Anthropic 문서에는 2026년 10월 31일 기준으로 Max는 $100, Ultra는 $200이라고 나와 있다. Team의 크레딧은 Standard 좌석당 $20, Premium 좌석당 $100이며, 여러 좌석이 공동으로 사용하고 월 $500으로 제한된다. Free, Pro 및 Enterprise 요금제는 대상이 아니며, 사용하지 않은 크레딧은 이월되지 않는다. 또한 대화형 Claude Code 사용량이나 usage credits에는 사용할 수 없다. 연결된 Console 조직의 API key로 직접 실행하는 경우에는 claude -p 및 Claude Agent SDK에 사용할 수 있다. Claude Code GitHub Action, IDE extension 또는 desktop app에서 시작한 실행은 -p가 있어도 계속 제외된다. 이러한 크레딧은 유료 요금제의 혜택이며, 아래 요금은 사용 가능한 크레딧 또는 유료 잔액에서 차감된다.
- Web search: 검색 1,000회당 $10이며, 검색 결과가 context에 포함하는 모든 항목의 일반 token 비용이 추가된다.
- Code execution: 조직당 매월 1,550시간이 무료이며, 이후에는 container당 시간당 $0.05가 부과된다. 동일한 요청에 tool version
20260209이상인 web search 또는 web fetch가 포함되면 무료다. - Claude Managed Agents: 일반적인 token 요금에 더해 session-hour당 $0.08의 session runtime 요금이 부과된다.
- Web fetch: 추가 요금은 없으며, 가져온 콘텐츠의 token 비용만 부과된다.
Memory는 위 항목 중 어느 항목에도 표시되지 않는다. Memory는 input token count에 포함되며, 바로 이 위치에서 그 사용량을 측정할 수 있다. 또한 pruning과 caching으로 그 사용량을 줄일 수 있다. virtual private server (VPS)에서 unattended agent를 운영할 예산을 책정한다면 VPS에서 AI agent의 비용을 제어하는 방법을 다음으로 마련해야 한다. Memory file이 계속 커지는데 pruning이 없으면 사용량을 보고하는 기능이 없어도 agent 비용이 매주 증가하기 때문이다.
FAQ
Claude의 memory 기능에는 별도 요금이 부과됩니까?
아닙니다. Anthropic의 가격표에는 백만 input tokens당 요금, 백만 output tokens당 요금, prompt caching 배수가 제시되어 있으며 memory 항목은 없습니다. Claude API에서 memory tool은 client-side로 동작하므로 파일은 이미 요금을 지불하고 있는 storage에 저장됩니다. memory가 추가하는 비용은 이를 포함하는 각 turn의 input tokens입니다. 이 tokens에는 model의 일반 input rate 또는 적용 가능한 caching rate가 부과됩니다.
memory를 끄면 Claude 사용 비용이 줄어듭니까?
각 request의 token 수가 줄어들므로 request별 비용도 줄어듭니다. 그러나 전체적으로 비용이 절약되는지는 이후 동작에 따라 달라집니다. Claude가 memory에 이미 저장된 내용을 복원하기 위해 파일 3개를 다시 읽고 질문 2개를 해야 한다면, 해당 tokens 비용이 memory 비용보다 커질 수 있습니다. 추측하지 말고 측정해야 합니다. memory를 자동으로 사용하는 session과 CLAUDE_CODE_DISABLE_AUTO_MEMORY=1로 시작한 session에서 /context을 실행한 다음, 동일한 작업에 사용된 전체 tokens를 비교합니다.
아무것도 변경하지 않았는데 사용량이 증가한 이유는 무엇입니까?
가장 일반적인 원인은 일시 중지 후 cache miss가 발생하는 것입니다. API의 cache entry는 기본적으로 5분 동안 유지됩니다. Claude Code는 subscription의 포함 사용량에서는 기본적으로 주 대화와 선택한 helper에 1시간을 적용하고, usage credits, API key 또는 cloud provider를 사용할 때는 5분을 적용합니다. 해당 수명이 만료된 후 첫 request는 전체 prefix를 다시 처리하고 cache-write rate로 다시 기록합니다. 두 번째로 흔한 원인은 prefix 수정입니다. tool definition을 변경하면 전체 cache가 무효화되고, system prompt를 변경하면 system 및 message cache가 무효화됩니다. subscription plan에서는 최근 사용량의 10 percent 이상을 차지할 때 /usage breakdown에서 해당 동작을 확인할 수 있습니다.
memory는 system prompt에 넣어야 합니까, 아니면 tool call 뒤에 두어야 합니까?
거의 모든 turn에서 사용하는 경우 system prompt에 넣어야 합니다. 그러면 cached prefix에 포함되어 cache read rate가 적용됩니다. 일부 작업에서만 필요한 경우 view call 뒤에 두어야 합니다. 그러면 필요할 때까지 파일의 tokens를 추가하지 않을 수 있습니다. 다만 context에서 제거하기 전까지 결과는 이후 turn에서 계속 replay됩니다. 판단 기준은 replay count이며, usage object에서 각 request의 input, cache-write 및 cache-read tokens를 확인할 수 있습니다.
memory 기능은 subscription 사용량 한도에 포함됩니까?
간접적으로 포함됩니다. subscription 한도는 각 request에 포함된 tokens를 기준으로 소모되기 때문입니다. Anthropic의 도움말 문서에 따르면 자동 context management를 트리거하는 긴 대화는 사용량 한도를 더 많이 소모합니다. memory를 사용하면 각 request가 조금 더 길어지고, 긴 session에서는 각 turn마다 그 길이가 replay됩니다. Claude의 사용량 한도는 실제로 어떻게 작동합니까에서 무엇이 언제 reset되는지 설명합니다.