Claude Code scrive codice e testo, e sa leggere le immagini, ma non sa disegnarle. Per ottenere immagini, devi collegargli un modello di immagini. Nano Banana, il modello di immagini Gemini di Google, è quello che sceglie la maggior parte delle persone: Claude Code lo raggiunge tramite un server MCP o una skill che invia il tuo prompt alla Gemini API con la tua chiave. Questa guida spiega entrambe le configurazioni, quanto costa ogni immagine, un problema di modelli che oggi manda in errore molti di questi strumenti e una strada che non richiede alcuna chiave.
In breve: se vuoi immagini finite senza configurare chiavi API, usa ImageStudio in Orkas. È un agente per le immagini con un modello di immagini integrato, e i nuovi account ricevono 500 crediti gratuiti. Se vuoi proprio Nano Banana, aggiungi la tua chiave Gemini a Orkas: ImageStudio userà Nano Banana 2.1. Per chiamare Nano Banana dall'interno di Claude Code, aggiungi un server MCP di Nano Banana, ma imposta tu il modello: all'8 novembre 2026, i server più diffusi usano per impostazione predefinita ID di modello che Google ha dismesso.
Claude Code può generare immagini?
Non da solo. Il centro assistenza di Anthropic spiega che Claude non genera foto o illustrazioni come fanno gli strumenti di generazione di immagini. Può scrivere codice SVG, HTML e per grafici, che basta per icone, diagrammi, banner semplici e grafici. Foto, illustrazioni, foto di prodotto e stili pittorici richiedono un modello di immagini. Codex di OpenAI ha la generazione di immagini integrata, con gpt-image-2; Claude Code non ha nulla di simile.
Quello che Claude Code sa fare è leggere i file di immagine. Dopo che un modello di immagini ha salvato un'immagine nel tuo progetto, Claude può aprirla, confrontarla con ciò che hai chiesto e riscrivere il prompt. È per questo ciclo che si usano i due insieme: Claude pianifica e controlla, il modello di immagini disegna.
Nel marketplace dei plugin di Anthropic non esiste un plugin ufficiale di Nano Banana. Lo si collega in uno di questi tre modi, e tutti chiamano la Gemini API di Google con una chiave che crei in Google AI Studio:
- Un server MCP dà a Claude Code un nuovo strumento da chiamare ogni volta che un'attività richiede un'immagine.
- Una skill è una cartella con delle istruzioni e a volte uno script. Claude Code la carica quando la tua richiesta riguarda le immagini o quando la richiami per nome.
- L'estensione nanobanana di Google per Gemini CLI aggiunge comandi per le immagini a Gemini CLI. Una skill di Claude Code può eseguirla al posto tuo.
Senza configurazione: ImageStudio in Orkas
Ti consigliamo di iniziare con ImageStudio, l'agente per le immagini integrato in Orkas. Dagli il tuo brief, le foto, il logo e il testo esatto, e descrivi il risultato che vuoi. Crea grafiche per i social, immagini di prodotto, copertine, poster, infografiche, grafici e illustrazioni. Titoli, prezzi ed etichette vengono composti come testo vero, quindi il testo esce esattamente come l'hai scritto. Per modificare una foto, digli cosa cambiare, per esempio lo sfondo o l'illuminazione, e cambierà solo quella parte. Quando un'immagine richiede pixel nuovi, usa il modello integrato Seedream 5.5, a 13–23 crediti / immagine generata + 5 / immagine in ingresso. Le operazioni di impaginazione, come ridimensionare, ritagliare e posizionare il testo, non chiamano alcun modello di immagini.
Se preferisci Nano Banana, aggiungi la tua chiave Gemini in Orkas: apri Impostazioni, scegli Modelli, poi Immagine e Aggiungi servizio di immagini, seleziona Google · Nano Banana 2.1 e incolla la chiave. La nuova chiave va in cima all'elenco, quindi ImageStudio genera con Nano Banana 2.1, il modello attuale. Quelle immagini te le fattura Google, e Orkas non ti addebita alcun credito. Se una richiesta a Google non va a buon fine, ImageStudio può ripiegare sul modello integrato, che consuma crediti.
- Installa Orkas ed effettua l'accesso. I nuovi account ricevono 500 crediti gratuiti per i modelli integrati, quindi puoi iniziare senza una chiave API.
- Scegli ImageStudio e aggiungi le tue foto e il tuo logo.
- Descrivi il risultato: la dimensione o la piattaforma, il testo esatto, cosa deve restare invariato e il tipo di file che vuoi.
- Controlla l'immagine e chiedi modifiche mirate, come un titolo più grande o uno sfondo diverso. Per impostazione predefinita genera una nuova immagine per richiesta, e ne crea un'altra solo se glielo chiedi.
Ottieni file PNG, JPG, WEBP, AVIF o TIFF salvati sul tuo computer. ImageStudio non crea file PSD a livelli né file vettoriali.
Una richiesta da provare
Aggiungi la foto del prodotto e il logo, sostituisci le parti tra parentesi quadre e invia questo testo a ImageStudio:
Crea un post [1080×1350] su [Instagram] per [i nostri saldi di primavera].
Usa [la foto del mio prodotto] come immagine principale e lascia il prodotto esattamente com'è.
Mettilo su uno sfondo [da studio beige tenue] con luce naturale.
Inserisci esattamente questo titolo: "[Saldi di primavera — sconto del 20%]".
Metti [il mio logo] nell'angolo in basso a destra.
Consegna un PNG.Quando l'immagine è pronta, chiedi modifiche precise, per esempio: "Ingrandisci il titolo e sposta il logo in alto a destra." ImageStudio cambia quella parte e lascia il resto com'è.
I modelli Nano Banana e quanto costano
Nano Banana è il nome che Google usa per la generazione di immagini di Gemini. Questi sono i modelli della Gemini API, con i prezzi di listino di Google per immagine nel livello a pagamento:
| Modello | ID modello | Prezzo per immagine | Note |
|---|---|---|---|
| Nano Banana 2.1 | gemini-nano-banana-2.1 | $0.0336 a 1K, $0.0504 a 2K, $0.113 a 4K | Il modello più recente, in disponibilità generale dal 6 ottobre 2026. Parti da qui. |
| Nano Banana 2 Lite | gemini-3.1-flash-lite-image | $0.0336, solo 1K | Il più veloce ed economico. Non è pensato per più immagini di riferimento o per modifiche passo passo. |
| Nano Banana Pro | gemini-3-pro-image | $0.134 a 1K o 2K, $0.24 a 4K | Per scene complesse; ragiona prima di disegnare. |
| Nano Banana 2 | gemini-3.1-flash-image | $0.067 a 1K, $0.101 a 2K, $0.151 a 4K | Deprecato; Google consiglia 2.1 per i nuovi progetti. |
| Nano Banana | gemini-2.5-flash-image | $0.039 | Il modello originale. Google lo dismette il 15 marzo 2027. |
Tre cose colgono spesso di sorpresa:
- Per le immagini non c'è un livello gratuito. Per creare immagini con una chiave API devi collegare un account di fatturazione e fare una ricarica prepagata di almeno $5. La prova gratuita di Google Cloud da $300 non copre la Gemini API.
- Gli ID dei modelli preview non funzionano più. Google ha dismesso gemini-2.5-flash-image-preview il 15 gennaio 2026, e gemini-3.1-flash-image-preview e gemini-3-pro-image-preview il 25 giugno 2026. Uno strumento che ne chiama ancora uno va in errore.
- Ogni immagine contiene una filigrana SynthID invisibile. Vale per tutti i modelli qui sopra.
Prezzi e ID provengono dalla pagina dei prezzi di Google e dalla guida alla generazione di immagini, aggiornati all'8 novembre 2026.
Server MCP e skill per Nano Banana a confronto
Questi sono i progetti che saltano fuori più spesso per Claude Code. Sono tutti gratuiti e open source; le immagini le paghi a Google. Controlla il modello prima di installare:
| Progetto | Cos'è | Modello predefinito | Cosa cambiare |
|---|---|---|---|
| nanobanana-mcp-server | Server MCP, si avvia con uv | Un ID preview di Nano Banana 2 già dismesso | Imposta NANOBANANA_MODEL su flash, che usa il Nano Banana originale |
| estensione nanobanana | Estensione di Google per Gemini CLI | Un ID preview di Nano Banana 2 già dismesso | Imposta NANOBANANA_MODEL su gemini-nano-banana-2.1 |
| cc-nano-banana | Skill di Claude Code che esegue l'estensione qui sopra | Quello dell'estensione | La stessa impostazione dell'estensione |
| Nano-Banana-MCP | Server MCP, si avvia con npx | Un ID preview di Nano Banana, scritto nel codice | Non c'è un'impostazione per cambiarlo; lascialo perdere finché il progetto non viene aggiornato |
Abbiamo controllato il codice di ogni progetto l'8 novembre 2026. Leggi il README prima di installare un progetto: esegue codice sul tuo computer e invia a Google i tuoi prompt e le tue immagini.
Come aggiungere Nano Banana a Claude Code con un server MCP
- Crea una chiave della Gemini API in Google AI Studio, poi collega la fatturazione e aggiungi credito prepagato.
- Installa uv, che scarica e avvia il server al posto tuo.
- Aggiungi il server dal terminale:
claude mcp add --env GEMINI_API_KEY=your-key --env NANOBANANA_MODEL=flash --transport stdio nanobanana -- uvx nanobanana-mcp-server@latest. Tieni--transport stdiosubito prima del nome; altrimenti Claude Code interpreta il nome come un'altra variabile. - Verifica che sia connesso: avvia Claude Code e digita
/mcp. - Chiedi un'immagine come parte dell'attività, per esempio: "Crea un'immagine hero 16:9 per questa landing page, salvala in public/images, poi aprila e dimmi cosa sistemare."
Il server salva le immagini in una cartella nanobanana-images nella tua cartella home, a meno che tu non imposti IMAGE_OUTPUT_DIR. Per impostazione predefinita, il comando qui sopra aggiunge il server solo per te, nel progetto corrente. Aggiungi --scope user per usarlo in tutti i progetti. Non aggiungerlo con l'ambito di progetto: scriverebbe la chiave in un file .mcp.json che potresti finire per committare.
L'impostazione flash usa il Nano Banana originale, l'unico modello nell'elenco di questo server che Google offre ancora, e Google lo dismette il 15 marzo 2027. Nano Banana 2.1 è in una pull request non ancora rilasciata. Per usare 2.1 oggi, segui la strada dell'estensione qui sotto, oppure usa ImageStudio con la tua chiave Gemini.
In alternativa, usa una skill
Una skill tiene le tue regole per le immagini in un unico posto, come le dimensioni che usi e la struttura di prompt che preferisci. La più nota, cc-nano-banana, funziona tramite l'estensione di Google per Gemini CLI:
- Installa Gemini CLI e l'estensione:
npm install -g @google/gemini-cli, poigemini extensions install https://github.com/gemini-cli-extensions/nanobanana. - Imposta due variabili nel profilo della tua shell:
NANOBANANA_API_KEYcon la tua chiave Gemini eNANOBANANA_MODEL=gemini-nano-banana-2.1. - Aggiungi la skill:
git clone https://github.com/kkoppenhaver/cc-nano-banana ~/.claude/skills/nano-banana - Chiedi un'immagine a Claude Code, oppure richiama la skill per nome con
/nano-banana.
Prima leggi il suo SKILL.md. Dice a Claude di eseguire Gemini CLI con il flag --yolo, che approva ogni azione di Gemini CLI senza chiedere. Alcuni utenti segnalano anche che l'estensione non riceve la chiave dalla shell. Se scrivi una skill tutta tua, mettici dentro l'ID del modello e tieni la chiave in una variabile d'ambiente, non nel file della skill.
Usare Claude Code da Orkas
Non devi scegliere tra Orkas e la configurazione che hai già.
- I tuoi server MCP e le tue skill continuano a funzionare. Nella barra laterale scegli Connetti agenti e seleziona Claude Code. Orkas esegue la copia installata sul tuo computer, con il tuo account. Aggiunge i propri strumenti accanto ai tuoi server MCP invece di sostituirli, quindi il server di Nano Banana e le skill che hai configurato continuano a caricarsi.
- Lascia che ogni agente faccia la sua parte. Chiedi a Claude Code di costruire la pagina o l'app, e chiedi a ImageStudio le immagini che servono. ImageStudio salva i file sul tuo computer, così Claude Code può inserirli nel progetto.
Quale strada scegliere?
| Il tuo obiettivo | Parti da | Cosa ottieni |
|---|---|---|
| Post per i social, immagini di prodotto o poster con testo esatto, senza configurazione | ImageStudio in Orkas | File PNG, JPG, WEBP, AVIF o TIFF; modello integrato, 500 crediti gratuiti per iniziare |
| Nano Banana 2.1 senza script né file di configurazione | ImageStudio con la tua chiave Gemini | Immagini Nano Banana; le fattura Google, niente crediti Orkas |
| Immagini mentre programmi, senza uscire da Claude Code | Un server MCP di Nano Banana, con il modello impostato | Immagini salvate sul tuo computer; Google fattura ogni immagine |
| Un flusso di lavoro ripetibile per le immagini, con le tue regole | Una skill di Nano Banana | Una skill che installi, leggi e aggiorni tu |
| Icone, diagrammi e grafici | Claude Code da solo | Codice SVG o per grafici; non serve un modello di immagini |
Domande frequenti
Claude Code può generare immagini da solo?
No. Anthropic spiega che Claude non genera foto o illustrazioni come fanno gli strumenti di generazione di immagini. Claude Code può scrivere codice SVG, HTML e per grafici, e può aprire file di immagine per controllarli, quindi funziona bene con un modello di immagini come Nano Banana.
Nano Banana è gratuito in Claude Code?
No. La Gemini API non ha un livello gratuito per i suoi modelli di immagini: devi collegare la fatturazione e fare una ricarica prepagata di almeno $5, e la prova gratuita di Google Cloud da $300 non la copre. Nano Banana 2.1 costa $0.0336 per immagine a 1K. ImageStudio in Orkas ha un modello integrato, e i nuovi account ricevono 500 crediti gratuiti.
Quale modello Nano Banana conviene usare?
Parti da Nano Banana 2.1 (gemini-nano-banana-2.1), il modello più recente. Usa Nano Banana 2 Lite per le immagini 1K più economiche e Nano Banana Pro per le scene complesse. Evita qualsiasi ID di modello che finisce con -preview; Google li ha dismessi.
Perché il mio server MCP di Nano Banana restituisce un errore 404?
Molto probabilmente sta chiamando un modello che Google ha dismesso. Google ha disattivato gemini-2.5-flash-image-preview il 15 gennaio 2026, e gemini-3.1-flash-image-preview e gemini-3-pro-image-preview il 25 giugno 2026. Imposta sul server un modello attuale, se ha un'impostazione per farlo, oppure passa a uno strumento che ti permetta di scegliere il modello.
Mi serve una chiave della Gemini API per creare immagini in Orkas?
No. ImageStudio usa il modello integrato Seedream 5.5, e i nuovi account ricevono 500 crediti gratuiti. Se aggiungi la tua chiave Gemini, ImageStudio usa invece Nano Banana 2.1, e quelle immagini te le fattura Google.
Per continuare a lavorare sull'immagine in Photoshop, leggi Come usare Claude con Photoshop. Per altre idee, scopri cosa puoi creare con ImageStudio. Per provarlo con le tue foto, scarica Orkas e inizia da ImageStudio.