Como colar uma captura de tela no Claude Code
A resposta curta: no Windows, não confie em Ctrl+V. Use o atalho de cola de imagem do Claude Code, arraste o arquivo de imagem para o terminal ou referencie o arquivo por caminho em seu prompt. Esta página cobre todas as três, por que a cola de área de transferência ordinária continua desaparecendo e como dimensionar a captura de tela para que não custe mil tokens.
Você quer mostrar ao Claude Code uma captura de tela — um diálogo de erro, um layout quebrado, um quadro de design — e digitá-la levaria uma eternidade. O problema é que o terminal não é uma caixa de bate-papo: o mesmo Ctrl+V que cola uma imagem em qualquer lugar no Windows com frequência faz nada aqui, especialmente dentro do WSL. A imagem não é perdida; o terminal simplesmente nunca a recebeu. O remédio é usar uma rota que não dependa da rota frágil de bitmap-em-área-de-transferência, e há três confiáveis.
Este é um guia publicado pelo Maxisnap. Maxisnap faz uma ferramenta de captura de tela do Windows cuja exportação é construída exatamente para essa transferência, então aparece onde é relevante — mas as rotas abaixo funcionam com qualquer captura de tela, de qualquer ferramenta.
Quais são as três maneiras de dar uma imagem ao Claude Code?
Claude Code aceita uma imagem de três maneiras, e no Windows não são igualmente confiáveis. Aproximadamente em ordem de confiabilidade:
| Rota | Como | Confiabilidade no Windows / WSL |
|---|---|---|
| Caminho do arquivo no prompt | Digite ou cole o caminho da imagem salva, ex. C:\Users\you\shot.png, em sua mensagem. | Mais confiável — sem envolver a área de transferência |
| Arraste o arquivo | Arraste o arquivo de imagem do Explorer (ou direto de uma ferramenta de captura) para a janela do terminal. | Confiável quando o terminal suporta arrastar e soltar |
| Atalho de cola | Use a chave de cola dedicada do Claude Code (versões recentes usam Alt+V para imagens). | Funciona em muitas configurações; a alternativa é um caminho de arquivo |
| O reflexo que todo mundo tenta primeiro. | Frequentemente não faz nada silenciosamente no terminal |
Os atalhos do Claude Code mudam entre versões — verifique a documentação atual para a tecla de cola exata. A rota do caminho do arquivo é aquela que continua funcionando independentemente.
Por que Ctrl+V não faz nada no terminal?
Porque colar uma imagem em um terminal é uma operação diferente e menos suportada do que colar texto. Quando você copia uma captura de tela, Windows coloca um bitmap na área de transferência. A maioria dos terminais só lida com cola de texto e silenciosamente ignora um bitmap, então nada aparece. Dentro do WSL a lacuna é ainda maior: o lado Linux do terminal não vê o bitmap da área de transferência do Windows, então até uma ferramenta que aceitaria uma imagem colada nunca recebe os dados. A imagem está bem — ela apenas não tem caminho da área de transferência para o prompt. É por isso que as rotas que usam um arquivo salvo em vez de um bitmap da área de transferência são as que se mantêm.
Até mesmo o atalho de cola dedicado pode ser frágil aqui: a cola de imagem no terminal foi relatada intermitentemente parando de funcionar em alguns setups do Windows e PowerShell. Quando a rota da área de transferência falha para você, um arquivo salvo — arrastado ou referenciado por caminho — nunca depende dela, é por isso que é o hábito que vale a pena construir.
Devo redimensionar a captura de tela antes de enviá-la?
Sim, se você está fazendo isso o dia todo. Uma captura de resolução completa não é apenas pesada para mover — é cara. Os modelos de visão dividem uma imagem em patches e cobram tokens por patch, então uma captura de tela 4K pode custar bem mais de mil tokens de imagem, enquanto uma cópia redimensionada para uma largura sensata custa algumas centenas e lê exatamente tão claramente, porque o modelo redimensiona imagens grandes internamente de qualquer maneira. Dimensionar corretamente a imagem antes que chegue ao Claude Code é a otimização mais barata em todo o loop.
É aqui que uma ferramenta de captura de propósito específico ganha seu lugar. Maxisnap tem uma Exportação otimizada para IA produz uma cópia limitada a uma largura máxima padrão de 1600 px (configurável em Configurações) e coloca o arquivo salvo para você — pronto para arrastar para o terminal ou referenciar por caminho. E se o disparo mostra uma chave de API, um token ou dados de um cliente, a ferramenta de borrão a redacta destrutivamente antes do arquivo ser criado, para que o segredo não possa ser recuperado do que você envia.
| O que você cola | Custo típico em tokens de imagem | No Claude Code |
|---|---|---|
| Captura 4K bruta / monitor inteiro | mais de 1.000 tokens | Mais caro e pode atingir um limite de tamanho |
| Cópia otimizada para IA da Maxisnap (1600 px de largura) | Algumas centenas de tokens | Leitura nítida, custa menos, envio rápido |
Os números de tokens são faixas típicas de modelos de visão, não um benchmark da Maxisnap; as contagens exatas variam conforme o modelo e o conteúdo da imagem.
$ a entrega confiável mais rápida
1. Ctrl+Alt+5 -> drag a box around the error 2. blur any secrets, then export the AI-optimized copy 3. drag the saved file into the terminal ...or paste its path: read this: C:\Users\you\shot.png # skip Ctrl+V — the terminal usually ignores the bitmap
Colar capturas de tela no Claude Code — FAQ
Por que Ctrl+V não cola minha captura de tela no Claude Code?
Porque o terminal geralmente não consegue aceitar uma imagem da área de transferência — está esperando texto e ignora o bitmap que Windows coloca lá quando você copia uma captura de tela. Dentro do WSL o bitmap da área de transferência do Windows não é visível para o lado Linux. Use a chave de cola de imagem do Claude Code, arraste o arquivo para o terminal ou referencie o caminho do arquivo salvo em seu prompt.
O atalho de cola parou de funcionar no Claude Code — e agora?
A cola de imagem no terminal pode falhar intermitentemente no Windows e PowerShell, então não confie nela como sua única rota. Salve a captura de tela e referencie o caminho de seu arquivo em seu prompt, ou arraste o arquivo para o terminal — nenhum toca a área de transferência, então ambos continuam funcionando quando o atalho de cola não funciona. Vale a pena verificar a documentação atual do Claude Code para a tecla de cola mais recente, mas a rota do caminho do arquivo é aquela que nunca quebra.
Qual é a forma mais confiável de adicionar uma imagem no Windows?
Referencie o arquivo salvo por seu caminho em sua mensagem. Não toca a área de transferência, portanto funciona da mesma maneira no Windows Terminal, WSL e via SSH. Arrastar o arquivo para o terminal é a próxima rota mais confiável.
A captura de tela precisa ter um tamanho específico?
Menor geralmente é melhor. Uma captura de resolução completa pode custar mais de mil tokens de imagem e é mais provável de atingir um limite por imagem. Uma cópia redimensionada para cerca de 1600 px de largura custa muito menos e lê exatamente tão claramente, porque o modelo redimensiona imagens grandes de qualquer maneira.
Como faço para ocultar uma chave de API antes de enviar uma captura de tela?
Redacte antes que o arquivo seja criado. No Maxisnap, arraste a ferramenta de desfoque sobre o segredo no editor e depois exporte — o desfoque é aplicado destrutivamente, portanto a chave não pode ser recuperada da imagem que você entrega ao Claude Code.
Posso fazer a mesma coisa com Codex CLI ou Gemini CLI?
Sim. Todos os três usam um caminho de arquivo ou um arquivo arrastado, que é a rota portátil no Windows. Nosso capturas para programação com IA página tem o detalhe por ferramenta, e gravação de tela para codificação por IA cobre enviar um clipe curto quando uma imagem parada não é suficiente.
Capture, redacte e entregue em três toques.
Uma captura de tela dimensionada corretamente e otimizada para IA com um arquivo salvo pronto para arrastar ou referenciar — gratuito no Windows.
Relacionados: capturas para programação com IA · gravação de tela para codificação por IA · desfocar uma captura de tela · ferramentas de captura para desenvolvedores