Claude Code 2.1.323: 미인식 모델 1M 컨텍스트 오류 해결
Claude Code 2.1.323부터 인식하지 못하는 모델 ID의 기본 컨텍스트 창이 200K에서 1M 토큰으로 변경되었습니다. 실제 한도가 더 낮은 게이트웨이를 사용하면 긴 세션에서 요청이 반복적으로 실패할 수 있습니다. 2.1.325의 수정 사항, CLAUDE_CODE_MAX_CONTEXT_TOKENS 설정 조건, /autocompact 우선순위, BetterToken을 통한 DeepSeek·Kimi 연결 방법, 이미 중단된 세션의 복구 절차를 설명합니다.
목차

Claude Code 2.1.323은 인식하지 못하는 모델 ID의 기본 컨텍스트 창을 200K에서 1M 토큰으로 변경했습니다. 연결된 외부 모델이나 API 게이트웨이의 실제 한도가 이보다 낮으면 자동 압축이 늦게 실행되어 요청이 계속 실패할 수 있습니다. 먼저 Claude Code를 2.1.325 이상으로 업데이트하고, 실제 컨텍스트 한도나 더 이른 자동 압축 임계값을 설정해야 합니다.
DeepSeek, GLM, Kimi를 사용하는 모든 세션에 200K 제한을 일괄 적용할 필요는 없습니다. 실제로 1M 토큰 컨텍스트를 지원하는 모델도 있습니다. 불필요하게 창을 줄이면 프로젝트 작업에 필요한 대화 내용이 더 일찍 요약됩니다.
이 글에서는 2.1.323부터 2.1.325까지의 변경 사항, 영향을 받는 모델 ID, 세 가지 설정 방법, 이미 오류가 반복되는 세션의 복구 절차를 설명합니다.
Claude Code 2.1.323, 2.1.324, 2.1.325에서 무엇이 바뀌었나요?
2.1.323에서 미인식 모델의 기본 컨텍스트 가정이 변경되었습니다. 이후 2.1.324와 2.1.325에서는 모델 ID 처리와 게이트웨이 컨텍스트 오류 관련 문제가 수정되었습니다.
Claude Code 공식 변경 기록에 따르면 다음과 같습니다.
| 버전 | 컨텍스트 관련 변경 사항 | 권장 조치 |
|---|---|---|
| 2.1.323 | 미인식 모델 ID의 기본 컨텍스트 창을 200K에서 1M 토큰으로 변경했습니다. | 긴 세션을 시작하기 전에 실제 한도를 확인합니다. |
| 2.1.323 | 컨텍스트 창이 작은 타사 모델에서 기록이 가득 차면 /clear를 실행할 때까지 모든 요청이 실패할 수 있습니다. | 기록이 가득 차기 전에 창 크기를 설정합니다. |
| 2.1.324 | CLAUDE_CODE_MAX_CONTEXT_TOKENS가 claude-로 시작하는 미인식 ID에도 적용됩니다. | 게이트웨이가 해당 별칭을 사용한다면 업데이트합니다. |
| 2.1.325 | 여러 타사 게이트웨이와 Foundry 환경에서 기록을 압축하지 않고 매 요청마다 컨텍스트 길이 오류로 중단되던 문제를 수정했습니다. | 다른 우회책을 적용하기 전에 업데이트합니다. |
2026-11-15 기준 npm에서 @anthropic-ai/claude-code의 latest 태그는 2.1.325, stable 태그는 2.1.311을 가리켰습니다.
stable 버전 2.1.311에는 2.1.323에서 변경된 기본 동작이 아직 없습니다. 하지만 이후 버전에서 제공된 수정 사항도 포함되지 않습니다.
설치된 버전을 먼저 확인합니다.
claude --version
Claude Code를 네이티브 설치 프로그램으로 설치했다면 문서에 안내된 업데이트 명령을 사용합니다.
claude update
claude --version
의도적으로 stable 채널을 사용하고 있다면 설정을 변경하기 전에 현재 실행 파일의 버전을 확인해야 합니다. latest에서 발생하는 동작이 기존 설치 버전에도 적용된다고 가정하면 안 됩니다.
2.1.325의 변경 기록은 여러 게이트웨이에서 반복 오류를 해결했다고 설명합니다. 모든 게이트웨이에서 복구된다는 뜻은 아닙니다. 게이트웨이에서 적용하는 별도의 컨텍스트 제한을 자동으로 알아내는 것도 아닙니다.
알 수 없는 모델 ID가 긴 세션을 중단시키는 이유는 무엇인가요?
Claude Code는 인식하는 모델 목록과 로컬 설정을 기반으로 대화 기록을 압축할 시점을 결정합니다.
자동 압축은 이전 메시지를 요약해 다음 요청이 모델의 컨텍스트 창에 들어가도록 하는 기능입니다. 게이트웨이가 자체 모델 ID를 제공하면 Claude Code가 실제 모델을 인식하지 못할 수 있습니다.
예를 들어 게이트웨이가 my-coding-model이라는 ID를 제공하고 실제 컨텍스트 한도는 200,000 토큰이라고 가정하겠습니다.
2.1.323 이전에는 Claude Code가 이 미인식 ID의 창을 200K로 가정했습니다. 2.1.323부터는 별도 설정이 없다면 1M으로 가정합니다.
모델과 게이트웨이의 처리 능력이 늘어난 것은 아닙니다. Claude Code 내부에서 사용하는 추정값만 변경된 것입니다.
대화 기록이 게이트웨이의 실제 한도를 넘으면 API가 요청을 거부할 수 있습니다. 실패해도 길어진 기록은 세션에 남습니다. 따라서 다음 요청도 같은 이유로 실패할 수 있습니다.
Anthropic은 2.1.323 변경 기록에 이 문제를 명시했습니다. 2.1.325에서는 여러 게이트웨이의 복구 동작이 개선되었습니다. 그러나 실제 창이 더 작다면 정확한 한도를 설정하는 것이 여전히 중요합니다.
어떤 모델 ID가 영향을 받나요?
Claude Code가 가정한 컨텍스트 창이 실제 API 경로에서 사용할 수 있는 창보다 클 때 문제가 발생합니다.
다음 경우를 확인해야 합니다.
- Claude Code가 인식하지 못하는
deepseek-v4.1-flash-1017,kimi-k3.1-pro같은 비-Claude 모델 ID. - 실제 서버에서 Claude 모델을 실행하더라도
my-coding-model처럼 게이트웨이가 자체적으로 지정한 별칭. claude-sonnet-latest처럼claude-로 시작하는 미인식 ID. 2.1.324에서 이러한 이름에 대한 설정 적용 방식이 바뀌었습니다.[1m]접미사가 붙은 ID. 컨텍스트 창을 재설정할 때 별도의 규칙이 적용됩니다.
모델 ID를 인식하지 못한다는 사실만으로 컨텍스트 설정이 잘못되었다고 판단할 수는 없습니다.
모델과 API 경로가 실제로 1M 토큰을 지원한다면 새로운 기본값이 적절할 수 있습니다. 문제는 모델, 게이트웨이 또는 배포 환경이 더 낮은 제한을 적용할 때 발생합니다.
Claude Code가 알고 있는 Claude 모델에 연결되는 별칭과 완전히 알 수 없는 모델 ID도 구분해야 합니다. 다른 공급자의 ID에 포함된 Anthropic 모델 이름을 인식하는 경우가 있습니다. 이때는 환경 변수의 적용 규칙도 달라집니다.
ID의 이름만 보고 판단하지 말고 Anthropic의 게이트웨이 및 사용자 정의 모델 ID 컨텍스트 설정 문서를 확인해야 합니다.
컨텍스트 창을 수정할 때 어떤 방법을 선택해야 하나요?
실제 한도를 알고 모델 ID에 재설정이 적용된다면 CLAUDE_CODE_MAX_CONTEXT_TOKENS를 사용합니다. 빠르게 200K 제한으로 되돌리려면 CLAUDE_CODE_DISABLE_1M_CONTEXT=1을 사용할 수 있습니다. 실제 한도에 도달하기 전에 여유를 확보하려면 자동 압축 임계값을 낮춥니다.
| 해결 방법 | 적합한 상황 | 제한 사항 |
|---|---|---|
CLAUDE_CODE_DISABLE_1M_CONTEXT=1 | 실제 창이 200K 이상이고 기존 제한으로 되돌리고 싶을 때 | 실제로 1M을 지원하는 일부 모델도 200K로 제한합니다. 200K 미만의 모델에는 충분하지 않습니다. |
CLAUDE_CODE_MAX_CONTEXT_TOKENS | 미인식 모델 또는 게이트웨이 별칭의 실제 창 크기를 지정할 때 | ID 인식 방식, 클라이언트 버전, [1m] 여부에 따라 적용 조건이 달라집니다. |
/autocompact, --autocompact, CLAUDE_CODE_AUTO_COMPACT_WINDOW | 예상 컨텍스트 한도보다 일찍 기록을 압축하고 싶을 때 | 설정 가능한 최솟값은 100K입니다. 실제 API 한도에 맞는 임계값을 사용해야 합니다. |
세 가지 설정은 서로 다른 역할을 합니다. 첫 번째는 200K 제한을 적용합니다. 두 번째는 Claude Code가 가정하는 모델의 창 크기를 변경합니다. 세 번째는 압축을 시작하는 시점을 결정합니다.
방법 1: 200K 제한으로 되돌리기
모델 또는 게이트웨이가 최소 200K 토큰을 허용한다면 Bash에서 다음과 같이 Claude Code를 시작합니다.
export CLAUDE_CODE_DISABLE_1M_CONTEXT=1
claude
Anthropic이 2.1.323 변경 기록에서 제시한 우회 방법입니다.
다음 실행에서도 설정을 유지하려면 ~/.claude/settings.json의 env에 변수를 추가합니다.
{
"env": {
"CLAUDE_CODE_DISABLE_1M_CONTEXT": "1"
}
}
이 설정을 활성화하면 Claude Code는 모델 선택 목록에서 [1m] 변형도 제거합니다.
기본적으로 1M 창을 사용하는 모델에서는 자동 압축이 켜져 있을 때 세션을 200K 경계로 제한합니다. 자동 압축을 껐다면 해당 경계에 도달했을 때 압축 대신 컨텍스트 제한 오류가 발생하며 중단됩니다.
다만 미인식 ID에서는 예외가 있습니다. 다른 설정으로 인해 200K 제한이 적용되지 않을 수 있습니다.
다음 경고가 표시되는지 확인합니다.
CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced for <model>, so this session can grow past it.
이 경고가 나타나면 CLAUDE_CODE_MAX_CONTEXT_TOKENS를 200K보다 크게 설정했는지 확인합니다. 미인식 모델의 창 제한을 비활성화한 설정이 있는지도 확인해야 합니다.
Anthropic의 오류 해결 문서는 200K 경계에서 압축을 적용해야 할 때 CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000을 설정하도록 안내합니다.
게이트웨이가 200K보다 적은 토큰만 허용한다면 이 방법만 사용해서는 안 됩니다.
방법 2: CLAUDE_CODE_MAX_CONTEXT_TOKENS로 실제 창 지정하기
게이트웨이의 한도를 확인했다면 해당 값을 직접 지정하는 편이 더 정확합니다.
예를 들어 관리자가 사용자 정의 모델 경로의 실제 한도가 200,000 토큰이라고 확인했다고 가정하겠습니다. Claude Code를 시작할 Bash 셸에서 다음과 같이 설정합니다.
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=200000
claude
여기서 200,000은 설명을 위한 가상 한도입니다. DeepSeek, GLM, Kimi를 비롯한 모든 모델에 권장하는 값이 아닙니다.
claude-로 시작하지 않고 [1m]도 포함하지 않는 미인식 ID에는 이 변수가 직접 적용됩니다. 지정한 창을 기준으로 사전 자동 압축도 계속 실행됩니다.
공식 모델 설정 문서의 ID별 적용 규칙에는 두 가지 중요한 예외가 있습니다.
- 미인식 ID에
[1m]이 포함되어 있다면 더 작은 창을 적용하고 사전 자동 압축을 유지하기 위해CLAUDE_CODE_DISABLE_1M_CONTEXT=1도 설정해야 합니다. - ID가 Claude Code에서 인식하는 Claude 모델로 확인된다면
DISABLE_COMPACT를 함께 설정해야 이 재설정이 적용됩니다. 하지만 이 변수는 모든 압축을 비활성화하므로 일반적인 긴 세션에는 권장되지 않습니다.
claude-로 시작하는 미인식 ID는 2.1.324부터 직접 재설정을 지원합니다. 이전 버전에서는 다르게 동작할 수 있습니다.
게이트웨이의 별칭이 실제 Claude 모델을 가리킨다면 modelOverrides 또는 modelPicker.behavesAs로 인식 가능한 Claude 모델에 연결할 수 있습니다.
경고를 없애기 위해 Claude가 아닌 모델을 Claude 모델로 등록해서는 안 됩니다.
설정에 필요한 값은 선택한 API 경로에 실제로 적용되는 컨텍스트 한도입니다. 프록시가 모델의 공개 사양보다 낮은 제한을 적용한다면 프록시의 한도를 기준으로 해야 합니다.
방법 3: /autocompact로 더 일찍 압축하기
자동 압축 임계값을 낮추면 게이트웨이가 요청을 거부하기 전에 대화 내용을 요약할 여유가 생깁니다.
실제 한도가 200K로 확인된 경로라면 다음과 같이 여유를 둔 값을 예로 사용할 수 있습니다.
/autocompact 150k
Claude Code 세션 안에서 실행합니다. 일반적으로 현재 모델의 modelSettings에 임계값을 저장하고 즉시 적용합니다.
/autocompact의 응답을 확인해 실제로 적용된 임계값을 검증해야 합니다. 관리자 설정처럼 우선순위가 높은 설정에 다른 임계값이 지정되어 있으면 입력한 값이 저장되어도 현재 세션에는 적용되지 않을 수 있습니다. 명령 응답에 이 내용이 표시됩니다.
관리자 설정 때문에 원하는 값이 적용되지 않으면 관리자에게 정책을 확인해 달라고 요청해야 합니다. Anthropic의 자동 압축 설정 문서에 따르면 시작 옵션인 --autocompact는 관리자 설정에 의해 덮어써지지 않습니다.
한 번 실행할 때만 적용하려면 다음과 같이 시작합니다.
claude --autocompact 150k
스크립트, 컨테이너 또는 자동화 환경에서는 환경 변수를 사용할 수 있습니다.
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=150000
claude
/autocompact 명령과 --autocompact 옵션은 100K–1M 토큰을 허용합니다. CLAUDE_CODE_AUTO_COMPACT_WINDOW의 설정 가능 범위는 100000부터 1000000까지입니다.
환경 변수의 값이 유효하면 명령, 시작 옵션, 저장된 설정보다 우선합니다. 이때 /autocompact를 실행하면 재설정이 적용 중이라는 메시지만 표시하고 새로운 값을 저장하지 않습니다.
모든 모델에 공통으로 적용할 설정은 ~/.claude/settings.json의 autoCompactWindow에 지정할 수 있습니다. 다만 같은 설정 범위에서는 모델별로 /autocompact에 저장한 값이 공통 설정보다 우선합니다.
150k는 200K를 허용하는 API 경로에 여유를 두기 위한 예시입니다. 실제 창이 더 작은 모델에 그대로 적용해서는 안 됩니다.
설정 가능한 최솟값은 100K입니다. 모델의 창이 이보다 작다면 모델 ID 재설정 규칙과 클라이언트의 실제 동작을 확인해야 합니다. /autocompact 50k가 지원된다고 가정하면 안 됩니다.
BetterToken 예시: Claude Code에 DeepSeek 또는 Kimi 연결하기
BetterToken은 지원되는 모델에 대해 https://bettertoken.ai에서 Anthropic 호환 API를 제공합니다. Claude Code의 ANTHROPIC_BASE_URL에는 /v1을 붙이지 않습니다.
BetterToken의 연동 문서와 Anthropic의 공식 지원 범위는 구분해야 합니다. Anthropic은 LLM 게이트웨이 문서에서 어떤 게이트웨이를 사용하더라도 Claude Code를 비-Claude 모델로 연결하는 구성을 지원하지 않는다고 명시합니다.
BetterToken은 자체적인 타사 연동 방법을 문서화하고 있습니다. 이것이 Anthropic이 DeepSeek 또는 Kimi 사용을 공식 지원한다는 의미는 아닙니다. 선택한 경로에서 모델 호환성, 도구 호출 동작, 게이트웨이 한도를 각각 확인해야 합니다.
2026-11-15 기준 BetterToken의 모델 기록과 문서에서 확인된 내용은 다음과 같습니다.
| BetterToken Model ID | 공개된 모델 컨텍스트 | Anthropic Messages 경로 |
|---|---|---|
deepseek-v4.1-flash-1017 | 1M 토큰 | 명시됨 |
kimi-k3.1-pro | 1M 토큰 | 명시됨 |
glm-5.3 | 1M 토큰 | 이 모델에는 명시되지 않음. 모델 기록에는 OpenAI 호환 접근만 표시됨 |
qwen3.8-max | 1,000,000 토큰 | 이 모델에는 명시되지 않음. 모델 기록에는 OpenAI 호환 접근만 표시됨 |
이 모델들의 공개 컨텍스트 창이 Claude Code의 새로운 1M 가정보다 반드시 작은 것은 아닙니다. 하지만 실제 적용되는 한도는 공급자나 API 경로에 따라 달라질 수 있습니다.
BetterToken에 모델이 등록되어 있어도 모든 API 프로토콜을 지원한다는 의미는 아닙니다. Claude Code용 모델을 선택하기 전에 현재 모델 카탈로그를 확인해야 합니다.
다음 Bash 예시는 Anthropic 호환 경로가 문서화된 DeepSeek ID를 사용합니다. BetterToken의 Claude Code 연동 가이드를 따른 구성입니다.
먼저 Claude Code를 설치하고 BetterToken 콘솔에서 자신의 API Key를 생성합니다. 그다음 별도의 Bash 셸에서 다음 명령을 실행합니다.
read -rs BETTERTOKEN_API_KEY && export BETTERTOKEN_API_KEY
export ANTHROPIC_BASE_URL="https://bettertoken.ai"
export ANTHROPIC_AUTH_TOKEN="$BETTERTOKEN_API_KEY"
export ANTHROPIC_MODEL="deepseek-v4.1-flash-1017"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"
unset CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT
claude -p "Reply with only: OK"
claude
첫 번째 명령이 입력을 기다리면 콘솔에서 생성한 API Key를 붙여넣고 Enter를 누릅니다. 입력한 키는 화면에 표시되지 않으며 명령 문자열에도 직접 들어가지 않습니다.
ANTHROPIC_AUTH_TOKEN은 Claude Code에 인증 정보를 전달합니다. 세 개의 ANTHROPIC_DEFAULT_*_MODEL 변수는 내부의 Haiku, Sonnet, Opus 역할을 선택한 BetterToken 모델에 연결합니다. 나중에 각 역할에 다른 지원 모델을 설정할 수도 있습니다.
Kimi를 사용하려면 세 개의 역할 변수를 export하기 전에 ANTHROPIC_MODEL을 kimi-k3.1-pro로 지정해야 합니다.
이미 DeepSeek 설정을 실행했다면 같은 Bash 셸에서 다음 네 줄을 모두 다시 실행합니다. 이후 Claude Code를 새 프로세스로 시작합니다.
export ANTHROPIC_MODEL="kimi-k3.1-pro"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"
ANTHROPIC_MODEL만 변경해도 이전에 export한 세 역할 변수의 값은 바뀌지 않습니다. 해당 변수들이 계속 DeepSeek를 가리킬 수 있습니다. 모델 ID와 연결 방법은 BetterToken의 Kimi K3.1 Pro 문서에서 확인할 수 있습니다.
[1m]이 없는 미인식 ID라면 검증한 컨텍스트 창을 명시할 수 있습니다. 선택한 API 경로가 실제로 1,000,000 토큰을 받아들인다면 다음을 설정합니다.
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=1000000
Claude Code를 시작하기 전에 설정해야 합니다. 게이트웨이의 한도가 더 낮다면 1000000을 확인된 한도로 바꿉니다. 필요하면 자동 압축 임계값도 더 일찍 설정합니다.
다음 예시를 DeepSeek나 Kimi에 검증 없이 적용해서는 안 됩니다.
# Example only: the gateway's verified limit is 200000 tokens.
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=200000
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=150000
첫 번째 변수는 실제 한도에 맞춘 예상 컨텍스트 창을 지정합니다. 두 번째 변수는 압축을 더 일찍 시작해 여유를 확보합니다. 다른 경로에서는 두 값을 각각 확인해야 합니다.
활성 모델과 게이트웨이 경로는 어떻게 확인하나요?
Claude Code를 시작한 뒤 다음을 실행합니다.
/status
Anthropic base URL에 https://bettertoken.ai가 표시되는지 확인합니다. 인증 정보의 출처는 claude.ai 계정 로그인이 아니라 ANTHROPIC_AUTH_TOKEN이어야 합니다.
다음으로 활성 모델을 확인합니다. 필요하면 /model을 사용해 원하는 ID를 선택합니다. 역할 변수를 변경했다면 Claude Code를 다시 시작해야 새로운 프로세스가 해당 값을 읽습니다.
앞서 사용한 claude -p "Reply with only: OK"는 기본 연결과 모델 접근을 확인하는 요청입니다. 정상 응답은 짧은 요청이 성공했다는 의미입니다. 긴 컨텍스트나 1M 토큰 처리까지 검증한 것은 아닙니다.
코딩 작업을 확인하려면 Claude Code에 저장소의 작은 파일을 읽고 특정 함수를 설명하도록 요청합니다. 파일을 수정하지 않도록 지정하고, 답변이 정확한 파일을 참조하는지 확인합니다.
연결이나 인증에 실패한다면 컨텍스트 문제와 구분해 먼저 해결해야 합니다. HTTP 403 관련 문제는 Claude Code 게이트웨이 403 오류 진단 가이드를 참고할 수 있습니다.
DeepSeek 설정과 모델 선택을 자세히 확인하려면 Claude Code와 DeepSeek 연동 가이드를 참고합니다. Kimi 관련 동작은 Kimi K3.1 Pro 코딩 가이드에서 확인할 수 있습니다.
이미 모든 요청이 실패한다면 어떻게 복구하나요?
먼저 게이트웨이가 컨텍스트 길이 때문에 요청을 거부하는지 확인해야 합니다. 2.1.323 변경 기록에는 반복 실패가 설명되어 있지만 모든 게이트웨이에 공통으로 나타나는 오류 문자열은 없습니다.
게이트웨이마다 다른 메시지를 반환할 수 있습니다. Anthropic의 게이트웨이 오류 해결 문서에는 다음 예시가 나옵니다.
ContextWindowExceededError
또는 다음과 같은 메시지입니다.
prompt token count of N exceeds the limit of M
이 문자열은 게이트웨이에서 반환할 수 있는 오류 예시입니다. 2.1.323 문제에서 반드시 출력되는 메시지는 아닙니다.
대화 기록을 바로 삭제하지 말고 손실이 적은 방법부터 시도합니다.
- 현재 세션의 내용을 확인할 수 있다면 작업 상태를 대화 외부에 저장합니다. 변경한 파일, 테스트 결과, 다음 작업을 기록합니다.
- Claude Code를 2.1.325 이상으로 업데이트하고 설치된 버전을 확인합니다.
- 게이트웨이의 실제 한도를 확인합니다. 다시 시작하기 전에
CLAUDE_CODE_MAX_CONTEXT_TOKENS또는 적절한 자동 압축 임계값을 설정합니다. - 현재 세션에서 명령을 실행할 수 있다면
/compact를 수동으로 시도합니다. - 대화를 압축하거나 계속할 수 없다면
/clear를 실행합니다. 저장한 작업 기록을 바탕으로 다시 시작합니다.
게이트웨이가 컨텍스트 초과 오류를 다른 형식으로 바꾸면 Claude Code가 해당 오류를 인식하지 못할 수 있습니다. 이 경우 자동 압축과 재시도가 실행되지 않을 수 있습니다.
2.1.325는 여러 게이트웨이에서 이러한 반복 실패를 수정했지만, 변경 기록에 모든 호환 경로가 나열되어 있지는 않습니다.
수동 압축까지 실패하는 상황은 Claude Code와 DeepSeek의 입력 길이 오류 복구 가이드에서 더 자세히 다룹니다.
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1을 범용 해결책으로 설정해서는 안 됩니다. Anthropic에 따르면 이 변수는 미인식 모델 ID의 사전 자동 압축을 건너뛰게 합니다. 클라이언트는 인식 가능한 API 오류가 반환될 때까지 기다리게 됩니다. 게이트웨이가 오류 형식을 변경한다면 복구가 더 어려워질 수 있습니다.
오래된 문서에는 왜 미인식 모델의 창이 200K라고 나오나요?
이 버전들이 출시되는 동안 공식 문서도 변경되었습니다.
2026-11-13에 수집된 모델 설정 문서에는 미인식 ID의 예상 창이 여전히 200K로 설명되어 있었습니다. 그러나 2026-11-15에 확인한 모델 설정 문서에는 context assumed to be 1m tokens라는 경고가 표시되어 있었습니다.
따라서 오래된 200K 경고를 현재 동작의 근거로 사용해서는 안 됩니다. 설치한 Claude Code 버전, 실제 세션에 출력되는 경고, 적용 중인 설정을 확인해야 합니다.
모델 ID가 인식되거나 올바른 창 크기가 설정되면 미인식 모델 경고가 사라질 수 있습니다. 이는 Claude Code가 설정을 받아들였다는 뜻입니다. 게이트웨이가 해당 크기의 요청을 실제로 처리할 수 있다는 증거는 아닙니다.
상황별 권장 설정
미인식 모델의 게이트웨이 한도가 1M 미만이라면 Claude Code 2.1.325 이상을 사용하고 확인된 실제 컨텍스트 창을 설정해야 합니다. 출력 토큰을 위한 여유가 필요하다면 자동 압축 임계값을 더 낮게 지정합니다.
게이트웨이 한도가 200K로 확인되었다면 CLAUDE_CODE_DISABLE_1M_CONTEXT=1은 빠른 우회 방법입니다. 더 정확하게 제어하려면 컨텍스트 창과 압축 임계값을 각각 지정합니다.
모델과 API 경로가 실제로 1M을 지원한다면 그 용량을 유지하는 편이 좋습니다. 짧은 세션을 원하거나 게이트웨이가 더 낮은 한도를 적용하는 경우에만 줄입니다.
[1m]이 붙은 미인식 ID와 이미 인식되는 Claude 모델 ID에는 별도 규칙이 적용됩니다. CLAUDE_CODE_MAX_CONTEXT_TOKENS 하나로 모든 모델의 창 크기를 바꿀 수 있다고 가정해서는 안 됩니다.
Claude Code의 기본 추정값보다 실제 API 경로에서 허용하는 컨텍스트 한도를 기준으로 설정해야 합니다.