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

Claude Code umí číst obrázky. Přiložte screenshot, vložte návrh UI nebo předejte graf a Claude ho analyzuje stejně jako kód. Háček je v tom, že vkládání ze schránky funguje spolehlivě na macOS, ale tiše selže na Windows a WSL, což je důvod, proč většina lidí skončí na Googlu.

Tento průvodce pokrývá všechny oficiální způsoby, jak dodat Claude Code obrázky, kde každý z nich skutečně funguje, čtyři obrazové formáty, které Claude Code přijímá, a vzorové příkazy, které ze screenshotu udělají funkční kód. Krátká odpověď, pokud chcete přeskočit ladění: přetáhněte soubor nebo vložte cestu k souboru do příkazu. Obojí funguje na každé platformě. Vkládání ze schránky je nejspolehlivější na macOS a od Claude Code v2.1.157 (květen 2026) nakonec funguje i na WSL pomocí vlastní klávesové zkratky.

Klíčová shrnutí

• Tři oficiální metody pro přidání obrázků do Claude Code: přetažení, kopírování a vkládání nebo cesta k souboru v příkazu.
• Přetažení a cesty k souborům fungují na každé platformě. Použijte je, pokud chcete metodu, která nikdy neselhává.
• Vkládání ze schránky pomocí Ctrl+V funguje spolehlivě pouze na macOS. Na nativním Windows raw obrázky ze schránky pořízené Snipping Tool tiše selžou (issue #26679, stále otevřené k červnu 2026). Na WSL vkládání dříve selhávalo, protože Windows přenáší obrázky jako BMP, ale v2.1.157 (29. května 2026) to opravil dedikovanou zkratkou Alt+V.
• Používejte Ctrl+V, nikdy Cmd+V, i na Macu, kde terminál zachytí Cmd+V ještě před tím, než ho Claude Code uvidí.
• Podporované formáty: JPEG, PNG, GIF, WebP. Max 5 MB na obrázek lokálně, až 100 obrázků na požadavek.

Vidí Claude Code obrázky?

Ano. Claude Code používá stejnou multimodální vizuální schopnost jako zbytek rodiny Claude, včetně Claude Opus 5 a Sonnet 5, takže umí číst screenshoty, diagramy, grafy, návrhy a jakýkoli jiný statický obrázek, který mu předáte. CLI pouze přidává vstupní vrstvu, která vám umožní soubor dodat.

Vizuální schopnosti jsou jedním z důvodů, proč je Claude Code užitečnější než starší asistenti jen pro kód. Ukažte Claude Code export z Figmy a napíše odpovídající HTML a CSS. Ukažte mu screenshot stack trace a dohledá chybu až k souboru. Pokud mu ukážete diagram databázového schématu, navrhne migraci.

V kombinaci s nejlepšími dovednostmi Claude Code promění obrázky CLI v rychlou smyčku pro práci design-to-code, která dříve vyžadovala chatovací okno a spoustu kliků. Stejná smyčka funguje i na mobilu, pokud použijete Claude Code na telefonu přes funkci Remote Control od Anthropic.

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

Podle oficiální dokumentace Anthropic existují přesně tři podporované způsoby, jak přidat obrázek do Claude Code. Dokumentace je staví naroveň, ale v praxi se jejich spolehlivost značně liší.

1. Přetáhněte soubor s obrázkem z Finderu, Průzkumníku nebo pracovní plochy do okna terminálu Claude Code. Funguje na každé platformě.
2. Uveďte cestu k souboru přímo v příkazu, například: Analyze this image: /Users/me/Desktop/error.png. Funguje na každé platformě.
3. Zkopírujte a vložte obrázek pomocí Ctrl+V (ne Cmd+V). Funguje spolehlivě pouze na macOS. Na Windows a WSL raw obrázky ze schránky tiše selžou.

Vyberte podle toho, co máte po ruce. Přetažení je nejrychlejší, když soubor už existuje na disku. Cesty k souborům se hodí pro skripty nebo prostředí, kde je práce se schránkou nespolehlivá. Vkládání ze schránky je nejrychlejší pro čerstvé screenshoty; použijte Ctrl+V na Macu a Alt+V na WSL (přidáno ve v2.1.157, květen 2026). Pokud jste na nativním Windows a chcete odeslat screenshot pořízený Win+Shift+S, nejprve ho uložte na disk a pak ho přetáhněte nebo zadejte cestu, protože raw vkládání ze schránky tam stále nefunguje.

Metoda 1: přetažení

Otevřete složku s obrázkem, klikněte a podržte soubor a přetáhněte ho do terminálu Claude Code. Pusťte a Claude Code připojí obrázek a čeká na váš příkaz.

Pokud se soubor otevře v nové záložce místo toho, aby se připojil ke Claude Code, podržte při přetahování Shift, abyste donutili terminál zacházet s přetaženým souborem jako s odkazem a ne spouštět systémový handler. Nejdůležitější je to v iTerm2, Windows Terminal a Warp, kde výchozí chování přetahování závisí na aplikaci.

Přetažení funguje spolehlivě na macOS a nativním Windows. Na Linuxu závisí na vašem desktopovém prostředí a emulátoru terminálu. Na WSL funguje pouze tehdy, když přetahujete z cesty, kterou vidí strana Linuxu, například /mnt/c/Users/..., ne z cesty dostupné jen na Windows.

Metoda 2: vkládání pomocí Ctrl+V (spolehlivě jen na macOS)

Tato metoda je spolehlivá na macOS a nespolehlivá všude jinde. Na Macu ji používejte, na Windows a WSL přejděte na přetažení nebo cesty k souborům.

Na Macu zachytí Cmd+Ctrl+Shift+4 oblast obrazovky přímo do schránky, samotné Cmd+Shift+4 ji uloží na plochu. Pak stiskněte Ctrl+V uvnitř Claude Code. Claude Code zobrazí zástupný symbol jako [Image #1] v příkazu a při odeslání připojí obrázek. Napište otázku za zástupný symbol a stiskněte Enter.

Největší chyba, kterou uživatelé Macu dělají: stisknutí Cmd+V. Cmd+V zachytí terminál před tím, než ho Claude Code uvidí, takže obrázek do CLI nikdy nedorazí. Používejte Ctrl+V.

Na nativním Windows zkopíruje Win+Shift+S screenshot do schránky, ale vložení do Claude Code pomocí Ctrl+V tiše nic neudělá. Jde o zdokumentované omezení sledované v GitHub feature request #26679 (podáno v únoru 2026, stále otevřené k červnu 2026). Uložte screenshot na disk a přetáhněte ho, nebo vložte cestu. Jeden vzor vkládání, který na Windows funguje: zkopírujte uložený soubor s obrázkem v Průzkumníku souborů pomocí Ctrl+C a vložte ho pomocí Ctrl+V. Claude Code přečte odkaz na soubor, nikoli raw bitmapu. Pokud spouštíte Claude Code pod WSL místo nativního Windows, máte nyní lepší možnost popsanou v sekci WSL níže.

Na Linuxu funguje vkládání obrázku ze schránky na některých terminálech (Konsole, Kitty, Alacritty) a selhává na jiných (xterm, gnome-terminal v některých konfiguracích). Berte to jako příležitostné, ne spolehlivé.

Metoda 3: cesta k souboru v příkazu

Nejnudnější metoda a jediná, která funguje všude. Napište cestu k obrázku přímo do příkazu jako součást zprávy:

Analyze this screenshot and tell me what's wrong: /Users/lenka/Desktop/login-bug.png

Nebo s relativní cestou z kořene projektu:

Compare this design to our current /src/components/Header.tsx: ./mockups/header-v2.png

Claude Code přečte soubor z disku a připojí ho ke zprávě před odesláním. Fungují absolutní i relativní cesty. Na WSL převeďte cesty Windows z C:\Users\me\file.png na /mnt/c/Users/me/file.png.

Nejčistší workflow je přidat obrázek přímo do složky projektu, na kterém pracujete, a pak na něj odkazovat relativní cestou. Uložte screenshot třeba jako ./screenshots/bug.png uvnitř repozitáře a pak Claude Code předejte příkaz Look at ./screenshots/bug.png and tell me what's broken. Claude Code ho přečte z disku jako jakýkoli jiný soubor v projektu, takže to funguje na každém OS a v každém terminálu, včetně WSL, kde je vkládání ze schránky rozbité. Je to také nejsnadnější vzor pro udržení pořádku v dlouhých sezeních, protože obrázek leží vedle kódu, který Claude upravuje, a složku můžete přidat do git-ignore.

Tato metoda je také jediný způsob, jak odesílat obrázky programově, například ze skriptu, který přenáší příkazy do CLI pomocí claude -p.

Metoda × spolehlivost operačního systému

Pokud chcete jednu metodu, která vždy funguje bez ohledu na terminál nebo OS, použijte cesty k souborům. Přetažení je těsně druhé. Vkládání raw obrázků ze schránky je teď pohodlné jen na Macu.

Jak přidat obrázky do Claude Code na každém OS

Každý operační systém má svá specifika. Zde je to, co skutečně funguje na každém z nich.

macOS

Dobrá platforma. Používejte Ctrl+V pro vkládání raw obrázků ze schránky, nikdy Cmd+V. Pro zachycení screenshotu přímo do schránky stiskněte Cmd+Ctrl+Shift+4 a vyberte oblast. Samotné Cmd+Shift+4 uloží na disk, což je špatná volba, pokud chcete vkládat.

iTerm2, Warp, WezTerm i výchozí macOS Terminal se pro vkládání v Claude Code chovají stejně. Terminál zachytí Cmd+V a spustí vlastní logiku paste-bufferu, která umí zpracovat jen text, nikoli obrázky, takže obrázek je zahozen dřív, než ho Claude Code stihne přečíst. Přechod na Ctrl+V to vyřeší.

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

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

Vkládání raw screenshotu ze schránky na nativním Windows dnes nefunguje. Win+Shift+S vloží obrázek do schránky, ale Ctrl+V handler Claude Code ho nezachytí. Toto je sledováno v otevřeném feature request #26679, stále otevřeném k červnu 2026. Toto se týká nativního Windows (PowerShell, Windows Terminal, příkazový řádek). Pokud spouštíte Claude Code přes WSL, platí oprava Alt+V z května 2026, viz následující sekce.

Místo toho použijte jednu z těchto možností:

• Přetáhněte soubor se screenshotem z Průzkumníku souborů do okna Claude Code. Podržte Shift při přetahování, pokud se soubor otevře v jiné aplikaci místo připojení.
• Uložte a zadejte cestu. Použijte Win+Shift+S, uložte screenshot do složky a pak v příkazu zadejte jeho cestu: Analyze this: C:\Users\you\Pictures\shot.png.
• Zkopírujte soubor, ne obrázek. V Průzkumníku souborů vyberte uložený soubor se screenshotem a stiskněte Ctrl+C, pak Ctrl+V uvnitř Claude Code. Claude Code přečte odkaz na soubor a připojí obrázek. Funguje to proto, že zcela obchází cestu raw-bitmap schránky.

Anthropic dodal oficiální klávesovou zkratku pro vkládání obrázků Alt+V ve v2.1.157 (29. května 2026), ale changelog omezuje tuto opravu na WSL a vkládání screenshotů na Windows 11, nikoli na raw vkládání ze schránky v nativním PowerShellu nebo příkazovém řádku, kde #26679 zůstává otevřené. Pokud jste na nativním Windows, spoléhejte na přetažení nebo cestu k souboru a Alt+V používejte až pod WSL.

Windows s WSL

WSL bývalo místem, kde vkládání obrázků v Claude Code nejčastěji selhávalo, a to se na konci května 2026 změnilo. Hlavní příčina, zdokumentovaná v GitHub issue #25935, byla přímočará: Windows kopíruje obrázky do schránky jako BMP, WSLg přenáší toto BMP beze změny přes schránku Wayland a starší verze Claude Code BMP nepřijímaly, takže vkládání tiše nic neudělalo.

Oprava přišla ve v2.1.157 (29. května 2026), kterou changelog popisuje jako „fixed image paste (alt+v keybinding), screenshot paste on Windows 11, and added support for dragging images from Windows Explorer." Na aktuální verzi je tedy nejrychlejší cestou zkopírovat screenshot do schránky a stisknout Alt+V uvnitř Claude Code, nikoli Ctrl+V. Nejprve se ujistěte, že máte nejnovější verzi pomocí claude update, protože to funguje jen na v2.1.157 a novějších.

Pokud jste uvázli na starší verzi nebo Alt+V u vás stále nefunguje správně, máte tři spolehlivé zálohy:

• Použijte cestu k souboru jako v Metodě 3. Uložte screenshot jako C:\Users\me\Pictures\shot.png a pak na něj odkazujte jako /mnt/c/Users/me/Pictures/shot.png uvnitř Claude Code.
• Převeďte schránku přes PowerShell, což vám umožní uložit obrázek ze schránky Windows jako PNG, který pak předáte Claude Code: powershell.exe -Command "(Get-Clipboard -Format Image).Save('shot.png')".
• Nainstalujte Claude Code Image Paste (WSL) VS Code extension, komunitní rozšíření, které vezme schránku Windows, převede obrázek na PNG, uloží ho do projektu a automaticky vloží cestu do terminálu Claude Code.

Pokud spouštíte Claude Code přes Cursor nebo integrovaný terminál VS Code, je rozšíření nejhladší opravou pro starší verze. Z prostého terminálu WSL na aktuální verzi je Alt+V nyní nejrychlejší cestou a cesta k souboru spolehlivou zálohou. Zajímá vás Cursor? Náš přehled cen Cursoru pokrývá každou úroveň.

Linux

Na většině moderních terminálů (Konsole, moderní GNOME Terminal, Kitty, Alacritty) funguje vkládání obrázku ze schránky pomocí Ctrl+V. Na starších nebo minimálních terminálech jako xterm, urxvt nebo linuxových frame bufferech vkládání obrázků vůbec nefunguje a musíte použít cesty k souborům.

Váš nástroj pro snímky obrazovky musí zkopírovat obrázek do schránky, nejen ho uložit jako soubor. GNOME Screenshot tuto možnost nabízí, Flameshot má tlačítko „kopírovat do schránky" a KDE Spectacle také.

Podporované formáty obrázků a limity

Claude Code přijímá čtyři standardní webové formáty a vše ostatní odmítá. Znalost správného formátu vás ušetří od smyčky ladění tiché chyby, kde Claude Code zdánlivě ignoruje váš obrázek, protože ho na začátku nemohl zparsovat.

Nepodporováno: BMP, TIFF, SVG. Pokud vložíte některý z nich, obrázek je tiše zahozen. Nejprve ho převeďte na PNG.

Pevné limity, které je dobré mít na paměti:

• 5 MB na obrázek v Claude Code lokálně
• 8 000 × 8 000 pixelů maximální rozlišení na obrázek
• 100 obrázků na požadavek maximálně
• Pokud pošlete více než 20 obrázků najednou, každý je omezen na 2 000 × 2 000 pixelů

Obrázek 1 000 × 1 000 pixelů stojí přibližně 1 334 tokenů kontextu. To je dost levné na volné používání, ale deset screenshotů v plném rozlišení v jednom příkazu sní pořádnou část kontextu.

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

Metody jsou bez dobrých příkazů k ničemu. Toto jsou čtyři nejvýkonnější pracovní postupy, které používáme každý den.

Design-to-code z návrhu. Přetáhněte export z Figmy nebo screenshot a požádejte Claude Code, aby ho sestavil.

„Generate the React component and Tailwind classes that match this design: [Image #1]"

Ladění pomocí screenshotu chyby. Vložte screenshot stack trace nebo chybové hlášení přímo. Rychlejší než psát ho ručně.

„Here's the error I'm seeing in the dev console. What's causing it and what file should I look at? [Image #1]"

OCR ze screenshotů. Vytáhněte text z obrázku bez ručního přepisování. Užitečné pro výstup terminálu, který nelze zkopírovat.

„Extract the configuration values from this screenshot of our prod settings panel into a JSON object: [Image #1]"

Přezkoumání schématu a diagramu. Přetáhněte ER diagram databáze nebo náčrt architektury a požádejte o migrace nebo kritiku.

„Here's our current Postgres schema. Add a subscriptions table with the right foreign keys: [Image #1]"

Pro dlouhá sezení s více obrázky zvažte dovednosti Claude Code, které si sami vytvoříte a které automatizují smyčku screenshot-vložení-příkaz.

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

Pokud se váš obrázek nepřipojí, projděte si tento kontrolní seznam v pořadí. Většina selhání je způsobena jednou z těchto věcí.

Kontrola platformy. Jste na nativním Windows a pokoušíte se vložit raw screenshot ze schránky pomocí Ctrl+V? To dnes stále nefunguje (#26679). Uložte soubor a přetáhněte ho, nebo vložte cestu. Na WSL raw vkládání funguje, ale pouze přes Alt+V na v2.1.157 nebo novějším, takže spusťte claude update, než předpokládáte, že je to rozbité.

Kontrola formátu. Je váš soubor JPEG, PNG, GIF nebo WebP? Pokud je BMP, TIFF nebo SVG, nejprve ho převeďte. Klikněte pravým tlačítkem v Preview (Mac) nebo Paintu (Windows) a uložte jako PNG.

Kontrola zkratky. Na Macu používáte Ctrl+V, ne Cmd+V? Cmd+V zachytí terminál před tím, než ho Claude Code uvidí.

Kontrola schránky. Je ve schránce skutečně obrázek, nebo jen odkaz na soubor? Na Macu ukládá Cmd+Shift+4 (bez Ctrl) na disk. Pro zkopírování přímo do schránky použijte Cmd+Ctrl+Shift+4.

Kontrola aktualizace. Spusťte claude --version a claude update. Chování při zpracování obrázků se mezi verzemi měnilo a vkládání na WSL zvláště funguje jen na v2.1.157 (29. května 2026) nebo novějším. Pokud narazíte na chybu, která přerušuje sezení, restartujte Claude Code.

Záloha. Pokud nic jiného nefunguje, přetáhněte soubor nebo vložte cestu k souboru. Tyto metody obcházejí každou vrstvu schránky, která může selhat.

Pokud také řešíte problémy s ověřením v terminálu, oprava Claude Code paste auth code pokrývá příbuznou skupinu problémů se schránkou, které možná chcete vyřešit ve stejném sezení.

Tip: otevírání obrázků, na které Claude odkazuje

Když Claude Code zmiňuje obrázky ve svých odpovědích jako [Image #1], [Image #2] a tak dále, jsou klikatelné. Cmd+Click na macOS nebo Ctrl+Click na Windows a Linuxu otevře odkazovaný obrázek ve výchozím prohlížeči obrázků. Rychlý způsob, jak ověřit, že Claude se dívá na to správné v sezení s více obrázky.

Přeskočte problémy s CLI: použijte Fello AI na Macu

Pokud čtete tohoto průvodce, protože vás unavují quirky schránky a WSL workaroundy, existuje rychlejší cesta. Fello AI je nativní aplikace pro Mac, která vám dá Claude s nahráváním obrázků, které prostě funguje. Žádné hry s Cmd+V vs Ctrl+V, žádné skripty pro konverzi BMP, žádná procedura „uložit soubor a přetáhnout". Přetáhnete screenshot do chatu, položíte otázku a Claude odpoví.

Fello AI sdružuje Claude, ChatGPT, Gemini, Grok a DeepSeek do jedné aplikace za $9.99/měsíc. Jedno předplatné, každý hlavní model, včetně DeepSeek, který většina chatovacích aplikací stále vynechává. Stejný screenshot, na jehož přesměrování do Claude Code byste přes workaround strávili deset minut, tady trvá dvě sekundy a můžete spustit stejný obrázek přes Claude, ChatGPT a Gemini za sebou a porovnat odpovědi bez placení tří oddělených předplatných. Pro srovnání vlastních plánů Claude Code si přečtěte náš průvodce cenami Claude Code. Aplikace má hodnocení 4,7 hvězdy napříč 25 000+ recenzemi.

Práce s obrázky se chová tak, jak byste od skutečné desktopové aplikace očekávali. Přetáhněte z Finderu, vložte pomocí Cmd+V nebo klikněte na tlačítko připojit. Obrázek jde přímo k vybranému modelu se stejnou vizuální schopností Claude, jakou máte v CLI, ale bez jediného workaroundu z tohoto průvodce. Pro uživatele Macu, kteří chtějí vizuální uvažování Claude bez boje s terminálem, je to nejčistší volba.

Závěr

Tři oficiální metody, ale pouze dvě fungují spolehlivě na každé platformě: přetáhněte soubor nebo vložte cestu k souboru do příkazu. Vkládání ze schránky je také reálné: uživatelé Macu stisknou Ctrl+V a uživatelé WSL nyní stisknou Alt+V na v2.1.157 nebo novějším. Nativní Windows je výjimkou, takže tam screenshot nejprve uložte na disk.

Pro všechny, kdo zůstávají u CLI, si záložte tohoto průvodce pro příště, kdy vkládání tiše pohltí váš screenshot. Metody přetažení a cesty k souboru vás dostanou z každého problému se schránkou, na který Claude Code narazí. A pokud ještě rozhodujete, zda se vyplatí za CLI platit, náš průvodce bezplatnými a placenými možnostmi Claude Code popisuje každou cestu.

FAQ