사전 도구 사용 후크가 Claude 코드 이미지 충돌 문제를 해결합니다

한 개발자가 Claude Code의 이미지 처리 충돌, 특히 API 오류 400: '이미지를 처리할 수 없습니다.'를 해결하는 PreToolUse 훅을 공유했습니다. 이 훅은 문제가 있는 이미지가 메인 컨텍스트에 들어가기 전에 가로채 세션 실패를 방지합니다.

문제 설명

원본은 Claude Code 세션을 충돌시키는 특정 이미지 유형을 식별합니다: 투명도가 있는 PNG 파일, 큰 스크린샷, 그리고 여러 이미지. 문제가 있는 이미지가 컨텍스트에 들어가면 이후의 모든 메시지가 오류를 발생시킵니다. 사용자는 때때로 두 번 뒤로가기로 복구할 수 있지만, 이는 컨텍스트와 토큰을 잃게 됩니다.

솔루션 구현

솔루션은 다음과 같은 PreToolUse 훅입니다:

• 이미지에 대한 Read 호출을 가로챕니다
• 처리 전에 이미지를 안전하게 변환합니다
• Haiku 서브프로세스를 통해 프록시합니다
• 이미지 데이터가 메인 컨텍스트에 들어가지 않도록 보장합니다

이 접근 방식은 Claude Code가 이미지를 읽으려 시도하기 전에 외부에서 이미지 처리를 처리함으로써 API 오류 400 충돌을 방지합니다.

기술적 세부사항

이 훅은 특히 이미지를 포함하는 Read 도구 사용 호출을 대상으로 합니다. 이미지 변환과 프록싱을 위해 Haiku 서브프로세스를 사용함으로써, 잠재적으로 문제가 있는 이미지 데이터를 메인 Claude Code 세션 컨텍스트에서 격리시킵니다. 이는 나쁜 이미지가 컨텍스트에 들어간 후 발생하는 오류의 연쇄적 발생을 방지합니다.

개발자는 이 솔루션이 충돌로부터 복구하기 위해 두 번 뒤로가기를 할 필요를 없애주며, 이미지를 포함하는 세션 동안 컨텍스트와 토큰을 모두 보존한다고 언급합니다.