Images dans Claude Code : comment les coller, les importer et les utiliser sur tous les systèmes

Claude Code sait lire les images. Glissez une capture d’écran, collez une maquette d’interface ou donnez-lui un graphique, et Claude l’analyse comme il analyse du code. Le collage était longtemps le point faible, et c’est sous Windows qu’il cassait. Ce n’est plus le cas : Alt+V colle désormais les images sous Windows et WSL, Ctrl+V le fait sur macOS et Linux, et iTerm2 accepte aussi Cmd+V.

Ce guide couvre les trois méthodes officielles pour donner une image à Claude Code, le bon raccourci pour chaque plateforme, les captures d’écran (y compris celles que Claude prend lui-même), SSH, l’extension VS Code et l’application de bureau, les formats et les limites, et la raison pour laquelle Claude Code ne peut pas générer d’images. Chaque affirmation a été vérifiée dans la documentation d’Anthropic et dans le journal des modifications de Claude Code à la version 2.1.292 (octobre 2026).

Les points clés à retenir

• Trois méthodes officielles pour ajouter des images à Claude Code : le glisser-déposer, le collage depuis le presse-papiers ou un chemin de fichier dans votre prompt.
• Le raccourci de collage dépend de la plateforme : Ctrl+V sur macOS et Linux, Cmd+V fonctionne aussi dans iTerm2, et Alt+V sous Windows et WSL.
• Le collage sous Windows natif fonctionne désormais. La demande de fonctionnalité correspondante (ticket #26679) a été fermée comme terminée le 17 août 2026. Si Alt+V indique qu’aucune image n’a été trouvée, lancez claude update.
• En SSH, le collage ne peut pas fonctionner, car le presse-papiers reste sur votre propre ordinateur. Copiez le fichier sur le serveur avec scp et donnez le chemin à Claude.
• Claude lit JPEG, PNG, GIF et WebP. Claude Code convertit pour vous certains autres formats et réduit les images collées à 2 000 pixels sur le grand côté.
• Claude Code ne peut pas générer d’images. Il peut écrire du SVG ou du HTML, ou appeler un modèle d’images via un script ou un serveur MCP.

Claude Code peut-il voir les images ?

Oui. Claude Code repose sur les mêmes modèles que le reste de la famille Claude, dont Claude Opus 5.5 et Sonnet 5.5, et tous lisent les images. Captures d’écran, schémas, graphiques, maquettes et photos fonctionnent. Claude Code ajoute la couche de saisie qui transmet le fichier au modèle et enregistre sur le disque chaque image collée, si bien que Claude peut aussi l’ouvrir comme un fichier et la copier dans votre projet.

La vision est l’une des raisons pour lesquelles Claude Code est plus utile que les anciens assistants limités au code. Montrez-lui un export Figma et il écrit le HTML et le CSS correspondants. Montrez-lui une capture d’une stack trace et il remonte le bug jusqu’au fichier. Montrez-lui un schéma de base de données et il rédige la migration.

Associées aux meilleures skills Claude Code, les images font de la CLI une boucle rapide de la maquette au code, qui exigeait auparavant 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 grâce à la fonction Remote Control d’Anthropic.

Claude Code peut-il générer des images ?

Non. La documentation sur la vision d’Anthropic indique que Claude « est uniquement un modèle de compréhension d’images » et qu’il « ne peut pas générer, produire, modifier, manipuler ni créer d’images ». Claude Code repose sur ces mêmes modèles, la réponse est donc la même dans le terminal que dans l’application de chat. Notre guide pour savoir si Claude peut générer des images traite le côté chat.

Ce que Claude Code sait faire, c’est écrire du code qui produit une image : une icône SVG, une maquette en HTML et CSS, un graphique avec une bibliothèque de visualisation ou un script canvas. Pour les schémas, les icônes et les ébauches d’interface, c’est souvent mieux qu’une image, car le résultat est un texte modifiable qui vit dans votre dépôt.

Pour les photos et les illustrations, Claude Code doit appeler un modèle d’images exploité par quelqu’un d’autre. Il existe deux façons de le mettre en place :

• Un script. Demandez à Claude Code d’écrire et d’exécuter un petit script qui appelle une API d’images d’OpenAI ou de Google avec votre propre clé d’API, puis enregistre le résultat dans votre projet.
• Un serveur MCP. Connectez un serveur MCP qui propose un outil d’images. Depuis la v2.1.283, les images renvoyées par les outils MCP sont aussi enregistrées dans un fichier, pour que Claude puisse les déplacer là où votre code les attend.

Dans les deux cas, le fournisseur d’images vous facture séparément de votre forfait Claude.

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

La documentation officielle de Claude Code indique trois façons d’ajouter une image. Toutes les trois fonctionnent sur toutes les plateformes, à condition d’utiliser le bon raccourci pour la vôtre.

1. Glissez-déposez le fichier image depuis le Finder, l’Explorateur de fichiers ou le bureau dans la fenêtre de Claude Code.
2. Collez depuis le presse-papiers avec Ctrl+V, ou avec Alt+V sous Windows et WSL.
3. Donnez un chemin de fichier à Claude dans votre prompt, par exemple : Analyse cette image : /Users/me/Desktop/error.png.

Choisissez selon ce que vous avez sous la main. Le collage est le plus rapide pour une capture que vous venez de prendre. Le glisser-déposer est le plus rapide quand le fichier existe déjà. Un chemin de fichier convient aux scripts, aux sessions SSH et à tout ce qui est automatisé, car il ne passe jamais par le presse-papiers.

Méthode 1 : glisser-déposer

Ouvrez le dossier qui contient votre image, faites glisser le fichier sur la fenêtre de Claude Code et relâchez-le. Claude Code joint l’image, note sa provenance et attend votre prompt. Vous pouvez déposer plusieurs images à la fois.

Sous WSL, faire glisser des images depuis l’Explorateur de fichiers de Windows fonctionne depuis la v2.1.157 (29 mai 2026). Sous Linux, le glisser-déposer dépend de votre émulateur de terminal, gardez donc le chemin de fichier comme solution de secours. Dans l’extension VS Code, maintenez Maj enfoncée pendant que vous faites glisser un fichier dans la zone de saisie.

Méthode 2 : coller depuis le presse-papiers

Copiez une image, cliquez dans le prompt de Claude Code et appuyez sur le raccourci de collage. Claude Code insère une puce [Image #1] à la position du curseur. La puce reste là où vous la placez dans la phrase, vous pouvez donc écrire des prompts comme « fais ressembler [Image #1] à [Image #2] ». Tapez la suite de votre question et appuyez sur Entrée.

C’est le raccourci qui piège les gens, car il change selon la plateforme :

L’erreur la plus fréquente sur Mac consiste à appuyer sur Cmd+V dans Terminal ou Warp. Cette touche appartient à l’application de terminal, qui colle du texte, et l’image n’arrive donc jamais à Claude Code. iTerm2 fait exception, car Claude Code y convertit Cmd+V en Ctrl+V.

Si votre terminal utilise le raccourci pour autre chose, changez-le. Lancez /keybindings pour ouvrir ~/.claude/keybindings.json et attribuez une autre touche à l’action chat:imagePaste. Claude Code prend en compte la modification sans redémarrage.

Méthode 3 : chemin de fichier dans votre prompt

La méthode la plus banale, et celle qui ne dépend jamais d’un presse-papiers ni d’un terminal. Tapez le chemin de votre image dans le prompt, dans votre message :

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

Ou avec un chemin relatif depuis la racine du projet :

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

Claude Code lit le fichier sur le disque et le joint. Les chemins absolus et relatifs fonctionnent tous les deux. Sous WSL, un chemin Windows comme C:\Users\me\file.png devient /mnt/c/Users/me/file.png.

Le plus propre est d’enregistrer les captures directement dans le projet, par exemple dans ./screenshots/bug.png, puis de demander : Regarde ./screenshots/bug.png et dis-moi ce qui est cassé. L’image se trouve à côté du code que Claude modifie, et vous pouvez exclure le dossier avec .gitignore.

C’est aussi la seule façon d’envoyer des images depuis un script, par exemple un script qui transmet des prompts à la CLI avec claude -p.

Méthode × plateforme en un coup d’œil

Si vous voulez une méthode qui fonctionne dans toutes les configurations, utilisez les chemins de fichier. Le collage est le plus rapide, à condition d’appuyer sur la bonne touche pour votre plateforme.

Comment ajouter des images à Claude Code sur chaque système

Chaque système a ses propres touches de capture et ses propres particularités. Voici ce qui fonctionne sur chacun.

macOS

Appuyez sur Cmd+Ctrl+Shift+4 et sélectionnez une zone pour copier une capture directement dans le presse-papiers, ou sur Cmd+Ctrl+Shift+3 pour tout l’écran. Appuyez ensuite sur Ctrl+V dans Claude Code (ou sur Cmd+V dans iTerm2). Cmd+Shift+4 sans Ctrl enregistre plutôt la capture sur le bureau, ce qui convient si vous préférez faire glisser le fichier.

macOS place les captures dans le presse-papiers au format TIFF, que Claude ne lit pas lui-même. Claude Code le convertit pour vous depuis la v2.1.0, vous n’avez donc jamais besoin d’enregistrer puis de réexporter d’abord.

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

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

Appuyez sur Win+Shift+S pour copier une capture dans le presse-papiers, puis sur Alt+V dans Claude Code. Sous Windows, Ctrl+V est le collage de texte du terminal et ne joint donc pas d’image.

Alt+V pour Windows existe depuis la v1.0.93, mais il ne trouvait pas toujours une capture fraîchement copiée avant un correctif dans la v2.1.141. Ce décalage explique pourquoi tant d’anciens guides, dont une version précédente de celui-ci, affirmaient que le collage était cassé sous Windows. La demande de fonctionnalité GitHub #26679 a été fermée comme terminée le 17 août 2026. Si Alt+V indique toujours qu’aucune image n’a été trouvée, mettez à jour avec claude update.

Vous pouvez aussi vous passer complètement du presse-papiers :

• Glissez-déposez le fichier de la capture depuis l’Explorateur de fichiers dans la fenêtre de Claude Code.
• Enregistrez-la et donnez le chemin. Enregistrez la capture depuis l’Outil Capture d’écran, puis faites-y référence dans votre prompt : Analyse ceci : C:\Users\you\Pictures\shot.png.

Windows avec WSL

C’est sous WSL que le collage d’images cassait le plus souvent. La cause, documentée dans le ticket GitHub #25935, était que Windows copie les images dans le presse-papiers au format BMP et que les anciennes versions de Claude Code n’acceptaient pas le BMP. Le problème a été corrigé dans la v2.1.47 (février 2026). Les versions suivantes ont ajouté une solution de repli PowerShell pour les presse-papiers que xclip et wl-paste ne savent pas lire (v2.1.136), puis le raccourci Alt+V, le collage de captures sous Windows 11 et le glisser-déposer depuis l’Explorateur de fichiers (v2.1.157, 29 mai 2026).

Avec une version récente, copiez votre capture avec Win+Shift+S et appuyez sur Alt+V. Ctrl+V est aussi attribué, mais de nombreux terminaux s’approprient Ctrl+V, c’est donc Alt+V qu’il faut retenir. Lancez d’abord claude update si votre version est ancienne.

Si le collage pose encore problème dans votre configuration, vous avez deux solutions fiables :

• Utilisez un chemin de fichier. Enregistrez la capture dans C:\Users\me\Pictures\shot.png, puis faites-y référence sous la forme /mnt/c/Users/me/Pictures/shot.png.
• Enregistrez le presse-papiers en PNG avec PowerShell, puis transmettez ce fichier à Claude Code : powershell.exe -Command "(Get-Clipboard -Format Image).Save('shot.png')".

Si vous utilisez Claude Code dans l’extension VS Code sous WSL, coller une capture dans la zone de chat joint l’image depuis la v2.1.267. Auparavant, elle pouvait insérer les octets bruts de l’image. Autre limite de WSL : l’intégration Chrome qui permet à Claude de prendre ses propres captures du navigateur (voir plus bas) ne fonctionne pas sous WSL. Les éditeurs de code avec IA vous intéressent ? Notre analyse des tarifs de Cursor couvre toutes les formules.

Linux

Claude Code lit le presse-papiers de Linux via xclip sous X11 ou wl-paste sous Wayland. Si Ctrl+V indique qu’il n’y a pas d’image dans le presse-papiers, installez l’outil adapté à votre session (xclip, ou le paquet wl-clipboard) et réessayez.

Votre outil de capture doit aussi copier l’image dans le presse-papiers, et pas seulement l’enregistrer. GNOME Screenshot propose cette option, Flameshot a un bouton « copier dans le presse-papiers », et Spectacle de KDE aussi. Dans un terminal minimal ou sur un serveur sans presse-papiers, utilisez les chemins de fichier.

Captures d’écran : collez-les, ou laissez Claude prendre les siennes

La plupart des images que l’on donne à Claude Code sont des captures d’écran. La voie la plus rapide sur chaque plateforme :

• macOS : Cmd+Ctrl+Shift+4, puis Ctrl+V (ou Cmd+V dans iTerm2).
• Windows : Win+Shift+S, puis Alt+V.
• WSL : Win+Shift+S, puis Alt+V.
• Linux : l’option de copie de votre outil de capture, puis Ctrl+V.

Pour le travail web, vous n’avez souvent même pas besoin de prendre la capture. Avec l’intégration Chrome, Claude Code pilote Chrome ou Edge via l’extension Claude in Chrome. Il ouvre votre application, lit les erreurs de la console et prend ses propres captures pour vérifier qu’une interface correspond à la maquette. Lancez-la avec claude --chrome. Il faut l’extension, un forfait Anthropic direct (Pro, Max, Team ou Enterprise) et une connexion avec /login, et elle ne fonctionne pas sous WSL. Demandez-lui « prends une capture de la page de paiement et enregistre-la sur le disque » : il écrit le fichier et vous donne le chemin (cette option fonctionne depuis la v2.1.211).

L’application de bureau de Claude Code fait la même chose dans son volet navigateur. Claude lance votre serveur de développement, y ouvre l’application, prend des captures, inspecte la page et corrige ce qu’il trouve. Les serveurs MCP d’automatisation du navigateur, comme celui de Playwright, sont une troisième option si vous voulez des captures dans votre propre environnement de test.

Claude Code en SSH et dans les sessions à distance

Le presse-papiers se trouve sur l’ordinateur devant vous. Quand Claude Code tourne sur une autre machine via SSH, il ne peut pas lire ce presse-papiers, et coller une image ne fonctionnera donc pas. Claude Code vous le signale et suggère scp, qui est la bonne solution. Copiez le fichier sur le serveur, puis donnez le chemin à Claude :

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

Demandez ensuite Regarde ./screenshots/shot.png depuis le dossier du projet sur le serveur. Si vous pilotez Claude Code depuis votre téléphone avec Remote Control, les images que vous importez depuis l’application mobile arrivent avec un chemin de fichier enregistré (depuis la v2.1.239), pour que Claude puisse les copier dans les fichiers qu’il crée.

Les images dans l’extension VS Code et l’application de bureau

Vous n’avez pas besoin de terminal du tout. Dans l’extension VS Code, collez une image du presse-papiers dans la zone de saisie, ou faites glisser un fichier en maintenant Maj. Depuis la v2.1.275, vous pouvez envoyer une image sans taper de texte.

Dans l’application de bureau de Claude Code, utilisez le bouton + à côté de la zone de saisie, ou glissez-déposez des fichiers dans le prompt. Elle accepte les images, les PDF et d’autres fichiers, ce qui en fait l’endroit le plus simple pour partager une capture de bug ou une maquette. Depuis la v2.1.275, les images que vous collez ou joignez dans l’application de bureau et dans VS Code sont enregistrées là où Claude peut les ouvrir sans demande d’autorisation.

Formats d’image pris en charge et limites

Claude lit quatre formats d’image. Envoyer le bon vous évite la boucle où Claude Code semble ignorer votre image parce qu’il ne pouvait tout simplement pas l’utiliser.

Les autres formats ne sont plus une impasse. Claude Code convertit le TIFF que les captures macOS placent dans le presse-papiers et le BMP que Windows transmet à WSL, et depuis la v2.1.285, il convertit les fichiers BMP, HEIC, HEIF, AVIF et TIFF lorsqu’il le peut. Le SVG est un cas à part : c’est du texte, donc Claude lit un fichier SVG comme du code et non comme une image. Si une image refuse toujours de se joindre, convertissez-la en PNG.

Les limites qui comptent :

• 2 000 pixels : Claude Code réduit les images collées pour que le grand côté fasse au plus 2 000 pixels, si bien qu’une capture énorme ne cassera pas votre session.
• 8 000 x 8 000 pixels, c’est le maximum que l’API Claude accepte pour une image.
• 10 Mo par image sur l’API d’Anthropic, et 5 Mo si votre Claude Code passe par Amazon Bedrock ou Google Cloud.
• 100 images par requête sur les modèles dotés d’une fenêtre de contexte de 200k tokens et 600 sur les autres. Au-delà de 20 images dans une requête, chaque image doit tenir dans 2 000 x 2 000 pixels.

Claude lit une image par tuiles de 28 x 28 pixels, et chaque tuile coûte un token. Une capture de 1 000 x 1 000 représente 1 296 tokens. Une capture de 1 920 x 1 080 représente environ 2 700 tokens sur Claude 4.7 et les modèles plus récents, qui lisent les images en plus haute résolution. C’est assez bon marché pour s’en servir librement, mais une longue session pleine de captures consomme du contexte : lancez /compact quand elle devient lourde.

Cas d’usage : ce que l’on fait vraiment avec des images dans Claude Code

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

De la maquette au code. Déposez un export Figma ou une capture 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’erreur. Collez une capture d’une stack trace ou d’un message d’erreur. Plus rapide que de tout retaper.

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

Texte extrait de captures. Récupérez le texte d’une image sans le retaper. Pratique pour un contenu que vous ne pouvez pas copier, comme un panneau de réglages.

« Extrais les valeurs de configuration de cette capture de notre panneau de réglages de prod dans un objet JSON : [Image #1] »

Revue de schémas et de diagrammes. Déposez un diagramme entité-relation 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 longues sessions avec beaucoup d’images, pensez aux skills Claude Code que vous créez vous-même pour automatiser la boucle capture, collage et prompt.

Dépannage : le collage d’images ne fonctionne pas

Si votre image ne se joint pas, suivez cette liste dans l’ordre. La plupart des échecs viennent de l’un de ces points.

Vérifiez le raccourci. Windows et WSL utilisent Alt+V. macOS utilise Ctrl+V, et Cmd+V seulement dans iTerm2. Linux utilise Ctrl+V.

Vérifiez le presse-papiers. Y a-t-il vraiment une image dans le presse-papiers, ou la capture a-t-elle fini dans un fichier ? Sur Mac, Cmd+Shift+4 sans Ctrl enregistre sur le disque. Utilisez Cmd+Ctrl+Shift+4 pour copier.

Vérifiez la version. Lancez claude --version et claude update. Le collage de captures avec Alt+V sous Windows a été corrigé dans la v2.1.141, et les correctifs WSL sont arrivés entre la v2.1.47 et la v2.1.157.

Vérifiez Linux. xclip (X11) ou wl-clipboard (Wayland) est-il installé ? Claude Code a besoin de l’un des deux pour lire le presse-papiers.

Vérifiez SSH. Claude Code tourne-t-il sur une machine distante ? Alors le collage ne peut pas fonctionner. Copiez le fichier avec scp et utilisez son chemin.

Vérifiez le format et la taille. Si le fichier est dans un format inhabituel, convertissez-le en PNG. S’il est trop lourd, Claude Code indique désormais la cause dans le message d’erreur et vous dit comment y remédier.

Solution de secours. Si rien d’autre ne marche, faites glisser le fichier ou collez son chemin. Les deux contournent toutes les couches du presse-papiers susceptibles d’échouer.

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

Astuce : ouvrir les images auxquelles Claude fait référence

Quand Claude Code mentionne des images dans ses réponses sous la forme [Image #1], [Image #2] et ainsi de suite, elles sont cliquables. Cmd+clic sur macOS ou Ctrl+clic sous Windows et Linux ouvre l’image dans votre visionneuse par défaut. C’est un moyen rapide de vérifier que Claude regarde la bonne image dans une session qui en contient beaucoup.

Finis les casse-têtes de la CLI : utilisez Fello AI sur Mac

Si vous êtes ici parce que vous voulez simplement que Claude regarde une image, le terminal est un détour. Fello AI est une application Mac native qui vous donne Claude avec un import d’images qui fonctionne, tout simplement. Pas de tableau de raccourcis, pas de copies via SSH, pas de conversion de format. Vous déposez une capture dans le chat, vous posez votre question, et Claude répond.

Fello AI réunit Claude, ChatGPT, Gemini, Grok et DeepSeek dans une seule application pour $9.99/mois. Vous pouvez soumettre la même capture à Claude, ChatGPT et Gemini l’un après l’autre et comparer les réponses, sans payer trois abonnements. Et contrairement à Claude Code, elle génère aussi des images : passez à un modèle d’images dans le même chat et transformez le plan de Claude en image. Pour les forfaits de Claude Code lui-même, consultez notre guide des tarifs de Claude Code. L’application affiche une note de 4,7 étoiles sur plus de 27 000 avis.

Les images fonctionnent comme on l’attend d’une application de bureau. Faites glisser depuis le Finder, collez avec Cmd+V ou cliquez sur le bouton de pièce jointe. L’image part vers le modèle que vous avez choisi, avec la même vision de Claude que dans la CLI. Pour les utilisateurs de Mac qui veulent l’analyse d’images de Claude sans le terminal, c’est l’option la plus simple.

Conclusion

Claude Code accepte les images de trois façons, et en 2026 toutes les trois fonctionnent sur toutes les plateformes : glisser-déposer un fichier, coller depuis le presse-papiers ou mettre un chemin de fichier dans votre prompt. La seule chose à retenir, c’est le raccourci : Ctrl+V sur macOS et Linux (Cmd+V dans iTerm2), Alt+V sous Windows et WSL. En SSH, copiez le fichier sur le serveur et utilisez son chemin.

Claude Code lit les images mais n’en crée pas : pour en obtenir, branchez une API d’images ou un serveur MCP, ou utilisez une application qui intègre un modèle d’images. Et si vous hésitez encore sur l’intérêt de la CLI, notre guide des options gratuites et payantes de Claude Code passe en revue toutes les possibilités.

FAQ