Images dans Claude Code : comment les coller, les importer et les utiliser sur n'importe quel OS

Claude Code peut lire les images. Déposez-y une capture d'écran, collez une maquette d'interface, ou donnez-lui un graphique, et Claude l'analysera de la même façon qu'il analyse du code. Le hic, c'est que le collage fonctionne de façon fiable sur macOS mais échoue silencieusement sur Windows et WSL, ce qui pousse la plupart des gens vers Google.

Ce guide couvre toutes les méthodes officielles pour donner des images à Claude Code, l'endroit où chaque méthode fonctionne réellement, les quatre formats d'image acceptés par Claude Code, et les exemples de prompts qui transforment une capture d'écran en code fonctionnel. La réponse courte si vous voulez sauter le dépannage : glissez-déposez un fichier ou collez un chemin de fichier dans votre prompt. Les deux fonctionnent sur toutes les plateformes. Le collage presse-papiers est le plus fiable sur macOS, et depuis Claude Code v2.1.157 (mai 2026), WSL a enfin obtenu un raccourci de collage qui fonctionne aussi.

Les points clés à retenir

• Trois méthodes officielles pour ajouter des images à Claude Code : glisser-déposer, copier-coller, ou passer un chemin de fichier dans votre prompt.
• Le glisser-déposer et les chemins de fichiers fonctionnent sur toutes les plateformes. Utilisez-les si vous voulez une méthode qui ne rate jamais.
• Le collage presse-papiers avec Ctrl+V ne fonctionne de façon fiable que sur macOS. Sur Windows natif, les images brutes du presse-papiers issues de l'Outil Capture d'écran échouent silencieusement (ticket #26679, toujours ouvert en juin 2026). Sur WSL, le collage presse-papiers échouait auparavant parce que Windows fournit les images au format BMP, mais la v2.1.157 (29 mai 2026) a corrigé cela avec un raccourci clavier dédié Alt+V.
• Utilisez Ctrl+V, jamais Cmd+V, même sur Mac, où Cmd+V est intercepté par le terminal avant que Claude Code ne le voie.
• Formats pris en charge : JPEG, PNG, GIF, WebP. Maximum 5 Mo par image en local, jusqu'à 100 images par requête.

Claude Code peut-il voir les images ?

Oui. Claude Code utilise la même capacité de vision multimodale que le reste de la famille Claude, y compris Claude Opus 5 et Sonnet 5, il peut donc lire des captures d'écran, des diagrammes, des graphiques, des maquettes, et toute autre image fixe que vous lui donnez. Le CLI ajoute simplement la couche d'entrée qui vous permet d'y faire parvenir le fichier.

La vision est l'une des raisons pour lesquelles Claude Code est plus utile que les anciens assistants uniquement dédiés au code. Montrez à Claude Code un export Figma, et il écrira le HTML et le CSS correspondants. Montrez-lui une capture d'écran de stack trace, et il remontera le bug jusqu'au fichier. Si vous lui montrez un diagramme de schéma de base de données, il rédigera la migration.

Combinées aux meilleures skills Claude Code, les images transforment le CLI en une boucle rapide pour le travail de design vers code qui nécessitait autrefois des allers-retours dans une fenêtre de chat. La même boucle fonctionne aussi sur mobile si vous utilisez Claude Code sur votre téléphone via la fonctionnalité Remote Control d'Anthropic.

Comment ajouter des images à Claude Code : 3 méthodes

D'après la documentation officielle d'Anthropic, il existe exactement trois façons prises en charge d'ajouter une image à Claude Code. La documentation les traite comme équivalentes, mais dans la pratique, leur fiabilité est loin de l'être.

1. Glissez-déposez le fichier image depuis le Finder, l'Explorateur, ou votre bureau dans la fenêtre de terminal de Claude Code. Fonctionne sur toutes les plateformes.
2. Référencez un chemin de fichier directement dans votre prompt, par exemple : Analyse cette image : /Users/me/Desktop/error.png. Fonctionne sur toutes les plateformes.
3. Copiez-collez l'image avec Ctrl+V (pas Cmd+V). Fonctionne de façon fiable uniquement sur macOS. Sur Windows et WSL, les images brutes du presse-papiers échouent silencieusement.

Choisissez selon ce que vous avez sous la main. Le glisser-déposer est le plus rapide quand le fichier existe déjà sur le disque. Les chemins de fichiers sont le bon choix pour les scripts ou tout environnement où la gestion du presse-papiers n'est pas fiable. Le collage presse-papiers est le plus rapide pour des captures d'écran toutes fraîches ; utilisez Ctrl+V sur Mac et Alt+V sur WSL (ajouté dans la v2.1.157, mai 2026). Si vous êtes sur Windows natif et essayez d'envoyer une capture d'écran que vous venez de prendre avec Win+Shift+S, enregistrez-la d'abord sur le disque, puis glissez-la ou indiquez son chemin, car le collage presse-papiers brut n'y arrive toujours pas.

Méthode 1 : le glisser-déposer

Ouvrez le dossier où se trouve votre image, cliquez et maintenez sur le fichier, puis faites-le glisser sur le terminal de Claude Code. Relâchez, et Claude Code joint l'image et attend votre prompt.

Si le fichier s'ouvre dans un nouvel onglet au lieu de se joindre à Claude Code, maintenez Maj pendant que vous faites glisser pour forcer le terminal à traiter le dépôt comme une référence de fichier plutôt que de lancer le gestionnaire système. Cela compte surtout dans iTerm2, Windows Terminal et Warp, où le comportement de glisser-déposer par défaut dépend de l'application.

Le glisser-déposer fonctionne de façon fiable sur macOS et Windows natif. Sur Linux, cela dépend de votre environnement de bureau et de votre émulateur de terminal. Sur WSL, cela ne fonctionne que si vous glissez depuis un chemin visible côté Linux, comme /mnt/c/Users/..., pas depuis un chemin propre à Windows.

Méthode 2 : coller avec Ctrl+V (fiable uniquement sur macOS)

Cette méthode est fiable sur macOS et peu fiable partout ailleurs. Utilisez-la sur Mac, et retombez sur le glisser-déposer ou les chemins de fichiers sur Windows et WSL.

Sur Mac, Cmd+Ctrl+Maj+4 capture une zone de l'écran directement dans le presse-papiers, tandis que Cmd+Maj+4 seul l'enregistre plutôt sur votre bureau. Appuyez ensuite sur Ctrl+V dans Claude Code. Claude Code affichera un espace réservé comme [Image #1] dans le prompt et joindra l'image quand vous validerez. Tapez votre question après l'espace réservé et appuyez sur Entrée.

La plus grosse erreur commise par les utilisateurs de Mac : appuyer sur Cmd+V. Cmd+V est intercepté par l'application terminal elle-même, pas par Claude Code, donc l'image n'atteint jamais le CLI. Utilisez Ctrl+V.

Sur Windows natif, Win+Maj+S copie votre capture d'écran dans le presse-papiers, mais la coller dans Claude Code avec Ctrl+V ne fait silencieusement rien. C'est une limitation documentée suivie dans la demande de fonctionnalité GitHub #26679 (déposée en février 2026, toujours ouverte en juin 2026). Enregistrez la capture d'écran sur le disque et glissez-la, ou collez le chemin. Le seul schéma de collage qui fonctionne sur Windows : copiez un fichier image enregistré dans l'Explorateur de fichiers avec Ctrl+C, puis collez avec Ctrl+V. Claude Code lit la référence de fichier, pas le bitmap brut. Si vous exécutez Claude Code sous WSL plutôt que sous Windows natif, vous avez maintenant une meilleure option, couverte dans la section WSL ci-dessous.

Sur Linux, le collage d'image via le presse-papiers fonctionne sur certains terminaux (Konsole, Kitty, Alacritty) et échoue sur d'autres (xterm, gnome-terminal dans certaines configurations). Considérez-le comme opportuniste, pas fiable.

Méthode 3 : le chemin de fichier dans votre prompt

La méthode la plus ennuyeuse, et la seule qui fonctionne partout. Tapez le chemin de votre image dans le prompt, comme partie de votre message :

Analyse cette capture d'écran et dis-moi ce qui ne va pas : /Users/lenka/Desktop/login-bug.png

Ou avec un chemin relatif depuis la racine de votre projet :

Compare ce design à notre composant actuel /src/components/Header.tsx : ./mockups/header-v2.png

Claude Code lit le fichier depuis le disque et le joint au message avant l'envoi. Les chemins absolus comme relatifs fonctionnent tous les deux. Sur WSL, convertissez les chemins Windows de C:\Users\me\file.png en /mnt/c/Users/me/file.png.

Le workflow le plus propre consiste à déposer l'image directement dans le dossier du projet sur lequel vous travaillez, puis à la référencer par son chemin relatif. Enregistrez votre capture d'écran sous un nom comme ./screenshots/bug.png dans le dépôt, puis demandez à Claude avec Regarde ./screenshots/bug.png et dis-moi ce qui est cassé. Claude Code la lit depuis le disque comme n'importe quel autre fichier de votre projet, donc cela fonctionne sur tout OS et dans tout terminal, y compris WSL où le collage presse-papiers est cassé. C'est aussi le moyen le plus simple de garder les choses propres sur de longues sessions, car l'image se trouve à côté du code que Claude modifie et vous pouvez ignorer le dossier avec git.

Cette méthode est aussi la seule façon d'envoyer des images de manière programmatique, par exemple depuis un script qui transmet des prompts au CLI avec claude -p.

Méthode × fiabilité par système d'exploitation

Si vous voulez une méthode qui fonctionne toujours, quel que soit le terminal ou l'OS, utilisez les chemins de fichiers. Le glisser-déposer arrive juste derrière. Le collage presse-papiers d'images brutes reste pour l'instant une commodité réservée à Mac.

Comment ajouter des images à Claude Code sur chaque OS

Chaque système d'exploitation a ses propres particularités. Voici ce qui fonctionne réellement sur chacun.

macOS

La bonne plateforme. Utilisez Ctrl+V pour coller des images brutes du presse-papiers, jamais Cmd+V. Pour capturer une zone d'écran directement dans le presse-papiers, appuyez sur Cmd+Ctrl+Maj+4 et sélectionnez la zone. Cmd+Maj+4 seul enregistre plutôt sur le disque, ce qui est le mauvais choix si vous voulez coller.

iTerm2, Warp, WezTerm et l'application Terminal par défaut de macOS se comportent tous de la même façon pour le collage dans Claude Code. L'application terminal capte Cmd+V et exécute sa propre logique de presse-papiers, qui ne gère que le texte, pas les images, donc l'image est perdue avant même que Claude Code ait la moindre chance de la lire. Passer à Ctrl+V résout le problème.

Le glisser-déposer depuis le Finder et les chemins de fichiers dans votre prompt fonctionnent aussi, bien sûr.

Windows natif (PowerShell, Windows Terminal, invite de commandes)

Le collage presse-papiers d'une capture d'écran brute ne fonctionne pas sur Windows natif aujourd'hui. Win+Maj+S place l'image dans le presse-papiers, mais le gestionnaire Ctrl+V de Claude Code ne la récupère pas. C'est suivi dans la demande de fonctionnalité ouverte #26679, toujours ouverte en juin 2026. Notez que cela concerne Windows natif (PowerShell, Windows Terminal, invite de commandes). Si vous exécutez Claude Code via WSL, c'est le correctif Alt+V de mai 2026 qui s'applique à la place, voir la section suivante.

Utilisez plutôt l'une de ces options :

• Glissez-déposez le fichier de capture d'écran depuis l'Explorateur de fichiers dans la fenêtre de Claude Code. Maintenez Maj pendant le glisser si le fichier se lance dans une autre application au lieu de se joindre.
• Enregistrez-la puis indiquez son chemin. Utilisez Win+Maj+S, enregistrez la capture d'écran dans un dossier, puis référencez son chemin dans votre prompt : Analyse ceci : C:\Users\you\Pictures\shot.png.
• Copiez le fichier, pas l'image. Dans l'Explorateur de fichiers, sélectionnez le fichier de capture d'écran enregistré et appuyez sur Ctrl+C, puis Ctrl+V dans Claude Code. Claude Code lit la référence de fichier et joint l'image. Cela fonctionne parce que ça contourne entièrement le chemin du presse-papiers en bitmap brut.

Anthropic a bien livré un raccourci officiel Alt+V pour le collage d'images dans la v2.1.157 (29 mai 2026), mais le journal des modifications limite ce correctif à WSL et au collage de capture d'écran sur Windows 11, pas au collage presse-papiers brut sur PowerShell natif ou l'invite de commandes, où le ticket #26679 reste ouvert. Si vous êtes sur Windows natif, considérez le glisser-déposer ou un chemin de fichier comme la réponse fiable, et n'utilisez Alt+V qu'une fois que vous êtes sous WSL.

Windows avec WSL

WSL était l'endroit où le collage d'images dans Claude Code cassait le plus souvent, et cela a changé fin mai 2026. La cause profonde, documentée dans le ticket GitHub #25935, était simple : Windows copie les images dans le presse-papiers au format BMP, WSLg transmet ce BMP tel quel via le presse-papiers Wayland, et les anciennes versions de Claude Code n'acceptaient pas le BMP, donc le collage ne faisait silencieusement rien.

Le correctif est arrivé dans la v2.1.157 (29 mai 2026), que le journal des modifications décrit comme « correction du collage d'image (raccourci alt+v), collage de capture d'écran sur Windows 11, et ajout de la prise en charge du glisser d'images depuis l'Explorateur Windows ». Donc sur une version actuelle, le chemin le plus rapide est de copier votre capture d'écran dans le presse-papiers et d'appuyer sur Alt+V dans Claude Code, pas Ctrl+V. Assurez-vous d'abord d'être sur la dernière version avec claude update, puisque cela ne fonctionne qu'à partir de la v2.1.157.

Si vous êtes bloqué sur une ancienne version ou qu'Alt+V se comporte encore mal sur votre installation, vous avez trois solutions de repli fiables :

• Utilisez un chemin de fichier comme dans la méthode 3. Enregistrez votre capture d'écran dans C:\Users\me\Pictures\shot.png, puis référencez-la comme /mnt/c/Users/me/Pictures/shot.png dans Claude Code.
• Convertissez le presse-papiers via PowerShell, ce qui vous permet d'enregistrer l'image du presse-papiers Windows dans un fichier PNG à transmettre ensuite à Claude Code : powershell.exe -Command "(Get-Clipboard -Format Image).Save('shot.png')".
• Installez l'extension VS Code Claude Code Image Paste (WSL), une extension communautaire qui récupère le presse-papiers Windows, convertit l'image en PNG, l'enregistre dans votre projet, et colle automatiquement le chemin dans le terminal de Claude Code.

Si vous exécutez Claude Code via Cursor ou le terminal intégré de VS Code, l'extension est la solution la plus fluide sur les anciennes versions. Depuis un terminal WSL classique sur une version actuelle, Alt+V est désormais la voie la plus rapide, avec la méthode du chemin de fichier comme solution de repli fiable. Curieux des forfaits de Cursor ? Notre détail des tarifs Cursor couvre tous les niveaux.

Linux

Sur la plupart des terminaux modernes (Konsole, GNOME Terminal récent, Kitty, Alacritty), le collage d'une image du presse-papiers avec Ctrl+V fonctionne. Sur des terminaux plus anciens ou minimalistes comme xterm, urxvt, ou les framebuffers Linux, le collage d'images ne fonctionnera pas du tout et vous devrez vous rabattre sur les chemins de fichiers.

Votre outil de capture d'écran doit copier l'image dans le presse-papiers, pas seulement l'enregistrer sous forme de fichier. GNOME Screenshot propose l'option, Flameshot a un bouton « copier dans le presse-papiers », et Spectacle de KDE a la même chose.

Formats d'image pris en charge et limites

Claude Code accepte les quatre formats web standards et rejette tout le reste. Savoir quel format envoyer vous épargne la boucle de débogage de l'échec silencieux, où Claude Code semble ignorer votre image parce qu'il n'a tout simplement pas pu l'analyser au départ.

Non pris en charge : BMP, TIFF, SVG. Si vous collez l'un de ces formats, l'image est silencieusement rejetée. Convertissez-la d'abord en PNG.

Les limites strictes à garder en tête :

• 5 Mo par image dans Claude Code en local
• 8000 x 8000 pixels de résolution maximale par image
• 100 images par requête maximum
• Si vous envoyez plus de 20 images à la fois, chacune est plafonnée à 2000 x 2000 pixels

Une image de 1000 x 1000 pixels coûte environ 1334 tokens de contexte. C'est assez peu cher pour être utilisé librement, mais dix captures d'écran en pleine résolution dans un même prompt consommeront un vrai contexte.

Cas d'usage : que faire réellement avec des images dans Claude Code

Les méthodes ne servent à rien sans de bons prompts. Voici les quatre workflows les plus rentables que nous utilisons au quotidien.

Du design au code à partir d'une maquette. Déposez un export Figma ou une capture d'écran et demandez à Claude Code de le construire.

« Génère le composant React et les classes Tailwind qui correspondent à ce design : [Image #1] »

Débogage à partir d'une capture d'écran d'erreur. Collez directement une capture d'écran de stack trace ou de notification d'erreur. Plus rapide que de la retaper.

« Voici l'erreur que je vois dans la console de développement. Qu'est-ce qui la cause, et quel fichier dois-je regarder ? [Image #1] »

OCR à partir de captures d'écran. Extrayez le texte d'une image sans avoir à le retaper manuellement. Utile pour une sortie de terminal que vous ne pouvez pas copier.

« Extrais les valeurs de configuration de cette capture d'écran de notre panneau de paramètres de production dans un objet JSON : [Image #1] »

Revue de schémas et de diagrammes. Déposez un diagramme ER de base de données ou un croquis d'architecture et demandez des migrations ou une critique.

« Voici notre schéma Postgres actuel. Ajoute une table subscriptions avec les bonnes clés étrangères : [Image #1] »

Pour les sessions longues avec plusieurs images, envisagez de créer des skills Claude Code que vous pouvez construire vous-même pour automatiser la boucle capture d'écran-collage-prompt.

Dépannage : le collage d'image ne fonctionne pas

Si votre image ne se joint pas, parcourez cette liste de contrôle dans l'ordre. La plupart des échecs se résument à l'un de ces points.

Vérification de la plateforme. Êtes-vous sur Windows natif en train d'essayer de coller une capture d'écran brute du presse-papiers avec Ctrl+V ? Cela ne fonctionne toujours pas aujourd'hui (#26679). Enregistrez le fichier et glissez-le, ou collez le chemin. Sur WSL, le collage brut fonctionne désormais, mais uniquement avec Alt+V sur la v2.1.157 ou plus récente, donc lancez claude update avant de supposer que c'est cassé.

Vérification du format. Votre fichier est-il un JPEG, PNG, GIF ou WebP ? S'il s'agit d'un BMP, TIFF ou SVG, convertissez-le d'abord. Faites un clic droit dans Aperçu (Mac) ou Paint (Windows) et enregistrez au format PNG.

Vérification du raccourci. Sur Mac, utilisez-vous Ctrl+V, et non Cmd+V ? Cmd+V est intercepté par le terminal avant que Claude Code ne le voie.

Vérification du presse-papiers. Y a-t-il vraiment une image dans le presse-papiers, ou juste une référence de fichier ? Sur Mac, Cmd+Maj+4 (sans Ctrl) enregistre sur le disque. Utilisez Cmd+Ctrl+Maj+4 pour copier directement dans le presse-papiers.

Vérification de la version. Lancez claude --version et claude update. Le comportement de gestion des images a changé au fil des versions, et le collage sous WSL en particulier ne fonctionne qu'à partir de la v2.1.157 (29 mai 2026). Si vous rencontrez un bug qui casse la session, redémarrez Claude Code.

Solution de repli. Si rien d'autre ne fonctionne, glissez le fichier ou collez un chemin de fichier. Ces méthodes contournent toutes les couches du presse-papiers qui peuvent échouer.

Si vous avez aussi des soucis d'authentification dans votre terminal, notre correctif pour coller le code d'authentification dans Claude Code couvre une famille de problèmes de presse-papiers voisins que vous voudrez peut-être régler dans la même session.

Astuce de pro : ouvrir les images référencées par Claude

Quand Claude Code mentionne des images dans ses réponses sous forme de [Image #1], [Image #2], et ainsi de suite, celles-ci sont cliquables. Cmd+clic sur macOS ou Ctrl+clic sur Windows et Linux ouvre l'image référencée dans votre visionneuse d'images par défaut. Un moyen rapide de vérifier que Claude regarde bien la bonne chose dans une session à plusieurs images.

Évitez les casse-têtes du CLI : utilisez Fello AI sur Mac à la place

Si vous lisez ce guide parce que les bizarreries du presse-papiers et les contournements WSL vous épuisent, il existe un chemin plus rapide. Fello AI est une application Mac native qui vous donne Claude avec un envoi d'images qui fonctionne tout simplement. Pas de jeu entre Cmd+V et Ctrl+V, pas de script de conversion BMP, pas de danse enregistrer-puis-glisser. Vous déposez une capture d'écran dans le chat, posez votre question, et Claude répond.

Fello AI regroupe Claude, ChatGPT, Gemini, Grok et DeepSeek dans une seule application pour $9.99/mois. Un seul abonnement, tous les grands modèles, y compris DeepSeek que la plupart des applications de chat ignorent encore. La même capture d'écran qui vous aurait pris dix minutes à faire parvenir à Claude Code via un contournement prend deux secondes ici, et vous pouvez faire passer la même image par Claude, ChatGPT et Gemini l'un après l'autre pour comparer les réponses sans payer trois abonnements séparés. Pour une comparaison des forfaits propres à Claude Code, consultez notre guide des tarifs Claude Code. L'application affiche une note de 4,7 étoiles sur plus de 25 000 avis.

La gestion des images se comporte comme on l'attendrait d'une vraie application de bureau. Glissez depuis le Finder, collez avec Cmd+V, ou cliquez sur le bouton de pièce jointe. L'image va directement vers le modèle que vous avez sélectionné, avec la même capacité de vision de Claude que dans le CLI, sans aucun des contournements de ce guide. Pour les utilisateurs Mac qui veulent le raisonnement sur images de Claude sans se battre avec le terminal, c'est l'option la plus propre.

Conclusion

Trois méthodes officielles, mais seules deux fonctionnent de façon fiable sur toutes les plateformes : glisser-déposer un fichier, ou coller un chemin de fichier dans votre prompt. Le collage presse-papiers est réel aussi : les utilisateurs Mac appuient sur Ctrl+V, et les utilisateurs WSL appuient désormais sur Alt+V sur la v2.1.157 ou plus récente. Windows natif reste le seul irréductible, donc là, vous devriez d'abord enregistrer la capture d'écran sur le disque.

Pour tous ceux qui restent avec le CLI, mettez ce guide de côté pour la prochaine fois qu'un collage avale silencieusement votre capture d'écran. Les méthodes du glisser-déposer et du chemin de fichier vous sortiront de tous les pièges du presse-papiers que Claude Code peut vous tendre. Et si vous hésitez encore à savoir si le CLI vaut la peine d'être payant, notre guide sur les options gratuites et payantes de Claude Code détaille tous les chemins.

FAQ