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.
- 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.
- Escolha o ImageStudio e adicione as suas fotografias e o seu logótipo.
- Descreva o resultado: o tamanho ou a plataforma, o texto exato, o que tem de ficar igual e o tipo de ficheiro que pretende.
- 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.
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:
| Modelo | ID do modelo | Preço por imagem | Notas |
|---|---|---|---|
| Nano Banana 2.1 | gemini-nano-banana-2.1 | $0.0336 em 1K, $0.0504 em 2K, $0.113 em 4K | O modelo mais recente, com disponibilidade geral desde 6 de outubro de 2026. Comece por aqui. |
| Nano Banana 2 Lite | gemini-3.1-flash-lite-image | $0.0336, apenas 1K | O 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 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; a Google recomenda o 2.1 para projetos novos. |
| Nano Banana | gemini-2.5-flash-image | $0.039 | O 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:
| Projeto | O que é | Modelo predefinido | O que alterar |
|---|---|---|---|
| nanobanana-mcp-server | Servidor MCP, executado 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 da 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 executa a extensão acima | A predefinição da extensão | A mesma definição da extensão |
| Nano-Banana-MCP | Servidor MCP, executado com npx | Um ID preview do Nano Banana, fixo no código | Nã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
- Crie uma chave da Gemini API no Google AI Studio e, depois, associe a faturação e adicione crédito pré-pago.
- Instale o uv, que transfere e executa o servidor por si.
- 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 stdioimediatamente antes do nome; caso contrário, o Claude Code interpreta o nome como mais uma variável. - Verifique se ficou ligado: inicie o Claude Code e escreva
/mcp. - 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:
- Instale o Gemini CLI e a extensão:
npm install -g @google/gemini-clie, a seguir,gemini extensions install https://github.com/gemini-cli-extensions/nanobanana. - Defina duas variáveis no perfil da sua shell:
NANOBANANA_API_KEYcom a 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 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 objetivo | Comece por | O que obtém |
|---|---|---|
| Publicações para redes sociais, imagens de produto ou cartazes com texto exato, sem configuração | ImageStudio no Orkas | Ficheiros 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ção | ImageStudio com a sua chave do Gemini | Imagens do Nano Banana; faturadas pela Google, sem créditos do Orkas |
| Imagens enquanto programa, sem sair do Claude Code | Um servidor MCP do Nano Banana, com o modelo definido | Imagens guardadas no seu computador; a Google fatura cada imagem |
| Um fluxo de trabalho de imagem repetível, com as suas próprias regras | Uma skill do Nano Banana | Uma skill que o próprio utilizador instala, lê e atualiza |
| Ícones, diagramas e gráficos | O 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.