Correção do Hook PreToolUse Resolve Problema de Travamento de Imagem de Código Claude

Um desenvolvedor compartilhou um hook PreToolUse que resolve as falhas de processamento de imagens do Claude Code, especificamente o API Error 400: "Não foi possível processar a imagem." O hook intercepta imagens problemáticas antes que elas entrem no contexto principal, evitando falhas na sessão.

Descrição do Problema

A fonte identifica tipos específicos de imagens que causam falhas nas sessões do Claude Code: arquivos PNG com transparência, capturas de tela grandes e múltiplas imagens. Uma vez que uma imagem problemática entra no contexto, todas as mensagens subsequentes geram erros. Os usuários às vezes conseguem recuperar-se usando duplo escape para voltar, mas isso resulta em perda de contexto e tokens.

Implementação da Solução

A solução é um hook PreToolUse que:

• Intercepta chamadas de Leitura em imagens
• Converte imagens com segurança antes do processamento
• As redireciona através de um subprocesso Haiku
• Garante que nenhum dado de imagem entre no contexto principal

Essa abordagem evita as falhas de API Error 400 ao lidar com o processamento de imagens externamente antes que o Claude Code tente lê-las.

Detalhes Técnicos

O hook especificamente tem como alvo as chamadas de uso da ferramenta Leitura que envolvem imagens. Ao usar um subprocesso Haiku para conversão e redirecionamento de imagens, ele isola dados de imagem potencialmente problemáticos do contexto principal da sessão do Claude Code. Isso impede a cascata de erros que ocorre quando uma imagem ruim entra no contexto.

O desenvolvedor observa que essa solução elimina a necessidade de usar duplo escape para voltar e recuperar-se de falhas, preservando tanto o contexto quanto os tokens durante sessões que envolvem imagens.