클로드가 안 되면 status.claude.com → /status → claude doctor 순서로 3분 안에 원인을 가린다. 서버 장애인지, 내 세션 문제인지, 설치 문제인지를 넓은 것부터 좁혀가는 상태 확인 루틴이다. 서버 문제면 기다리는 게 유일한 답이고, 아니면 아래 체크리스트 순서대로 내려가면 된다.
한참 작업 중인데 클로드가 응답을 안 하거나, 에러를 뱉거나, 어제까지 되던 게 갑자기 안 될 때가 있습니다. 이때 제일 아까운 시간이 내 설정을 뒤지는 시간입니다 — 서버 장애였다면 그 삽질은 전부 헛수고거든요. 그래서 순서가 중요합니다. 원인 후보를 넓은 것부터 좁혀가는 확인 루틴을 정리했습니다.
혹시 서버 장애 아닐까? — status.claude.com 30초 확인
status.claude.com 을 엽니다. 앤트로픽의 공식 상태 페이지로, claude.ai(웹·앱), API, Claude Code가 각각 정상인지 실시간으로 표시됩니다. 여기에 주황·빨강 표시가 떠 있으면 내 잘못이 아닙니다. 설정을 뒤질 필요 없이 복구를 기다리면 됩니다. 과거 장애 이력도 같이 보여서, “며칠 전 그 이상 현상이 이거였나” 확인하는 데도 씁니다.
마침 이 글을 마무리하던 날 실제 장애가 떠 있었습니다. 장애가 나면 이렇게 보입니다.
장애까지는 아닌데 유난히 느리거나 자꾸 끊긴다면 과부하일 수 있습니다. API 기준으로 사용량 한도에 걸리면 429, 서버가 일시적으로 몰리면 529 오류가 돌아오는데, 둘 다 잠시 뒤 재시도가 정답입니다. 오류 코드별 의미는 공식 문서에 정리돼 있습니다.
두 번째 — 세션 문제인지, Claude Code 안에서 확인
서버가 정상이라면 범위를 내 세션으로 좁힙니다. Claude Code 대화창에 슬래시 명령 두 개면 됩니다.
- /status — 지금 세션의 버전, 로그인 계정, 사용 중인 모델을 보여줍니다. “어? 모델이 왜 이거지” 같은 상황이 여기서 걸립니다.
- /mcp — 연결한 MCP 서버들의 상태를 보여줍니다. 저는 며칠 전 피그마·이미지 생성 도구가 갑자기 안 붙길래 한참 헤맸는데, 여기서 보니 원격 MCP의 로그인 세션이 만료돼 있었습니다. 같은 화면에서 재인증하면 끝이었죠. 원격 MCP(OAuth 로그인형)는 세션이 만료되면 조용히 끊기니, 도구가 사라졌다 싶으면 이것부터 보세요.
대화가 이상하게 꼬였다면 세션 자체를 의심할 차례입니다. 컨텍스트가 가득 차면 응답 품질이 떨어지니 /compact로 압축하거나, 새 대화로 시작하는 게 빠를 때도 많습니다.
세 번째 — 설치 문제인지, 터미널에서 진단
Claude Code 자체가 안 뜨거나 이상 동작하면 터미널에서 진단 명령을 칩니다.
claude doctor
실제 출력은 이렇게 생겼습니다. (제 맥에서 실행한 결과에서 핵심 줄만 남겼습니다)
Claude Code doctor
Running: npm-global (2.1.220)
Platform: darwin-arm64
Path: ~/.local/.../node_modules/@anthropic-ai/claude-code/bin/claude.exe
Search: OK (bundled)
Auto-updates: enabled
Last update attempt: success → 2.1.220 (2026-07-28)
No installation issues found.
여기서 보는 포인트는 세 가지입니다 — 버전이 최신인지(자동 업데이트 성공 여부가 같이 나옵니다), 설치 경로가 정상인지, 마지막 줄에 문제 없음이 뜨는지. 문제가 발견되면 항목별로 알려주고, 세션 안에서 /doctor를 치면 자동 수정까지 시도합니다.
그래도 안 되면 뭘 봐야 할까? — 마지막 체크리스트
- 재로그인 — 세션 안에서
/login. 인증이 꼬였을 때 의외로 이거 하나로 끝나는 경우가 많습니다 - 재시작 — 터미널을 완전히 닫고 다시
claude. 오래 살아있던 세션의 이상 동작이 리셋됩니다 - 네트워크 의심 — VPN·프록시·회사망은 스트리밍 응답을 끊는 주범입니다. 잠깐 끄고 재현되는지 확인
- 어디가 안 되는지 분리 — claude.ai 웹은 되는데 Claude Code만 안 된다면 설치·터미널 쪽, 둘 다 안 되면 계정·네트워크·서버 쪽입니다
정리
- status.claude.com — 서버 장애면 여기서 끝. 기다린다
- /status · /mcp — 세션·모델·MCP 연결 상태. 원격 MCP는 로그인 만료로 조용히 끊긴다
- claude doctor — 설치·버전 진단.
/doctor는 수정까지 - 재로그인 → 재시작 → 네트워크 → 범위 분리 순서로 좁힌다
- 원인을 넓은 것(서버)부터 좁은 것(내 설치)으로 — 반대로 가면 삽질이 길어진다
이 상태 확인 루틴을 CLAUDE.md에 함정 목록으로 박아두는 것도 방법입니다 — 다음에 같은 증상이 오면 AI가 먼저 상태 페이지부터 확인해줄 테니까요.
