![Terminal de Claude Code con una captura pegada como chip [Image #1], las tres teclas para pegar según el terminal (Ctrl+V, Cmd+V en iTerm2, Alt+V en Windows y WSL) y el aviso de que el pegado a veces falla sin ningún error](https://wmedia.es/storage/writing/4mJm2D5SjvSQ0MUz.svg)
TL;DR Copia cualquier captura y pégala en el prompt de Claude Code con
Ctrl+V. En iTerm2 (macOS) también funcionaCmd+V; en Windows y WSL,Alt+V. Aparece un chip[Image #1]en el cursor y lo nombras dentro de la frase: "arregla el margen de[Image #1]". Si pegas y no aparece nada, no es cosa tuya: el pegado de imágenes falla de forma intermitente y sin avisar. Cuando dude, arrastra el archivo al terminal o pasa la ruta.
Para darle una imagen a Claude Code, la mayoría hace el mismo baile: captura de pantalla, guardarla en el escritorio, arrastrar el archivo o escribir la ruta a mano. Sobra casi todo. Copias la captura al portapapeles y la pegas directa en el prompt con Ctrl+V. Claude Code inserta un chip [Image #1] justo donde tienes el cursor y trata esa imagen igual que cualquier archivo que le pasaras.
La tecla correcta según tu terminal
Aquí es donde mucha gente se rinde antes de tiempo: prueba Ctrl+V, no ocurre nada, y da por hecho que la feature no existe. El problema casi siempre es la tecla, y depende del terminal.
| Sistema / terminal | Tecla para pegar la imagen |
|---|---|
| Por defecto (la mayoría) | Ctrl+V |
| macOS con iTerm2 | Cmd+V (también funciona Ctrl+V) |
| Windows y WSL | Alt+V |
En WSL están enlazadas las dos, Ctrl+V y Alt+V. Si tu terminal intercepta Ctrl+V para su propio pegado, usa Alt+V y la imagen llega igual.
En iTerm2, aunque Cmd+V funciona, Ctrl+V suele ser más fiable. Si una captura no entra con Cmd+V, prueba Ctrl+V antes de rendirte.
El chip [Image #N] y cómo lo nombras
Al pegar no ves la imagen dentro del terminal. Ves un chip de texto, [Image #1], en la posición del cursor. Esa es tu referencia: escribes alrededor y lo nombras dentro de la instrucción.
Este es el diseño final: [Image #1]. Ajusta el espaciado del header
en @src/components/Header.tsx para que coincida.
Puedes pegar varias capturas en la misma conversación ([Image #1], [Image #2]...) y referirte a cada una por su número. Cuando Claude cita una de vuelta en su respuesta, haz Cmd+Click (Mac) o Ctrl+Click (Windows/Linux) sobre el enlace [Image #1] para abrirla en tu visor por defecto.
Cada captura que pegas se queda en la conversación y viaja en cada petición. Con cientos de ellas en una sesión larga puedes acabar en "Request rejected as unprocessable by the model".
Ese contador lo comparten los pegados de texto, así que un texto largo también se colapsa en un chip numerado y se despliega volviendo a pegarlo.
Cuando pegas y no aparece nada
Esta es la parte que nadie cuenta y que te ahorra media hora de frustración: el pegado de imágenes es intermitente. A veces pegas, no aparece el chip, el prompt sigue vacío, y no hay ningún error. La imagen se ha perdido entre el portapapeles y la CLI, y tú sigues escribiendo sin saberlo.
Le pasa sobre todo a Cmd+V en iTerm2 (hay varios bugs abiertos en el repo) y, en algunos setups, deja de funcionar a partir del segundo mensaje. Qué hacer cuando falla:
- Haz clic en el campo del prompt antes de pegar. Sube bastante la tasa de acierto.
- Si aun así no entra, no insistas: arrastra el archivo de imagen sobre la ventana del terminal. Es el método más fiable.
- O pasa la ruta directamente:
Analiza esta imagen: /ruta/a/tu/captura.png. Funciona en cualquier plataforma, siempre.
Pegar una captura es solo una de las cinco formas de darle contexto a Claude Code. Es la más directa para lo visual, y ahora ya sabes por qué a veces no entra.
Referencia
| Método | Cómo | Fiabilidad |
|---|---|---|
Pegar (Ctrl+V / Cmd+V iTerm2 / Alt+V WSL) |
Copias la captura y pegas en el prompt | Rápido, pero intermitente |
| Arrastrar y soltar | Sueltas el archivo sobre la ventana del terminal | Alta |
| Ruta de archivo | "Analiza esta imagen: /ruta/captura.png" | Total, en todas las plataformas |
Documentación oficial: Work with images