Claude Code obrázky: jak vkládat, nahrávat a používat na každém OS

Claude Code umí číst obrázky. Přetáhněte do něj snímek obrazovky, vložte mockup rozhraní nebo mu dejte graf a Claude ho rozebere stejně jako kód. Vkládání bylo dlouho slabým místem a nejčastěji selhávalo na Windows. To se změnilo: Alt+V teď vkládá obrázky na Windows i ve WSL, Ctrl+V to zvládá na macOS a Linuxu a iTerm2 přijímá i Cmd+V.

Tento průvodce ukazuje tři oficiální způsoby, jak dát Claude Code obrázek, správnou klávesovou zkratku pro každou platformu, snímky obrazovky (včetně těch, které si Claude pořídí sám), SSH, rozšíření pro VS Code a desktopovou aplikaci, formáty a limity a také to, proč Claude Code neumí obrázky generovat. Každý údaj je ověřený v dokumentaci Anthropicu a v changelogu Claude Code ve verzi 2.1.292 (říjen 2026).

Klíčová shrnutí

• Tři oficiální metody, jak přidat obrázky do Claude Code: přetažení, vložení ze schránky, nebo cesta k souboru v promptu.
• Zkratka pro vložení závisí na platformě: Ctrl+V na macOS a Linuxu, v iTerm2 funguje i Cmd+V a na Windows a ve WSL Alt+V.
• Vkládání na nativních Windows už funguje. Žádost o tuto funkci (issue #26679) byla 17. srpna 2026 uzavřena jako dokončená. Pokud Alt+V hlásí, že nenašlo žádný obrázek, spusťte claude update.
• Přes SSH vkládání fungovat nemůže, protože schránka zůstává na vašem počítači. Zkopírujte soubor na server pomocí scp a dejte Claudovi cestu.
• Claude čte JPEG, PNG, GIF a WebP. Claude Code za vás převede některé další formáty a vložené obrázky zmenší na 2000 pixelů na delší straně.
• Claude Code neumí generovat obrázky. Umí napsat SVG nebo HTML, nebo zavolat obrazový model přes skript či MCP server.

Vidí Claude Code obrázky?

Ano. Claude Code běží na stejných modelech jako zbytek rodiny Claude, včetně Claude Opus 5.5 a Sonnet 5.5, a všechny čtou obrázky. Fungují snímky obrazovky, diagramy, grafy, mockupy i fotky. Claude Code přidává vstupní vrstvu, která soubor doručí modelu, a každý vložený obrázek ukládá na disk, takže ho Claude může otevřít i jako soubor a zkopírovat do vašeho projektu.

Práce s obrazem je jedním z důvodů, proč je Claude Code užitečnější než starší asistenti, kteří rozuměli jen kódu. Ukažte mu export z Figmy a napíše odpovídající HTML a CSS. Ukažte mu snímek stack trace a dohledá chybu až k souboru. Ukažte mu diagram databázového schématu a navrhne migraci.

Spolu s nejlepšími skills pro Claude Code udělají obrázky z CLI rychlou smyčku od návrhu ke kódu, která dřív vyžadovala přepínání do chatovacího okna. Stejná smyčka funguje i v mobilu, pokud používáte Claude Code v telefonu přes funkci Remote Control od Anthropicu.

Umí Claude Code generovat obrázky?

Ne. Dokumentace Anthropicu k práci s obrazem uvádí, že Claude je „pouze model pro porozumění obrázkům“ a že obrázky „nemůže generovat, vytvářet, upravovat ani s nimi manipulovat“. Claude Code běží na stejných modelech, takže v terminálu platí stejná odpověď jako v chatovací aplikaci. Chatovou stránku věci rozebírá náš článek o tom, zda Claude umí generovat obrázky.

Claude Code ale umí napsat kód, který obrázek vytvoří: ikonu v SVG, mockup v HTML a CSS, graf z vizualizační knihovny nebo skript pro canvas. U diagramů, ikon a návrhů rozhraní je to často lepší než obrázek, protože výsledek je upravitelný text uložený ve vašem repozitáři.

U fotek a ilustrací musí Claude Code zavolat obrazový model, který provozuje někdo jiný. Nastavit to lze dvěma způsoby:

• Skript. Požádejte Claude Code, ať napíše a spustí malý skript, který s vaším vlastním API klíčem zavolá obrazové API od OpenAI nebo Googlu a výsledek uloží do projektu.
• MCP server. Připojte MCP server, který nabízí nástroj pro obrázky. Od verze 2.1.283 se obrázky vrácené nástroji MCP ukládají i do souboru, takže je Claude může přesunout tam, kde je váš kód čeká.

Obrazový poskytovatel vám v obou případech účtuje zvlášť, mimo předplatné Claude.

Jak přidat obrázky do Claude Code: 3 metody

Oficiální dokumentace Claude Code uvádí tři způsoby, jak přidat obrázek. Všechny tři fungují na každé platformě, pokud použijete správnou zkratku pro tu svou.

1. Přetáhněte soubor s obrázkem z Finderu, Průzkumníka souborů nebo z plochy do okna Claude Code.
2. Vložte ho ze schránky pomocí Ctrl+V, na Windows a ve WSL pomocí Alt+V.
3. Dejte Claudovi cestu k souboru v promptu, například: Analyzuj tento obrázek: /Users/me/Desktop/error.png.

Vybírejte podle toho, co máte po ruce. Vložení je nejrychlejší pro čerstvě pořízený snímek obrazovky. Přetažení je nejrychlejší, když soubor už existuje. Cesta k souboru se hodí pro skripty, SSH relace a vše automatizované, protože se vůbec nedotkne schránky.

Metoda 1: přetažení

Otevřete složku s obrázkem, přetáhněte soubor do okna Claude Code a pusťte ho. Claude Code obrázek připojí, poznamená si, odkud pochází, a čeká na váš prompt. Přetáhnout můžete i několik obrázků naráz.

Ve WSL funguje přetahování obrázků z Průzkumníka souborů ve Windows od verze 2.1.157 (29. května 2026). Na Linuxu přetažení závisí na emulátoru terminálu, takže tam mějte jako zálohu cestu k souboru. V rozšíření pro VS Code při přetahování souboru do pole pro prompt držte Shift.

Metoda 2: vložení ze schránky

Zkopírujte obrázek, klikněte do promptu Claude Code a stiskněte zkratku pro vložení. Claude Code vloží na pozici kurzoru štítek [Image #1]. Štítek zůstane ve větě tam, kam ho umístíte, takže můžete psát prompty jako „ať [Image #1] vypadá jako [Image #2]“. Dopište zbytek dotazu a stiskněte Enter.

Kámen úrazu je zkratka, protože se liší podle platformy:

Nejčastější chyba na Macu je stisknout Cmd+V v Terminálu nebo ve Warpu. Tahle klávesa patří aplikaci terminálu, která vkládá text, takže se obrázek do Claude Code vůbec nedostane. Výjimkou je iTerm2, kde Claude Code mapuje Cmd+V na Ctrl+V.

Pokud váš terminál používá zkratku k něčemu jinému, změňte ji. Spusťte /keybindings, tím otevřete ~/.claude/keybindings.json, a akci chat:imagePaste přiřaďte jinou klávesu. Claude Code změnu převezme bez restartu.

Metoda 3: cesta k souboru v promptu

Nejnudnější metoda a jediná, která nikdy nezávisí na schránce ani na terminálu. Napište cestu k obrázku do promptu jako součást zprávy:

Analyzuj tento snímek obrazovky a řekni mi, co je špatně: /Users/lenka/Desktop/login-bug.png

Nebo s relativní cestou z kořene projektu:

Porovnej tento návrh s naším aktuálním /src/components/Header.tsx: ./mockups/header-v2.png

Claude Code načte soubor z disku a připojí ho. Fungují absolutní i relativní cesty. Ve WSL se z cesty ve Windows jako C:\Users\me\file.png stane /mnt/c/Users/me/file.png.

Nejúhlednější postup je ukládat snímky obrazovky rovnou do projektu, například do ./screenshots/bug.png, a pak napsat prompt Podívej se na ./screenshots/bug.png a řekni mi, co je rozbité. Obrázek leží vedle kódu, který Claude upravuje, a složku můžete vyřadit přes .gitignore.

Je to také jediný způsob, jak posílat obrázky ze skriptu, například z takového, který předává prompty do CLI přes claude -p.

Metoda × platforma v přehledu

Pokud chcete metodu, která funguje v jakémkoli nastavení, používejte cesty k souborům. Vložení je nejrychlejší, pokud stisknete správnou klávesu pro svou platformu.

Jak přidat obrázky do Claude Code na jednotlivých systémech

Každý systém má vlastní klávesy pro snímky obrazovky a vlastní zvláštnosti. Tohle funguje na každém z nich.

macOS

Stiskněte Cmd+Ctrl+Shift+4 a vyberte oblast, tím snímek obrazovky zkopírujete rovnou do schránky, případně Cmd+Ctrl+Shift+3 pro celou obrazovku. Pak v Claude Code stiskněte Ctrl+V (nebo Cmd+V v iTerm2). Samotné Cmd+Shift+4 bez Ctrl uloží snímek na plochu, což se hodí, pokud soubor raději přetáhnete.

macOS dává snímky obrazovky do schránky ve formátu TIFF, který Claude sám nečte. Claude Code ho za vás převede, a to už od verze 2.1.0, takže nikdy nemusíte nejdřív ukládat a znovu exportovat.

Přetažení z Finderu a cesty k souborům v promptu samozřejmě fungují také.

Nativní Windows (PowerShell, Windows Terminal, příkazový řádek)

Stiskněte Win+Shift+S, tím zkopírujete snímek obrazovky do schránky, a pak v Claude Code stiskněte Alt+V. Ctrl+V je na Windows vkládání textu v terminálu, takže obrázek nepřipojí.

Alt+V pro Windows přibylo už ve verzi 1.0.93, ale čerstvě zkopírovaný snímek obrazovky ve schránce spolehlivě našlo až po opravě ve verzi 2.1.141. Právě kvůli této mezeře tolik starších návodů, včetně dřívější verze tohoto, tvrdilo, že vkládání na Windows nefunguje. Žádost o funkci na GitHubu #26679 byla 17. srpna 2026 uzavřena jako dokončená. Pokud Alt+V stále hlásí, že nenašlo žádný obrázek, aktualizujte přes claude update.

Schránku můžete také úplně vynechat:

• Přetáhněte soubor se snímkem obrazovky z Průzkumníka souborů do okna Claude Code.
• Uložte ho a zadejte cestu. Uložte snímek z Výstřižků a odkažte na něj v promptu: Analyzuj tohle: C:\Users\you\Pictures\shot.png.

Windows s WSL

Ve WSL vkládání obrázků dřív selhávalo nejčastěji. Příčina, zdokumentovaná v issue #25935 na GitHubu, byla v tom, že Windows kopírují obrázky do schránky jako BMP a starší verze Claude Code formát BMP nepřijímaly. Opraveno to bylo ve verzi 2.1.47 (únor 2026). Pozdější verze přidaly záložní řešení přes PowerShell pro schránky, které xclip a wl-paste neumí přečíst (2.1.136), a potom zkratku Alt+V, vkládání snímků obrazovky ve Windows 11 a přetahování z Průzkumníka souborů (2.1.157, 29. května 2026).

S aktuální verzí zkopírujte snímek přes Win+Shift+S a stiskněte Alt+V. Přiřazené je i Ctrl+V, ale mnoho terminálů si Ctrl+V bere pro sebe, takže si zapamatujte Alt+V. Pokud máte starou verzi, spusťte nejdřív claude update.

Pokud vkládání ve vašem nastavení pořád zlobí, máte dvě spolehlivé alternativy:

• Použijte cestu k souboru. Uložte snímek do C:\Users\me\Pictures\shot.png a odkažte na něj jako /mnt/c/Users/me/Pictures/shot.png.
• Uložte schránku do PNG přes PowerShell a tento soubor předejte Claude Code: powershell.exe -Command "(Get-Clipboard -Format Image).Save('shot.png')".

Pokud používáte Claude Code v rozšíření pro VS Code ve WSL, vložení snímku obrazovky do pole chatu od verze 2.1.267 obrázek připojí. Předtím mohlo vložit surová data obrázku. Ještě jedno omezení WSL: integrace s Chromem, díky které si Claude pořizuje vlastní snímky prohlížeče (viz níže), ve WSL neběží. Zajímají vás editory kódu s AI? Náš přehled cen Cursoru pokrývá všechny tarify.

Linux

Claude Code čte linuxovou schránku přes xclip na X11 nebo wl-paste na Waylandu. Pokud Ctrl+V hlásí, že ve schránce není žádný obrázek, nainstalujte nástroj, který používá vaše relace (xclip, nebo balíček wl-clipboard), a zkuste to znovu.

Váš nástroj na snímky obrazovky musí obrázek také zkopírovat do schránky, nejen uložit. GNOME Screenshot tu možnost má, Flameshot má tlačítko „kopírovat do schránky“ a Spectacle od KDE také. V minimálním terminálu nebo na serveru úplně bez schránky použijte cesty k souborům.

Snímky obrazovky: vložte je, nebo je nechte pořídit Clauda

Většina obrázků, které lidé dávají Claude Code, jsou snímky obrazovky. Nejrychlejší cesta na každé platformě:

• macOS: Cmd+Ctrl+Shift+4, pak Ctrl+V (nebo Cmd+V v iTerm2).
• Windows: Win+Shift+S, pak Alt+V.
• WSL: Win+Shift+S, pak Alt+V.
• Linux: volba kopírování ve vašem nástroji na snímky, pak Ctrl+V.

Při práci na webu často snímek vůbec pořizovat nemusíte. S integrací s Chromem ovládá Claude Code Chrome nebo Edge přes rozšíření Claude in Chrome. Otevře vaši aplikaci, přečte chyby z konzole a pořídí si vlastní snímky, aby ověřil, že rozhraní odpovídá mockupu. Spustíte ji příkazem claude --chrome. Potřebujete rozšíření, přímé předplatné Anthropicu (Pro, Max, Team nebo Enterprise) a přihlášení přes /login, a ve WSL neběží. Požádejte ho „pořiď snímek stránky pokladny a ulož ho na disk“ a on soubor zapíše a řekne vám cestu (tahle možnost funguje od verze 2.1.211).

Desktopová aplikace Claude Code dělá totéž ve svém panelu prohlížeče. Claude spustí váš vývojový server, otevře v něm aplikaci, pořídí snímky, prohlédne stránku a opraví, co najde. Třetí možností jsou MCP servery pro automatizaci prohlížeče, například ten od Playwrightu, pokud chcete snímky ve vlastním testovacím prostředí.

Claude Code přes SSH a ve vzdálených relacích

Schránka je na počítači, u kterého sedíte. Když Claude Code běží na jiném stroji přes SSH, tuto schránku přečíst nemůže, takže vložení obrázku fungovat nebude. Claude Code vás na to upozorní a navrhne scp, což je správné řešení. Zkopírujte soubor na server a dejte Claudovi cestu:

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

Pak ve složce projektu na serveru napište prompt Podívej se na ./screenshots/shot.png. Pokud Claude Code ovládáte z telefonu přes Remote Control, obrázky nahrané z mobilní aplikace přicházejí s uloženou cestou k souboru (od verze 2.1.239), takže je Claude může kopírovat do souborů, které vytváří.

Obrázky v rozšíření pro VS Code a v desktopové aplikaci

Terminál vůbec nepotřebujete. V rozšíření pro VS Code vložte obrázek ze schránky do pole pro prompt, nebo do něj přetáhněte soubor se stisknutým Shiftem. Od verze 2.1.275 můžete obrázek poslat i bez textu.

V desktopové aplikaci Claude Code použijte tlačítko + vedle pole pro prompt, nebo soubory do promptu přetáhněte. Přijímá obrázky, PDF i další soubory, takže je to nejjednodušší místo, kde sdílet snímek chyby nebo návrh rozhraní. Od verze 2.1.275 se obrázky, které vložíte nebo připojíte v desktopové aplikaci a ve VS Code, ukládají tam, kde je Claude může otevřít bez žádosti o oprávnění.

Podporované formáty obrázků a limity

Claude čte čtyři formáty obrázků. Když pošlete ten správný, ušetříte si kolečko, kdy se zdá, že Claude Code váš obrázek ignoruje, protože ho vůbec nemohl použít.

Ostatní formáty už nejsou slepá ulička. Claude Code převádí TIFF, který do schránky ukládají snímky obrazovky v macOS, i BMP, které Windows předávají WSL, a od verze 2.1.285 převádí soubory BMP, HEIC, HEIF, AVIF a TIFF, kde to jde. SVG je jiný případ: je to text, takže ho Claude čte jako kód, ne jako obrázek. Pokud se obrázek pořád nepřipojí, převeďte ho do PNG.

Limity, na kterých záleží:

• 2000 pixelů: Claude Code vložené obrázky zmenšuje tak, aby delší strana měřila nejvýš 2000 pixelů, takže obří snímek obrazovky vaši relaci nerozbije.
• 8000 x 8000 pixelů je maximum, které Claude API přijme pro jeden obrázek.
• 10 MB na obrázek přes vlastní API Anthropicu a 5 MB, pokud váš Claude Code běží přes Amazon Bedrock nebo Google Cloud.
• 100 obrázků na požadavek u modelů s kontextovým oknem 200k tokenů a 600 u ostatních. Při více než 20 obrázcích v jednom požadavku se každý musí vejít do 2000 x 2000 pixelů.

Claude čte obrázek po dlaždicích 28 x 28 pixelů a každá dlaždice stojí jeden token. Snímek obrazovky 1000 x 1000 vyjde na 1296 tokenů. Snímek 1920 x 1080 vyjde zhruba na 2700 tokenů u modelů Claude 4.7 a novějších, které čtou obrázky ve vyšším rozlišení. To je dost levné na volné používání, ale dlouhá relace plná snímků obrazovky ukusuje kontext, takže když zhoustne, spusťte /compact.

Případy použití: co s obrázky v Claude Code opravdu dělat

Bez dobrých promptů jsou metody k ničemu. Tohle jsou čtyři nejvýnosnější pracovní postupy, které denně používáme.

Od mockupu ke kódu. Vložte export z Figmy nebo snímek obrazovky a požádejte Claude Code, ať ho postaví.

„Vygeneruj komponentu v Reactu a třídy Tailwindu, které odpovídají tomuto návrhu: [Image #1]“

Ladění podle snímku chyby. Vložte snímek stack trace nebo chybového hlášení. Rychlejší než přepisování.

„Tohle je chyba, kterou vidím ve vývojářské konzoli. Co ji způsobuje a na který soubor se mám podívat? [Image #1]“

Text ze snímků obrazovky. Vytáhněte text z obrázku bez přepisování. Hodí se pro obsah, který nejde zkopírovat, třeba panel nastavení.

„Vytáhni konfigurační hodnoty z tohoto snímku našeho produkčního panelu nastavení do objektu JSON: [Image #1]“

Kontrola schémat a diagramů. Vložte ER diagram databáze nebo náčrt architektury a požádejte o migrace nebo kritiku.

„Tohle je naše aktuální schéma v Postgresu. Přidej tabulku subscriptions se správnými cizími klíči: [Image #1]“

Pro dlouhé relace s mnoha obrázky zvažte vlastní skills pro Claude Code, které smyčku snímek, vložení a prompt zautomatizují.

Řešení problémů: vkládání obrázků nefunguje

Pokud se obrázek nepřipojí, projděte tento seznam popořadě. Většina chyb je jedna z těchto.

Zkontrolujte zkratku. Windows a WSL používají Alt+V. macOS používá Ctrl+V, Cmd+V jen v iTerm2. Linux používá Ctrl+V.

Zkontrolujte schránku. Je ve schránce opravdu obrázek, nebo snímek skončil v souboru? Na Macu Cmd+Shift+4 bez Ctrl ukládá na disk. Pro kopírování použijte Cmd+Ctrl+Shift+4.

Zkontrolujte verzi. Spusťte claude --version a claude update. Vkládání snímků přes Alt+V na Windows bylo opraveno ve verzi 2.1.141 a opravy pro WSL přišly mezi verzemi 2.1.47 a 2.1.157.

Zkontrolujte Linux. Máte nainstalovaný xclip (X11) nebo wl-clipboard (Wayland)? Claude Code potřebuje jeden z nich, aby schránku přečetl.

Zkontrolujte SSH. Běží Claude Code na vzdáleném stroji? Pak vkládání fungovat nemůže. Zkopírujte soubor přes scp a použijte jeho cestu.

Zkontrolujte formát a velikost. Pokud má soubor neobvyklý formát, převeďte ho do PNG. Pokud je příliš velký, Claude Code dnes v chybové hlášce uvede příčinu a poradí, jak ji odstranit.

Záloha. Pokud nic jiného nepomůže, soubor přetáhněte nebo vložte jeho cestu. Obojí obejde všechny vrstvy schránky, které mohou selhat.

Pokud vás v terminálu trápí i přihlášení, oprava vkládání přihlašovacího kódu do Claude Code řeší příbuzné problémy se schránkou, které se vyplatí vyřešit v téže relaci.

Tip: otevírejte obrázky, na které Claude odkazuje

Když Claude Code v odpovědích zmiňuje obrázky jako [Image #1], [Image #2] a tak dále, dá se na ně kliknout. Cmd+klik na macOS nebo Ctrl+klik na Windows a Linuxu otevře obrázek ve výchozím prohlížeči. Je to rychlý způsob, jak v relaci s mnoha obrázky ověřit, že se Claude dívá na ten správný.

Bez potíží s CLI: použijte Fello AI na Macu

Pokud jste tu proto, že chcete, aby se Claude jen podíval na obrázek, je terminál zbytečná oklika. Fello AI je nativní aplikace pro Mac, která vám dá Clauda s nahráváním obrázků, které prostě funguje. Žádná tabulka zkratek, žádné kopírování přes SSH, žádné převody formátů. Přetáhnete snímek obrazovky do chatu, položíte otázku a Claude odpoví.

Fello AI spojuje Claude, ChatGPT, Gemini, Grok a DeepSeek v jedné aplikaci za $9.99/měsíc. Stejný snímek můžete projet Claudem, ChatGPT a Gemini hned po sobě a porovnat odpovědi, aniž byste platili tři předplatná. A na rozdíl od Claude Code umí i generovat obrázky: ve stejném chatu přepněte na obrazový model a z Claudova plánu udělejte obrázek. Tarify samotného Claude Code najdete v našem průvodci cenami Claude Code. Aplikace má hodnocení 4,7 hvězdičky z více než 27 000 recenzí.

Obrázky fungují tak, jak od desktopové aplikace čekáte. Přetáhněte je z Finderu, vložte přes Cmd+V nebo klikněte na tlačítko pro přílohu. Obrázek jde do modelu, který máte vybraný, se stejnou schopností Clauda pracovat s obrazem jako v CLI. Pro uživatele Macu, kteří chtějí Claudovu analýzu obrázků bez terminálu, je to nejčistší volba.

Závěr

Claude Code přijímá obrázky třemi způsoby a v roce 2026 fungují všechny tři na každé platformě: přetažení souboru, vložení ze schránky, nebo cesta k souboru v promptu. Zapamatovat si stačí zkratku: Ctrl+V na macOS a Linuxu (Cmd+V v iTerm2), Alt+V na Windows a ve WSL. Přes SSH soubor zkopírujte na server a použijte jeho cestu.

Claude Code obrázky čte, ale nevytváří, takže pro jejich tvorbu připojte obrazové API nebo MCP server, případně použijte aplikaci s vestavěným obrazovým modelem. A pokud se ještě rozhodujete, jestli se vám CLI vyplatí, náš průvodce bezplatnými a placenými možnostmi Claude Code projde všechny cesty.

Časté dotazy