Imágenes en Claude Code: cómo pegarlas, subirlas y usarlas en cualquier sistema operativo

Claude Code puede leer imágenes. Arrastra una captura de pantalla, pega un mockup de interfaz o pásale un gráfico, y Claude lo analiza igual que analiza el código. Pegar era el punto débil, y Windows era donde fallaba. Eso ha cambiado: Alt+V ya pega imágenes en Windows y WSL, Ctrl+V lo hace en macOS y Linux, e iTerm2 también acepta Cmd+V.

Esta guía cubre las tres formas oficiales de darle una imagen a Claude Code, el atajo correcto para cada plataforma, las capturas de pantalla (incluidas las que Claude hace por su cuenta), SSH, la extensión de VS Code y la app de escritorio, los formatos y límites, y por qué Claude Code no puede generar imágenes. Cada dato está contrastado con la documentación de Anthropic y con el registro de cambios de Claude Code en la versión 2.1.292 (octubre de 2026).

Conclusiones clave

• Tres métodos oficiales para añadir imágenes a Claude Code: arrastrar y soltar, pegar desde el portapapeles o escribir una ruta de archivo en tu prompt.
• El atajo para pegar depende de la plataforma: Ctrl+V en macOS y Linux, Cmd+V también funciona en iTerm2, y Alt+V en Windows y WSL.
• Pegar en Windows nativo ya funciona. La solicitud de función correspondiente (issue #26679) se cerró como completada el 17 de agosto de 2026. Si Alt+V dice que no encuentra ninguna imagen, ejecuta claude update.
• Por SSH, pegar no puede funcionar, porque el portapapeles se queda en tu propio ordenador. Copia el archivo al servidor con scp y dale a Claude la ruta.
• Claude lee JPEG, PNG, GIF y WebP. Claude Code convierte algunos otros formatos por ti y reduce las imágenes pegadas a 2000 píxeles en el lado largo.
• Claude Code no puede generar imágenes. Puede escribir SVG o HTML, o llamar a un modelo de imágenes mediante un script o un servidor MCP.

¿Puede Claude Code ver imágenes?

Sí. Claude Code funciona con los mismos modelos que el resto de la familia Claude, incluidos Claude Opus 5.5 y Sonnet 5.5, y todos leen imágenes. Capturas, diagramas, gráficos, mockups y fotos funcionan. Claude Code añade la capa de entrada que lleva el archivo al modelo y guarda en disco cada imagen que pegas, así que Claude también puede abrirla como archivo y copiarla a tu proyecto.

La visión es una de las razones por las que Claude Code es más útil que los asistentes antiguos que solo entendían código. Enséñale una exportación de Figma y escribe el HTML y el CSS correspondientes. Enséñale una captura de un stack trace y rastrea el error hasta el archivo. Enséñale un diagrama del esquema de la base de datos y redacta la migración.

Combinadas con las mejores skills de Claude Code, las imágenes convierten la CLI en un ciclo rápido de diseño a código que antes exigía ir y venir con una ventana de chat. El mismo ciclo funciona en el móvil si usas Claude Code en tu teléfono con la función Remote Control de Anthropic.

¿Puede Claude Code generar imágenes?

No. La documentación de visión de Anthropic dice que Claude «es solo un modelo de comprensión de imágenes» y que «no puede generar, producir, editar, manipular ni crear imágenes». Claude Code usa esos mismos modelos, así que la respuesta es la misma en la terminal que en la app de chat. Nuestra guía sobre si Claude puede generar imágenes cubre el lado del chat.

Lo que Claude Code sí puede hacer es escribir código que produce una imagen: un icono SVG, un mockup en HTML y CSS, un gráfico con una librería de visualización o un script de canvas. Para diagramas, iconos y borradores de interfaz suele ser mejor que una imagen, porque el resultado es texto editable que vive en tu repositorio.

Para fotos e ilustraciones, Claude Code tiene que llamar a un modelo de imágenes que gestiona otra empresa. Hay dos formas de montarlo:

• Un script. Pídele a Claude Code que escriba y ejecute un pequeño script que llame a una API de imágenes de OpenAI o Google con tu propia clave de API y que guarde el resultado en tu proyecto.
• Un servidor MCP. Conecta un servidor MCP que ofrezca una herramienta de imágenes. Desde la v2.1.283, las imágenes que devuelven las herramientas MCP también se guardan en un archivo, así que Claude puede moverlas adonde tu código las espera.

En ambos casos, el proveedor de imágenes te cobra aparte de tu plan de Claude.

Cómo añadir imágenes a Claude Code: 3 métodos

La documentación oficial de Claude Code indica tres formas de añadir una imagen. Las tres funcionan en todas las plataformas, siempre que uses el atajo correcto para la tuya.

1. Arrastra y suelta el archivo de imagen desde Finder, el Explorador de archivos o el escritorio en la ventana de Claude Code.
2. Pega desde el portapapeles con Ctrl+V, o con Alt+V en Windows y WSL.
3. Dale a Claude una ruta de archivo en tu prompt, por ejemplo: Analiza esta imagen: /Users/me/Desktop/error.png.

Elige según lo que tengas a mano. Pegar es lo más rápido para una captura que acabas de hacer. Arrastrar es lo más rápido cuando el archivo ya existe. Una ruta de archivo es lo indicado para scripts, sesiones SSH y todo lo automatizado, porque nunca toca el portapapeles.

Método 1: arrastrar y soltar

Abre la carpeta donde está tu imagen, arrastra el archivo a la ventana de Claude Code y suéltalo. Claude Code adjunta la imagen, anota de dónde viene y espera tu prompt. Puedes soltar varias imágenes a la vez.

En WSL, arrastrar imágenes desde el Explorador de archivos de Windows funciona desde la v2.1.157 (29 de mayo de 2026). En Linux, arrastrar y soltar depende de tu emulador de terminal, así que ten la ruta de archivo como plan B. En la extensión de VS Code, mantén pulsada Shift mientras arrastras un archivo al cuadro del prompt.

Método 2: pegar desde el portapapeles

Copia una imagen, haz clic en el prompt de Claude Code y pulsa el atajo de pegar. Claude Code inserta un chip [Image #1] en la posición del cursor. El chip queda donde lo pongas en la frase, así que puedes escribir prompts como «haz que [Image #1] se parezca a [Image #2]». Escribe el resto de tu pregunta y pulsa Enter.

El atajo es lo que confunde a la gente, porque cambia según la plataforma:

El error más común en un Mac es pulsar Cmd+V en Terminal o Warp. Esa tecla pertenece a la app de terminal, que pega texto, así que la imagen nunca llega a Claude Code. iTerm2 es la excepción, porque Claude Code convierte allí su Cmd+V en Ctrl+V.

Si tu terminal usa el atajo para otra cosa, cámbialo. Ejecuta /keybindings para abrir ~/.claude/keybindings.json y asigna otra tecla a la acción chat:imagePaste. Claude Code aplica el cambio sin reiniciar.

Método 3: ruta de archivo en tu prompt

El método más aburrido, y el único que nunca depende de un portapapeles ni de una terminal. Escribe la ruta de tu imagen en el prompt como parte del mensaje:

Analiza esta captura y dime qué falla: /Users/lenka/Desktop/login-bug.png

O con una ruta relativa desde la raíz del proyecto:

Compara este diseño con nuestro /src/components/Header.tsx actual: ./mockups/header-v2.png

Claude Code lee el archivo del disco y lo adjunta. Funcionan tanto las rutas absolutas como las relativas. En WSL, una ruta de Windows como C:\Users\me\file.png pasa a ser /mnt/c/Users/me/file.png.

Lo más ordenado es guardar las capturas directamente en el proyecto, por ejemplo en ./screenshots/bug.png, y luego pedir: Mira ./screenshots/bug.png y dime qué está roto. La imagen vive junto al código que Claude está editando, y puedes excluir la carpeta con .gitignore.

También es la única forma de enviar imágenes desde un script, por ejemplo uno que pasa prompts a la CLI con claude -p.

Método × plataforma de un vistazo

Si quieres un método que funcione en cualquier configuración, usa rutas de archivo. Pegar es lo más rápido, siempre que pulses la tecla correcta para tu plataforma.

Cómo añadir imágenes a Claude Code en cada sistema operativo

Cada sistema operativo tiene sus propias teclas de captura y sus propias manías. Esto es lo que funciona en cada uno.

macOS

Pulsa Cmd+Ctrl+Shift+4 y selecciona una zona para copiar una captura directamente al portapapeles, o Cmd+Ctrl+Shift+3 para la pantalla completa. Luego pulsa Ctrl+V en Claude Code (o Cmd+V en iTerm2). Cmd+Shift+4 sin Ctrl guarda la captura en el escritorio, lo cual está bien si prefieres arrastrar el archivo.

macOS pone las capturas en el portapapeles en formato TIFF, que Claude no lee. Claude Code lo convierte por ti desde la v2.1.0, así que nunca tienes que guardar y volver a exportar primero.

Arrastrar y soltar desde Finder y las rutas de archivo en el prompt también funcionan, claro.

Windows nativo (PowerShell, Windows Terminal, Símbolo del sistema)

Pulsa Win+Shift+S para copiar una captura al portapapeles y luego Alt+V dentro de Claude Code. En Windows, Ctrl+V es el pegado de texto de la terminal, así que no adjunta ninguna imagen.

Alt+V para Windows llegó ya con la v1.0.93, pero no siempre encontraba una captura recién copiada en el portapapeles hasta una corrección en la v2.1.141. Ese hueco explica por qué tantas guías antiguas, incluida una versión anterior de esta, decían que pegar en Windows no funcionaba. La solicitud de función de GitHub #26679 se cerró como completada el 17 de agosto de 2026. Si Alt+V sigue diciendo que no encuentra ninguna imagen, actualiza con claude update.

También puedes saltarte el portapapeles por completo:

• Arrastra y suelta el archivo de la captura desde el Explorador de archivos en la ventana de Claude Code.
• Guárdala y pasa la ruta. Guarda la captura desde la Herramienta Recortes y haz referencia a ella en tu prompt: Analiza esto: C:\Users\you\Pictures\shot.png.

Windows con WSL

WSL era donde más fallaba pegar imágenes. La causa, documentada en el issue #25935 de GitHub, era que Windows copia las imágenes al portapapeles como BMP y las versiones antiguas de Claude Code no aceptaban BMP. Se corrigió en la v2.1.47 (febrero de 2026). Versiones posteriores añadieron una alternativa con PowerShell para portapapeles que xclip y wl-paste no pueden leer (v2.1.136) y, después, el atajo Alt+V, el pegado de capturas en Windows 11 y arrastrar y soltar desde el Explorador de archivos (v2.1.157, 29 de mayo de 2026).

Con una versión actual, copia tu captura con Win+Shift+S y pulsa Alt+V. Ctrl+V también está asignado, pero muchas terminales se quedan con Ctrl+V, así que la tecla que debes recordar es Alt+V. Ejecuta antes claude update si tienes una versión antigua.

Si pegar sigue fallando en tu configuración, tienes dos alternativas fiables:

• Usa una ruta de archivo. Guarda la captura en C:\Users\me\Pictures\shot.png y haz referencia a ella como /mnt/c/Users/me/Pictures/shot.png.
• Guarda el portapapeles como PNG con PowerShell y pasa ese archivo a Claude Code: powershell.exe -Command "(Get-Clipboard -Format Image).Save('shot.png')".

Si usas Claude Code en la extensión de VS Code bajo WSL, pegar una captura en el cuadro de chat adjunta la imagen desde la v2.1.267. Antes podía insertar los bytes de la imagen en bruto. Otro límite de WSL: la integración con Chrome que permite a Claude hacer sus propias capturas del navegador (la verás más abajo) no funciona en WSL. ¿Te interesan los editores de código con IA? Nuestro análisis de precios de Cursor cubre todos los planes.

Linux

Claude Code lee el portapapeles de Linux mediante xclip en X11 o wl-paste en Wayland. Si Ctrl+V dice que no hay ninguna imagen en el portapapeles, instala la que use tu sesión (xclip, o el paquete wl-clipboard) y vuelve a intentarlo.

Tu herramienta de capturas también tiene que copiar la imagen al portapapeles, no solo guardarla. GNOME Screenshot tiene esa opción, Flameshot tiene un botón «copiar al portapapeles» y Spectacle de KDE también. En una terminal mínima o en un servidor sin portapapeles, usa rutas de archivo.

Capturas de pantalla: pégalas o deja que Claude haga las suyas

La mayoría de las imágenes que la gente le da a Claude Code son capturas. La vía más rápida en cada plataforma:

• macOS: Cmd+Ctrl+Shift+4 y luego Ctrl+V (o Cmd+V en iTerm2).
• Windows: Win+Shift+S y luego Alt+V.
• WSL: Win+Shift+S y luego Alt+V.
• Linux: la opción de copiar de tu herramienta de capturas y luego Ctrl+V.

En el trabajo web, muchas veces ni siquiera tienes que hacer la captura. Con la integración con Chrome, Claude Code controla Chrome o Edge a través de la extensión Claude in Chrome. Abre tu app, lee los errores de la consola y hace sus propias capturas para comprobar que una interfaz coincide con el mockup. Actívala con claude --chrome. Necesita la extensión, un plan directo de Anthropic (Pro, Max, Team o Enterprise) y haber iniciado sesión con /login, y no funciona en WSL. Pídele «haz una captura de la página de pago y guárdala en el disco» y escribirá el archivo y te dirá la ruta (esa opción funciona desde la v2.1.211).

La app de escritorio de Claude Code hace lo mismo en su panel de navegador. Claude arranca tu servidor de desarrollo, abre la app allí, hace capturas, inspecciona la página y corrige lo que encuentra. Los servidores MCP de automatización del navegador, como el de Playwright, son una tercera opción si quieres capturas dentro de tu propio entorno de pruebas.

Claude Code por SSH y en sesiones remotas

El portapapeles vive en el ordenador que tienes delante. Cuando Claude Code se ejecuta en otra máquina por SSH, no puede leer ese portapapeles, así que pegar una imagen no funcionará. Claude Code te lo indica y sugiere scp, que es la solución correcta. Copia el archivo al servidor y dale a Claude la ruta:

scp ~/Desktop/shot.png you@server:~/project/screenshots/

Después pide Mira ./screenshots/shot.png desde la carpeta del proyecto en el servidor. Si controlas Claude Code desde el móvil con Remote Control, las imágenes que subes desde la app móvil llegan con una ruta de archivo guardada (desde la v2.1.239), así que Claude puede copiarlas a los archivos que crea.

Imágenes en la extensión de VS Code y en la app de escritorio

No necesitas ninguna terminal. En la extensión de VS Code, pega una imagen del portapapeles en el cuadro del prompt o arrastra un archivo manteniendo pulsada Shift. Desde la v2.1.275 puedes enviar una imagen sin escribir texto.

En la app de escritorio de Claude Code, usa el botón + junto al cuadro del prompt o arrastra archivos al prompt. Acepta imágenes, PDF y otros archivos, lo que la convierte en el sitio más fácil para compartir la captura de un error o un mockup de diseño. Desde la v2.1.275, las imágenes que pegas o adjuntas en la app de escritorio y en VS Code se guardan donde Claude puede abrirlas sin pedir permiso.

Formatos de imagen compatibles y límites

Claude lee cuatro formatos de imagen. Enviar el adecuado te ahorra el ciclo en el que Claude Code parece ignorar tu imagen porque, de entrada, no podía usarla.

Los demás formatos ya no son un callejón sin salida. Claude Code convierte el TIFF que las capturas de macOS dejan en el portapapeles y el BMP que Windows pasa a WSL, y desde la v2.1.285 convierte archivos BMP, HEIC, HEIF, AVIF y TIFF cuando puede. SVG es distinto: es texto, así que Claude lee un archivo SVG como código y no como imagen. Si una imagen sigue sin adjuntarse, conviértela a PNG.

Los límites que importan:

• 2000 píxeles: Claude Code reduce las imágenes pegadas para que el lado largo mida como mucho 2000 píxeles, así que una captura enorme no romperá tu sesión.
• 8000 x 8000 píxeles es lo máximo que acepta la API de Claude por imagen.
• 10 MB por imagen en la API de Anthropic y 5 MB si tu Claude Code funciona a través de Amazon Bedrock o Google Cloud.
• 100 imágenes por solicitud en los modelos con una ventana de contexto de 200k tokens y 600 en los demás. Con más de 20 imágenes en una solicitud, cada imagen debe caber en 2000 x 2000 píxeles.

Claude lee una imagen en bloques de 28 x 28 píxeles, y cada bloque cuesta un token. Una captura de 1000 x 1000 son 1296 tokens. Una captura de 1920 x 1080 son unos 2700 tokens en Claude 4.7 y modelos posteriores, que leen las imágenes a mayor resolución. Es lo bastante barato para usarlo sin miedo, pero una sesión larga llena de capturas consume contexto, así que ejecuta /compact cuando se cargue.

Casos de uso: qué hacer de verdad con imágenes en Claude Code

Los métodos no sirven de nada sin buenos prompts. Estos son los cuatro flujos de trabajo con más impacto que usamos a diario.

De mockup a código. Suelta una exportación de Figma o una captura y pídele a Claude Code que lo construya.

«Genera el componente de React y las clases de Tailwind que encajan con este diseño: [Image #1]»

Depuración con capturas de errores. Pega una captura de un stack trace o de un aviso de error. Es más rápido que teclearlo.

«Este es el error que veo en la consola de desarrollo. ¿Qué lo causa y qué archivo debería revisar? [Image #1]»

Texto a partir de capturas. Saca el texto de una imagen sin volver a teclearlo. Útil para contenido que no puedes copiar, como un panel de ajustes.

«Extrae los valores de configuración de esta captura de nuestro panel de ajustes de producción a un objeto JSON: [Image #1]»

Revisión de esquemas y diagramas. Suelta un diagrama entidad-relación o un boceto de arquitectura y pide migraciones o una crítica.

«Este es nuestro esquema actual de Postgres. Añade una tabla subscriptions con las claves foráneas correctas: [Image #1]»

Para sesiones largas con muchas imágenes, plantéate crear tus propias skills de Claude Code para automatizar el ciclo de captura, pegado y prompt.

Solución de problemas: pegar imágenes no funciona

Si tu imagen no se adjunta, repasa esta lista en orden. La mayoría de los fallos son uno de estos.

Comprueba el atajo. Windows y WSL usan Alt+V. macOS usa Ctrl+V, y Cmd+V solo en iTerm2. Linux usa Ctrl+V.

Comprueba el portapapeles. ¿Hay de verdad una imagen en el portapapeles o la captura acabó en un archivo? En un Mac, Cmd+Shift+4 sin Ctrl guarda en disco. Usa Cmd+Ctrl+Shift+4 para copiar.

Comprueba la versión. Ejecuta claude --version y claude update. El pegado de capturas con Alt+V en Windows se corrigió en la v2.1.141, y las correcciones de WSL llegaron entre la v2.1.47 y la v2.1.157.

Comprueba Linux. ¿Tienes instalado xclip (X11) o wl-clipboard (Wayland)? Claude Code necesita uno de los dos para leer el portapapeles.

Comprueba SSH. ¿Claude Code se ejecuta en una máquina remota? Entonces pegar no puede funcionar. Copia el archivo con scp y usa su ruta.

Comprueba el formato y el tamaño. Si el archivo tiene un formato poco habitual, conviértelo a PNG. Si es demasiado grande, Claude Code ahora indica la causa en el error y te dice cómo solucionarlo.

Plan B. Si nada más funciona, arrastra el archivo o pega su ruta. Las dos opciones se saltan todas las capas del portapapeles que pueden fallar.

Si además tienes problemas para iniciar sesión en la terminal, la solución para pegar el código de autenticación de Claude Code cubre una familia de problemas de portapapeles relacionada que quizá quieras resolver en la misma sesión.

Truco: abre las imágenes a las que se refiere Claude

Cuando Claude Code menciona imágenes en sus respuestas como [Image #1], [Image #2] y así sucesivamente, se pueden pulsar. Cmd+clic en macOS o Ctrl+clic en Windows y Linux abre la imagen en tu visor predeterminado. Es una forma rápida de comprobar que Claude está mirando lo correcto en una sesión con muchas imágenes.

Olvídate de los líos de la CLI: usa Fello AI en Mac

Si has llegado aquí porque solo quieres que Claude mire una imagen, la terminal es dar un rodeo. Fello AI es una app nativa para Mac que te da Claude con una subida de imágenes que simplemente funciona. Sin tabla de atajos, sin copias por SSH, sin conversiones de formato. Sueltas una captura en el chat, haces tu pregunta y Claude responde.

Fello AI reúne Claude, ChatGPT, Gemini, Grok y DeepSeek en una sola app por $9.99/mes. Puedes pasar la misma captura por Claude, ChatGPT y Gemini una tras otra y comparar las respuestas sin pagar tres suscripciones. Y a diferencia de Claude Code, también genera imágenes: cambia a un modelo de imágenes en el mismo chat y convierte el plan de Claude en una imagen. Para los planes del propio Claude Code, consulta nuestra guía de precios de Claude Code. La app tiene una valoración de 4,7 estrellas con más de 27 000 reseñas.

Las imágenes funcionan como esperas en una app de escritorio. Arrastra desde Finder, pega con Cmd+V o pulsa el botón de adjuntar. La imagen va al modelo que tengas seleccionado, con la misma visión de Claude que tienes en la CLI. Para usuarios de Mac que quieren el análisis de imágenes de Claude sin la terminal, es la opción más limpia.

Conclusión

Claude Code acepta imágenes de tres formas, y en 2026 las tres funcionan en todas las plataformas: arrastrar y soltar un archivo, pegar desde el portapapeles o escribir una ruta de archivo en tu prompt. Lo único que hay que recordar es el atajo: Ctrl+V en macOS y Linux (Cmd+V en iTerm2), Alt+V en Windows y WSL. Por SSH, copia el archivo al servidor y usa su ruta.

Claude Code lee imágenes, pero no las crea, así que para generarlas conecta una API de imágenes o un servidor MCP, o usa una app que ya traiga un modelo de imágenes. Y si todavía estás decidiendo si la CLI merece la pena, nuestra guía sobre las opciones gratuitas y de pago de Claude Code repasa todos los caminos.

Preguntas frecuentes