![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.
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