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

Claude Code puede leer imágenes. Suéltale una captura de pantalla, pégale un mockup de interfaz o pásale una gráfica, y Claude la analizará igual que analiza el código. El detalle es que pegar funciona de forma fiable en macOS pero falla en silencio en Windows y WSL, que es lo que manda a la mayoría de la gente a Google.

Esta guía cubre todas las formas oficiales de darle imágenes a Claude Code, dónde funciona realmente cada método, los cuatro formatos de imagen que Claude Code acepta y los prompts de ejemplo que convierten una captura de pantalla en código funcional. La respuesta corta si quieres saltarte la resolución de problemas: arrastra y suelta un archivo o pega una ruta de archivo en tu prompt. Ambas cosas funcionan en todas las plataformas. Pegar del portapapeles es lo más fiable en macOS, y desde Claude Code v2.1.157 (mayo de 2026) WSL por fin tiene también un atajo de pegado que funciona.

Conclusiones clave

• Tres métodos oficiales para añadir imágenes a Claude Code: arrastrar y soltar, copiar y pegar, o pasar una ruta de archivo en tu prompt.
• Arrastrar y soltar y las rutas de archivo funcionan en todas las plataformas. Usa estas si quieres un método que nunca falle.
• Pegar del portapapeles con Ctrl+V funciona de forma fiable solo en macOS. En Windows nativo, las imágenes del portapapeles en bruto desde la Herramienta Recortes fallan en silencio (issue #26679, todavía abierto a fecha de junio de 2026). En WSL, pegar del portapapeles solía fallar porque Windows entrega las imágenes en BMP, pero v2.1.157 (29 de mayo de 2026) lo arregló con una combinación de teclas dedicada, Alt+V.
• Usa Ctrl+V, nunca Cmd+V, incluso en Mac, donde el terminal captura Cmd+V antes de que Claude Code lo vea.
• Formatos admitidos: JPEG, PNG, GIF, WebP. Máximo 5 MB por imagen en local, hasta 100 imágenes por solicitud.

¿Puede Claude Code ver imágenes?

Sí. Claude Code usa la misma capacidad de visión multimodal que el resto de la familia Claude, incluidos Claude Opus 5 y Sonnet 5, así que puede leer capturas de pantalla, diagramas, gráficas, mockups y cualquier otra imagen fija que le pases. La CLI solo añade la capa de entrada que te permite hacer llegar el archivo hasta ahí.

La visión es una de las razones por las que Claude Code es más útil que los asistentes más antiguos de solo código. Muéstrale a Claude Code una exportación de Figma y escribirá el HTML y el CSS correspondientes. Muéstrale una captura de un stack trace y rastreará el error hasta el archivo. Si le muestras un diagrama del esquema de una base de datos, redactará la migración.

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

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

Según la documentación oficial de Anthropic, hay exactamente tres formas admitidas de añadir una imagen a Claude Code. La documentación las trata a las tres como iguales, pero en la práctica su fiabilidad es de todo menos igual.

1. Arrastra y suelta el archivo de imagen desde Finder, el Explorador o tu escritorio a la ventana del terminal de Claude Code. Funciona en todas las plataformas.
2. Haz referencia a una ruta de archivo directamente en tu prompt, por ejemplo: Analyze this image: /Users/me/Desktop/error.png. Funciona en todas las plataformas.
3. Copia y pega la imagen con Ctrl+V (no con Cmd+V). Funciona de forma fiable solo en macOS. En Windows y WSL, las imágenes del portapapeles en bruto fallan en silencio.

Elige según lo que tengas a mano. Arrastrar y soltar es lo más rápido cuando el archivo ya existe en disco. Las rutas de archivo son la opción adecuada para scripts o cualquier entorno donde el manejo del portapapeles no sea fiable. Pegar del portapapeles es lo más rápido para capturas recién hechas; usa Ctrl+V en Mac y Alt+V en WSL (añadido en v2.1.157, mayo de 2026). Si estás en Windows nativo e intentas enviar una captura que acabas de hacer con Win+Mayús+S, guárdala primero en disco y luego arrástrala o pásala por ruta, porque pegar del portapapeles en bruto todavía no funciona ahí.

Método 1: arrastrar y soltar

Abre la carpeta donde vive tu imagen, mantén pulsado el archivo y luego arrástralo hasta el terminal de Claude Code. Suéltalo, y Claude Code adjuntará la imagen y esperará tu prompt.

Si el archivo se abre en una nueva pestaña en lugar de adjuntarse a Claude Code, mantén pulsado Mayús mientras arrastras para forzar al terminal a tratar lo que sueltas como una referencia de archivo en vez de lanzar el gestor del sistema. Esto importa sobre todo en iTerm2, Windows Terminal y Warp, donde el comportamiento de arrastre por defecto depende de la aplicación.

Arrastrar y soltar funciona de forma fiable en macOS y en Windows nativo. En Linux depende de tu entorno de escritorio y de tu emulador de terminal. En WSL, funciona solo cuando arrastras desde una ruta que el lado de Linux puede ver, como /mnt/c/Users/..., no desde una ruta solo de Windows.

Método 2: pegar con Ctrl+V (solo en macOS, de forma fiable)

Este método es fiable en macOS y poco fiable en todos los demás sitios. Úsalo en Mac, y recurre a arrastrar y soltar o a las rutas de archivo en Windows y WSL.

En Mac, Cmd+Ctrl+Mayús+4 captura una región de la pantalla directamente al portapapeles; el simple Cmd+Mayús+4 la guarda en el escritorio en su lugar. Luego pulsa Ctrl+V dentro de Claude Code. Claude Code mostrará un marcador de posición como [Image #1] en el prompt y adjuntará la imagen cuando la envíes. Escribe tu pregunta después del marcador de posición y pulsa Intro.

El mayor error que cometen los usuarios de Mac: pulsar Cmd+V. La propia app del terminal captura Cmd+V, no Claude Code, así que la imagen nunca llega a la CLI. Usa Ctrl+V.

En Windows nativo, Win+Mayús+S copia tu captura al portapapeles, pero pegarla en Claude Code con Ctrl+V no hace nada en silencio. Es una limitación documentada, registrada en la solicitud de función #26679 de GitHub (presentada en febrero de 2026, todavía abierta a fecha de junio de 2026). Guarda la captura en disco y arrástrala, o pega la ruta. El único patrón de pegado que sí funciona en Windows: copia un archivo de imagen guardado en el Explorador de archivos con Ctrl+C, y luego pega con Ctrl+V. Claude Code lee la referencia del archivo, no el mapa de bits en bruto. Si ejecutas Claude Code bajo WSL en lugar de Windows nativo, ahora tienes una opción mejor, que se cubre en la sección de WSL más abajo.

En Linux, pegar imágenes del portapapeles funciona en algunos terminales (Konsole, Kitty, Alacritty) y falla en otros (xterm, gnome-terminal en algunas configuraciones). Trátalo como algo oportunista, no fiable.

Método 3: ruta de archivo en tu prompt

El método más aburrido, y el único que funciona en todas partes. Escribe la ruta de tu imagen en el prompt como parte de tu mensaje:

Analyze this screenshot and tell me what's wrong: /Users/lenka/Desktop/login-bug.png

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

Compare this design to our current /src/components/Header.tsx: ./mockups/header-v2.png

Claude Code lee el archivo desde el disco y lo adjunta al mensaje antes de enviarlo. Funcionan tanto las rutas absolutas como las relativas. En WSL, convierte las rutas de Windows de C:\Users\me\file.png a /mnt/c/Users/me/file.png.

El flujo de trabajo más limpio es soltar la imagen directamente en la carpeta del proyecto en la que estás trabajando y luego hacer referencia a ella por su ruta relativa. Guarda tu captura en algo como ./screenshots/bug.png dentro del repositorio, y luego pídele a Claude con Look at ./screenshots/bug.png and tell me what's broken. Claude Code la lee desde el disco como cualquier otro archivo de tu proyecto, así que esto funciona en cualquier sistema operativo y en cualquier terminal, incluido WSL, donde pegar del portapapeles está roto. También es el patrón más fácil de mantener ordenado en sesiones largas, porque la imagen vive junto al código que Claude está editando y puedes poner la carpeta en el git-ignore.

Este método es además la única forma de enviar imágenes de manera programática, por ejemplo desde un script que canaliza prompts hacia la CLI con claude -p.

Fiabilidad por método × sistema operativo

Si quieres un método que funcione siempre, sea cual sea el terminal o el sistema operativo, usa las rutas de archivo. Arrastrar y soltar va justo detrás. Pegar imágenes en bruto del portapapeles es de momento una comodidad exclusiva de Mac.

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

Cada sistema operativo tiene sus propias peculiaridades. Esto es lo que funciona de verdad en cada uno.

macOS

La plataforma buena. Usa Ctrl+V para pegar imágenes del portapapeles en bruto, nunca Cmd+V. Para capturar una imagen directamente al portapapeles, pulsa Cmd+Ctrl+Mayús+4 y selecciona el área. El simple Cmd+Mayús+4 la guarda en disco en su lugar, que es la jugada equivocada si quieres pegar.

iTerm2, Warp, WezTerm y el Terminal por defecto de macOS se comportan todos igual para el pegado en Claude Code. La app del terminal ve Cmd+V y ejecuta su propia lógica de búfer de pegado, que solo gestiona texto, no imágenes, así que la imagen se descarta antes de que Claude Code tenga siquiera la oportunidad de leerla. Cambiar a Ctrl+V lo soluciona.

Arrastrar y soltar desde Finder y las rutas de archivo en tu prompt también funcionan, por supuesto.

Windows nativo (PowerShell, Windows Terminal, Command Prompt)

Pegar del portapapeles una captura en bruto no funciona hoy en Windows nativo. Win+Mayús+S pone la imagen en el portapapeles, pero el gestor de Ctrl+V de Claude Code no la recoge. Esto está registrado en la solicitud de función abierta #26679, todavía abierta a fecha de junio de 2026. Ten en cuenta que esto se aplica a Windows nativo (PowerShell, Windows Terminal, Command Prompt). Si ejecutas Claude Code a través de WSL, se aplica en su lugar la corrección de Alt+V de mayo de 2026, mira la siguiente sección.

Usa una de estas en su lugar:

• Arrastra y suelta el archivo de la captura desde el Explorador de archivos a la ventana de Claude Code. Mantén pulsado Mayús mientras arrastras si el archivo se abre en otra app en lugar de adjuntarse.
• Guárdala y pásala por ruta. Usa Win+Mayús+S, guarda la captura en una carpeta y luego haz referencia a su ruta en tu prompt: Analyze this: C:\Users\you\Pictures\shot.png.
• Copia el archivo, no la imagen. En el Explorador de archivos, selecciona el archivo de la captura guardada y pulsa Ctrl+C, y luego Ctrl+V dentro de Claude Code. Claude Code lee la referencia del archivo y adjunta la imagen. Esto funciona porque evita por completo la vía del mapa de bits en bruto del portapapeles.

Anthropic sí lanzó una combinación oficial de pegado de imágenes con Alt+V en v2.1.157 (29 de mayo de 2026), pero el registro de cambios acota esa corrección a WSL y al pegado de capturas en Windows 11, no al pegado del portapapeles en bruto en PowerShell o Command Prompt nativos, donde el #26679 sigue abierto. Si estás en Windows nativo, trata arrastrar y soltar o una ruta de archivo como la respuesta fiable, y usa Alt+V solo cuando ejecutes bajo WSL.

Windows con WSL

WSL solía ser donde el pegado de imágenes de Claude Code fallaba más a menudo, y eso cambió a finales de mayo de 2026. La causa raíz, documentada en el issue #25935 de GitHub, era sencilla: Windows copia las imágenes al portapapeles como BMP, WSLg reenvía ese BMP sin cambios a través del portapapeles de Wayland, y las compilaciones más antiguas de Claude Code no aceptaban BMP, así que el pegado no hacía nada en silencio.

La corrección llegó en v2.1.157 (29 de mayo de 2026), que el registro de cambios describe como «arreglado el pegado de imágenes (combinación alt+v), el pegado de capturas en Windows 11, y añadido el soporte para arrastrar imágenes desde el Explorador de Windows». Así que en una compilación actual, la vía más rápida es copiar tu captura al portapapeles y pulsar Alt+V dentro de Claude Code, no Ctrl+V. Asegúrate primero de estar en la última versión con claude update, ya que esto solo funciona en v2.1.157 y posteriores.

Si te has quedado en una compilación más antigua o Alt+V sigue portándose mal en tu configuración, tienes tres alternativas fiables:

• Usa una ruta de archivo como en el Método 3. Guarda tu captura en C:\Users\me\Pictures\shot.png y luego haz referencia a ella como /mnt/c/Users/me/Pictures/shot.png dentro de Claude Code.
• Convierte el portapapeles con PowerShell, lo que te deja guardar la imagen del portapapeles de Windows en un archivo PNG que luego puedes pasar a Claude Code: powershell.exe -Command "(Get-Clipboard -Format Image).Save('shot.png')".
• Instala la extensión de VS Code Claude Code Image Paste (WSL), una extensión de la comunidad que toma el portapapeles de Windows, convierte la imagen a PNG, la guarda en tu proyecto y pega la ruta en el terminal de Claude Code automáticamente.

Si ejecutas Claude Code a través del terminal integrado de Cursor o VS Code, la extensión es la solución más cómoda en compilaciones antiguas. Desde un terminal WSL normal en una compilación actual, Alt+V es ahora la ruta más rápida, con el método de la ruta de archivo como tu respaldo fiable. ¿Te interesan los planes de Cursor? Nuestro desglose de precios de Cursor cubre todos los niveles.

Linux

En la mayoría de los terminales modernos (Konsole, GNOME Terminal moderno, Kitty, Alacritty), pegar una imagen del portapapeles con Ctrl+V funciona. En terminales más antiguos o minimalistas como xterm, urxvt o los frame buffers de Linux, pegar imágenes no funcionará en absoluto y deberías recurrir a las rutas de archivo.

Tu herramienta de captura tiene que copiar la imagen al portapapeles, no solo guardarla como archivo. GNOME Screenshot tiene la opción, Flameshot tiene un botón de «copiar al portapapeles» y Spectacle de KDE tiene lo mismo.

Formatos de imagen admitidos y límites

Claude Code acepta los cuatro formatos web estándar y rechaza todo lo demás. Saber qué formato enviar te ahorra el ciclo de depuración de fallos en silencio, en el que Claude Code parece ignorar tu imagen porque no pudo analizarla siquiera.

No admitidos: BMP, TIFF, SVG. Si pegas cualquiera de estos, la imagen se descarta en silencio. Conviértela primero a PNG.

Límites estrictos que tener en cuenta:

• 5 MB por imagen en Claude Code en local
• 8000 x 8000 píxeles de resolución máxima por imagen
• 100 imágenes por solicitud como máximo
• Si envías más de 20 imágenes a la vez, cada una se limita a 2000 x 2000 píxeles

Una imagen de 1000 x 1000 píxeles cuesta aproximadamente 1334 tokens de contexto. Eso es lo bastante barato como para usarlo con libertad, pero diez capturas a resolución completa en un solo prompt se comerán un buen pellizco de contexto.

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 de mayor rendimiento que usamos a diario.

De diseño a código a partir de un mockup. Suelta una exportación de Figma o una captura y pídele a Claude Code que la construya.

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

Depuración a partir de una captura de error. Pega directamente una captura de un stack trace o un toast de error. Más rápido que escribirlo.

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

OCR desde capturas de pantalla. Extrae texto de una imagen sin volver a teclearlo a mano. Útil para salidas de terminal de las que no puedes copiar.

«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 ER de una base de datos o un boceto de arquitectura y pide migraciones o una crítica.

«Aquí está 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 skills de Claude Code que puedes construir tú mismo que automaticen el ciclo de captura, pegado y prompt.

Solución de problemas: el pegado de imágenes no funciona

Si tu imagen no se adjunta, repasa esta lista de comprobación en orden. La mayoría de los fallos son una de estas cosas.

Comprobación de plataforma. ¿Estás en Windows nativo intentando pegar con Ctrl+V una captura del portapapeles en bruto? Eso todavía no funciona hoy (#26679). Guarda el archivo y arrástralo, o pega la ruta. En WSL, pegar en bruto sí funciona ahora, pero solo con Alt+V en v2.1.157 o posterior, así que ejecuta claude update antes de dar por hecho que está roto.

Comprobación de formato. ¿Tu archivo es JPEG, PNG, GIF o WebP? Si es BMP, TIFF o SVG, conviértelo primero. Haz clic derecho en Vista Previa (Mac) o Paint (Windows) y guárdalo como PNG.

Comprobación de atajo. En Mac, ¿estás usando Ctrl+V, no Cmd+V? El terminal captura Cmd+V antes de que Claude Code lo vea.

Comprobación del portapapeles. ¿Hay realmente una imagen en el portapapeles, o solo una referencia de archivo? En Mac, Cmd+Mayús+4 (sin Ctrl) guarda en disco. Usa Cmd+Ctrl+Mayús+4 para copiar directamente al portapapeles.

Comprobación de actualización. Ejecuta claude --version y claude update. El comportamiento del manejo de imágenes ha cambiado entre versiones, y el pegado en WSL en particular solo funciona en v2.1.157 (29 de mayo de 2026) o posterior. Si te topas con un fallo que rompe la sesión, reinicia Claude Code.

Alternativa. Si nada más funciona, arrastra el archivo o pega una ruta de archivo. Estos métodos evitan todas las capas del portapapeles que pueden fallar.

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

Consejo pro: abre las imágenes a las que Claude hace referencia

Cuando Claude Code menciona imágenes en sus respuestas como [Image #1], [Image #2], etc., son clicables. Cmd+clic en macOS o Ctrl+clic en Windows y Linux abre la imagen referenciada en tu visor de imágenes por defecto. Una forma rápida de verificar que Claude está mirando lo correcto en una sesión con varias imágenes.

Olvídate de los dolores de cabeza de la CLI: usa Fello AI en Mac en su lugar

Si estás leyendo esta guía porque las peculiaridades del portapapeles y los apaños de WSL te están agotando, hay una vía más rápida. Fello AI es una app nativa de Mac que te da Claude con una subida de imágenes que simplemente funciona. Sin juegos de Cmd+V contra Ctrl+V, sin scripts de conversión de BMP, sin el baile de guardar el archivo y luego arrastrarlo. 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. Una suscripción, todos los modelos importantes, incluido DeepSeek, que la mayoría de las apps de chat todavía omiten. La misma captura que habrías tardado diez minutos en encaminar hacia Claude Code con un apaño tarda aquí dos segundos, y puedes pasar la misma imagen por Claude, ChatGPT y Gemini una tras otra para comparar respuestas sin pagar tres suscripciones distintas. Para una comparación directa de los propios planes de 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 25.000 reseñas.

El manejo de imágenes se comporta como esperarías de una app de escritorio de verdad. Arrastra desde Finder, pega con Cmd+V, o haz clic en el botón de adjuntar. La imagen va directa al modelo que tengas seleccionado, con la misma capacidad de visión de Claude que obtienes en la CLI, sin ninguno de los apaños de esta guía. Para los usuarios de Mac que quieren el razonamiento con imágenes de Claude sin pelearse con el terminal, esta es la opción más limpia.

Conclusión

Tres métodos oficiales, pero solo dos de ellos funcionan de forma fiable en todas las plataformas: arrastrar y soltar un archivo, o pegar una ruta de archivo en tu prompt. Pegar del portapapeles también es real: los usuarios de Mac pulsan Ctrl+V, y los de WSL ahora pulsan Alt+V en v2.1.157 o posterior. Windows nativo es el único rezagado, así que ahí deberías guardar primero la captura en disco.

Para todos los que se quedan con la CLI, guarda esta guía en marcadores para la próxima vez que un pegado se trague tu captura en silencio. Los métodos de arrastrar y soltar y de ruta de archivo te sacarán de cualquier lío del portapapeles que Claude Code pueda ponerte. Y si todavía estás decidiendo si merece la pena pagar por la CLI, nuestra guía sobre las opciones gratuitas y de pago de Claude Code expone todas las vías.

Preguntas frecuentes