# Cómo pegar una imagen en Claude Code: Ctrl+V, Alt+V o la ruta > En Claude Code la imagen se pega con Ctrl+V (la tecla Control, también en Mac) o con Alt+V en Windows y WSL. Si falla, arrastra el archivo o escribe su ruta. - URL: https://blog.laozhang.ai/es/posts/claude-code-paste-image - Published: 2026-10-02 - Updated: 2026-10-02 - Author: LaoZhang AI Team (https://blog.laozhang.ai/es/about) - Category: Claude Code - Tags: Claude Code, Capturas de pantalla, Portapapeles, Atajos de teclado, WSL, VS Code --- Para pegar una imagen en Claude Code desde la terminal, copia la imagen al portapapeles y pulsa **Ctrl+V**: la tecla Control, también en un Mac, no Comando. En Windows y en WSL la tecla es **Alt+V**, y en iTerm2 vale además Cmd+V. Si la imagen entró, aparece un marcador `[Image #1]` en la posición del cursor. Si no aparece nada, o sale el mensaje «No image found in clipboard», tienes dos vías que no pasan por el portapapeles: arrastrar el archivo a la ventana o escribir su ruta en el prompt. Antes de seguir, conviene saber de dónde sale cada cosa. Los atajos de teclado proceden de la [documentación del modo interactivo](https://code.claude.com/docs/en/interactive-mode) y del [registro de cambios](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) (changelog) de Anthropic a 2 de octubre de 2026, cuando la última versión anotada era la 2.1.287. Ninguno de esos atajos se ejecutó en una terminal para preparar este texto. Lo único que sí se recorrió fue la vía de la ruta, en la app de escritorio de Claude Code sobre macOS 26.1: al darle la ruta de un PNG de 1416×1366 y la de un WebP de 2000×1125, Claude abrió los dos archivos y describió su contenido. ## Qué tecla pega una imagen en Claude Code según tu entorno La tecla depende de dónde corre Claude Code, no de tu costumbre de pegar. Esta tabla reúne lo que dice la documentación de Anthropic para cada caso. | Dónde usas Claude Code | Cómo entra la imagen | Qué tener en cuenta | | --- | --- | --- | | Terminal en macOS | Ctrl+V, con la tecla Control | Cmd+V es el pegado de texto de la terminal y no trae la imagen | | iTerm2 en macOS | Ctrl+V o Cmd+V | Es la única terminal para la que la documentación nombra Cmd+V; se añadió en la versión 2.1.0 | | Windows nativo | Alt+V | Atajo añadido en la versión 1.0.93 | | WSL | Alt+V o Ctrl+V | Están asignadas las dos; usa Alt+V si tu terminal intercepta Ctrl+V | | Linux | Ctrl+V | Por lo que dejan ver las notas de versión, se apoya en xclip o, en Wayland, en wl-paste | | Sesión por SSH | Ningún atajo ve tu portapapeles local | Copia el archivo al servidor y cita su ruta | | Extensión de VS Code, cuadro del prompt | El atajo de pegar habitual del sistema | Los archivos se adjuntan arrastrándolos con Mayús pulsada | | VS Code, terminal integrada | Las mismas teclas que en la terminal de tu sistema | Ahí corre la CLI, no la extensión | | App de escritorio | Botón de adjuntar o arrastrar y soltar | La página de la app no menciona el pegado desde el portapapeles | ![Nueve entornos de Claude Code con la tecla que pega la imagen en cada uno: Ctrl+V en macOS y Linux, Alt+V en Windows y WSL, ningún atajo por SSH](https://blog.laozhang.ai/posts/es/claude-code-paste-image/img/atajos-por-entorno.webp) Las filas de terminal salen de la tabla de atajos del modo interactivo, que describe la acción así: «`Ctrl+V` or `Cmd+V` (iTerm2) or `Alt+V` (Windows and WSL)», pegar imagen desde el portapapeles. La misma página avisa de que los atajos pueden variar según la plataforma y la terminal. La [referencia de atajos configurables](https://code.claude.com/docs/en/keybindings) llama a esta acción `chat:imagePaste` y permite reasignarla, de modo que, si ninguna de las teclas por defecto te resulta cómoda, puedes cambiarla ahí. Sobre el Mac hay una confusión tan frecuente que una de las respuestas más citadas en Reddit lo resume así: «Control-V (on the Mac). That's not a typo». No es una errata. Es Control, la tecla que casi nunca usas para pegar. Para Ghostty, Kitty, WezTerm, Warp, la Terminal de Apple o la Terminal de Windows no hay nada escrito en la documentación de Anthropic: ni que Cmd+V sirva en otra terminal que no sea iTerm2, ni cómo se comporta cada una con Ctrl+V. Si la tuya no responde, pasa directamente a arrastrar el archivo o a escribir su ruta. ## Por qué Cmd+V no pega la imagen en la terminal Porque el pegado de la terminal solo sabe enviar texto. Cmd+V en macOS, o Ctrl+Mayús+V y el botón derecho en muchas terminales de Linux y Windows, toman el texto del portapapeles y se lo escriben al programa que está en marcha. Una captura de pantalla no tiene forma de texto, así que la terminal no manda nada y Claude Code no se entera de que has pulsado una tecla. El pegado de imágenes de Claude Code es otra cosa: un atajo propio del programa que, al pulsarlo, lee el portapapeles por su cuenta. Por eso tiene que ser una tecla distinta de la del sistema, y por eso cambia cuando la terminal se queda con Ctrl+V para sí misma, que es lo que ocurre a menudo en Windows y la razón de que allí exista Alt+V. Esta explicación es el mecanismo general de las terminales, no una cita de Anthropic, pero encaja con la tabla oficial y con lo que cuentan los usuarios. De aquí sale también un requisito previo: la imagen tiene que estar en el portapapeles, no en un archivo. En macOS, Cmd+Mayús+4 guarda la captura como archivo; para copiarla al portapapeles hay que añadir Control (Cmd+Ctrl+Mayús+4). En Windows, Win+Mayús+S deja el recorte en el portapapeles. ## Cómo saber que la imagen entró: el marcador de imagen La señal es un marcador `[Image #N]` que aparece donde tenías el cursor, con N como número de orden. La documentación oficial lo llama «chip» y explica para qué sirve la posición: puedes referirte a la imagen dentro de la frase, en el punto exacto en que la pegaste. Este comportamiento llegó en la versión 2.1.83; desde la 2.1.132, mientras el programa lee el portapapeles tras un Ctrl+V, el pie de la pantalla muestra el aviso «Pasting…». Puedes usar varias imágenes en una misma conversación, cada una con su número. Y cuando Claude menciona una de ellas en su respuesta, por ejemplo `[Image #1]`, la referencia es un enlace: Cmd+clic en Mac o Ctrl+clic en Windows y Linux la abre en tu visor de imágenes, según la receta [«Work with images»](https://code.claude.com/docs/en/common-workflows) de la documentación. Una vez dentro, el prompt es el de siempre. Los ejemplos de Anthropic dan la medida de lo que se suele pedir: «What does this image show?», «Here's a screenshot of the error. What's causing it?» o «Generate CSS to match this design mockup». ## «No image found in clipboard»: cinco causas y qué hacer El mensaje significa que Claude Code leyó el portapapeles y no encontró una imagen que pudiera usar. Las causas, en el orden en que cuesta menos descartarlas: 1. **En el portapapeles no hay una imagen.** Hiciste la captura a archivo en lugar de copiarla, o copiaste texto después. Repite la captura con el atajo que copia al portapapeles e inténtalo de nuevo. Si lo que tienes es un archivo ya guardado, no hace falta copiar nada: arrástralo o escribe su ruta. 2. **La tecla no es la de tu entorno.** Cmd+V fuera de iTerm2, o Ctrl+V en una terminal de Windows que se lo queda. Vuelve a la tabla de arriba; en Windows y WSL, Alt+V. 3. **Estás en una sesión remota.** Por SSH, Claude Code corre en el servidor y el portapapeles que puede leer es el de esa máquina, no el de tu equipo. El atajo no tiene arreglo aquí; el siguiente apartado explica qué hacer. 4. **Falta la utilidad de portapapeles en Linux.** Las notas de versión hablan de xclip y de wl-paste como recurso en Wayland cuando xclip no está disponible. Anthropic no publica una lista de requisitos, así que esto es una lectura de esas notas: si ninguna de las dos utilidades está instalada, es el primer sitio donde mirar. 5. **Tu versión es antigua.** Varios casos de «no se encontró imagen» eran errores que se corrigieron después: en Windows con una captura en el portapapeles (2.1.141), en WSL con Alt+V y con las capturas de Windows 11 (2.1.157), en WSL2 leyendo el portapapeles de Windows (2.1.136). Actualizar Claude Code es un paso legítimo antes de buscar causas más raras. ![Las cinco causas del mensaje No image found in clipboard en Claude Code y qué hacer en cada una, de repetir la captura a actualizar la versión](https://blog.laozhang.ai/posts/es/claude-code-paste-image/img/no-image-found-causas.webp) Hay un caso más que antes confundía: si en el portapapeles había texto, Ctrl+V respondía con «No image found in clipboard» en lugar de pegar el texto. Eso se corrigió en la versión 2.1.181. Fuera de lo documentado, hay quien informa de diferencias entre intérpretes de comandos en Windows: un bloguero contó en abril de 2026 que en cmd.exe sobre Windows 11 Alt+V no pegaba una captura hecha con Snipaste y devolvía este mismo mensaje, mientras que en PowerShell sí entraba. Es el relato de una sola persona, pero cambiar de intérprete cuesta poco si estás en esa situación. ## Arrastrar el archivo o escribir su ruta: las vías sin portapapeles Las dos evitan el portapapeles por completo, y por eso son la salida cuando el atajo falla o cuando no sabes cómo se porta tu terminal. La documentación las pone al mismo nivel que el pegado: arrastrar y soltar la imagen sobre la ventana de Claude Code, o darle a Claude la ruta, con un prompt del tipo: ```text Analiza esta imagen: /Users/ana/Desktop/error-login.png ``` La ruta es la vía que sí se recorrió para este texto, en la app de escritorio sobre macOS: Claude abrió los archivos con su herramienta de lectura y describió lo que mostraban. Tiene además una ventaja práctica: sirve igual en una sesión remota, siempre que el archivo esté en la máquina donde corre Claude Code. Por SSH, ese es justo el camino que sugiere el propio programa. Desde la versión 2.1.2, el mensaje de error al intentar pegar una imagen en una sesión remota recomienda `scp` en lugar de repetir el consejo del atajo. La secuencia es copiar la captura al servidor desde tu equipo y citar después la ruta remota en el prompt: ```bash scp captura.png usuario@servidor:/tmp/captura.png ``` Nombre de usuario, servidor y carpeta de destino son de ejemplo; usa los de tu conexión. En WSL, desde la versión 2.1.157 puedes arrastrar imágenes desde el Explorador de Windows. Y desde la 2.1.2 las imágenes arrastradas a la terminal conservan la ruta de origen como metadato, de manera que Claude sabe de qué archivo vienen. ## Pegar capturas en la extensión de VS Code y en la app de escritorio En VS Code hay dos casos distintos y se confunden con facilidad. Si usas el panel de la extensión, el cuadro del prompt es una interfaz gráfica: según la [página de VS Code](https://code.claude.com/docs/en/vs-code), para adjuntar una imagen la pegas desde el portapapeles en ese cuadro, lo que en una interfaz gráfica es el atajo de pegar de siempre; la página no nombra ninguna tecla. Para adjuntar archivos, los arrastras al cuadro manteniendo pulsada Mayús, y para quitar un adjunto haces clic en su X. Si en cambio abres la terminal integrada de VS Code y lanzas Claude Code allí, estás en la CLI y valen las teclas de la tabla: Ctrl+V, o Alt+V en Windows y WSL. Quien trabaje con VS Code sobre WSL2 tiene un motivo más para mantener la versión al día: antes de la 2.1.267, pegar una captura en el cuadro de la extensión podía insertar los bytes de la imagen como texto en el chat; desde esa versión la imagen se adjunta si el portapapeles la ofrece y, si no, el pegado se ignora. Si dudas de con qué sesión estás trabajando en el editor, [comprobar la cuenta de Claude Code en VS Code](https://blog.laozhang.ai/es/posts/check-claude-code-vscode-account) es el paso previo. En la app de escritorio, la [documentación](https://code.claude.com/docs/en/desktop) describe dos gestos: el botón de adjuntar junto al cuadro del prompt y arrastrar y soltar los archivos directamente sobre él. Admite imágenes, PDF y otros archivos, y Anthropic menciona como uso típico las capturas de errores y las maquetas de diseño. ## Qué versión de Claude Code cambió cada atajo Los consejos antiguos se contradicen porque cada uno era cierto para una versión distinta. Un hilo que dice que el pegado solo existe en Mac, otro que niega que Cmd+V sirva en iTerm2 y otro que da por perdido WSL pueden ser los tres correctos en su momento. El registro de cambios no fecha estas líneas, pero sí las ordena: | Versión | Qué cambió | | --- | --- | | 0.2.59 | Copiar y pegar imágenes directamente en el prompt | | 0.2.75 | Arrastrar archivos de imagen al prompt | | 1.0.93 | Windows: atajo Alt+V para pegar desde el portapapeles | | 2.0.52 | Linux con Wayland: recurre a wl-paste si no hay xclip | | 2.1.0 | Cmd+V en iTerm2; capturas de macOS más fiables gracias al formato TIFF | | 2.1.2 | Por SSH, el mensaje de error sugiere `scp` | | 2.1.83 | La imagen pegada inserta el marcador `[Image #N]` en el cursor | | 2.1.132 | Aviso «Pasting…» mientras se lee el portapapeles | | 2.1.136 | WSL2: lectura del portapapeles de Windows mediante PowerShell como recurso | | 2.1.141 | Windows: corregido que Alt+V respondiera «no image found» con una captura en el portapapeles | | 2.1.157 | WSL: corregidos Alt+V y las capturas de Windows 11; arrastrar desde el Explorador | | 2.1.181 | Ctrl+V con texto en el portapapeles ya no muestra «No image found in clipboard» | | 2.1.275 | Las imágenes pegadas o adjuntas se guardan donde Claude puede abrirlas como archivo sin pedir permiso, también en la app de escritorio y en VS Code | La lectura práctica: si tu instalación es anterior a alguna de estas líneas y tu problema coincide con ella, la solución es actualizar, no cambiar de tecla. ## Tamaño y formatos de imagen: qué está documentado y qué no No hay un tamaño máximo ni una lista de formatos admitidos en las páginas de Claude Code citadas aquí. Lo que sí existe son correcciones que indican cómo se tratan hoy las imágenes grandes: - En la versión 2.1.0 se corrigió el error «Image was too large» al pegar imágenes grandes. - Desde la 2.1.97, las imágenes pegadas y adjuntas se comprimen con el mismo presupuesto de tokens que las que Claude lee de un archivo. - En la 2.1.126 se arregló que una imagen de más de 2000 px rompiera la sesión: ahora se reduce al pegarla. Esa cifra describe un fallo antiguo, no un límite oficial. - Desde la 2.1.157, una imagen ilegible (vacía o corrupta) se convierte en un texto de sustitución en lugar de hacer fallar la petición. Tampoco está documentado el coste en tokens de cada imagen, ni el comportamiento dentro de tmux o en las terminales de los IDE de JetBrains. Para esos entornos la recomendación es la misma que para cualquier terminal sin fila propia en la tabla: la ruta del archivo no depende de nada de eso. Si lo que buscas es el sentido contrario, que Claude Code produzca la imagen en lugar de leerla, el recorrido está en [cómo generar imágenes con Claude Code: SVG, script o MCP](https://blog.laozhang.ai/es/posts/claude-code-image-generation).