Claude Code "prompt is too long"의 원인과 해결 방법 (컨텍스트 한도 초과)
지금 장애가 있나요?
Claude Code 공식 상태는 정상입니다. 이 오류가 계속되면 구현(코드) 또는 사용자 환경 문제일 가능성이 높습니다.
Claude Code의 가동 상태 보기 →오류의 의미
입력이 모델의 컨텍스트 한도를 초과했습니다(예: "API Error: 400 … prompt is too long"). 대화가 너무 길어지거나 큰 파일·대량 붙여넣기가 토큰 한도를 넘으면 발생합니다.
자주 있는 원인
- •대화 기록이 너무 길어져 토큰이 비대해짐
- •큰 파일·로그·출력을 컨텍스트에 추가
- •대량의 텍스트를 붙여넣음
- •입력과 출력(max tokens)의 합이 한도 초과
해결 방법
- 1.`/compact`로 압축하거나 `/clear`로 초기화
- 2.큰 파일은 전체가 아니라 필요한 부분만 전달
- 3.불필요한 붙여넣기·로그 줄이기
- 4.작업을 더 작은 단계로 분할
- 5.컨텍스트 창이 더 큰 모델 사용
기다리면 되는 경우 / 기다려도 안 되는 경우
입력 크기 문제이므로 기다려도 해결되지 않습니다. /compact, /clear 또는 입력량 축소로 대처하세요.
Claude Code을(를) 쓸 수 없을 때의 대체
관련 오류
자주 묻는 질문
Prompt is too long은(는) 무엇인가요?
입력이 모델의 컨텍스트 한도를 초과했습니다(예: "API Error: 400 … prompt is too long"). 대화가 너무 길어지거나 큰 파일·대량 붙여넣기가 토큰 한도를 넘으면 발생합니다.
Prompt is too long은(는) 어떻게 해결하나요?
`/compact`로 압축하거나 `/clear`로 초기화 / 큰 파일은 전체가 아니라 필요한 부분만 전달 / 불필요한 붙여넣기·로그 줄이기 / 작업을 더 작은 단계로 분할 / 컨텍스트 창이 더 큰 모델 사용