홈 › Claude Code › 오류 › 프롬프트가 너무 깁니다
개요설치CLI 참조요금 및 한도Agent SDK스킬 및 플러그인GitHub웹, 데스크톱 및 IDE모델오류오픈 소스인가요?튜토리얼학생용 안내QA 자동화Cursor와 비교Codex 및 OpenCode와 비교하위 에이전트훅MCP생태계VS CodeOpenRouter요청 속도 제한중국어 가이드
최종 업데이트: 2026년 10월 11일

Claude "프롬프트가 너무 깁니다", "요청한 모델에 비해 입력이 너무 깁니다", "컨텍스트 한도에 도달했습니다": 컨텍스트 창을 채우는 요소와 여유 공간을 확보하는 방법

이 메시지들은 모두 같은 의미입니다. Claude Code(또는 claude.ai)가 보내려는 요청이 더 이상 모델의 컨텍스트 윈도에 들어가지 않는다는 뜻입니다. 컨텍스트 윈도에는 직접 입력한 메시지 외에도 훨씬 많은 내용이 들어갑니다. 에이전트가 읽은 모든 파일, 모든 도구 결과, 시스템 프롬프트, 로드된 스킬과 MCP 도구 정의가 모두 포함됩니다. 전송하는 내용을 줄이면 해결할 수 있으며, 트래커에는 사용량 표시 자체가 잘못된 사례도 여러 건 보고되어 있습니다.

TLDR

  • Prompt is too long / input is too long for requested model — API가 반환하는 400 오류로, 요청이 컨텍스트 윈도를 초과했다는 뜻입니다. /compact, 그다음 /clear 필요한 경우에 한합니다.
  • Context limit reached · /compact or /clear to continue — Claude Code 자체의 사전 검사입니다. 해결 방법은 같으며, 때로는 오탐일 수 있습니다.
  • automatic compaction failed / single-exchange conversation cannot be compacted — 한 번의 턴이 너무 큰 경우(거대한 파일이나 도구 출력)입니다; /clear 그리고 더 적은 내용으로 지시를 다시 전달하세요.
  • 용량을 많이 차지하는 주요 항목: 많은 MCP 서버, 큰 스킬, 로그 전체 또는 압축된 파일 읽기, 긴 /goal 텍스트, 모든 내용을 상속받는 하위 에이전트.

오류 메시지

API Error: 400 {"type":"error","error":{"type":"invalid_request_error","message":"prompt is too long: 213456 tokens > 200000 maximum"}}
API Error: 400 input is too long for requested model
Context limit reached · /compact or /clear to continue
Error during compaction: automatic compaction failed
Error: a single-exchange conversation cannot be compacted
Stop hook error: Hook evaluator API error: Prompt is too long

앞의 두 오류는 API에서 발생하며 400 상태를 반환합니다. 요청이 거부되었으므로 변경 없이 재시도하면 동일하게 실패합니다. Context limit reached 는 요청을 보내기 전에 Claude Code가 자체적으로 산출한 추정치입니다. 압축 오류는 탈출 수단 자체가 실패했다는 뜻이며, 대개 대화가 하나의 거대한 요청과 응답으로 이루어져 요약할 이전 내용이 없기 때문입니다.

실제로 컨텍스트 창을 채우는 요소

  • 도구 결과. A cat 4 MB 로그, 압축된 번들에 대한 find 전체를 대상으로 node_modules — 출력의 모든 바이트가 대화에 들어갑니다. 먼저 head, grep 또는 wc -l 를 요청하거나, 에이전트에게 읽을 파일을 지정하세요.
  • MCP 도구 정의. 등록된 모든 서버의 도구 스키마가 *모든* 요청에 포함됩니다. #50284: Explore 하위 에이전트가 다음 오류로 실패했습니다. Prompt is too long 많은 MCP 서버를 등록한 뒤에는 호출할 때마다 발생했습니다. 하위 에이전트는 아무 작업도 하기 전에 이미 컨텍스트가 거의 가득 찬 상태로 시작합니다. 이 프로젝트에서 사용하지 않는 서버를 비활성화하세요(claude mcp list, 그런 다음 제거하거나 적용 범위를 제한하세요).
  • 스킬과 CLAUDE.md. #69179 에서 보고된 오류는 Context limit reached 표시된 사용량이 21%인 상태에서 기본 제공 claude-api 스킬을 로드한 직후 발생했습니다. 같은 스레드의 다른 사용자는 새 프로세스의 첫 프롬프트에서 이 오류를 겪었으며, CLAUDE.md에서 스킬 호출을 제거해 해결했습니다. 자동으로 로드되는 대규모 스킬은 눈에 잘 드러나지 않는 고정 비용입니다.
  • 대화를 평가하는 훅. 이 /goal Stop 훅은 최근 대화를 평가 모델에 보냅니다. 세션이 길어지면 이 평가 요청 자체가 한도를 초과합니다(#58192, 댓글 17개, #62345). Anthropic 엔지니어는 목표가 4,000자로 제한된다고 설명했으므로, 원인은 목표 텍스트가 아니라 세션 길이입니다. 장시간 자율 실행을 시작하기 전에 목표를 지우거나 대화를 압축하세요.
  • 하위 에이전트. 각 하위 에이전트에는 자체 컨텍스트 창이 있지만, Cowork 방식의 에이전트 생성에서 다음 오류가 발생한다는 보고가 있었습니다. Prompt is too long 0토큰에서 발생했습니다(#55712). 이런 양상이 보이면 CLI를 업데이트하세요.

Claude Code에서 해결하기

/context          # what is in the window right now, by category
/compact          # summarise history, keep the task
/compact focus on the failing test and the diff   # steer what survives
/clear            # fresh window; paste a short brief of where you were
/model            # a (1M) variant if the job is genuinely large

순서가 중요합니다. 먼저 확인할 것은 /context 입니다. MCP 도구나 스킬이 컨텍스트 창의 상당 부분을 차지한다면 대화를 압축해도 효과가 오래가지 않습니다. 고정 비용을 제거하세요. 하나의 도구 결과가 문제라면, /clear 를 사용하는 편이 압축 문제와 씨름하는 것보다 빠릅니다. 작업에 실제로 수십만 토큰이 필요하다면, (1M) 모델 변형이 적합합니다. 다만 선택 과정에도 함정이 있으므로 다음 절을 확인하세요.

사용량 표시가 잘못된 경우

이슈 트래커에는 안내된 컨텍스트 한도보다 훨씬 낮은 사용량에서 실패했다는 보고가 여러 건 있습니다. #51915: Context limit reached 사용량 27%에서 발생했으며, /compact 도 이어서 오류가 발생했습니다. #49605: 한도에 도달하지 않았는데도 경고가 발생했습니다. API 오류 400 가이드 에서는 다음과 관련된 사례를 다룹니다. Prompt is too long 클라이언트에는 1M이 표시되지만 실제로는 200K 컨텍스트 창이 제공되는 계정에서 166K~178K토큰 사이에 발생하는 경우입니다. 실용적인 원칙은 다음과 같습니다. /context 에 여유가 있다고 표시되는데도 API가 계속 거부한다면, 약 150K을 실제 상한으로 간주하고 그 지점에서 압축하세요.

반대의 함정도 있습니다. 1M 컨텍스트 창이 포함되지 않은 요금제에서 해당 창을 기본값으로 사용하는 모델을 선택하면 컨텍스트 오류가 아니라 *사용량 한도* 메시지가 표시됩니다(#62052 — "Sonnet 선택 시 오해를 부르는 사용량 한도 도달 오류 — 실제로는 1M 컨텍스트 등급 제한"). 다음에서 1M이 아닌 변형을 선택하세요. /model, 또는 다음을 설정하세요. CLAUDE_CODE_DISABLE_1M_CONTEXT=1. 자세한 내용은 다음에서 확인하세요. 사용 한도 페이지.

claude.ai의 "이 대화는 너무 길어 계속할 수 없습니다"

채팅 제품에도 같은 한도가 있지만 표현이 다릅니다. *메시지를 보내면 이 채팅의 길이 한도를 초과합니다. 첨부 파일 수나 크기를 줄이거나 새 대화를 시작해 보세요.* 및 *이 대화는 너무 길어 계속할 수 없습니다. 새 채팅을 시작하거나 일부 도구를 제거해 공간을 확보하세요.* 두 번째 메시지는 커넥터와 관련이 있습니다. 활성화된 도구나 MCP 커넥터는 메시지마다 컨텍스트를 차지하므로, 메시지에서 도구 제거를 제안하는 것입니다(#58521). 새 채팅을 시작하고, 첨부 파일 수를 줄이고, 지속적으로 참조할 자료는 다시 첨부하는 대신 프로젝트에 넣고, 해당 대화에서 사용하지 않는 커넥터를 끄세요.

API와 게이트웨이에서

길이로 인한 400은 모델이 결정하므로, Anthropic 직접 연결과 이 게이트웨이를 통한 연결에서 동일하게 동작합니다(ANTHROPIC_BASE_URL=https://aiprimetech.io). 차이는 과금 방식입니다. API는 세션 사용량 창 없이 토큰당 과금하므로, 구독 한도에 계속 걸리는 긴 컨텍스트 작업은 API 키로 수행하는 편이 비용이 적게 들고 더 수월한 경우가 많습니다. 엔드포인트에서 제공하는 모델과 컨텍스트 창 크기는 다음에서 확인하세요. /v1/models 다음을 사용하기 전에 (1M) 변형.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
claude

이 문제와 씨름하는 데 지치셨나요?

대신 AI Prime Tech 게이트웨이를 통해 Claude Code를 실행하세요. 게이트웨이 자체 업스트림 계정에서 동일한 Claude 모델을 사용하며, 환경 변수 두 개로 전환할 수 있고, 신규 계정에는 다음이 제공됩니다: $5의 무료 API 크레딧이 제공됩니다 사용할 코드: FIXIT — 카드 불필요.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

코드 FIXIT로 계정 만들기

자주 묻는 질문

'요청한 모델에 비해 입력이 너무 깁니다'는 무슨 뜻인가요?

요청이 선택한 모델의 컨텍스트 창을 초과했다는 뜻입니다. API에서 반환하는 400입니다. /compact 또는 /clear를 실행하거나, 사용하지 않는 MCP 서버와 스킬을 제거하거나, 더 큰 컨텍스트 창을 제공하는 모델 변형으로 전환하세요.

Claude Code에서 '컨텍스트 한도에 도달했습니다'를 어떻게 해결하나요?

/context로 컨텍스트 창을 채우는 항목을 확인하고, /compact로 요약하며, 압축에 실패하면 /clear를 실행하세요. 한도보다 훨씬 낮은 사용량에서 발생한다면 잘못된 경고로 간주하되, 그래도 압축하세요. 이슈 트래커에 이런 버그가 여러 건 등록되어 있습니다.

압축은 왜 실패하나요?

자동 압축에는 요약할 이전 대화 턴이 필요합니다. 하나의 거대한 도구 출력처럼 대화가 하나의 거대한 요청과 응답으로 이루어져 있다면 압축할 내용이 없습니다. /clear를 실행하고 더 작은 입력으로 작업 내용을 다시 전달하세요.

claude.ai에서 '이 대화는 너무 길어 계속할 수 없습니다'를 어떻게 해결하나요?

새 채팅을 시작하고, 첨부 파일 수나 크기를 줄이며, 사용하지 않는 커넥터나 도구를 비활성화하세요. 활성화된 각 도구는 메시지마다 컨텍스트를 차지합니다.

게이트웨이에서 Claude Code 실행하기

동일한 모델, 환경 변수 두 개, 액면가의 7.69231배에 해당하는 크레딧 또는 정액 무제한 요금제를 이용하세요. 신규 계정: 코드 FIXIT로 $5의 무료 API 크레딧을 받으세요.

API 키 발급받기 무제한 요금제 보기

AI Prime Tech는 독립 API 게이트웨이이며 Anthropic과 제휴 관계가 없고, Anthropic의 보증이나 후원을 받지 않습니다. “Claude”와 “Claude Code”는 Anthropic의 상표입니다. 여기에 설명된 Claude Code 기능은 작성 당시 Anthropic의 공개 문서를 기준으로 하며 자주 변경됩니다. 이 페이지의 가격과 모델 목록은 이 게이트웨이의 실시간 설정에서 가져옵니다.

더 많은 Claude Code 가이드

Claude Code 오류와 해결 방법Claude Code "API 오류: 500": 의미와 실제로 효과가 있는 해결 방법Claude "과부하" 오류(API 오류 529): 의미와 대처 방법Claude Code API 오류 400: 프롬프트 길이 초과, 도구 사용 동시성 및 기타 오류Claude Code OAuth 오류: 15000ms 제한 시간 초과 및 상태 코드 500"Claude Code 프로세스가 코드 1으로 종료되었습니다": 실제 오류를 찾아 해결하는 방법Claude 사용량 한도 도달: 세션, 주간 및 Opus 한도, "지정된 API 사용량 한도", "크레딧 잔액이 너무 적습니다" — 대처 방법Claude Code 401 및 403: 유효하지 않은 인증 자격 증명, 유효하지 않은 API 키, "로그인되지 않음", host_not_allowedClaude Code 연결 오류: ECONNRESET, 응답 도중 연결 끊김, "API 응답 대기 중", "API에 연결할 수 없음", SSL 인증서 오류Claude Code가 멈추거나 진행되지 않거나 응답하지 않는 경우: 멈춘 지점을 파악하고 벗어나는 방법Claude.ai가 작동하지 않는 경우: "문제가 발생했습니다", 용량 제약, "5시간 한도에 도달했습니다", "로그인 중 오류" 및 기타 문제