Comment coller une capture d'écran dans Claude Code
La réponse courte : sur Windows, ne comptez pas sur Ctrl+V. Utilisez le raccourci de collage propre à Claude Code, faites glisser le fichier image dans le terminal, ou référencez le fichier par chemin dans votre message d'invite. Cette page couvre les trois, pourquoi le collage de presse-papiers ordinaire continue à disparaître, et comment dimensionner la capture d'écran pour qu'elle ne coûte pas une millier de tokens.
Vous voulez montrer à Claude Code une capture d'écran — une boîte de dialogue d'erreur, une mise en page cassée, un cadre de conception — et la taper prendrait une éternité. Le problème est que le terminal n'est pas une boîte de chat : la même Ctrl+V que le collage fonctionne partout ailleurs dans Windows fonctionne fréquemment ne rien faire ici, surtout à l'intérieur de WSL. L'image n'est pas perdue ; le terminal simplement ne l'a jamais reçue. La solution est d'utiliser une route qui ne dépend pas de la route fragile du bitmap-sur-presse-papiers, et il y en a trois fiables.
Ceci est un guide publié par Maxisnap. Maxisnap fait un outil de capture d'écran Windows dont l'exportation est construite pour exactement cette remise, donc il apparaît où c'est pertinent — mais les routes ci-dessous fonctionnent avec n'importe quelle capture d'écran, de n'importe quel outil.
Quelles sont les trois façons de donner à Claude Code une image ?
Claude Code accepte une image trois façons, et sur Windows elles ne sont pas également fiables. Environ dans l'ordre de fiabilité :
| Route | Comment | Fiabilité sur Windows / WSL |
|---|---|---|
| Chemin de fichier dans l'invite | Tapez ou collez le chemin de l'image enregistrée, par exemple C:\Users\you\shot.png; dans votre message. | Le plus fiable — pas de presse-papiers impliqué |
| Faites glisser le fichier | Faites glisser le fichier image depuis l'Explorateur (ou directement depuis un outil de capture) sur la fenêtre du terminal. | Fiable quand le terminal supporte le dépôt |
| Raccourci de collage | Utilisez la touche de collage dédiée de Claude Code (les versions récentes utilisent Alt+V pour les images). | Fonctionne dans de nombreux configurations ; la solution de rechange est un chemin de fichier |
| Le réflexe que tout le monde essaie en premier. | Souvent ne rien ne fait silencieusement dans le terminal |
Les raccourcis clavier de Claude Code changent entre les versions — vérifiez sa documentation actuelle pour la touche de collage exacte. La route du chemin de fichier est celle qui continue à fonctionner indépendamment.
Pourquoi Ctrl+V ne rien ne fait dans le terminal ?
Parce que coller une image dans un terminal est une opération différente et moins supportée que coller du texte. Quand vous copiez une capture d'écran, Windows met un bitmap sur le presse-papiers. La plupart des terminaux ne gèrent que le collage de texte et ignorent silencieusement un bitmap, donc rien n'apparaît. À l'intérieur de WSL, l'écart est encore plus large : le côté Linux du terminal ne voit pas du tout le bitmap du presse-papiers Windows, donc même un outil qui accepterait une image collée ne reçoit jamais les données. L'image va bien — elle n'a simplement pas de chemin du presse-papiers à l'invite. C'est pourquoi les routes qui utilisent un fichier sauvegardé plutôt qu'un bitmap du presse-papiers sont celles qui tiennent.
Même le raccourci de collage dédié peut être flaky ici : le collage d'images dans le terminal a été signalé comme s'arrêtant intermittent sur certains systèmes Windows et PowerShell. Quand la route du presse-papiers vous échoue, un fichier sauvegardé — glissé ou référencé par chemin — ne dépend jamais de cela, c'est pourquoi c'est l'habitude qui vaut la peine de construire.
Dois-je redimensionner la capture d'écran avant de l'envoyer ?
Oui, si vous faites cela toute la journée. Une capture en résolution complète n'est pas seulement lourde à déplacer — c'est coûteux. Les modèles de vision divisent une image en patchs et facturent les tokens par patch, donc une capture d'écran 4K peut coûter bien plus d'une millier de tokens d'image, tandis qu'une copie redimensionnée à une largeur sensée coûte quelques centaines et se lit tout aussi clairement, car le modèle réduit l'échelle des grandes images en interne de toute façon. Dimensionner correctement l'image avant qu'elle atteigne Claude Code est l'optimisation la moins chère de toute la boucle.
C'est là qu'un outil de capture conçu à cet effet gagne sa place. Maxisnap's Export optimisé pour l'IA produit une copie plafonnée à une largeur maximale par défaut de 1600 px (configurable dans Paramètres) et vous remme le fichier sauvegardé — prêt à faire glisser dans le terminal ou à référencer par chemin. Et si le cliché montre une clé API, un token, ou les données d'un client, l'outil de flou le rédige de manière destructive avant que le fichier ne soit jamais créé, donc le secret ne peut pas être récupéré de ce que vous envoyez.
| Ce que vous collez | Coût typique en tokens d'image | Dans Claude Code |
|---|---|---|
| Capture 4K brute / plein moniteur | Plus de 1 000 tokens | Plus cher et peut dépasser une limite de taille |
| Copie optimisée pour l'IA de Maxisnap (1600 px de large) | Quelques centaines de tokens | Se lit clairement, coûte moins cher, se téléverse vite |
Les chiffres de tokens correspondent à des fourchettes typiques des modèles de vision, et non à un test de référence Maxisnap ; les valeurs exactes varient selon le modèle et le contenu de l'image.
$ la remise la plus fiable et la plus rapide
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
Coller des captures d'écran dans Claude Code — FAQ
Pourquoi Ctrl+V ne colle pas ma capture d'écran dans Claude Code ?
Parce que le terminal généralement ne peut pas accepter une image du presse-papiers — il attend du texte, et il ignore le bitmap que Windows met là quand vous copiez une capture d'écran. À l'intérieur de WSL, le bitmap du presse-papiers Windows n'est pas du tout visible du côté Linux. Utilisez la touche de collage d'image propre à Claude Code, faites glisser le fichier dans le terminal, ou référencez le chemin du fichier sauvegardé dans votre message d'invite à la place.
Le raccourci de collage a arrêté de fonctionner dans Claude Code — maintenant quoi ?
Le collage d'images dans le terminal peut échouer de manière intermittente sur Windows et PowerShell, donc ne vous fiez pas à lui comme votre seule route. Enregistrez la capture d'écran et référencez son chemin de fichier dans votre message d'invite, ou faites glisser le fichier sur le terminal — ni l'un ni l'autre ne touche au presse-papiers, donc les deux continuent à fonctionner quand le raccourci de collage ne fonctionne pas. Cela vaut la peine de vérifier la documentation actuelle de Claude Code pour la touche de collage la plus récente, mais la route du chemin de fichier est celle qui ne casse jamais.
Quel est le moyen le plus fiable d'ajouter une image sur Windows ?
Référencez le fichier sauvegardé par son chemin dans votre message. Il ne touche pas au presse-papiers, donc il fonctionne pareil dans Windows Terminal, WSL, et sur SSH. Faire glisser le fichier sur le terminal est la prochaine route la plus fiable.
La capture d'écran doit-elle être d'une certaine taille ?
Plus petit est généralement mieux. Une capture en résolution complète peut coûter plus d'une millier de tokens d'image et est plus susceptible de dépasser une limite par image. Une copie redimensionnée autour de 1600 px de large coûte bien moins et se lit tout aussi clairement, car le modèle réduit l'échelle des grandes images de toute façon.
Comment masquer une clé API avant d'envoyer une capture d'écran ?
Rédigez-la avant que le fichier soit créé. Dans Maxisnap, faites glisser l'outil de flou sur le secret dans l'éditeur, puis exportez — le flou est appliqué de manière destructive, donc la clé ne peut pas être récupérée de l'image que vous remettez à Claude Code.
Puis-je faire la même chose avec Codex CLI ou Gemini CLI ?
Oui. Tous les trois prennent un chemin de fichier ou un fichier glissé, qui est la route portable sur Windows. Notre captures d'écran pour le codage assisté par IA page a le détail par outil, et enregistrement d'écran pour le codage IA couvre l'envoi d'un court clip quand une image figée ne suffit pas.
Capturez, rédigez, et remettez-le en trois frappes.
Une capture d'écran correctement dimensionnée et optimisée pour l'IA avec un fichier sauvegardé prêt à glisser ou référencer — gratuit sur Windows.
À voir aussi : captures d'écran pour le codage assisté par IA · enregistrement d'écran pour le codage IA · flouter une capture d'écran · outils de capture d'écran pour développeurs