Come incollare uno screenshot in Claude Code
La risposta breve: su Windows, non fare affidamento su Ctrl+VUsa il tuo tasto di incollamento dell'immagine di Claude Code, trascina il file di immagine nel terminale o fai riferimento al file per percorso nel tuo prompt. Questa pagina copre tutti e tre, perché il normale incollamento degli appunti continua a scomparire e come dimensionare lo screenshot in modo che non costi mille token.
Vuoi mostrare a Claude Code uno screenshot — una finestra di dialogo di errore, un layout interrotto, una cornice di design — e digitare richiederebbe un'eternità. Il problema è che il terminale non è una chat box: lo stesso Ctrl+V — che incolla un'immagine altrove in Windows frequentemente non fa nulla qui, specialmente all'interno di WSL. L'immagine non è persa; il terminale semplicemente non l'ha mai ricevuta. La soluzione è usare un percorso che non dipenda dal fragile percorso bitmap-negli-appunti e ce ne sono tre affidabili.
Questa è una guida pubblicata da Maxisnap. Maxisnap crea uno strumento di screenshot Windows la cui esportazione è costruita esattamente per questo passaggio, quindi appare dove è rilevante — ma i percorsi di seguito funzionano con qualsiasi screenshot, da qualsiasi strumento.
Quali sono i tre modi per dare a Claude Code un'immagine?
Claude Code accetta un'immagine in tre modi e su Windows non sono ugualmente affidabili. In ordine approssimativo di affidabilità:
| Percorso | Come | Affidabilità su Windows / WSL |
|---|---|---|
| Percorso file nel prompt | Digita o incolla il percorso del file dell'immagine salvata, ad es. C:\Users\you\shot.png— nel tuo messaggio. | Più affidabile — nessun appunto coinvolto |
| Trascina il file in | Trascina il file di immagine da Esplora file (o direttamente da uno strumento di cattura) sulla finestra del terminale. | Affidabile quando il terminale supporta la goccia |
| Tasto di incollamento | Usa il tasto di incollamento dedicato di Claude Code (le versioni recenti usano Alt+V — per le immagini). | Funziona in molti setup; il fallback è un percorso di file |
| Il riflesso che tutti provano per primo. | Spesso silenziosamente non fa nulla nel terminale |
I tasti di scelta rapida di Claude Code cambiano tra le versioni — consulta la sua documentazione corrente per il tasto di incollamento esatto. Il percorso del file è quello che continua a funzionare indipendentemente.
Perché Ctrl+V non fa nulla nel terminale?
Perché incollare un'immagine in un terminale è un'operazione diversa e meno supportata rispetto all'incollamento di testo. Quando copi uno screenshot, Windows mette una bitmap negli appunti. La maggior parte dei terminali gestisce solo l'incollamento di testo e ignora silenziosamente una bitmap, quindi non appare nulla. All'interno di WSL il divario è ancora più ampio: il lato Linux del terminale non vede affatto la bitmap degli appunti di Windows, quindi anche uno strumento che accetterebbe un'immagine incollata non riceve mai i dati. L'immagine va bene — semplicemente non ha un percorso dagli appunti al prompt. Ecco perché i percorsi che utilizzano un file salvato piuttosto che una bitmap negli appunti sono quelli che funzionano.
Anche il collegamento di incollamento dedicato può essere difettoso qui: l'incollamento di immagini nel terminale è stato segnalato come intermittentemente non funzionante su alcuni setup di Windows e PowerShell. Quando il percorso degli appunti ti fallisce, un file salvato — trascinato o referenziato per percorso — non dipende mai da esso, ecco perché è l'abitudine che vale la pena costruire.
Devo ridimensionare lo screenshot prima di inviarlo?
Sì, se stai facendo questo tutto il giorno. Una cattura a piena risoluzione non è solo pesante da muovere — è costosa. I modelli di visione dividono un'immagine in patch e addebitano token per patch, quindi uno screenshot 4K può costare più di mille token di immagine, mentre una copia ridimensionata a una larghezza sensata costa poche centinaia e si legge altrettanto chiaramente, perché il modello ridimensiona comunque le immagini grandi internamente. Ridimensionare l'immagine prima che raggiunga Claude Code è l'ottimizzazione più economica dell'intero ciclo.
Qui è dove uno strumento di cattura appositamente costruito si guadagna il suo posto. Maxisnap Esportazione ottimizzata per l'IA — produce una copia limitata a una larghezza massima predefinita di 1600 px — configurabile in Impostazioni — e ti consegna il file salvato — pronto per trascinare nel terminale o referenziare per percorso. E se lo scatto mostra una chiave API, un token o i dati di un cliente, lo strumento di offuscamento lo redige distruttivamente prima che il file sia mai creato, quindi il segreto non può essere recuperato da quello che invii.
| Cosa incolli | Costo tipico in token immagine | In Claude Code |
|---|---|---|
| Cattura grezza in 4K / a schermo intero | oltre 1.000 token | Più caro e può raggiungere un limite di dimensione |
| Copia ottimizzata per l'IA di Maxisnap (larga 1600 px) | Qualche centinaio di token | Si legge chiaramente, costa meno, si carica velocemente |
Le cifre sui token sono intervalli tipici dei modelli di visione, non un benchmark di Maxisnap; i conteggi esatti variano in base al modello e al contenuto dell'immagine.
$ il passaggio di consegna più veloce affidabile
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
Incollare screenshot in Claude Code — Domande frequenti
Perché Ctrl+V non incolla il mio screenshot in Claude Code?
Perché il terminale di solito non può accettare un'immagine dagli appunti — si aspetta testo e ignora la bitmap che Windows mette lì quando copi uno screenshot. All'interno di WSL la bitmap degli appunti di Windows non è affatto visibile al lato Linux. Usa il tuo tasto di incollamento dell'immagine di Claude Code, trascina il file nel terminale o fai riferimento al percorso del file salvato nel tuo prompt invece.
Il tasto di incollamento ha smesso di funzionare in Claude Code — adesso cosa?
L'incollamento di immagini nel terminale può intermittentemente non riuscire su Windows e PowerShell, quindi non fare affidamento su di esso come unico percorso. Salva lo screenshot e fai riferimento al suo percorso di file nel tuo prompt, o trascina il file nel terminale — nessuno dei due tocca gli appunti, quindi entrambi continuano a funzionare quando il collegamento di incollamento non lo fa. Vale la pena controllare la documentazione corrente di Claude Code per il tasto di incollamento più recente, ma il percorso del file è quello che non si rompe mai.
Qual è il modo più affidabile per aggiungere un'immagine su Windows?
Fai riferimento al file salvato per il suo percorso nel tuo messaggio. Non tocca gli appunti, quindi funziona allo stesso modo in Windows Terminal, WSL e su SSH. Trascinare il file nel terminale è il percorso più affidabile dopo.
Lo screenshot deve avere una dimensione specifica?
Più piccolo è di solito meglio. Una cattura a piena risoluzione può costare più di mille token di immagine ed è più probabile che raggiunga un limite per immagine. Una copia ridimensionata a circa 1600 px di larghezza costa molto meno e si legge altrettanto chiaramente, perché il modello ridimensiona comunque le immagini grandi.
Come nascondo una chiave API prima di inviare uno screenshot?
Redalo prima che il file sia creato. In Maxisnap, trascina lo strumento di offuscamento sul segreto nell'editor, quindi esporta — l'offuscamento viene applicato distruttivamente, quindi la chiave non può essere recuperata dall'immagine che consegni a Claude Code.
Posso fare la stessa cosa con Codex CLI o Gemini CLI?
Sì. Tutti e tre prendono un percorso di file o un file trascinato, che è il percorso portatile su Windows. Il nostro screenshot per l'AI coding — la pagina ha il dettaglio per tool e registrazione dello schermo per la codifica IA — copre l'invio di una clip breve quando una still non è sufficiente.
Cattura, redallo e consegnalo in tre tasti.
Uno screenshot dimensionato correttamente e ottimizzato per l'IA con un file salvato pronto per trascinare o referenziare — gratuito su Windows.
Correlati: screenshot per l'AI coding · registrazione dello schermo per la codifica IA · sfocare uno screenshot · strumenti di screenshot per sviluppatori