Orkas Orkas
Início Blog Claude Code + Nano Banana
Produto

Como gerar imagens no Claude Code com o Nano Banana

O Claude Code não desenha sozinho, mas pode chamar um modelo de imagem. Veja como conectar o Nano Banana, do Google, com um servidor MCP ou uma skill, quanto custa cada imagem e como gerar imagens no Orkas sem uma chave do Gemini.

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.

  1. 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.
  2. Escolha o ImageStudio e adicione suas fotos e seu logo.
  3. 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.
  4. 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.

Crie com o ImageStudio Tenha imagens prontas sem configurar um servidor MCP. O Orkas é gratuito para macOS e Windows. Contas novas ganham 500 créditos para os modelos integrados, ou você pode adicionar sua própria chave do Gemini.
Baixar o Orkas — grátis

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:

ModeloID do modeloPreço por imagemObservações
Nano Banana 2.1gemini-nano-banana-2.1$0.0336 em 1K, $0.0504 em 2K, $0.113 em 4KO modelo mais novo, com disponibilidade geral desde 6 de outubro de 2026. Comece por aqui.
Nano Banana 2 Litegemini-3.1-flash-lite-image$0.0336, só 1KO 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 Progemini-3-pro-image$0.134 em 1K ou 2K, $0.24 em 4KPara cenas complexas; raciocina antes de desenhar.
Nano Banana 2gemini-3.1-flash-image$0.067 em 1K, $0.101 em 2K, $0.151 em 4KObsoleto; o Google recomenda o 2.1 para projetos novos.
Nano Bananagemini-2.5-flash-image$0.039O 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:

ProjetoO que éModelo padrãoO que mudar
nanobanana-mcp-serverServidor MCP, roda com uvUm ID preview do Nano Banana 2 que já foi desativadoDefina NANOBANANA_MODEL como flash, que usa o Nano Banana original
extensão nanobananaExtensão do Google para o Gemini CLIUm ID preview do Nano Banana 2 que já foi desativadoDefina NANOBANANA_MODEL como gemini-nano-banana-2.1
cc-nano-bananaSkill do Claude Code que roda a extensão acimaO padrão da extensãoA mesma configuração da extensão
Nano-Banana-MCPServidor MCP, roda com npxUm ID preview do Nano Banana, fixo no códigoNã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

  1. Crie uma chave da Gemini API no Google AI Studio, depois vincule o faturamento e adicione crédito pré-pago.
  2. Instale o uv, que baixa e executa o servidor para você.
  3. 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 stdio logo antes do nome; caso contrário, o Claude Code lê o nome como mais uma variável.
  4. Confira se conectou: abra o Claude Code e digite /mcp.
  5. 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:

  1. Instale o Gemini CLI e a extensão: npm install -g @google/gemini-cli e depois gemini extensions install https://github.com/gemini-cli-extensions/nanobanana.
  2. Defina duas variáveis no perfil do seu shell: NANOBANANA_API_KEY com sua chave do Gemini e NANOBANANA_MODEL=gemini-nano-banana-2.1.
  3. Adicione a skill: git clone https://github.com/kkoppenhaver/cc-nano-banana ~/.claude/skills/nano-banana
  4. 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 objetivoComece comO que você recebe
Posts para redes sociais, imagens de produto ou pôsteres com texto exato, sem configuraçãoImageStudio no OrkasArquivos 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çãoImageStudio com sua chave do GeminiImagens do Nano Banana; cobradas pelo Google, sem créditos do Orkas
Imagens enquanto você programa, sem sair do Claude CodeUm servidor MCP do Nano Banana, com o modelo definidoImagens salvas no seu computador; o Google cobra cada imagem
Um fluxo de imagens repetível, com suas próprias regrasUma skill do Nano BananaUma skill que você mesmo instala, lê e atualiza
Ícones, diagramas e gráficosO Claude Code sozinhoCó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.