오류 원문

Claude Code 오류 메시지 모음: 원문, 원인 위치, 해결 방법

보이는 메시지를 입력하거나 붙여 넣으면 목록이 좁혀집니다. 항목마다 원인이 내 PC, 계정, 서비스, 중간 게이트웨이 중 어디에 있는지 표시하고 전체 해결 방법으로 연결합니다.

메시지 63개
해결 글 15편
2026년 11월 15일 확인

Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh
- 원인: 내 PC 또는 설정
- CLI
- 이슈 #91708
- 이슈 #92330
- 이슈 #95822
- 이슈 #105729
이 글에서 함께 다루는 메시지
- Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh)
  - 원인: 내 PC 또는 설정
  - CLI
- EPERM: operation not permitted, mkdir
  - 원인: 내 PC 또는 설정
  - 이슈 #91708
로그인이 거부된 것이 아니라 같은 컴퓨터의 갱신 잠금이 막은 것입니다. 1분 뒤 다시 실행하고, 반복되면 다른 Claude Code를 닫은 뒤 남은 빈 잠금 폴더만 지우고 /login 합니다.
해결 방법 보기: Failed to refresh OAuth token: another Claude Code process 오류 해결글 업데이트 2026년 11월 12일
Failed to authenticate. API Error: 403 Your account can't receive replies from Claude right now
- 원인: 계정 또는 요금제
- CLI
- HTTP 403
이 글에서 함께 다루는 메시지
- Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted
  - 원인: 계정 또는 요금제
  - CLI
- Replies from Claude are unavailable on your account. You can complete the verification now in the Anthropic Verification Portal
  - 원인: 계정 또는 요금제
  - 웹
- Complete verification to continue
  - 원인: 계정 또는 요금제
  - 데스크톱 앱
Your account can't receive replies from Claude right now는 Claude Code 버그가 아닌 계정 본인인증 요청이라 /login으로 풀리지 않습니다.
해결 방법 보기: Claude Code "can't receive replies from Claude" 오류: 본인인증 요청글 업데이트 2026년 11월 5일

모델을 찾을 수 없거나 사용할 수 없음

There's an issue with the selected model (claude-fable-5.2)
- 원인: 여러 가능성
- CLI
이 글에서 함께 다루는 메시지
- You've reached your Fable limit.
  - 원인: 계정 또는 요금제
  - CLI
- Fable 5.2's safeguards flagged this message
  - 원인: 서비스 쪽
  - CLI
  - 이슈 #109211
- Claude Code doesn't recognize the model "claude-fable-5-2", so it assumes a context window of 200k tokens
  - 원인: 내 PC 또는 설정
  - CLI
  - 데스크톱 앱
  - 이슈 #108785
- Fable is experiencing high load, please use /model to switch to Sonnet
  - 원인: 서비스 쪽
  - CLI
- Invalid signature in thinking block. The block is bound to a different conversation.
  - 원인: 내 PC 또는 설정
  - API
  - HTTP 400
Fable 5.2 오류는 화면 문구로 원인을 가립니다. Claude Code는 2.1.321 이상에서 /model claude-fable-5-2를 입력하고, API는 하이픈 ID부터 봅니다.
해결 방법 보기: Claude Fable 5.2 오류: 문구별 원인과 해결, /model에 없으면 ID 입력글 업데이트 2026년 11월 14일

속도 제한과 용량

API Error: Rate limit reached
- 원인: 여러 가능성
- CLI
- HTTP 429
이 글에서 함께 다루는 메시지
- You've hit your session limit · resets 3:45pm
  - 원인: 계정 또는 요금제
  - CLI
- You've hit your weekly limit · resets Mon 12:00am
  - 원인: 계정 또는 요금제
  - CLI
- API Error: Server is temporarily limiting requests (not your usage limit)
  - 원인: 서비스 쪽
  - CLI
- API Error: Request rejected (429) · this may be a temporary capacity issue
  - 원인: 계정 또는 요금제
  - CLI
  - HTTP 429
- API Error: Usage credits required for 1M context
  - 원인: 계정 또는 요금제
  - CLI
Claude Code의 Rate limit reached는 구독 한도, 서버 일시 제한, API 키 429, 1M 컨텍스트 권한 중 하나입니다. 원문으로 종류를 가리고 세션을 닫지 말고 이어가세요.
해결 방법 보기: Claude Code Rate Limit Reached 해결: 사용량·컨텍스트·API 제한 구분하기글 업데이트 2026년 11월 10일
API Error: Repeated 529 Overloaded errors
- 원인: 서비스 쪽
- CLI
- HTTP 529
이 글에서 함께 다루는 메시지
- Opus is experiencing high load, please use /model to switch to Sonnet
  - 원인: 서비스 쪽
  - CLI
- Opus is experiencing high load. Switch to Sonnet.
  - 원인: 서비스 쪽
  - 데스크톱 앱
- API Error: Server error mid-response. The response above may be incomplete.
  - 원인: 서비스 쪽
  - CLI
Claude Code의 529 과부하 메시지는 최대 10회 자동 재시도 뒤에 뜨며 사용량 한도와 무관합니다. 급하면 /model로 모델을 바꾸고, 반복되면 fallback 체인을 설정하세요.
해결 방법 보기: Claude Code 529 과부하 오류: 기다릴지, 모델을 바꿀지글 업데이트 2026년 9월 28일

서버 오류와 연결 끊김

API Error: 500 Internal server error
- 원인: 서비스 쪽
- HTTP 500
이 글에서 함께 다루는 메시지
- OAuth error: Request failed with status code 500
  - 원인: 여러 가능성
  - CLI
  - HTTP 500
  - 이슈 #33226
  - 이슈 #44271
  - 이슈 #44725
- API Error: 500 status code (no body)
  - 원인: 내 PC 또는 설정
  - HTTP 500
  - 이슈 #58827
  - 이슈 #70650
- No conversation found with session ID
  - 원인: 내 PC 또는 설정
Claude Code API Error 500은 장애 확인 후 1분 뒤 한 번 재시도합니다. 끊긴 작업은 완료된 일을 확인해 남은 단계만 잇고, 로그인 중이나 특정 대화만 실패하면 순서가 다릅니다.
해결 방법 보기: Claude Code API Error 500·529 해결: 끊긴 작업을 중복 없이 재개하기글 업데이트 2026년 10월 5일
API Error: 403 {"error":{"type":"forbidden","message":"Request not allowed"}}
- 원인: 여러 가능성
- HTTP 403
이 글에서 함께 다루는 메시지
- App unavailable in region
  - 원인: 여러 가능성
- No available accounts
  - 원인: 게이트웨이 또는 중계
  - HTTP 503
- No available channel for model X under group Y
  - 원인: 게이트웨이 또는 중계
  - HTTP 503
  - 이슈 #6915
- API Error: 503 Bedrock is unable to process your request
  - 원인: 서비스 쪽
  - CLI
  - VS Code
  - HTTP 503
  - 이슈 #67080
  - 이슈 #38134
  - 이슈 #74514
같은 403·503도 응답한 곳이 다릅니다. /status에 Anthropic base URL 줄이 있으면 중계·게이트웨이부터, 없으면 계정·프록시를 봅니다. 529는 한도가 아닌 용량 문제입니다.
해결 방법 보기: Claude Code 403·503·529 오류, 발생 위치별 해결법글 업데이트 2026년 9월 29일
Unable to connect to API
- 원인: 내 PC 또는 설정
- CLI
이 글에서 함께 다루는 메시지
- ECONNREFUSED
  - 원인: 내 PC 또는 설정
  - CLI
- ECONNRESET
  - 원인: 여러 가능성
  - CLI
- ETIMEDOUT
  - 원인: 내 PC 또는 설정
  - CLI
- fetch failed
  - 원인: 내 PC 또는 설정
  - CLI
Claude Code를 시작한 shell에서 API host를 검사한 뒤 network, proxy, CA, 실행 환경, gateway 중 실패한 경로만 수정합니다.
해결 방법 보기: Claude Code Unable to connect to API 해결: ECONNREFUSED, ECONNRESET, 프록시 점검글 업데이트 2026년 8월 4일

요청이 거부됨

top_p deprecated
- 원인: 여러 가능성
- HTTP 400
Claude Code에서 Opus 4.7의 top_p deprecated 오류가 나면 실제 모델과 연결 경로부터 확인하세요. 최종 요청의 샘플링 항목만 제거하고 메시지·도구·출력 제한은 보존한 뒤, 같은 경로에서 원래 작업이 완료되는지 확인해야 합니다.
해결 방법 보기: Claude Code에서 top_p deprecated? 먼저 Opus 4.7 request contract부터 확인하세요글 업데이트 2026년 10월 7일

앱, IDE, 실행

Git is required for local sessions
- 원인: 내 PC 또는 설정
- 데스크톱 앱
- 1.49585.0에서 수정
- 이슈 #72976
- 이슈 #44297
이 글에서 함께 다루는 메시지
- Git is required but was not found
  - 원인: 내 PC 또는 설정
  - 데스크톱 앱
- Git is installed but isn't working
  - 원인: 내 PC 또는 설정
  - 데스크톱 앱
- Git LFS is required by this repository but is not installed
  - 원인: 내 PC 또는 설정
  - 데스크톱 앱
Windows 앱 1.49585.0 미만은 Git 재설치 대신 업데이트로 풀립니다. 최신 앱은 Worktree 세션만 Git이 필요하고, 그래도 뜨면 bash.exe 경로와 완전 종료를 봅니다.
해결 방법 보기: Claude Code '로컬 세션에는 Git이 필요합니다' 해결: 버전·Worktree부터글 업데이트 2026년 10월 23일
Error: Cannot find module './yoga.wasm'
- 원인: 내 PC 또는 설정
- CLI
- 이슈 #1103
- 이슈 #7193
이 글에서 함께 다루는 메시지
- Error: claude native binary not installed.
  - 원인: 내 PC 또는 설정
  - CLI
  - 2.1.113부터 발생
- npm error code ENOTEMPTY
  - 원인: 내 PC 또는 설정
  - CLI
  - 이슈 #7193
Claude Code의 yoga.wasm 에러는 2.0.25 이하 npm 빌드가 실행될 때만 납니다. which -a claude로 그 복사본을 찾아 지우고 설치를 하나만 남기세요.
해결 방법 보기: Claude Code Cannot find module yoga.wasm 해결: 2.0.25 이하 복사본 정리글 업데이트 2026년 10월 16일
error: claude code process exited with code 1
- 원인: 여러 가능성
- CLI
- VS Code
- JetBrains
Claude Code가 code 1로 종료되면 API key, VS Code, GitHub Action, PATH, hooks, 상태, 세션을 한꺼번에 고치지 말고 실행 경로별로 좁혀야 합니다.
해결 방법 보기: Claude Code process exited with code 1 해결: 재설치 전에 분기부터 확인글 업데이트 2026년 5월 7일
command 'claude-vscode.editor.openLast' not found
- 원인: 여러 가능성
- VS Code
- 이슈 #28112
- 이슈 #28145
- 이슈 #28454
- 이슈 #56501
이 글에서 함께 다루는 메시지
- command 'claude-vscode.terminal.open' not found
  - 원인: 여러 가능성
  - VS Code
  - 이슈 #28404
  - 이슈 #57459
- The argument 'filename' must be a file URL
  - 원인: 서비스 쪽
  - VS Code
  - 이슈 #28112
  - 이슈 #56501
- V is not iterable
  - 원인: 내 PC 또는 설정
  - VS Code
  - 이슈 #41383
  - 이슈 #43153
- TypeError: Invalid value for env
  - 원인: 내 PC 또는 설정
  - VS Code
  - 이슈 #78139
- command 'claude-vscode.editor.open' not found
  - 원인: 여러 가능성
  - VS Code
  - 이슈 #28404
재설치나 credential 변경 전에 Claude Code의 실패 지점을 나누고, 같은 지점에서 검증해 status, performance, provider, PATH, 다른 assistant 문제를 분리합니다.
해결 방법 보기: Claude Code가 VS Code에서 안 될 때는 먼저 실패 지점을 나눠야 한다글 업데이트 2026년 5월 2일

파일, 세션, 로컬 상태

Error compacting conversation
- 원인: 여러 가능성
- CLI
- 데스크톱 앱
이 글에서 함께 다루는 메시지
- Conversation too long. Press esc twice to go up a few messages and try again.
  - 원인: 내 PC 또는 설정
  - CLI
  - 데스크톱 앱
  - 이슈 #7530
- Prompt is too long · automatic compaction failed:
  - 원인: 여러 가능성
  - CLI
  - 데스크톱 앱
- Autocompact is thrashing: the context refilled to the limit within 3 turns of the previous compact, 3 times in a row.
  - 원인: 내 PC 또는 설정
  - CLI
  - 데스크톱 앱
  - 2.1.89부터 발생
- Compaction failed · attached media exceeds size limits
  - 원인: 내 PC 또는 설정
  - CLI
  - 데스크톱 앱
- Compaction failed · conversation could not be reduced below the context limit
  - 원인: 내 PC 또는 설정
  - CLI
  - 데스크톱 앱
클로드 코드의 Error compacting conversation 알림은 겉포장이고 원인은 함께 뜬 줄에 있습니다. 업데이트 후 원문에 맞춰 되감기, /compact, /clear를 고릅니다.
해결 방법 보기: Claude Code compact 오류: Error compacting conversation 메시지별 해결글 업데이트 2026년 10월 16일
Error writing file
- 원인: 여러 가능성
- CLI
- 이슈 #29841
- 이슈 #24151
- 이슈 #63838
이 글에서 함께 다루는 메시지
- File has been modified since read, either by the user or by a linter. Read it again before attempting to write it.
  - 원인: 내 PC 또는 설정
  - 데스크톱 앱
  - 이슈 #10498
  - 이슈 #10245
- EPERM: operation not permitted
  - 원인: 내 PC 또는 설정
- InputValidationError: Write failed due to the following issues: The required parameter `file_path` is missing
  - 원인: 여러 가능성
  - 이슈 #895
- Error editing file
  - 원인: 내 PC 또는 설정
  - 이슈 #8750
  - 이슈 #63838
Claude Code의 Error writing file은 요약 표시입니다. Ctrl+O 트랜스크립트 보기의 실제 메시지로 권한, 파일 변경 감지, 출력 잘림, 알려진 버그 중 원인을 가릅니다.
해결 방법 보기: Claude Code Error writing file 오류 해결: Ctrl+O로 실제 메시지부터 확인글 업데이트 2026년 10월 16일

이 목록을 관리하는 방식

이 사이트의 글에서 다루는 메시지만 싣고, 원문은 해당 글에서 글자 그대로 옮깁니다.
버전, HTTP 상태 코드, GitHub 이슈 번호는 연결된 글이 인용한 것입니다. 글에 없는 항목은 비워 둡니다.
원인 표시는 어느 쪽부터 볼지 알려 줍니다. 확인 방법은 글에 있습니다.

목록 최종 확인: 2026년 11월 15일.

Claude Code 오류 메시지 모음: 원문, 원인 위치, 해결 방법

로그인, 계정, 인증

Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh

Failed to authenticate. API Error: 403 Your account can't receive replies from Claude right now

모델을 찾을 수 없거나 사용할 수 없음

There's an issue with the selected model (claude-fable-5.2)

속도 제한과 용량

API Error: Rate limit reached

API Error: Repeated 529 Overloaded errors

서버 오류와 연결 끊김

API Error: 500 Internal server error

API Error: 403 {"error":{"type":"forbidden","message":"Request not allowed"}}

Unable to connect to API

요청이 거부됨

top_p deprecated

앱, IDE, 실행

Git is required for local sessions

Error: Cannot find module './yoga.wasm'

error: claude code process exited with code 1

command 'claude-vscode.editor.openLast' not found

파일, 세션, 로컬 상태

Error compacting conversation

Error writing file

이 목록을 관리하는 방식