Claude Code "tool call could not be parsed" / 손상된 도구 호출의 원인과 해결 방법 (call / invoke / parameter 가 텍스트로 표시됨)
지금 장애가 있나요?
Claude Code 공식 상태는 정상입니다. 이 오류가 계속되면 구현(코드) 또는 사용자 환경 문제일 가능성이 높습니다.
업데이트: 2026. 6. 6. AM 3:29 UTC
Claude Code의 가동 상태 보기 →오류의 의미
모델이 도구 호출을 잘못된 형식으로 생성해, 시스템이 "tool call could not be parsed(파싱 불가)"로 거부하는 현상입니다. 올바르게 감싸져야 할 호출이 외부 래퍼 없는 invoke로 출력되어 실행되지 않고, "call", "<invoke name=…>", "<parameter>"가 그대로 텍스트로 새어 나와 표시됩니다. 긴 세션에서 손상된 호출이 한 번 대화 기록에 들어가면 이후 모든 도구 호출이 같은 손상 형식을 계속 복제합니다(맥락 내 few-shot 자기 오염). 이는 당신 코드의 버그가 아니라 Claude Code(모델/시스템) 측의 알려진 문제입니다.
자주 있는 원인
- •긴 세션에서 도구 호출을 연달아 대량으로 연쇄 실행
- •손상된 호출이 기록에 들어가면 모델이 자기회귀적으로 재생산(few-shot poisoning)
- •같은 세션에서 재시도하면 손상된 예시가 더 굳어져 악화
- •XML/마크업 밀도가 높은 거대 파일이나 긴 skill 로드로 도구 형식 제어가 약해짐
- •큰 컨텍스트(예: 1M) × 높은 강도의 장시간 작업
해결 방법
- 1.발생하면 /clear(또는 새 세션)로 오염된 기록을 버리기 — 확인된 유일한 복구 방법
- 2.같은 세션에서 재시도하지 않기(손상 형식을 강화함)
- 3.대화가 길어지기 전에 /compact로 자주 압축
- 4.편집을 너무 몰아서 하지 말고 도구 호출 사이에 짧은 설명/확인을 끼우기
- 5.XML/heredoc 밀도가 높은 거대 파일이나 skill을 한 번에 로드하지 않기
- 6.Claude Code를 최신 버전으로 업데이트(수정은 진행 중)
- 7.이 페이지 상단에서 Anthropic API 장애가 아님을 확인(본 건은 모델/시스템 측으로 API 장애와 별개)
기다리면 되는 경우 / 기다려도 안 되는 경우
이는 모델/시스템 측의 알려진 문제(GitHub에 보고, 영구 수정은 진행 중)로 같은 세션에서 기다려도 해결되지 않습니다. /clear로 새 세션으로 전환하는 것이 확실한 해결책입니다. 재발을 막으려면 세션을 짧게 유지하고 자주 /compact 하며 손상된 호출을 재시도하지 마세요.
Claude Code을(를) 쓸 수 없을 때의 대체
관련 오류
자주 묻는 질문
Tool call could not be parsed은(는) 무엇인가요?
모델이 도구 호출을 잘못된 형식으로 생성해, 시스템이 "tool call could not be parsed(파싱 불가)"로 거부하는 현상입니다. 올바르게 감싸져야 할 호출이 외부 래퍼 없는 invoke로 출력되어 실행되지 않고, "call", "<invoke name=…>", "<parameter>"가 그대로 텍스트로 새어 나와 표시됩니다. 긴 세션에서 손상된 호출이 한 번 대화 기록에 들어가면 이후 모든 도구 호출이 같은 손상 형식을 계속 복제합니다(맥락 내 few-shot 자기 오염). 이는 당신 코드의 버그가 아니라 Claude Code(모델/시스템) 측의 알려진 문제입니다.
Tool call could not be parsed은(는) 어떻게 해결하나요?
발생하면 /clear(또는 새 세션)로 오염된 기록을 버리기 — 확인된 유일한 복구 방법 / 같은 세션에서 재시도하지 않기(손상 형식을 강화함) / 대화가 길어지기 전에 /compact로 자주 압축 / 편집을 너무 몰아서 하지 말고 도구 호출 사이에 짧은 설명/확인을 끼우기 / XML/heredoc 밀도가 높은 거대 파일이나 skill을 한 번에 로드하지 않기 / Claude Code를 최신 버전으로 업데이트(수정은 진행 중) / 이 페이지 상단에서 Anthropic API 장애가 아님을 확인(본 건은 모델/시스템 측으로 API 장애와 별개)