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. Saiba como ligar o Nano Banana, da Google, através de um servidor MCP ou de uma skill, quanto custa cada imagem e como obter imagens no Orkas sem uma chave do Gemini.

O Claude Code escreve código e texto, e consegue analisar imagens, mas não as consegue desenhar. Para obter imagens, tem de lhe ligar um modelo de imagem. O Nano Banana, o modelo de imagem do Gemini da Google, é o mais escolhido: o Claude Code liga-se a ele através de um servidor MCP ou de uma skill que envia o seu prompt para a Gemini API com a sua própria chave. Este guia explica as duas configurações, quanto custa cada imagem, um problema de modelos que hoje faz falhar muitas destas ferramentas e um caminho que não precisa de chave nenhuma.

Resposta curta: se quer imagens finais sem configurar chaves de API, use o ImageStudio no Orkas. É um agente de imagem com um modelo de imagem integrado, e as contas novas recebem 500 créditos gratuitos. Se faz questão do Nano Banana, adicione a sua chave do Gemini ao Orkas, e o ImageStudio passa a usar o Nano Banana 2.1. Para chamar o Nano Banana a partir do Claude Code, adicione um servidor MCP do Nano Banana, mas defina o modelo manualmente: à data de 8 de novembro de 2026, os servidores mais populares usam por predefinição IDs de modelo que a Google já desativou.

O Claude Code consegue gerar imagens?

Sozinho, não. O centro de ajuda da Anthropic diz que o Claude não gera fotografias nem ilustrações como fazem as ferramentas de geração de imagens. Consegue escrever código SVG, HTML e de gráficos, o que chega para ícones, diagramas, banners simples e gráficos. Fotografias, ilustrações, fotografias de produto e estilos pictóricos 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 semelhante.

O que o Claude Code consegue fazer é ler ficheiros de imagem. Depois de um modelo de imagem guardar uma imagem no seu projeto, o Claude pode abri-la, compará-la com o que pediu e reescrever o prompt. É por causa deste ciclo que se usam os dois em conjunto: o Claude planeia e verifica, e o modelo de imagem desenha.

Não existe nenhum plugin oficial do Nano Banana no marketplace de plugins da Anthropic. Quem o usa liga-o de uma de três formas, e todas chamam a Gemini API da Google com uma chave criada no Google AI Studio:

  • Um servidor MCP dá ao Claude Code uma nova ferramenta, que pode chamar sempre que uma tarefa precisar de uma imagem.
  • Uma skill é uma pasta com instruções e, por vezes, um script. O Claude Code carrega-a quando o pedido envolve imagens ou quando a chama pelo nome.
  • A extensão nanobanana da Google para o Gemini CLI acrescenta comandos de imagem ao Gemini CLI. Uma skill do Claude Code pode executá-la por si.

Sem configuração: ImageStudio no Orkas

Recomendamos começar pelo ImageStudio, o agente de imagem integrado no Orkas. Dê-lhe o briefing, as fotografias, o logótipo e o texto exato, e descreva o resultado que pretende. Cria grafismos para redes sociais, imagens de produto, capas, cartazes, infografias, gráficos e ilustrações. Títulos, preços e etiquetas são compostos como texto real, por isso o texto sai exatamente como o escreveu. Para editar uma fotografia, diga o que quer mudar, como o fundo ou a iluminação, e só essa parte é alterada. Quando uma imagem precisa de píxeis novos, usa o modelo integrado Seedream 5.5, a 13–23 créditos / imagem de saída + 5 / imagem de entrada. Tarefas de composição, como redimensionar, recortar e colocar texto, não recorrem a nenhum modelo de imagem.

Se preferir o Nano Banana, adicione a sua chave do Gemini no Orkas: abra Definições, escolha Modelos, depois Imagem e Adicionar serviço de imagem, selecione Google · Nano Banana 2.1 e cole a chave. A nova chave fica no topo da lista, por isso o ImageStudio passa a gerar com o Nano Banana 2.1, o modelo atual. Essas imagens são faturadas pela Google, e o Orkas não cobra créditos por elas. Se um pedido à Google falhar, o ImageStudio pode recorrer ao modelo integrado, que gasta créditos.

  1. Instale o Orkas e inicie sessão. As contas novas recebem 500 créditos gratuitos para os modelos integrados, por isso pode começar sem chave de API.
  2. Escolha o ImageStudio e adicione as suas fotografias e o seu logótipo.
  3. Descreva o resultado: o tamanho ou a plataforma, o texto exato, o que tem de ficar igual e o tipo de ficheiro que pretende.
  4. Reveja a imagem e peça alterações concretas, como um título maior ou um fundo diferente. Por predefinição, gera uma imagem nova por pedido e só cria outra quando o pede.

Recebe ficheiros PNG, JPG, WEBP, AVIF ou TIFF guardados no seu computador. O ImageStudio não cria ficheiros PSD com camadas nem ficheiros vetoriais.

Crie com o ImageStudio Obtenha imagens finais sem configurar um servidor MCP. O Orkas é gratuito para macOS e Windows. As contas novas recebem 500 créditos para os modelos integrados, ou pode adicionar a sua própria chave do Gemini.
Descarregar Orkas — grátis

Um pedido para experimentar

Adicione a fotografia do seu produto e o seu logótipo, substitua o que está entre parênteses retos e envie isto ao ImageStudio:

Cria uma publicação de [1080×1350] para o [Instagram] sobre [os nossos saldos de primavera].
Usa [a fotografia do meu produto] como imagem principal e mantém o produto exatamente como está.
Coloca-o sobre um fundo [de estúdio bege suave] com luz natural.
Usa exatamente este título: «[Saldos de primavera — 20% de desconto]».
Coloca [o meu logótipo] no canto inferior direito.
Entrega um PNG.

Quando a imagem estiver pronta, peça alterações concretas, por exemplo: «Aumenta o título e passa o logótipo 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 a Google dá à geração de imagens do Gemini. Estes são os modelos da Gemini API, com os preços de tabela da Google por imagem no escalão pago:

ModeloID do modeloPreço por imagemNotas
Nano Banana 2.1gemini-nano-banana-2.1$0.0336 em 1K, $0.0504 em 2K, $0.113 em 4KO modelo mais recente, com disponibilidade geral desde 6 de outubro de 2026. Comece por aqui.
Nano Banana 2 Litegemini-3.1-flash-lite-image$0.0336, apenas 1KO mais rápido e barato. Não foi pensado 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; a Google recomenda o 2.1 para projetos novos.
Nano Bananagemini-2.5-flash-image$0.039O modelo original. A Google desativa-o a 15 de março de 2027.

Há três coisas que apanham muita gente desprevenida:

  • Não há escalão gratuito para imagens. Para criar imagens com uma chave de API, tem de associar uma conta de faturação e fazer um pré-pagamento de pelo menos $5. O período experimental gratuito de $300 do Google Cloud não abrange a Gemini API.
  • Os IDs de modelo preview já não funcionam. A Google desativou o gemini-2.5-flash-image-preview a 15 de janeiro de 2026, e o gemini-3.1-flash-image-preview e o gemini-3-pro-image-preview a 25 de junho de 2026. Uma ferramenta que ainda chame algum deles falha.
  • Todas as imagens levam uma marca de água SynthID invisível. Isto aplica-se a todos os modelos acima.

Os preços e IDs são da página de preços da Google e do guia de geração de imagens, à data de 8 de novembro de 2026.

Servidores MCP e skills do Nano Banana: comparação

Estes são os projetos que mais aparecem para o Claude Code. Todos são gratuitos e de código aberto; as imagens são pagas à Google. Confirme o modelo antes de instalar:

ProjetoO que éModelo predefinidoO que alterar
nanobanana-mcp-serverServidor MCP, executado 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 da 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 executa a extensão acimaA predefinição da extensãoA mesma definição da extensão
Nano-Banana-MCPServidor MCP, executado com npxUm ID preview do Nano Banana, fixo no códigoNão tem definição para isso; evite-o até o projeto ser atualizado

Verificámos o código de cada projeto a 8 de novembro de 2026. Leia o README antes de instalar um projeto: executa código no seu computador e envia os seus prompts e imagens para a Google.

Como adicionar o Nano Banana ao Claude Code com um servidor MCP

  1. Crie uma chave da Gemini API no Google AI Studio e, depois, associe a faturação e adicione crédito pré-pago.
  2. Instale o uv, que transfere e executa o servidor por si.
  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 imediatamente antes do nome; caso contrário, o Claude Code interpreta o nome como mais uma variável.
  4. Verifique se ficou ligado: inicie o Claude Code e escreva /mcp.
  5. Peça uma imagem como parte da tarefa, por exemplo: «Cria uma imagem de destaque em 16:9 para esta landing page, guarda-a em public/images e depois abre-a e diz-me o que há a corrigir.»

O servidor guarda as imagens numa pasta nanobanana-images dentro da sua pasta pessoal, a não ser que defina IMAGE_OUTPUT_DIR. Por predefinição, o comando acima adiciona o servidor apenas para si, no projeto atual. Acrescente --scope user para o usar em todos os projetos. Não o adicione com o âmbito de projeto: isso escreve a chave num ficheiro .mcp.json que pode acabar por incluir num commit.

A definição flash usa o Nano Banana original, o único modelo da lista deste servidor que a Google ainda disponibiliza, e a Google desativa-o a 15 de março de 2027. O suporte ao Nano Banana 2.1 está num 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 a sua chave do Gemini.

Em alternativa, use uma skill

Uma skill reúne as suas regras de imagem num só sítio, como os tamanhos que usa e a estrutura de prompt de que gosta. A mais conhecida, cc-nano-banana, funciona através da extensão da Google para o Gemini CLI:

  1. Instale o Gemini CLI e a extensão: npm install -g @google/gemini-cli e, a seguir, gemini extensions install https://github.com/gemini-cli-extensions/nanobanana.
  2. Defina duas variáveis no perfil da sua shell: NANOBANANA_API_KEY com a 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 primeiro o respetivo SKILL.md. Diz ao Claude para executar o Gemini CLI com a flag --yolo, que aprova todas as ações do Gemini CLI sem perguntar. Alguns utilizadores também referem que a extensão não recebe a chave a partir da shell. Se escrever a sua própria skill, coloque nela o ID do modelo e guarde a chave numa variável de ambiente, não no ficheiro da skill.

Executar o Claude Code a partir do Orkas

Não tem de escolher entre o Orkas e a configuração que já tem.

  • Os seus servidores MCP e skills continuam a funcionar. Na barra lateral, escolha Ligar agentes e selecione o Claude Code. O Orkas executa a cópia instalada no seu computador, com a sua sessão iniciada. Acrescenta as suas próprias ferramentas ao lado dos seus servidores MCP em vez de os substituir, por isso o servidor do Nano Banana e as skills que configurou continuam a ser carregados.
  • Deixe cada agente fazer a sua parte. Peça ao Claude Code que construa a página ou a aplicação, e peça ao ImageStudio as imagens necessárias. O ImageStudio guarda os ficheiros no seu computador, por isso o Claude Code pode colocá-los no seu projeto.

Que caminho deve escolher?

O seu objetivoComece porO que obtém
Publicações para redes sociais, imagens de produto ou cartazes com texto exato, sem configuraçãoImageStudio no OrkasFicheiros PNG, JPG, WEBP, AVIF ou TIFF; modelo integrado e 500 créditos gratuitos para começar
Nano Banana 2.1 sem scripts nem ficheiros de configuraçãoImageStudio com a sua chave do GeminiImagens do Nano Banana; faturadas pela Google, sem créditos do Orkas
Imagens enquanto programa, sem sair do Claude CodeUm servidor MCP do Nano Banana, com o modelo definidoImagens guardadas no seu computador; a Google fatura cada imagem
Um fluxo de trabalho de imagem repetível, com as suas próprias regrasUma skill do Nano BananaUma skill que o próprio utilizador instala, lê e atualiza
Ícones, diagramas e gráficosO Claude Code por si sóCódigo SVG ou de gráficos; não é preciso modelo de imagem

Perguntas frequentes

O Claude Code consegue gerar imagens sozinho?

Não. A Anthropic diz que o Claude não gera fotografias nem ilustrações como fazem as ferramentas de geração de imagens. O Claude Code consegue escrever código SVG, HTML e de gráficos, e pode abrir ficheiros de imagem para os verificar, 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 escalão gratuito para os modelos de imagem: tem de associar a faturação e fazer um pré-pagamento de pelo menos $5, e o período experimental gratuito de $300 do Google Cloud não o abrange. O Nano Banana 2.1 custa $0.0336 por imagem 1K. O ImageStudio no Orkas tem um modelo integrado, e as contas novas recebem 500 créditos gratuitos.

Que modelo do Nano Banana devo usar?

Comece pelo Nano Banana 2.1 (gemini-nano-banana-2.1), o modelo mais recente. 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; a Google já os desativou.

Porque é que o meu servidor MCP do Nano Banana devolve um erro 404?

O mais provável é estar a chamar um modelo que a Google desativou. A Google desligou o gemini-2.5-flash-image-preview a 15 de janeiro de 2026, e o gemini-3.1-flash-image-preview e o gemini-3-pro-image-preview a 25 de junho de 2026. Configure o servidor com um modelo atual, se tiver essa definição, ou mude para uma ferramenta que permita 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 as contas novas recebem 500 créditos gratuitos. Se adicionar a sua própria chave do Gemini, o ImageStudio passa a usar o Nano Banana 2.1, e essas imagens são faturadas pela Google.

Para continuar a trabalhar a imagem no Photoshop, consulte Como usar o Claude no Photoshop. Para mais ideias, veja o que pode criar com o ImageStudio. Para experimentar com as suas próprias fotografias, descarregue o Orkas e comece pelo ImageStudio.