Исправление проблемы сбоя изображения кода Клода с помощью хука PreToolUse

Разработчик поделился PreToolUse-хуком, который решает проблему сбоев обработки изображений в Claude Code, в частности API Error 400: "Не удалось обработать изображение." Хук перехватывает проблемные изображения до их попадания в основной контекст, предотвращая сбои сессий.

Описание проблемы

Источник определяет конкретные типы изображений, вызывающие сбои сессий Claude Code: PNG-файлы с прозрачностью, большие скриншоты и множественные изображения. Как только проблемное изображение попадает в контекст, каждое последующее сообщение вызывает ошибку. Пользователи иногда могут восстановиться двойным выходом назад, но это приводит к потере контекста и токенов.

Реализация решения

Решение представляет собой PreToolUse-хук, который:

• Перехватывает вызовы Read для изображений
• Безопасно конвертирует изображения перед обработкой
• Проксирует их через Haiku-подпроцесс
• Гарантирует, что данные изображений не попадают в основной контекст

Такой подход предотвращает сбои API Error 400, обрабатывая изображения внешне до того, как Claude Code попытается их прочитать.

Технические детали

Хук специально нацелен на вызовы инструмента Read, связанные с изображениями. Используя Haiku-подпроцесс для конвертации и проксирования изображений, он изолирует потенциально проблемные данные изображений от основного контекста сессии Claude Code. Это предотвращает каскад ошибок, возникающий после попадания плохого изображения в контекст.

Разработчик отмечает, что это решение устраняет необходимость двойного выхода назад для восстановления после сбоев, сохраняя как контекст, так и токены во время сессий с изображениями.