Imagens no Claude Code: como colar, carregar e usar em qualquer sistema

O Claude Code consegue ler imagens. Arraste uma captura de ecrã, cole um mockup de interface ou entregue-lhe um gráfico, e o Claude analisa-o da mesma forma que analisa código. Colar era o ponto fraco, e era no Windows que falhava. Isso mudou: o Alt+V já cola imagens no Windows e no WSL, o Ctrl+V faz o mesmo no macOS e no Linux, e o iTerm2 aceita também o Cmd+V.

Este guia explica as três formas oficiais de dar uma imagem ao Claude Code, o atalho certo para cada plataforma, as capturas de ecrã (incluindo as que o Claude tira sozinho), o SSH, a extensão para VS Code e a aplicação para computador, os formatos e limites, e porque é que o Claude Code não consegue gerar imagens. Cada afirmação foi confirmada na documentação da Anthropic e no registo de alterações do Claude Code na versão 2.1.292 (outubro de 2026).

Principais conclusões

• Três métodos oficiais para adicionar imagens ao Claude Code: arrastar e largar, colar a partir da área de transferência ou indicar o caminho do ficheiro no prompt.
• O atalho para colar depende da plataforma: Ctrl+V no macOS e no Linux, Cmd+V também funciona no iTerm2, e Alt+V no Windows e no WSL.
• Colar no Windows nativo já funciona. O pedido de funcionalidade correspondente (issue #26679) foi fechado como concluído a 17 de agosto de 2026. Se o Alt+V disser que não encontrou nenhuma imagem, execute claude update.
• Por SSH, colar não pode funcionar, porque a área de transferência fica no seu próprio computador. Copie o ficheiro para o servidor com scp e indique o caminho ao Claude.
• O Claude lê JPEG, PNG, GIF e WebP. O Claude Code converte outros formatos por si e reduz as imagens coladas para 2000 píxeis no lado maior.
• O Claude Code não consegue gerar imagens. Consegue escrever SVG ou HTML, ou chamar um modelo de imagem através de um script ou de um servidor MCP.

O Claude Code consegue ver imagens?

Sim. O Claude Code funciona com os mesmos modelos que o resto da família Claude, incluindo o Claude Opus 5.5 e o Sonnet 5.5, e todos leem imagens. Capturas de ecrã, diagramas, gráficos, mockups e fotografias funcionam. O Claude Code acrescenta a camada de entrada que leva o ficheiro até ao modelo e guarda no disco cada imagem colada, por isso o Claude também a pode abrir como ficheiro e copiá-la para o seu projeto.

A visão é uma das razões pelas quais o Claude Code é mais útil do que os antigos assistentes que só percebiam código. Mostre-lhe uma exportação do Figma e ele escreve o HTML e o CSS correspondentes. Mostre-lhe uma captura de um stack trace e ele segue o erro até ao ficheiro. Mostre-lhe um diagrama do esquema da base de dados e ele redige a migração.

Juntamente com as melhores skills do Claude Code, as imagens transformam a CLI num ciclo rápido do design ao código, que antes exigia idas e voltas a uma janela de chat. O mesmo ciclo funciona no telemóvel se usar o Claude Code no telemóvel através da funcionalidade Remote Control da Anthropic.

O Claude Code consegue gerar imagens?

Não. A documentação de visão da Anthropic diz que o Claude «é apenas um modelo de compreensão de imagens» e que «não consegue gerar, produzir, editar, manipular nem criar imagens». O Claude Code usa esses mesmos modelos, por isso a resposta é igual no terminal e na aplicação de chat. O nosso guia sobre se o Claude consegue gerar imagens cobre o lado do chat.

O que o Claude Code consegue fazer é escrever código que produz uma imagem: um ícone SVG, um mockup em HTML e CSS, um gráfico com uma biblioteca de visualização ou um script de canvas. Para diagramas, ícones e rascunhos de interface, isto é muitas vezes melhor do que uma imagem, porque o resultado é texto editável que fica no seu repositório.

Para fotografias e ilustrações, o Claude Code tem de chamar um modelo de imagem gerido por outra empresa. Há duas formas de o configurar:

• Um script. Peça ao Claude Code que escreva e execute um pequeno script que chame uma API de imagens da OpenAI ou da Google com a sua própria chave de API e guarde o resultado no projeto.
• Um servidor MCP. Ligue um servidor MCP que ofereça uma ferramenta de imagem. Desde a v2.1.283, as imagens devolvidas por ferramentas MCP também são guardadas num ficheiro, para que o Claude as possa mover para onde o seu código as espera.

Em qualquer dos casos, o fornecedor de imagens cobra-lhe à parte do seu plano Claude.

Como adicionar imagens ao Claude Code: 3 métodos

A documentação oficial do Claude Code indica três formas de adicionar uma imagem. As três funcionam em todas as plataformas, desde que use o atalho certo para a sua.

1. Arraste e largue o ficheiro de imagem a partir do Finder, do Explorador de Ficheiros ou do ambiente de trabalho para a janela do Claude Code.
2. Cole a partir da área de transferência com Ctrl+V, ou com Alt+V no Windows e no WSL.
3. Indique ao Claude o caminho do ficheiro no prompt, por exemplo: Analisa esta imagem: /Users/me/Desktop/error.png.

Escolha consoante o que tem à mão. Colar é o mais rápido para uma captura acabada de tirar. Arrastar é o mais rápido quando o ficheiro já existe. O caminho do ficheiro é a escolha certa para scripts, sessões SSH e tudo o que for automatizado, porque nunca passa pela área de transferência.

Método 1: arrastar e largar

Abra a pasta onde está a imagem, arraste o ficheiro para a janela do Claude Code e largue-o. O Claude Code anexa a imagem, regista de onde veio e aguarda o seu prompt. Pode largar várias imagens de uma vez.

No WSL, arrastar imagens a partir do Explorador de Ficheiros do Windows funciona desde a v2.1.157 (29 de maio de 2026). No Linux, arrastar e largar depende do emulador de terminal, por isso mantenha o caminho do ficheiro como alternativa. Na extensão para VS Code, mantenha premida a tecla Shift enquanto arrasta um ficheiro para a caixa do prompt.

Método 2: colar a partir da área de transferência

Copie uma imagem, clique no prompt do Claude Code e prima o atalho de colar. O Claude Code insere uma etiqueta [Image #1] na posição do cursor. A etiqueta fica onde a colocar na frase, por isso pode escrever prompts como «faz com que [Image #1] se pareça com [Image #2]». Escreva o resto da pergunta e prima Enter.

É o atalho que confunde as pessoas, porque muda conforme a plataforma:

O erro mais comum num Mac é premir Cmd+V no Terminal ou no Warp. Essa tecla pertence à aplicação de terminal, que cola texto, por isso a imagem nunca chega ao Claude Code. O iTerm2 é a exceção, porque o Claude Code converte aí o Cmd+V em Ctrl+V.

Se o seu terminal usar o atalho para outra coisa, altere-o. Execute /keybindings para abrir ~/.claude/keybindings.json e atribua outra tecla à ação chat:imagePaste. O Claude Code aplica a alteração sem reiniciar.

Método 3: caminho do ficheiro no prompt

O método mais aborrecido, e o único que nunca depende da área de transferência nem do terminal. Escreva o caminho da imagem no prompt, como parte da mensagem:

Analisa esta captura e diz-me o que está errado: /Users/lenka/Desktop/login-bug.png

Ou com um caminho relativo a partir da raiz do projeto:

Compara este design com o nosso /src/components/Header.tsx atual: ./mockups/header-v2.png

O Claude Code lê o ficheiro do disco e anexa-o. Funcionam caminhos absolutos e relativos. No WSL, um caminho do Windows como C:\Users\me\file.png passa a ser /mnt/c/Users/me/file.png.

O mais arrumado é guardar as capturas diretamente no projeto, por exemplo em ./screenshots/bug.png, e depois pedir: Olha para ./screenshots/bug.png e diz-me o que está partido. A imagem fica junto ao código que o Claude está a editar, e pode excluir a pasta com o .gitignore.

É também a única forma de enviar imagens a partir de um script, por exemplo um que passa prompts à CLI com claude -p.

Método × plataforma num relance

Se quiser um método que funcione em qualquer configuração, use caminhos de ficheiro. Colar é o mais rápido, desde que prima a tecla certa para a sua plataforma.

Como adicionar imagens ao Claude Code em cada sistema operativo

Cada sistema operativo tem as suas teclas de captura e as suas manias. Eis o que funciona em cada um.

macOS

Prima Cmd+Ctrl+Shift+4 e selecione uma área para copiar uma captura diretamente para a área de transferência, ou Cmd+Ctrl+Shift+3 para o ecrã inteiro. Depois prima Ctrl+V no Claude Code (ou Cmd+V no iTerm2). O Cmd+Shift+4 sem Ctrl guarda a captura no ambiente de trabalho, o que não tem mal se preferir arrastar o ficheiro.

O macOS coloca as capturas na área de transferência em formato TIFF, que o próprio Claude não lê. O Claude Code converte-o por si desde a v2.1.0, por isso nunca precisa de guardar e exportar de novo primeiro.

Arrastar e largar a partir do Finder e indicar caminhos de ficheiro no prompt também funciona, claro.

Windows nativo (PowerShell, Windows Terminal, Linha de Comandos)

Prima Win+Shift+S para copiar uma captura para a área de transferência e depois Alt+V dentro do Claude Code. No Windows, o Ctrl+V é a colagem de texto do terminal, por isso não anexa nenhuma imagem.

O Alt+V para Windows chegou logo na v1.0.93, mas nem sempre encontrava uma captura acabada de copiar até uma correção na v2.1.141. Essa lacuna explica porque é que tantos guias antigos, incluindo uma versão anterior deste, diziam que colar no Windows não funcionava. O pedido de funcionalidade no GitHub #26679 foi fechado como concluído a 17 de agosto de 2026. Se o Alt+V continuar a dizer que não encontrou nenhuma imagem, atualize com claude update.

Também pode dispensar por completo a área de transferência:

• Arraste e largue o ficheiro da captura a partir do Explorador de Ficheiros para a janela do Claude Code.
• Guarde-a e indique o caminho. Guarde a captura a partir da Ferramenta de Recorte e faça referência a ela no prompt: Analisa isto: C:\Users\you\Pictures\shot.png.

Windows com WSL

O WSL era onde colar imagens falhava mais vezes. A causa, documentada na issue #25935 do GitHub, era que o Windows copia as imagens para a área de transferência em BMP e as versões antigas do Claude Code não aceitavam BMP. Isso foi corrigido na v2.1.47 (fevereiro de 2026). Versões posteriores acrescentaram uma alternativa via PowerShell para áreas de transferência que o xclip e o wl-paste não conseguem ler (v2.1.136) e, depois, o atalho Alt+V, a colagem de capturas no Windows 11 e arrastar e largar a partir do Explorador de Ficheiros (v2.1.157, 29 de maio de 2026).

Numa versão atual, copie a captura com Win+Shift+S e prima Alt+V. O Ctrl+V também está atribuído, mas muitos terminais ficam com o Ctrl+V para si, por isso a tecla a recordar é o Alt+V. Execute primeiro claude update se tiver uma versão antiga.

Se colar continuar a falhar na sua configuração, tem duas alternativas fiáveis:

• Use um caminho de ficheiro. Guarde a captura em C:\Users\me\Pictures\shot.png e faça referência a ela como /mnt/c/Users/me/Pictures/shot.png.
• Guarde a área de transferência como PNG com o PowerShell e passe esse ficheiro ao Claude Code: powershell.exe -Command "(Get-Clipboard -Format Image).Save('shot.png')".

Se usar o Claude Code na extensão para VS Code no WSL, colar uma captura na caixa de chat anexa a imagem desde a v2.1.267. Antes disso, podia inserir os bytes da imagem em bruto. Outro limite do WSL: a integração com o Chrome, que permite ao Claude tirar as suas próprias capturas do navegador (ver mais abaixo), não funciona no WSL. Tem curiosidade sobre editores de código com IA? A nossa análise dos preços do Cursor cobre todos os planos.

Linux

O Claude Code lê a área de transferência do Linux através do xclip no X11 ou do wl-paste no Wayland. Se o Ctrl+V disser que não há nenhuma imagem na área de transferência, instale a ferramenta que a sua sessão usa (xclip, ou o pacote wl-clipboard) e tente de novo.

A sua ferramenta de captura também tem de copiar a imagem para a área de transferência, e não apenas guardá-la. O GNOME Screenshot tem essa opção, o Flameshot tem um botão «copiar para a área de transferência» e o Spectacle do KDE também. Num terminal mínimo ou num servidor sem área de transferência, use caminhos de ficheiro.

Capturas de ecrã: cole-as ou deixe o Claude tirar as suas

A maioria das imagens que as pessoas dão ao Claude Code são capturas de ecrã. O caminho mais rápido em cada plataforma:

• macOS: Cmd+Ctrl+Shift+4 e depois Ctrl+V (ou Cmd+V no iTerm2).
• Windows: Win+Shift+S e depois Alt+V.
• WSL: Win+Shift+S e depois Alt+V.
• Linux: a opção de copiar da sua ferramenta de captura e depois Ctrl+V.

No trabalho web, muitas vezes nem precisa de tirar a captura. Com a integração com o Chrome, o Claude Code controla o Chrome ou o Edge através da extensão Claude in Chrome. Abre a sua aplicação, lê os erros da consola e tira as suas próprias capturas para confirmar que uma interface corresponde ao mockup. Inicie-a com claude --chrome. Precisa da extensão, de um plano direto da Anthropic (Pro, Max, Team ou Enterprise) e de iniciar sessão com /login, e não funciona no WSL. Peça-lhe «tira uma captura da página de pagamento e guarda-a no disco» e ele escreve o ficheiro e indica-lhe o caminho (essa opção funciona desde a v2.1.211).

A aplicação do Claude Code para computador faz o mesmo no seu painel de navegador. O Claude arranca o seu servidor de desenvolvimento, abre aí a aplicação, tira capturas, inspeciona a página e corrige o que encontra. Os servidores MCP de automação do navegador, como o do Playwright, são uma terceira opção se quiser capturas no seu próprio ambiente de testes.

Claude Code por SSH e em sessões remotas

A área de transferência está no computador à sua frente. Quando o Claude Code corre noutra máquina por SSH, não consegue ler essa área de transferência, por isso colar uma imagem não vai funcionar. O Claude Code avisa-o disso e sugere o scp, que é a solução certa. Copie o ficheiro para o servidor e indique o caminho ao Claude:

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

Depois peça Olha para ./screenshots/shot.png a partir da pasta do projeto no servidor. Se controlar o Claude Code a partir do telemóvel com o Remote Control, as imagens que carrega na aplicação móvel chegam com um caminho de ficheiro guardado (desde a v2.1.239), para que o Claude as possa copiar para os ficheiros que cria.

Imagens na extensão para VS Code e na aplicação para computador

Não precisa de terminal nenhum. Na extensão para VS Code, cole uma imagem da área de transferência na caixa do prompt, ou arraste um ficheiro com a tecla Shift premida. Desde a v2.1.275 pode enviar uma imagem sem escrever texto.

Na aplicação do Claude Code para computador, use o botão + ao lado da caixa do prompt, ou arraste e largue ficheiros no prompt. Aceita imagens, PDF e outros ficheiros, o que a torna o sítio mais fácil para partilhar a captura de um erro ou um mockup de design. Desde a v2.1.275, as imagens que cola ou anexa na aplicação para computador e no VS Code são guardadas onde o Claude as consegue abrir sem pedir permissão.

Formatos de imagem suportados e limites

O Claude lê quatro formatos de imagem. Enviar o certo poupa-lhe o ciclo em que o Claude Code parece ignorar a sua imagem porque, à partida, não a conseguia usar.

Os outros formatos já não são um beco sem saída. O Claude Code converte o TIFF que as capturas do macOS colocam na área de transferência e o BMP que o Windows passa ao WSL, e desde a v2.1.285 converte ficheiros BMP, HEIC, HEIF, AVIF e TIFF sempre que consegue. O SVG é diferente: é texto, por isso o Claude lê um ficheiro SVG como código e não como imagem. Se uma imagem continuar a não anexar, converta-a para PNG.

Os limites que interessam:

• 2000 píxeis: o Claude Code reduz as imagens coladas para que o lado maior tenha no máximo 2000 píxeis, por isso uma captura enorme não estraga a sua sessão.
• 8000 x 8000 píxeis é o máximo que a API do Claude aceita por imagem.
• 10 MB por imagem na API da própria Anthropic e 5 MB se o seu Claude Code funcionar através do Amazon Bedrock ou do Google Cloud.
• 100 imagens por pedido nos modelos com uma janela de contexto de 200k tokens e 600 nos restantes. Com mais de 20 imagens num pedido, cada imagem tem de caber em 2000 x 2000 píxeis.

O Claude lê uma imagem em blocos de 28 x 28 píxeis, e cada bloco custa um token. Uma captura de 1000 x 1000 custa 1296 tokens. Uma captura de 1920 x 1080 custa cerca de 2700 tokens no Claude 4.7 e em modelos mais recentes, que leem as imagens em maior resolução. É barato o suficiente para usar à vontade, mas uma sessão longa cheia de capturas consome contexto, por isso execute /compact quando ficar pesada.

Casos de uso: o que fazer realmente com imagens no Claude Code

Os métodos de nada servem sem bons prompts. Estes são os quatro fluxos de trabalho mais rentáveis que usamos todos os dias.

Do mockup ao código. Largue uma exportação do Figma ou uma captura e peça ao Claude Code que a construa.

«Gera o componente React e as classes Tailwind que correspondem a este design: [Image #1]»

Depuração a partir de capturas de erros. Cole uma captura de um stack trace ou de uma mensagem de erro. É mais rápido do que escrever tudo.

«Este é o erro que vejo na consola de desenvolvimento. O que o está a causar e que ficheiro devo ver? [Image #1]»

Texto a partir de capturas. Retire o texto de uma imagem sem o voltar a escrever. Útil para conteúdo que não consegue copiar, como um painel de definições.

«Extrai os valores de configuração desta captura do nosso painel de definições de produção para um objeto JSON: [Image #1]»

Revisão de esquemas e diagramas. Largue um diagrama entidade-relação ou um esboço de arquitetura e peça migrações ou uma crítica.

«Este é o nosso esquema atual em Postgres. Acrescenta uma tabela subscriptions com as chaves estrangeiras certas: [Image #1]»

Para sessões longas com muitas imagens, pondere criar as suas próprias skills do Claude Code para automatizar o ciclo de captura, colagem e prompt.

Resolução de problemas: colar imagens não funciona

Se a imagem não anexar, percorra esta lista por ordem. A maioria das falhas é uma destas.

Verifique o atalho. Windows e WSL usam Alt+V. O macOS usa Ctrl+V, e o Cmd+V só no iTerm2. O Linux usa Ctrl+V.

Verifique a área de transferência. Há mesmo uma imagem na área de transferência, ou a captura foi parar a um ficheiro? Num Mac, o Cmd+Shift+4 sem Ctrl guarda no disco. Use Cmd+Ctrl+Shift+4 para copiar.

Verifique a versão. Execute claude --version e claude update. A colagem de capturas com Alt+V no Windows foi corrigida na v2.1.141, e as correções do WSL chegaram entre a v2.1.47 e a v2.1.157.

Verifique o Linux. Tem o xclip (X11) ou o wl-clipboard (Wayland) instalado? O Claude Code precisa de um deles para ler a área de transferência.

Verifique o SSH. O Claude Code está a correr numa máquina remota? Então colar não pode funcionar. Copie o ficheiro com scp e use o caminho dele.

Verifique o formato e o tamanho. Se o ficheiro tiver um formato pouco comum, converta-o para PNG. Se for demasiado grande, o Claude Code indica agora a causa na mensagem de erro e diz-lhe como resolver.

Alternativa. Se nada mais resultar, arraste o ficheiro ou cole o caminho dele. Ambos contornam todas as camadas da área de transferência que podem falhar.

Se também tiver problemas para iniciar sessão no terminal, a solução para colar o código de autenticação do Claude Code cobre uma família semelhante de problemas de área de transferência que talvez queira resolver na mesma sessão.

Dica: abra as imagens a que o Claude se refere

Quando o Claude Code menciona imagens nas respostas como [Image #1], [Image #2] e assim por diante, elas são clicáveis. Cmd+clique no macOS ou Ctrl+clique no Windows e no Linux abre a imagem no visualizador predefinido. É uma forma rápida de confirmar que o Claude está a olhar para a imagem certa numa sessão com muitas.

Esqueça as dores de cabeça da CLI: use o Fello AI no Mac

Se chegou aqui porque só quer que o Claude olhe para uma imagem, o terminal é um desvio. O Fello AI é uma aplicação nativa para Mac que lhe dá o Claude com um carregamento de imagens que simplesmente funciona. Sem tabela de atalhos, sem cópias por SSH, sem conversões de formato. Larga uma captura no chat, faz a pergunta e o Claude responde.

O Fello AI reúne o Claude, o ChatGPT, o Gemini, o Grok e o DeepSeek numa só aplicação por $9.99/mês. Pode passar a mesma captura pelo Claude, pelo ChatGPT e pelo Gemini, uns a seguir aos outros, e comparar as respostas sem pagar três subscrições. E, ao contrário do Claude Code, também gera imagens: mude para um modelo de imagem no mesmo chat e transforme o plano do Claude numa imagem. Para os planos do próprio Claude Code, consulte o nosso guia de preços do Claude Code. A aplicação tem uma classificação de 4,7 estrelas em mais de 27 000 avaliações.

As imagens funcionam como espera numa aplicação para computador. Arraste a partir do Finder, cole com Cmd+V ou clique no botão de anexar. A imagem vai para o modelo que tiver selecionado, com a mesma visão do Claude que tem na CLI. Para quem usa Mac e quer a análise de imagens do Claude sem o terminal, é a opção mais simples.

Conclusão

O Claude Code aceita imagens de três formas, e em 2026 as três funcionam em todas as plataformas: arrastar e largar um ficheiro, colar a partir da área de transferência ou indicar o caminho do ficheiro no prompt. A única coisa a recordar é o atalho: Ctrl+V no macOS e no Linux (Cmd+V no iTerm2), Alt+V no Windows e no WSL. Por SSH, copie o ficheiro para o servidor e use o caminho dele.

O Claude Code lê imagens mas não as cria, por isso, para as obter, ligue uma API de imagens ou um servidor MCP, ou use uma aplicação que já traga um modelo de imagem. E se ainda está a decidir se a CLI compensa, o nosso guia sobre as opções gratuitas e pagas do Claude Code percorre todos os caminhos.

Perguntas frequentes