Как вставить скриншот в Claude Code
Короткий ответ: на Windows не полагайтесь на Ctrl+V. Используйте собственную комбинацию вставки Claude Code, перетащите файл изображения в терминал или укажите путь к файлу в запросе. На этой странице рассмотрены все три способа, объясняется, почему обычная вставка из буфера обмена постоянно не срабатывает, и как задать размер скриншота, чтобы он не стоил тысячу токенов.
Вы хотите показать Claude Code скриншот — диалог с ошибкой, сломанный макет, кадр дизайна — а набрать это текстом займёт слишком много времени. Проблема в том, что терминал — это не чат: тот же Ctrl+V, который вставляет изображение везде в Windows, здесь часто ничего не делает, особенно в WSL. Изображение не теряется — терминал его просто никогда не получает. Решение — использовать способ, который не зависит от ненадёжного пути «битмап в буфере обмена», и таких способов три.
Это руководство опубликовано Maxisnap. Maxisnap выпускает инструмент для скриншотов на Windows, чей экспорт создан именно для такой передачи данных, поэтому он упоминается здесь, где это уместно — но описанные ниже способы работают с любым скриншотом, из любого инструмента.
Какие три способа передать Claude Code изображение?
Claude Code принимает изображение тремя способами, и на Windows они не одинаково надёжны. В примерном порядке по убыванию надёжности:
| Способ | Как | Надёжность на Windows / WSL |
|---|---|---|
| Путь к файлу в запросе | Введите или вставьте путь к сохранённому изображению, например C:\Users\you\shot.png, в своём сообщении. | Самый надёжный — буфер обмена не задействован |
| Перетащить файл | Перетащите файл изображения из Проводника (или прямо из инструмента захвата) в окно терминала. | Надёжно, если терминал поддерживает перетаскивание |
| Сочетание клавиш для вставки | Используйте выделенную клавишу вставки Claude Code (в последних версиях для изображений применяется Alt+V). | Работает во многих конфигурациях; запасной вариант — путь к файлу |
| Рефлекс, который все пробуют первым. | Часто молча ничего не делает в терминале |
Комбинации клавиш Claude Code меняются от версии к версии — сверяйтесь с актуальной документацией, чтобы узнать точную клавишу вставки. Способ с путём к файлу — тот, что продолжает работать в любом случае.
Почему Ctrl+V ничего не делает в терминале?
Потому что вставка изображения в терминал — это другая, менее поддерживаемая операция, чем вставка текста. Когда вы копируете скриншот, Windows помещает битмап в буфер обмена. Большинство терминалов обрабатывают только вставку текста и молча игнорируют битмап, поэтому ничего не появляется. Внутри WSL разрыв ещё больше: Linux-часть терминала вообще не видит битмап буфера обмена Windows, поэтому даже инструмент, который принял бы вставленное изображение, никогда не получает данные. С изображением всё в порядке — у него просто нет пути из буфера обмена в запрос. Именно поэтому надёжны те способы, которые используют сохранённый файл, а не битмап из буфера обмена.
Даже специальное сочетание клавиш для вставки может работать нестабильно: сообщалось, что вставка изображений в терминал периодически перестаёт работать в некоторых конфигурациях Windows и PowerShell. Когда способ через буфер обмена подводит, сохранённый файл — перетащенный или указанный по пути — никогда от него не зависит, поэтому стоит выработать привычку использовать именно его.
Нужно ли изменять размер скриншота перед отправкой?
Да, если вы делаете это весь день. Захват в полном разрешении не просто тяжело передавать — это ещё и дорого. Модели зрения разбивают изображение на фрагменты и берут токены за каждый фрагмент, поэтому скриншот в 4K может стоить свыше тысячи токенов изображения, а копия, уменьшенная до разумной ширины, обойдётся в несколько сотен и читается так же чётко, потому что модель всё равно внутренне уменьшает крупные изображения. Приведение изображения к правильному размеру до того, как оно попадёт в Claude Code, — самая дешёвая оптимизация во всём процессе.
В Maxisnap экспорт с оптимизацией для ИИ создаёт копию с ограничением по умолчанию до максимальной ширины 1600 px (настраивается в Settings), готовую перетащить в терминал или использовать по пути. Перед экспортом исключите учётные данные и приватные данные клиентов из захвата или обрежьте их. Размытие может визуально скрыть деталь, но не может гарантировать, что конфиденциальный текст останется секретным.
| Что вы вставляете | Типичная стоимость в токенах изображения | В Claude Code |
|---|---|---|
| Необработанный захват 4K / всего монитора | 1 000+ токенов | Дороже и может упереться в ограничение по размеру |
| Копия Maxisnap с оптимизацией под ИИ (ширина 1600 px) | Несколько сотен токенов | Читается чётко, стоит меньше, загружается быстро |
Значения токенов — типичные диапазоны для моделей зрения, а не бенчмарк Maxisnap; точные значения зависят от модели и содержимого изображения.
$ the fastest reliable hand-off
1. Ctrl+Alt+5 -> drag a box around the error 2. crop secrets out, export the AI-optimized copy, and inspect it 3. drag the saved file into the terminal ...or paste its path: read this: C:\Users\you\shot.png # skip Ctrl+V — the terminal usually ignores the bitmap
Вставка скриншотов в Claude Code — вопросы и ответы
Почему Ctrl+V не вставляет мой скриншот в Claude Code?
Потому что терминал обычно не может принять изображение из буфера обмена — он ожидает текст и игнорирует битмап, который Windows помещает туда при копировании скриншота. Внутри WSL битмап буфера обмена Windows вообще не виден Linux-стороне. Используйте собственную клавишу вставки изображений Claude Code, перетащите файл в терминал или укажите путь к сохранённому файлу в запросе.
Сочетание клавиш для вставки перестало работать в Claude Code — что теперь?
Вставка изображений в терминал может периодически давать сбой в Windows и PowerShell, поэтому не полагайтесь на неё как на единственный способ. Сохраните скриншот и укажите путь к файлу в запросе, либо перетащите файл в терминал — ни один из этих способов не затрагивает буфер обмена, поэтому оба продолжают работать, даже когда сочетание клавиш для вставки не срабатывает. Стоит свериться с актуальной документацией Claude Code насчёт последней клавиши вставки, но способ с путём к файлу никогда не ломается.
Какой самый надёжный способ добавить изображение в Windows?
Укажите путь к сохранённому файлу в сообщении. Это не затрагивает буфер обмена, поэтому работает одинаково в Windows Terminal, WSL и через SSH. Перетаскивание файла в терминал — следующий по надёжности способ.
Должен ли скриншот иметь определённый размер?
Обычно меньше — лучше. Захват в полном разрешении может стоить свыше тысячи токенов изображения и с большей вероятностью упрётся в лимит на изображение. Копия, уменьшенная примерно до 1600 px в ширину, стоит значительно меньше и читается так же чётко, потому что модель всё равно уменьшает крупные изображения.
Как скрыть API-ключ перед отправкой скриншота?
Держите ключ вне выбранной области захвата или используйте обрезку, чтобы удалить его перед экспортом. Одно только размытие может оставить достаточно деталей для восстановления текста. Если обрезка не подходит, используйте полностью непрозрачный инструмент скрытия в другом редакторе и проверяйте объединённое изображение перед передачей его в Claude Code.
Можно ли сделать то же самое с Codex CLI или Gemini CLI?
Да. Все три принимают путь к файлу или перетащенный файл — это универсальный способ для Windows. Наша страница скриншоты для ИИ-программирования содержит подробности по каждому инструменту, а запись экрана для программирования с ИИ рассказывает об отправке короткого клипа, когда одного кадра недостаточно.
Сделайте снимок, проверьте его и поделитесь оптимизированной для ИИ копией.
Скриншот правильного размера, оптимизированный под ИИ, с сохранённым файлом, готовым для перетаскивания или указания по пути — бесплатно на Windows.
Похожее: скриншоты для ИИ-программирования · запись экрана для программирования с ИИ · размытие скриншота · инструменты для скриншотов для разработчиков