Cómo pegar una captura de pantalla en Claude Code
La respuesta corta: en Windows, no dependas de Ctrl+VUsa el atajo de pegado propio de Claude Code, arrastra el archivo de imagen a la terminal, o referencia el archivo por ruta en tu prompt. Esta página cubre los tres, por qué el pegado ordinario del portapapeles sigue desapareciendo, y cómo cambiar la captura de pantalla para que no cueste mil tokens.
Quieres mostrar a Claude Code una captura de pantalla (un diálogo de error, un diseño roto, un marco de diseño) y escribirlo tomaría para siempre. El problema es que la terminal no es una caja de chat: la misma Ctrl+V que pega una imagen en todo Windows frecuentemente hace nada aquí, especialmente dentro de WSL. La imagen no se pierde; la terminal simplemente nunca la recibió. La corrección es usar una ruta que no dependa de la ruta frágil de mapa de bits en portapapeles, y hay tres confiables.
Esta es una guía publicada por Maxisnap. Maxisnap hace una herramienta de captura de pantalla de Windows cuya exportación está construida exactamente para esta entrega, así aparece donde es relevante (pero las rutas abajo funcionan con cualquier captura de pantalla, de cualquier herramienta.
¿Cuáles son las tres formas de dar a Claude Code una imagen?
Claude Code acepta una imagen de tres formas, y en Windows no son igualmente confiables. En orden aproximado de confiabilidad:
| Ruta | Cómo | Confiabilidad en Windows / WSL |
|---|---|---|
| Ruta de archivo en el prompt | Escribe o pega la ruta de la imagen guardada, por ejemplo, C:\Users\you\shot.pngen tu mensaje. | Más confiable (sin portapapeles involucrado) |
| Arrastra el archivo | Arrastra el archivo de imagen desde Explorer (o directamente de una herramienta de captura) a la ventana de terminal. | Confiable cuando la terminal soporta caída |
| Atajo de pegado | Usa la tecla de pegado dedicada de Claude Code (las versiones recientes usan Alt+V para imágenes). | Funciona en muchas configuraciones; la alternativa es una ruta de archivo |
| El reflejo que todos prueban primero. | A menudo hace nada silenciosamente en la terminal |
Los atajos de teclado de Claude Code cambian entre versiones (verifica su documentación actual para la tecla de pegado exacta). La ruta de ruta de archivo es la que sigue funcionando independientemente.
¿Por qué Ctrl+V hace nada en la terminal?
Porque pegar una imagen en una terminal es una operación diferente y menos compatible que pegar texto. Cuando copias una captura de pantalla, Windows pone un mapa de bits en el portapapeles. La mayoría de terminales solo manejan pegado de texto e ignoran silenciosamente un mapa de bits, así que nada aparece. Dentro de WSL la brecha es aún mayor: el lado Linux de la terminal no ve el mapa de bits del portapapeles de Windows en absoluto, así que incluso una herramienta que aceptaría una imagen pegada nunca recibe los datos. La imagen está bien, simplemente no tiene un camino desde el portapapeles al prompt. Por eso las rutas que usan un archivo guardado en lugar de un mapa de bits del portapapeles son las que funcionan.
Incluso el atajo de pegado dedicado puede ser inestable aquí: el pegado de imagen en la terminal ha sido reportado para pausarse intermitentemente en algunas configuraciones de Windows y PowerShell. Cuando la ruta del portapapeles falla, un archivo guardado (arrastrado o referenciado por ruta) nunca depende de ella, que es por qué es el hábito que vale la pena construir.
¿Debo cambiar el tamaño de la captura de pantalla antes de enviarla?
Sí, si estás haciendo esto todo el día. Una captura de resolución completa no es solo pesada para mover, es cara. Los modelos de visión mosaican una imagen en parches y cobran tokens por parche, así que una captura de pantalla 4K puede costar bien más de mil tokens de imagen, mientras que una copia redimensionada a un ancho sensato cuesta algunos cientos y se lee igual de claramente, porque el modelo reduce las imágenes grandes internamente de todos modos. Redimensionar la imagen antes de que llegue a Claude Code es la optimización más barata en el bucle completo.
Aquí es donde una herramienta de captura diseñada específicamente justifica su existencia. Maxisnap Exportación optimizada para IA produce una copia limitada a un ancho máximo predeterminado de 1600 px (configurable en Configuración) y te entrega el archivo guardado (listo para arrastrar a la terminal o referir por ruta). Y si la toma muestra una clave de API, un token, o datos del cliente, la herramienta de desenfoque lo redacta destructivamente antes de que el archivo sea jamás creado, así el secreto no se puede recuperar de lo que envías.
| Lo que pegas | Coste típico en tokens de imagen | En Claude Code |
|---|---|---|
| Captura 4K sin procesar / de todo el monitor | 1000+ tokens | Más caro y puede alcanzar un límite de tamaño |
| Copia optimizada para IA de Maxisnap (1600 px de ancho) | Unos pocos cientos de tokens | Se lee con claridad, cuesta menos, se sube rápido |
Las cifras de tokens son rangos típicos de los modelos de visión, no una medición propia de Maxisnap; los recuentos exactos varían según el modelo y el contenido de la imagen.
$ la entrega más rápida y confiable
1. Ctrl+Alt+5 -> drag a box around the error 2. blur any secrets, then export the AI-optimized copy 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
Pegando capturas de pantalla en Claude Code (preguntas frecuentes)
¿Por qué Ctrl+V no pegará mi captura de pantalla en Claude Code?
Porque la terminal generalmente no puede aceptar una imagen del portapapeles (está esperando texto, e ignora el mapa de bits que Windows pone allí cuando copias una captura de pantalla). Dentro de WSL el mapa de bits del portapapeles de Windows no es visible para el lado Linux en absoluto. Usa la tecla de pegado de imagen propia de Claude Code, arrastra el archivo a la terminal, o referencia la ruta del archivo guardado en tu prompt en su lugar.
El atajo de pegado dejó de funcionar en Claude Code (¿ahora qué?
El pegado de imagen en la terminal puede fallar intermitentemente en Windows y PowerShell, así que no dependas de él como tu única ruta. Guarda la captura de pantalla y referencia su ruta de archivo en tu prompt, o arrastra el archivo a la terminal (ninguno toca el portapapeles, así que ambos siguen funcionando cuando el atajo de pegado no funciona). Vale la pena verificar la documentación actual de Claude Code para la tecla de pegado más reciente, pero la ruta de ruta de archivo es la que nunca se quiebra.
¿Cuál es la forma más confiable de añadir una imagen en Windows?
Referencia el archivo guardado por su ruta en tu mensaje. No toca el portapapeles, así que funciona igual en Windows Terminal, WSL y sobre SSH. Arrastrar el archivo a la terminal es la siguiente ruta más confiable.
¿La captura de pantalla necesita ser un tamaño determinado?
Más pequeño es generalmente mejor. Una captura de resolución completa puede costar más de mil tokens de imagen y es más probable que alcance un límite por imagen. Una copia redimensionada a alrededor de 1600 px de ancho cuesta mucho menos y se lee igual de claramente, porque el modelo reduce las imágenes grandes de todos modos.
¿Cómo oculto una clave de API antes de enviar una captura de pantalla?
Redáctalo antes de que el archivo sea creado. En Maxisnap, arrastra la herramienta de desenfoque sobre el secreto en el editor, luego exporta (el desenfoque se aplica destructivamente, así la clave no se puede recuperar de la imagen que entregas a Claude Code.
¿Puedo hacer lo mismo con Codex CLI o Gemini CLI?
Sí. Los tres toman una ruta de archivo o un archivo arrastrado, que es la ruta portátil en Windows. Nuestro capturas para programación con IA la página tiene el detalle por herramienta, y grabación de pantalla para codificación de IA cubre enviar un clip corto cuando una imagen fija no es suficiente.
Captura, redacta y entrégalo en tres pulsaciones de tecla.
Una captura de pantalla de tamaño correcto y optimizada para IA con un archivo guardado listo para arrastrar o referir (gratuito en Windows.
Relacionado: capturas para programación con IA · grabación de pantalla para codificación de IA · difuminar una captura de pantalla · herramientas de captura para desarrolladores