claude code status 막힐 때, 장애인지 내 설정 문제인지 5분 안에 가르는 법

2026년 07월 04일

0 Views

claude code status 막힐 때, 장애인지 내 설정 문제인지 5분 안에 가르는 법

Claude Code가 갑자기 멈췄다면 먼저 세 가지를 나눠 봐야 합니다. Anthropic 서비스 장애인지, 내 Claude Code CLI 세션 문제인지, 계정·쿼터·네트워크 문제인지를 순서대로 확인하면 대부분 5분 안에 방향이 잡힙니다.

에러 문구를 복사한 뒤 Status 페이지, /status, /doctor 순서로 점검해 보세요.

제가 빌더 로그용 Next.js 프로젝트를 Claude Code로 수정할 때도 “요청이 오래 걸림”, “인증 재확인”, “API overloaded” 같은 메시지가 섞여 나와서 원인 파악이 더 오래 걸렸습니다. 결론은 간단했습니다. 터미널 안에서는 /status와 /doctor, 외부 장애는 Anthropic Status 페이지, 비용·사용량은 /cost 또는 계정 화면을 따로 봐야 합니다.

지금 멈춘 화면을 그대로 두세요.
에러 문구를 복사한 뒤, 아래 순서대로 장애·세션·계정 문제를 하나씩 지우면 됩니다.

먼저 확인할 것: 상태는 한 군데서 다 보이지 않는다

검색어로 claude code status를 찾는 분들이 헷갈리는 지점은 “status”가 여러 의미로 쓰인다는 점입니다. Claude Code 안의 상태, Anthropic API의 상태, 내 구독·인증 상태가 서로 다릅니다.

예를 들어 Claude 웹은 열리는데 Claude Code만 안 될 수 있고, 반대로 로컬 터미널은 정상인데 Anthropic API 쪽 지연 때문에 명령이 계속 실패할 수도 있습니다. 그래서 아래처럼 층을 나눠 보는 게 안전합니다.

1) 서비스 장애: Anthropic Status 페이지부터 본다

터미널에 overloaded, rate limit, internal server error처럼 서버성 메시지가 반복되면 먼저 Anthropic Status를 확인하세요. Claude Code는 Anthropic API와 연결되어 동작하므로, API 장애나 지연이 있으면 로컬 설정이 멀쩡해도 실패할 수 있습니다.

이때 Cursor, GitHub Copilot, ChatGPT 같은 다른 도구가 정상이라고 해서 Claude Code 설정 문제라고 단정하면 안 됩니다. 각 서비스의 백엔드와 모델 라우팅이 다르기 때문입니다.

2) 터미널 세션: Claude Code 안에서 /status 확인

Claude Code 실행 중이라면 먼저 /status를 입력해 현재 계정, 모델, 연결 상태를 확인합니다. 여기서 로그인 상태가 이상하거나 기대한 워크스페이스가 아니면, 코드 문제가 아니라 세션 문제일 가능성이 큽니다.

특히 회사 계정과 개인 계정을 번갈아 쓰는 개발자는 이 단계가 중요합니다. 같은 저장소에서 작업해도 어느 계정으로 인증됐는지에 따라 모델 접근, 사용 한도, 권한이 달라질 수 있습니다.

3) 로컬 설치: /doctor로 환경 문제를 분리

서비스 상태가 정상이고 /status도 이상해 보이지 않는데 명령이 실패한다면 /doctor를 실행해 보세요. Node.js, 터미널 권한, 인증 파일, 네트워크 프록시 같은 로컬 요소가 문제일 때가 있습니다.

저는 프로젝트 루트가 아닌 상위 폴더에서 Claude Code를 실행해 놓고 “왜 파일을 못 찾지?”라고 헤맨 적이 있습니다. 이 경우 장애가 아니라 작업 디렉터리와 권한 확인 문제였습니다.

상황별로 어디를 봐야 하는지 비교

증상	먼저 볼 곳	판단 기준	다음 행동
API error, overloaded 반복	Anthropic Status	API 지연·장애 공지 여부	잠시 대기하거나 Cursor/ChatGPT로 임시 작업
로그인 또는 계정이 이상함	`/status`	현재 인증 계정, 모델 접근 상태	재로그인 후 프로젝트 재실행
파일 접근, 명령 실행 실패	`/doctor`	로컬 환경·권한·설치 문제	작업 폴더, 권한, CLI 업데이트 확인
갑자기 답변이 짧아짐	`/cost`, 계정 사용량	사용량·요금제·한도 근접 여부	작업을 작게 쪼개거나 다음 리셋 시간 확인

실전 예시: 배포 전 버그 수정 중 멈췄을 때

가상의 상황으로 보겠습니다. Vercel에 올릴 Next.js SaaS 대시보드에서 결제 페이지 버그를 고치던 중 Claude Code가 “요청 처리 실패”를 반복합니다. 이때 바로 npm 재설치부터 하면 시간이 낭비될 수 있습니다.

첫째, Anthropic Status에서 API 장애가 없는지 확인합니다. 둘째, 터미널에서 /status로 계정과 모델 상태를 봅니다. 셋째, 같은 오류가 계속되면 /doctor로 로컬 환경을 점검합니다. 마지막으로 /cost를 확인해 세션이 지나치게 커졌거나 사용량이 높아진 것은 아닌지 봅니다.

장애라면 기다리거나 ChatGPT에 에러 로그를 붙여 임시 분석을 맡기면 됩니다. 세션 문제라면 Claude Code를 재시작하고, 로컬 문제라면 프로젝트 루트에서 다시 실행하는 편이 빠릅니다.

자주 하는 실수 하나

가장 흔한 실수는 “Claude 웹이 열리니 Claude Code도 정상일 것”이라고 보는 겁니다. 웹 앱, API, CLI는 장애 지점이 다를 수 있습니다. 반대로 Status 페이지가 정상이어도 내 인증 토큰이나 로컬 권한이 꼬이면 명령은 실패합니다.

또 하나는 에러 문구를 저장하지 않고 터미널을 바로 닫는 것입니다. 문제를 재현하기 어렵다면 원인 파악도 어려워집니다. 최소한 마지막 에러 5줄은 복사해 두세요.

FAQ

Claude Code가 느린데 장애인지 어떻게 구분하나요?

여러 요청이 모두 느리고 Anthropic Status에 지연 공지가 있으면 서비스 이슈일 가능성이 큽니다. 특정 저장소에서만 느리면 컨텍스트 크기, 파일 수, 로컬 환경을 의심하세요.

/status가 정상인데도 실패합니다. 무엇을 봐야 하나요?

/doctor로 설치와 권한을 점검하고, 프로젝트 루트에서 실행 중인지 확인하세요. 그래도 반복되면 에러 문구를 기준으로 공식 문서나 GitHub 이슈를 검색하는 편이 빠릅니다.

Cursor나 ChatGPT로 바로 갈아타도 되나요?

장애가 길어질 때는 임시 대안으로 좋습니다. 다만 Claude Code가 이미 수정한 파일과 의도한 작업 범위를 정리한 뒤 넘겨야 충돌을 줄일 수 있습니다.

바로 할 다음 행동

지금 터미널이 멈춰 있다면 닫지 말고, 에러 문구를 복사한 다음 Anthropic Status → /status → /doctor → /cost 순서로 확인하세요. 이 네 단계만 해도 장애인지, 내 설정 문제인지, 사용량 문제인지 대부분 갈립니다.

monstereae에서는 Claude Code, Cursor, MCP를 실제 빌드 흐름에 붙이는 방법을 계속 정리하고 있습니다. 다음 글에서는 Claude Code 세션을 길게 끌고 가지 않도록 작업 단위를 쪼개는 방식도 다뤄보겠습니다.

claude code status 막힐 때, 장애인지 내 설정 문제인지 5분 안에 가르는 법