O Claude Code escreve código e texto, e consegue analisar imagens, mas não consegue desenhá-las. Para obter imagens dele, você precisa conectar um modelo de imagem. O Nano Banana, modelo de imagem do Gemini, do Google, é o mais escolhido: o Claude Code chega até ele por um servidor MCP ou por uma skill que envia o seu prompt para a Gemini API com a sua própria chave. Este guia mostra as duas configurações, quanto custa cada imagem, um problema de modelo que hoje quebra muitas dessas ferramentas e um caminho que não exige chave nenhuma.
Resposta curta: se você quer imagens prontas sem configurar chaves de API, use o ImageStudio no Orkas. Ele é um agente de imagem com um modelo de imagem integrado, e contas novas ganham 500 créditos grátis. Se você quer especificamente o Nano Banana, adicione sua chave do Gemini ao Orkas, e o ImageStudio passa a usar o Nano Banana 2.1. Para chamar o Nano Banana de dentro do Claude Code, adicione um servidor MCP do Nano Banana, mas defina o modelo você mesmo: em 8 de novembro de 2026, os servidores mais populares usam por padrão IDs de modelo que o Google já desativou.
O Claude Code consegue gerar imagens?
Sozinho, não. A central de ajuda da Anthropic diz que o Claude não gera fotos nem ilustrações como fazem as ferramentas de geração de imagem. Ele consegue escrever código SVG, HTML e de gráficos, o que basta para ícones, diagramas, banners simples e gráficos. Fotos, ilustrações, fotos de produto e estilos de pintura precisam de um modelo de imagem. O Codex, da OpenAI, tem geração de imagens integrada, com o gpt-image-2; o Claude Code não tem nada parecido.
O que o Claude Code consegue fazer é ler arquivos de imagem. Depois que um modelo de imagem salva uma imagem no seu projeto, o Claude pode abri-la, compará-la com o que você pediu e reescrever o prompt. É por causa desse ciclo que as pessoas usam os dois juntos: o Claude planeja e confere, e o modelo de imagem desenha.
Não existe um plugin oficial do Nano Banana no marketplace de plugins da Anthropic. As pessoas o conectam de uma destas três formas, e todas chamam a Gemini API do Google com uma chave que você cria no Google AI Studio:
- Um servidor MCP dá ao Claude Code uma nova ferramenta, que ele pode chamar sempre que uma tarefa precisar de uma imagem.
- Uma skill é uma pasta com instruções e, às vezes, um script. O Claude Code a carrega quando o seu pedido envolve imagens ou quando você a chama pelo nome.
- A extensão nanobanana do Google para o Gemini CLI adiciona comandos de imagem ao Gemini CLI. Uma skill do Claude Code pode rodá-la para você.
Sem configuração: ImageStudio no Orkas
Recomendamos começar pelo ImageStudio, o agente de imagem integrado ao Orkas. Envie seu briefing, suas fotos, seu logo e o texto exato, e descreva o resultado que você quer. Ele cria artes para redes sociais, imagens de produto, capas, pôsteres, infográficos, gráficos e ilustrações. Títulos, preços e rótulos entram como texto de verdade, então o texto sai exatamente como você escreveu. Para editar uma foto, diga o que mudar, como o fundo ou a iluminação, e ele altera só essa parte. Quando uma imagem precisa de pixels novos, ele usa o modelo integrado Seedream 5.5, a 13–23 créditos / imagem de saída + 5 / imagem de entrada. Tarefas de layout, como redimensionar, recortar e posicionar texto, não chamam nenhum modelo de imagem.
Se preferir o Nano Banana, adicione sua chave do Gemini no Orkas: abra Configurações, escolha Modelos, depois Imagem e Adicionar serviço de imagem, selecione Google · Nano Banana 2.1 e cole a chave. A nova chave vai para o topo da lista, então o ImageStudio passa a gerar com o Nano Banana 2.1, o modelo atual. O Google cobra essas imagens, e o Orkas não desconta créditos por elas. Se uma solicitação ao Google falhar, o ImageStudio pode recorrer ao modelo integrado, que consome créditos.
- Instale o Orkas e faça login. Contas novas ganham 500 créditos grátis para os modelos integrados, então você pode começar sem chave de API.
- Escolha o ImageStudio e adicione suas fotos e seu logo.
- Descreva o resultado: o tamanho ou a plataforma, o texto exato, o que não pode mudar e o tipo de arquivo que você quer.
- Revise a imagem e peça ajustes pontuais, como um título maior ou outro fundo. Por padrão, ele gera uma imagem nova por pedido e só faz outra quando você pede.
Você recebe arquivos PNG, JPG, WEBP, AVIF ou TIFF salvos no seu computador. O ImageStudio não gera arquivos PSD com camadas nem arquivos vetoriais.
Um pedido para testar
Adicione a foto do seu produto e o seu logo, troque o que está entre colchetes e envie isto para o ImageStudio:
Crie um post de [1080×1350] para o [Instagram] sobre [nossa promoção de primavera].
Use [a foto do meu produto] como imagem principal e mantenha o produto exatamente como está.
Coloque-o sobre um fundo [de estúdio bege suave] com luz natural.
Use exatamente este título: "[Promoção de primavera — 20% off]".
Coloque [meu logo] no canto inferior direito.
Entregue em PNG.Quando a imagem estiver pronta, peça mudanças específicas, por exemplo: "Aumente o título e mova o logo para o canto superior direito." O ImageStudio altera essa parte e mantém o resto.
Modelos do Nano Banana e quanto custam
Nano Banana é o nome que o Google usa para a geração de imagens do Gemini. Estes são os modelos da Gemini API, com os preços de tabela do Google por imagem no nível pago:
| Modelo | ID do modelo | Preço por imagem | Observações |
|---|---|---|---|
| Nano Banana 2.1 | gemini-nano-banana-2.1 | $0.0336 em 1K, $0.0504 em 2K, $0.113 em 4K | O modelo mais novo, com disponibilidade geral desde 6 de outubro de 2026. Comece por aqui. |
| Nano Banana 2 Lite | gemini-3.1-flash-lite-image | $0.0336, só 1K | O mais rápido e barato. Não foi feito para várias imagens de referência nem para edições passo a passo. |
| Nano Banana Pro | gemini-3-pro-image | $0.134 em 1K ou 2K, $0.24 em 4K | Para cenas complexas; raciocina antes de desenhar. |
| Nano Banana 2 | gemini-3.1-flash-image | $0.067 em 1K, $0.101 em 2K, $0.151 em 4K | Obsoleto; o Google recomenda o 2.1 para projetos novos. |
| Nano Banana | gemini-2.5-flash-image | $0.039 | O modelo original. O Google vai desativá-lo em 15 de março de 2027. |
Três coisas pegam muita gente de surpresa:
- Não existe nível gratuito para imagens. Para criar imagens com uma chave de API, você precisa vincular uma conta de faturamento e pagar antecipadamente pelo menos $5. O teste gratuito de $300 do Google Cloud não cobre a Gemini API.
- Os IDs de modelo preview não funcionam mais. O Google desativou o gemini-2.5-flash-image-preview em 15 de janeiro de 2026, e o gemini-3.1-flash-image-preview e o gemini-3-pro-image-preview em 25 de junho de 2026. Uma ferramenta que ainda chame algum deles vai falhar.
- Toda imagem leva uma marca d'água SynthID invisível. Isso vale para todos os modelos acima.
Os preços e IDs são da página de preços do Google e do guia de geração de imagens, consultados em 8 de novembro de 2026.
Servidores MCP e skills do Nano Banana: comparativo
Estes são os projetos que mais aparecem para o Claude Code. Todos são gratuitos e open source; quem cobra pelas imagens é o Google. Confira o modelo antes de instalar:
| Projeto | O que é | Modelo padrão | O que mudar |
|---|---|---|---|
| nanobanana-mcp-server | Servidor MCP, roda com uv | Um ID preview do Nano Banana 2 que já foi desativado | Defina NANOBANANA_MODEL como flash, que usa o Nano Banana original |
| extensão nanobanana | Extensão do Google para o Gemini CLI | Um ID preview do Nano Banana 2 que já foi desativado | Defina NANOBANANA_MODEL como gemini-nano-banana-2.1 |
| cc-nano-banana | Skill do Claude Code que roda a extensão acima | O padrão da extensão | A mesma configuração da extensão |
| Nano-Banana-MCP | Servidor MCP, roda com npx | Um ID preview do Nano Banana, fixo no código | Não há configuração para isso; deixe de lado até o projeto ser atualizado |
Verificamos o código de cada projeto em 8 de novembro de 2026. Leia o README antes de instalar um projeto: ele executa código no seu computador e envia seus prompts e imagens para o Google.
Como adicionar o Nano Banana ao Claude Code com um servidor MCP
- Crie uma chave da Gemini API no Google AI Studio, depois vincule o faturamento e adicione crédito pré-pago.
- Instale o uv, que baixa e executa o servidor para você.
- Adicione o servidor no terminal:
claude mcp add --env GEMINI_API_KEY=your-key --env NANOBANANA_MODEL=flash --transport stdio nanobanana -- uvx nanobanana-mcp-server@latest. Mantenha--transport stdiologo antes do nome; caso contrário, o Claude Code lê o nome como mais uma variável. - Confira se conectou: abra o Claude Code e digite
/mcp. - Peça uma imagem como parte da tarefa, por exemplo: "Crie uma imagem hero em 16:9 para esta landing page, salve em public/images, depois abra e me diga o que precisa corrigir."
O servidor salva as imagens em uma pasta nanobanana-images dentro da sua pasta de usuário, a menos que você defina IMAGE_OUTPUT_DIR. Por padrão, o comando acima adiciona o servidor só para você, no projeto atual. Adicione --scope user para usá-lo em todos os projetos. Não o adicione com o escopo de projeto: isso grava a chave em um arquivo .mcp.json que você pode acabar commitando.
A opção flash usa o Nano Banana original, o único modelo da lista desse servidor que o Google ainda oferece, e o Google vai desativá-lo em 15 de março de 2027. O Nano Banana 2.1 está em um pull request que ainda não foi lançado. Para usar o 2.1 hoje, siga o caminho da extensão, mais abaixo, ou use o ImageStudio com sua chave do Gemini.
Ou use uma skill
Uma skill reúne suas regras de imagem em um só lugar, como os tamanhos que você usa e a estrutura de prompt de que gosta. A mais conhecida, cc-nano-banana, funciona por meio da extensão do Google para o Gemini CLI:
- Instale o Gemini CLI e a extensão:
npm install -g @google/gemini-clie depoisgemini extensions install https://github.com/gemini-cli-extensions/nanobanana. - Defina duas variáveis no perfil do seu shell:
NANOBANANA_API_KEYcom sua chave do Gemini eNANOBANANA_MODEL=gemini-nano-banana-2.1. - Adicione a skill:
git clone https://github.com/kkoppenhaver/cc-nano-banana ~/.claude/skills/nano-banana - Peça uma imagem ao Claude Code ou chame a skill pelo nome com
/nano-banana.
Leia o SKILL.md dela antes. Ele instrui o Claude a rodar o Gemini CLI com a flag --yolo, que aprova todas as ações do Gemini CLI sem perguntar. Alguns usuários também relatam que a extensão não recebe a chave a partir do shell. Se você escrever sua própria skill, coloque nela o ID do modelo e mantenha a chave em uma variável de ambiente, não no arquivo da skill.
Use o Claude Code a partir do Orkas
Você não precisa escolher entre o Orkas e a configuração que já tem.
- Seus servidores MCP e skills continuam funcionando. Na barra lateral, escolha Conectar agentes e selecione o Claude Code. O Orkas executa a cópia instalada no seu computador, com o seu login. Ele adiciona as próprias ferramentas ao lado dos seus servidores MCP, sem substituí-los, então o servidor do Nano Banana e as skills que você configurou continuam sendo carregados.
- Deixe cada agente fazer a sua parte. Peça ao Claude Code para criar a página ou o app, e peça ao ImageStudio as imagens necessárias. O ImageStudio salva os arquivos no seu computador, então o Claude Code pode colocá-los no seu projeto.
Qual caminho escolher?
| Seu objetivo | Comece com | O que você recebe |
|---|---|---|
| Posts para redes sociais, imagens de produto ou pôsteres com texto exato, sem configuração | ImageStudio no Orkas | Arquivos PNG, JPG, WEBP, AVIF ou TIFF; modelo integrado e 500 créditos grátis para começar |
| Nano Banana 2.1 sem scripts nem arquivos de configuração | ImageStudio com sua chave do Gemini | Imagens do Nano Banana; cobradas pelo Google, sem créditos do Orkas |
| Imagens enquanto você programa, sem sair do Claude Code | Um servidor MCP do Nano Banana, com o modelo definido | Imagens salvas no seu computador; o Google cobra cada imagem |
| Um fluxo de imagens repetível, com suas próprias regras | Uma skill do Nano Banana | Uma skill que você mesmo instala, lê e atualiza |
| Ícones, diagramas e gráficos | O Claude Code sozinho | Código SVG ou de gráficos; não precisa de modelo de imagem |
Perguntas frequentes
O Claude Code consegue gerar imagens sozinho?
Não. A Anthropic diz que o Claude não gera fotos nem ilustrações como fazem as ferramentas de geração de imagem. O Claude Code consegue escrever código SVG, HTML e de gráficos, e pode abrir arquivos de imagem para conferi-los, por isso funciona bem com um modelo de imagem como o Nano Banana.
O Nano Banana é gratuito no Claude Code?
Não. A Gemini API não tem nível gratuito para os modelos de imagem: você precisa vincular o faturamento e pagar antecipadamente pelo menos $5, e o teste gratuito de $300 do Google Cloud não cobre isso. O Nano Banana 2.1 custa $0.0336 por imagem 1K. O ImageStudio no Orkas tem um modelo integrado, e contas novas ganham 500 créditos grátis.
Qual modelo do Nano Banana devo usar?
Comece pelo Nano Banana 2.1 (gemini-nano-banana-2.1), o modelo mais novo. Use o Nano Banana 2 Lite para as imagens 1K mais baratas e o Nano Banana Pro para cenas complexas. Evite qualquer ID de modelo que termine em -preview; o Google já desativou esses modelos.
Por que meu servidor MCP do Nano Banana retorna erro 404?
O mais provável é que ele esteja chamando um modelo que o Google desativou. O Google desligou o gemini-2.5-flash-image-preview em 15 de janeiro de 2026, e o gemini-3.1-flash-image-preview e o gemini-3-pro-image-preview em 25 de junho de 2026. Configure o servidor com um modelo atual, se ele tiver essa opção, ou troque por uma ferramenta que deixe você escolher o modelo.
Preciso de uma chave da Gemini API para criar imagens no Orkas?
Não. O ImageStudio usa o modelo integrado Seedream 5.5, e contas novas ganham 500 créditos grátis. Se você adicionar sua própria chave do Gemini, o ImageStudio passa a usar o Nano Banana 2.1, e o Google cobra essas imagens.
Para continuar trabalhando na imagem no Photoshop, veja Como usar o Claude no Photoshop. Para mais ideias, confira o que dá para criar com o ImageStudio. Para testar com suas próprias fotos, baixe o Orkas e comece pelo ImageStudio.