Claude Code에서 '1M 컨텍스트에 사용 크레딧 필요'의 의미는? 표준 컨텍스트로 압축될 때 유지되는 내용 (2026)

오류 레퍼런스에서는 명확하게 설명합니다: "이것은 권한 확인(entitlement check)이지 할당량 소진이 아닙니다. 세션 및 주간 허용량에 여유가 있더라도 발생합니다."

일부 모델은 [1m]으로 표시된 변형 모델을 통해서만 1M 토큰 컨텍스트 창에 도달할 수 있으며, 귀하의 플랜에 해당 변형 모델이 포함되어 있는지 여부는 모델에 따라 다릅니다. Claude Code의 모델 구성 페이지에는 다음 두 모델에 대해 이 내용이 명시되어 있습니다.

• Opus 4.6 (1M 컨텍스트 포함): Max, Team, Enterprise 플랜에 포함되며, Pro 플랜에서는 사용 크레딧이 필요합니다.
• Sonnet 4.6 (1M 컨텍스트 포함): Max를 포함한 모든 구독 플랜에서 사용 크레딧이 필요합니다.

최신 모델은 다르게 작동합니다. 동일한 페이지에 따르면 Fable 5.1, Fable 5, Sonnet 5 이상, Haiku 5.5, Opus 4.7 이상은 "[1m] 접미사 없이 기본적으로 1M 창으로 실행됩니다."

사용 크레딧은 플랜에 포함된 범위를 초과할 때 적용되는 Anthropic의 종량제 과금 방식입니다. 플랜이 확장 컨텍스트를 크레딧을 통해서만 지원하는 경우, 모델 구성 페이지에 "토큰은 사용 크레딧으로 청구됩니다"라고 표시됩니다. 크레딧이 활성화되어 있지 않은 상태에서 해당 창이 필요한 요청을 보내면 이 오류가 발생합니다.

이 오류가 발생하는 경로는 두 가지입니다.

[1m] 모델을 선택한 경우. /model에서 1M 변형 모델을 선택했거나 구성 파일 어딘가에 설정되어 있으며, 귀하의 플랜이 사용 크레딧을 통해서만 해당 모델에 접근할 수 있는 경우입니다. 오류 레퍼런스에 따르면 모델을 전환한 후에도 오류가 지속되면 "다른 곳에 1M 모델 ID가 설정되어 있을 수 있습니다."

대화가 표준 창을 초과한 경우. 이 경우가 사람들을 당황하게 만듭니다. 레퍼런스에서는 다음과 같이 설명합니다: "대화 도중 컨텍스트가 200K 토큰을 초과하여 이 오류가 나타나면, Claude Code는 자동으로 대화를 표준 컨텍스트 제한 아래로 압축하고 이후 세션을 해당 제한으로 유지하므로 별도의 조치가 필요하지 않습니다."

이러한 자동 처리는 최근에 도입되었습니다. 10월 26일에 출시된 Claude Code v2.1.311에서는 "요청이 200K 토큰을 초과할 때 표준 컨텍스트 세션이 중단되는 문제"에 대한 수정 사항이 포함되었으며, 이제 Claude Code가 "대화를 압축하고 계속 진행한다"고 명시되어 있습니다. 이전 버전인 v2.1.172에서의 수정 사항은 사용 크레딧 없이 1M 컨텍스트를 사용할 때 세션이 "영구적으로 멈추는" 문제를 해결했습니다. v2.1.172 이전 버전에서 모든 요청마다 오류가 반복되는 경우, 레퍼런스에서는 /clear를 실행하여 새로운 대화를 시작하라고 권장합니다.

최신 버전에서의 시퀀스는 다음과 같습니다:

1. 요청이 대화를 표준 제한 이상으로 확장하려고 합니다.
2. 귀하의 플랜에는 사용 크레딧 없이는 해당 모델의 더 큰 창이 포함되어 있지 않습니다.
3. Claude Code가 대화를 표준 제한 아래로 다시 압축합니다.
4. 세션은 이후 표준 제한 상태로 유지됩니다.

레퍼런스의 "별도의 조치가 필요하지 않습니다"라는 말은 세션이 계속 이어진다는 점에서는 사실입니다. 하지만 압축 과정에서 대화 기록이 요약으로 대체되며, 이는 Claude가 참조할 수 있는 정보의 형태를 변화시킵니다.

Claude Code의 컨텍스트 창 문서는 압축을 직접적으로 설명합니다: "긴 세션이 압축될 때, Claude Code는 컨텍스트 창에 맞게 대화 기록을 요약합니다." 그런 다음 각 콘텐츠 유형에 어떤 일이 일어나는지 나열합니다.

디스크에서 다시 로드됨. 프로젝트 루트의 CLAUDE.md와 paths 필드가 없는 규칙(rules)은 디스크에서 다시 주입됩니다. 자동 memory(auto memory)와 Claude가 계획 모드(plan mode)에서 작성한 계획도 마찬가지입니다. 시스템 프롬프트와 출력 스타일도 그대로 적용됩니다.

필요할 때 다시 로드됨. 하위 디렉터리의 중첩된 CLAUDE.md 파일과 paths: 프런트매터가 있는 규칙은 요청 시(on demand) 다시 로드됩니다. 즉, Claude가 일치하는 파일을 다시 건드릴 때만 로드됩니다.

부분적으로 복구됨. "압축 직후, Claude Code는 세션에서 Claude가 읽거나 편집한 파일 중 가장 최근에 수정된 파일을 최대 5개까지 다시 읽습니다." 5,000 토큰이 넘는 파일은 내용 대신 해당 경로에 대한 참조로 복구됩니다. Claude가 사용한 skill 본문은 skill당 및 전체 한도까지 다시 주입되며, 오래된 것부터 먼저 삭제됩니다.

요약됨. 대화에만 존재했던 나머지 모든 것: 사용자가 설명한 내용, Claude가 찾아낸 정보, 도달한 결정 사항, 그리고 이전에 hook이 추가한 컨텍스트 등입니다.

문서에는 놓치기 쉬운 세부 사항이 추가되어 있습니다: "경로 범위 규칙(Path-scoped rules)과 중첩된 CLAUDE.md 파일은 Claude가 해당 트리거 파일을 읽고, 쓰고, 편집할 때 메시지 기록에 로드되므로, 압축 시 다른 모든 것과 함께 요약되어 사라집니다." Claude가 일치하는 파일을 다시 읽기 전까지는 해당 규칙들이 적용되지 않습니다.

실제적인 핵심은 간단합니다. 대화 속에서만 말하고 다른 곳에는 기록하지 않은 내용은 이제 요약된 수준으로만 남게 됩니다. 자동 압축 시 필요한 내용을 유지하는 방법에 대한 가이드에서 이 요약을 구성하는 방법을 자세히 다룹니다.

Claude Desktop 앱이 실행하는 세션에서는 메시지가 다르게 표시됩니다. 오류 레퍼런스에 따르면 "힌트에 명령어가 이름으로 표시되지 않습니다." 대신 claude.ai 사용량 설정 페이지를 가리키거나, Team 및 Enterprise 플랜의 경우 조직의 사용량 설정에서 사용 크레딧을 켜거나 관리자에게 요청하라고 안내합니다. 의미는 동일합니다.

사용 한도에 도달했다고 가정함. 그렇지 않습니다. 오류 레퍼런스에서는 이를 권한 확인이라고 부르며, 허용량이 남아 있어도 발생할 수 있습니다.

/compact를 반복해서 실행함. 최신 버전의 Claude Code는 스스로 압축을 수행합니다. v2.1.172 이전 버전에서는 /compact를 실행해도 오류가 반복된다고 레퍼런스에 명시되어 있습니다.

사용 크레딧을 켜고 동일한 세션에서 계속 진행함. 레퍼런스에 따르면 크레딧을 켠 후에는 Claude Code를 재시작하거나 새 세션을 시작해야 합니다. "그 전까지 세션은 표준 컨텍스트 제한 상태로 유지됩니다."

모델을 전환했는데도 오류가 다시 발생함. 설정 파일이나 환경 변수 등 구성의 다른 곳에 1M 모델 ID가 설정되어 있을 수 있습니다.

아무것도 변하지 않은 것처럼 계속 진행함. 대화는 압축되었습니다. 채팅에만 존재했던 결정 사항들은 이제 요약본에만 들어 있습니다.

1단계: 1M 창이 필요한지 결정하기

대부분의 세션에는 필요하지 않습니다. 필요 없다면 /model을 실행하고 [1m] 접미사가 없는 변형 모델을 선택하세요. 선택 목록에서 1M 변형을 완전히 제거하려면 레퍼런스에서 제안하는 대로 CLAUDE_CODE_DISABLE_1M_CONTEXT=1을 설정하세요. 이 설정이 활성화되면 모델 구성 페이지에 따라 세션은 자동 압축을 통해 200K 경계에서 압축됩니다.

정말 필요하다면 /usage-credits를 실행하세요. Pro 및 Max 플랜에서는 claude.ai의 사용량 설정이 열리며, 여기서 크레딧을 켜거나 끄고 잔액 및 월간 지출 한도를 확인할 수 있습니다. Team 및 Enterprise 플랜에서는 결제 권한이 있는 경우 조직의 사용량 설정이 열리고, 권한이 없는 경우 관리자에게 요청을 보냅니다. 그런 다음 메시지 안내에 따라 Claude Code를 재시작하거나 새 세션을 시작하세요. API 키로 로그인한 경우에는 이 명령어를 사용할 수 없습니다.

2단계: 대화 전용 컨텍스트를 유지되는 곳으로 이동하기

긴 세션이 제한에 도달하기 전에, 중요한 내용을 압축 후에도 다시 로드되는 위치에 두세요. 관습이나 규칙은 디스크에서 다시 읽어오는 프로젝트 루트의 CLAUDE.md에 넣어야 합니다. 규칙에 대해 문서는 구체적으로 명시합니다: "규칙이 압축 후에도 유지되어야 한다면 paths: 프런트매터를 삭제하거나 프로젝트 루트의 CLAUDE.md로 옮기세요."

세션 중에 내린 결정 사항은 Claude에게 저장해 달라고 요청하세요. Claude Code의 memory 문서는 Claude에게 무언가를 기억하라고 요청하면 자동 memory에 저장되며, 이는 압축 후에 다시 주입된다고 설명합니다.

3단계: 직접 제어하며 압축하기

자동 처리를 기다릴 필요는 없습니다. 컨텍스트 창 문서에서는 /compact focus on the auth bug fix와 같이 지침과 함께 /compact를 실행할 것을 권장합니다. 이렇게 하면 "자동 처리가 중요하다고 추측하는 대신 사용자가 선택한 내용을 요약에 유지"할 수 있습니다. 또한 관련 없는 작업 사이에는 /clear를 실행하거나, 대규모 조사는 subagent에게 보내어 해당 읽기 기록이 기본 컨텍스트에 남지 않도록 할 수 있습니다.

압축 후에는 Claude가 여전히 필요한 상태를 유지하고 있는지 확인하세요. 현재 작업과 그 뒤에 숨겨진 결정 사항을 요약해 달라고 요청하고, 요약에서 누락된 부분을 수정하세요. Claude 채팅이 너무 길어질 때에 대한 가이드에서 Claude 앱의 동일한 문제를 다룹니다.

1M 오류는 결제 관련 메시지이지만, 그 결과는 컨텍스트의 문제입니다. 긴 대화가 짧아지고, 대화에만 있던 내용은 이제 요약에 의존하게 됩니다. 가장 잃고 싶지 않은 결정 사항은 바로 세션 자체에서 도출된 것들입니다.

MemoryLake는 이러한 결정 사항들을 사용자가 직접 관리하는 하나의 리스트로 유지하고, Claude Code뿐만 아니라 ChatGPT, Codex 등 연결된 다른 어시스턴트에서도 사용할 수 있게 해주는 memory 레이어입니다.

사용자는 자신의 언어로 직접 항목을 작성합니다. Claude Code 세션, 요약, CLAUDE.md 파일, 자동 memory 또는 어떤 벤더의 저장소에서도 내용을 읽거나 쓰거나 삭제하지 않습니다. 압축은 Anthropic이 설명한 방식 그대로 계속 작동합니다.

1단계: API 키 생성

로그인 후 대시보드에서 키를 생성합니다. 이 키는 MemoryLake 워크스페이스에 속하며 Claude 계정 및 사용 크레딧과는 별개입니다.

2단계: 첫 번째 memory 업로드

압축으로 인해 가장 큰 타격을 입을 내용부터 시작하세요. 가장 긴 세션에서 내린 결정 사항과 그 이유들입니다. 항목당 하나의 결정을 날짜와 함께 기록하고, 적용되는 저장소(repository) 라벨을 붙입니다.

3단계: AI 및 에이전트 연결

Claude Code와 사용하는 다른 어시스턴트를 연결하세요. 압축된 세션, 새로운 세션, 또는 다른 도구 모두 동일한 결정 사항을 바탕으로 시작할 수 있습니다.

첫 번째 차이점은 오류가 더 이상 당황스럽지 않다는 것입니다. 이것이 사용량 제한이 아니라 권한 확인이며, 최신 버전에서는 세션이 계속 유지된다는 점을 알게 됩니다.

두 번째는 압축이 무엇을 했는지 이해하게 된다는 것입니다. 루트 CLAUDE.md, 범위 미지정 규칙, 자동 memory는 디스크에서 돌아왔고, 경로 범위 규칙은 일치하는 파일을 기다리며, 대화는 요약이 되었습니다.

세 번째는 중요한 부분이 결코 대화 속에만 존재하지 않게 된다는 점입니다. 나중에 긴 세션으로 돌아올 경우, 이전 세션 재개 전 Claude Code의 경고에 대한 가이드에서 재개 비용을 다루며, 유휴 상태 압축 가이드에서 자리를 비운 사이 발생하는 압축을 다룹니다.

권한 확인으로 이해하세요. 허용량은 충분할 수 있습니다.

더 많이 필요하지 않다면 표준 창을 유지하세요. [1m]이 없는 모델을 선택하거나 CLAUDE_CODE_DISABLE_1M_CONTEXT=1을 설정하세요.

사용 크레딧을 켠 후에는 재시작하세요. 재시작 전까지 세션은 표준 제한 상태로 유지됩니다.

Claude Code를 업데이트하세요. 최신 버전은 압축 후 계속 진행되지만, 구버전은 멈출 수 있습니다.

압축 후에도 유지되어야 하는 규칙은 범위를 지정하지 마세요. 또는 프로젝트 루트의 CLAUDE.md에 넣으세요.

제한에 도달하기 전에 특정 초점을 맞춰 압축하세요. 요약에 무엇을 남길지 직접 결정할 수 있습니다.

압축 후 상태를 확인하세요. Claude에게 요약을 요청하고 누락된 내용을 수정하세요. 긴 하위 디렉터리 지침 파일의 경우, Claude Code 하위 디렉터리 CLAUDE.md 제한 가이드에서 컨텍스트 창에 따른 크기 제한을 설명합니다.

'Usage credits required for 1M context'는 사용 중인 모델에 1M 토큰 창이 필요하며, 귀하의 플랜은 사용 크레딧을 통해서만 해당 창을 지원한다는 의미입니다. 이는 사용량 제한이 아니라 권한 확인입니다. 대화가 200K 토큰을 초과하여 이 오류가 나타나면, 최신 버전의 Claude Code는 대화를 표준 제한 아래로 압축하고 세션을 유지합니다.

더 큰 창이 필요한지 결정하고, 표준 변형 모델로 전환하거나 사용 크레딧을 켜고 재시작하세요. 그런 다음 중요한 컨텍스트가 CLAUDE.md, 범위 미지정 규칙 또는 자동 memory와 같이 압축 후에도 디스크에서 다시 로드되는 곳에 있는지 확인하세요.