Source: https://aiprimetech.io/ko/claude-code/errors/claude-ai-not-working/ [홈](/ko/) › [Claude Code](/ko/claude-code/) › [오류](/ko/claude-code/errors/) › claude.ai 오류 [개요](/ko/claude-code/)[설치](/ko/claude-code/install/)[CLI 참조](/ko/claude-code/cli/)[요금 및 한도](/ko/claude-code/pricing/)[Agent SDK](/ko/claude-code/sdk/)[스킬 및 플러그인](/ko/claude-code/skills/)[GitHub](/ko/claude-code/github/)[웹, 데스크톱 및 IDE](/ko/claude-code/web-and-desktop/)[모델](/ko/claude-code/models/)[오류](/ko/claude-code/errors/)[오픈 소스인가요?](/ko/claude-code/open-source/)[튜토리얼](/ko/claude-code/tutorial/)[학생용 안내](/ko/claude-code/for-students/)[QA 자동화](/ko/claude-code/qa-automation/)[Cursor와 비교](/ko/claude-code/vs-cursor/)[Codex 및 OpenCode와 비교](/ko/claude-code/vs-codex/)[하위 에이전트](/ko/claude-code/subagents/)[훅](/ko/claude-code/hooks/)[MCP](/ko/claude-code/mcp/)[생태계](/ko/claude-code/ecosystem/)[VS Code](/ko/claude-code/vscode/)[OpenRouter](/ko/claude-code/openrouter/)[요청 속도 제한](/ko/claude-code/rate-limits/)[중국어 가이드](/claude-code/zh/) 최종 업데이트: 2026년 10월 11일 # Claude.ai가 작동하지 않는 경우: "문제가 발생했습니다", 용량 제약, "5시간 한도에 도달했습니다", "로그인 중 오류" 및 기타 문제 Claude.ai는 코드 없이 짧은 메시지만 표시하므로, 문구가 유일한 단서입니다. Anthropic의 공식 지원 문서에 이 메시지들이 나열되어 있습니다. 여기서는 원인별로 묶어 각각의 해결 방법을 설명하고, 기다리는 것만이 유일한 해결책인 경우도 솔직하게 안내합니다. ## TLDR - 용량 문제 및 *문제가 발생했습니다* → Anthropic 측 문제입니다. status.claude.com을 확인하고 몇 분 후 다시 시도하세요. - *5시간 한도* / 주간 한도 → 요금제의 사용 한도 기간입니다. 표시된 시각에 초기화되며, 해결할 문제는 없습니다. - 길이 한도 메시지 → 채팅이 가득 찼습니다. 새 채팅을 시작하고 첨부 파일과 커넥터를 줄이세요. - 로그인 오류 → claude.ai의 사이트 데이터를 삭제하고, 확장 프로그램을 비활성화한 다음 다른 브라우저나 네트워크를 사용해 보세요. ## 메시지와 그 의미 - 예기치 않은 용량 제약으로 인해 Claude가 메시지에 응답할 수 없습니다. 잠시 후 다시 시도해 주세요. — 해당 모델 등급의 처리 용량이 포화 상태입니다. API의 다음 오류와 같습니다. [529 과부하](/ko/claude-code/errors/overloaded-529/). 몇 분 기다리세요. 용량은 모델별로 관리되므로, 모델 선택기에서 더 작은 모델로 전환하면 즉시 해결되는 경우가 많습니다. - 문제가 발생했습니다 / 끝없이 돌아가는 로딩 표시 — 서비스 장애, 잘못된 세션 토큰, 브라우저 확장 프로그램의 간섭 등 일반적인 실패입니다. 새로고침하세요. 계속되면 아래 체크리스트를 따르세요. - 5시간 한도에 가까워지고 있습니다. / 5시간 한도에 도달했습니다 - 오후 3:00시에 초기화됩니다. — 요금제의 세션 사용 한도이며, 토큰 사용량에 따라 소진됩니다(긴 문서와 긴 채팅이 가장 많이 소모합니다). 표시된 시각에 자동으로 초기화됩니다. Pro와 Max에는 같은 방식으로 작동하는 주간 사용 한도도 있습니다. [사용 한도 페이지](/ko/claude-code/errors/usage-limit-reached/) 에서 이 모든 한도를 설명합니다. - 메시지가 이 채팅의 길이 한도를 초과합니다. 첨부 파일 수나 크기를 줄이거나 새 대화를 시작해 보세요. — 대화와 첨부 파일이 더 이상 허용 범위에 들어가지 않습니다. 새 채팅을 시작하고 지속적으로 참고할 파일은 프로젝트에 넣으세요. - 이 대화는 너무 길어 계속할 수 없습니다. 새 채팅을 시작하거나 일부 도구를 제거해 공간을 확보하세요. — 같은 한도이며, 메시지 후반부에 단서가 있습니다. 활성화된 모든 커넥터나 도구는 메시지마다 컨텍스트를 차지합니다([#58521](https://github.com/anthropics/claude-code/issues/58521)). 사용하지 않는 항목은 끄세요. - 로그인 중 오류가 발생했습니다 — 로그인 요청과 응답 과정이 실패했습니다. 대개 확장 프로그램, 오래된 쿠키, 인증 서비스가 허용하지 않는 VPN 출구 서버 또는 서비스 장애가 원인입니다. - Claude가 곧 돌아옵니다 / 앱 전체가 작동하지 않음 — 서비스 중단입니다. status.claude.com만이 도움이 되는 페이지입니다. ## 오 분 체크리스트 - 열기 [status.claude.com](https://status.claude.com/). 진행 중인 장애가 있다면 여기서 멈추고 기다리세요. - 강력 새로고침(Ctrl+Shift+R / Cmd+Shift+R)을 실행하세요. 그런 다음 로그아웃하고 다시 로그인하세요. - 시크릿 창을 사용해 보세요. 거기서 정상 작동한다면 확장 프로그램이 간섭하는 것입니다. 광고 차단기와 Claude in Chrome 확장 프로그램이 흔한 원인입니다. - 브라우저 전체가 아니라 claude.ai의 사이트 데이터(쿠키 및 저장소)만 삭제하세요. - 네트워크를 바꿔 보세요. VPN을 끄거나 켜고, 사무실 Wi-Fi 대신 모바일 핫스팟을 사용하세요. 기업 프록시와 일부 VPN 출구 서버는 로그인과 스트리밍 응답을 방해합니다. - 브라우저를 업데이트하고 다른 브라우저도 사용해 보세요. 데스크톱 앱과 모바일 앱은 별도로 빌드되므로, 한쪽은 작동하고 다른 쪽은 작동하지 않는다면 계정이 아니라 해당 앱에 문제가 있는 것입니다. ## 오류가 아니라 한도가 문제인 경우 세션 및 주간 사용 한도는 요금제가 설계된 대로 작동하는 것이며, 이를 바꾸는 설정은 없습니다. 현실적인 선택지는 초기화될 때까지 기다리거나, 한도가 더 큰 요금제로 업그레이드하거나, 토큰별로 과금되는 곳에서 대규모 작업을 수행하는 것입니다. API에는 세션 사용 한도가 없습니다. Claude Code, Cursor 및 모든 Anthropic 호환 클라이언트는 API 키로 실행할 수 있으며, 이 게이트웨이를 통해 처음 암호화폐로 충전하면 충전액이 두 배가 됩니다(+50%). 채팅 방식으로 사용하려면 Messages API를 지원하는 모든 클라이언트에서 같은 키를 사용할 수 있습니다. ``` export ANTHROPIC_BASE_URL=https://aiprimetech.io export ANTHROPIC_API_KEY=your_gateway_key claude # per-token billing, no 5-hour window ``` ## 관련 페이지 터미널의 Claude Code에는 별도의 메시지들이 있습니다. [API 오류 500](/ko/claude-code/errors/api-error-500/), [529 과부하](/ko/claude-code/errors/overloaded-529/), [프롬프트가 너무 깁니다](/ko/claude-code/errors/prompt-too-long/), [401 / 403](/ko/claude-code/errors/auth-401-403/), [연결 오류](/ko/claude-code/errors/connection-lost/), [OAuth 로그인 오류](/ko/claude-code/errors/oauth-error/). Anthropic의 claude.ai 메시지 목록은 다음 문서에서 확인할 수 있습니다. [지원 문서](https://support.claude.com/en/articles/12466728-troubleshoot-claude-error-messages). ## 이 문제와 씨름하는 데 지치셨나요? 대신 AI Prime Tech 게이트웨이를 통해 Claude Code를 실행하세요. 게이트웨이 자체 업스트림 계정에서 동일한 Claude 모델을 사용하며, 환경 변수 두 개로 전환할 수 있고, 신규 계정에는 다음이 제공됩니다: $5의 무료 API 크레딧이 제공됩니다 사용할 코드: FIXIT — 카드 불필요. ``` export ANTHROPIC_BASE_URL=https://aiprimetech.io export ANTHROPIC_API_KEY=your_key ``` [코드 FIXIT로 계정 만들기](/register?promo=FIXIT) ## 자주 묻는 질문 claude.ai에 '예기치 않은 용량 제약으로 인해'라는 메시지가 표시되는 이유는 무엇인가요? 선택한 모델의 처리 용량이 Anthropic 측에서 포화 상태입니다. 몇 분 기다리거나 더 작은 모델을 선택하세요. API의 529 과부하 오류에 해당하는 채팅 메시지입니다.claude.ai에 '문제가 발생했습니다'라는 메시지가 표시되는 이유는 무엇인가요? 서비스 장애, 오래된 세션 또는 브라우저 확장 프로그램으로 인한 일반적인 실패입니다. status.claude.com을 확인하고, 강력 새로고침을 실행하고, 시크릿 창을 사용해 보고, claude.ai의 사이트 데이터를 삭제한 다음 다른 브라우저나 네트워크를 사용해 보세요.Claude에서 '5시간 한도에 도달했습니다'는 무슨 뜻인가요? 요금제의 세션 사용 한도를 모두 소진했다는 뜻이며, 표시된 시각에 초기화됩니다. 토큰 사용량에 따라 소진되므로 긴 채팅과 큰 첨부 파일이 한도를 가장 빠르게 소모합니다. API 경로는 토큰별로 과금되며 이러한 세션 사용 한도가 없습니다.지금 Claude 서비스가 중단되었나요? status.claude.com.을 확인하세요. 장애가 표시되면 로컬에서 어떤 조치를 해도 해결되지 않습니다. 정상 상태인데도 claude.ai이 계속 작동하지 않으면 위의 브라우저 체크리스트를 따르세요. ## 게이트웨이에서 Claude Code 실행하기 동일한 모델, 환경 변수 두 개, 액면가의 7.69231배에 해당하는 크레딧 또는 정액 무제한 요금제를 이용하세요. 신규 계정: 코드 FIXIT로 $5의 무료 API 크레딧을 받으세요.[API 키 발급받기](/register?promo=FIXIT) [무제한 요금제 보기](/ko/plans/) AI Prime Tech는 독립 API 게이트웨이이며 Anthropic과 제휴 관계가 없고, Anthropic의 보증이나 후원을 받지 않습니다. “Claude”와 “Claude Code”는 Anthropic의 상표입니다. 여기에 설명된 Claude Code 기능은 작성 당시 Anthropic의 공개 문서를 기준으로 하며 자주 변경됩니다. 이 페이지의 가격과 모델 목록은 이 게이트웨이의 실시간 설정에서 가져옵니다. ## 더 많은 Claude Code 가이드 [Claude Code 오류와 해결 방법](/ko/claude-code/errors/)[Claude Code "API 오류: 500": 의미와 실제로 효과가 있는 해결 방법](/ko/claude-code/errors/api-error-500/)[Claude "과부하" 오류(API 오류 529): 의미와 대처 방법](/ko/claude-code/errors/overloaded-529/)[Claude Code API 오류 400: 프롬프트 길이 초과, 도구 사용 동시성 및 기타 오류](/ko/claude-code/errors/api-error-400/)[Claude Code OAuth 오류: 15000ms 제한 시간 초과 및 상태 코드 500](/ko/claude-code/errors/oauth-error/)["Claude Code 프로세스가 코드 1으로 종료되었습니다": 실제 오류를 찾아 해결하는 방법](/ko/claude-code/errors/process-exited-code-1/)[Claude "프롬프트가 너무 깁니다", "요청한 모델에 비해 입력이 너무 깁니다", "컨텍스트 한도에 도달했습니다": 컨텍스트 창을 채우는 요소와 여유 공간을 확보하는 방법](/ko/claude-code/errors/prompt-too-long/)[Claude 사용량 한도 도달: 세션, 주간 및 Opus 한도, "지정된 API 사용량 한도", "크레딧 잔액이 너무 적습니다" — 대처 방법](/ko/claude-code/errors/usage-limit-reached/)[Claude Code 401 및 403: 유효하지 않은 인증 자격 증명, 유효하지 않은 API 키, "로그인되지 않음", host_not_allowed](/ko/claude-code/errors/auth-401-403/)[Claude Code 연결 오류: ECONNRESET, 응답 도중 연결 끊김, "API 응답 대기 중", "API에 연결할 수 없음", SSL 인증서 오류](/ko/claude-code/errors/connection-lost/)[Claude Code가 멈추거나 진행되지 않거나 응답하지 않는 경우: 멈춘 지점을 파악하고 벗어나는 방법](/ko/claude-code/errors/claude-code-hangs/)