Como gerar imagens com Claude Code (2026): 3 métodos

O Claude Code não gera imagens sozinho. Veja como adicionar geração de imagens ao Claude Code com servidores MCP, uma CLI de capability runtime ou integração direta via API.

by AnyCap

Arte digital abstrata mostrando um cursor de pixel brilhante se transformando em fragmentos neon coloridos — estética de desenvolvedor em roxo escuro e azul

Não, o Claude Code não consegue gerar imagens sozinho. Ele é um agente de programação baseado em terminal, criado para raciocínio sobre código, manipulação de arquivos e execução de shell — não para geração de pixels. Mas há três formas práticas de adicionar geração de imagens ao Claude Code: um servidor MCP, uma CLI de capability runtime ou uma integração direta com API.

Este guia mostra as três opções, com comandos reais e exemplos de saída, para que você escolha a abordagem que faz mais sentido para o seu fluxo de trabalho.


O Claude Code pode gerar imagens? A resposta curta

O Claude Code, o agente de programação com IA nativo de terminal da Anthropic, tem zero capacidade nativa de geração de imagens. Ele pode escrever o componente <Image>, configurar lazy loading e otimizar breakpoints responsivos — mas não consegue produzir o arquivo de imagem em si.

Isso não é um bug. O Claude Code foi projetado para ser excelente em código — planejar, refatorar, depurar, entregar — e nada além disso. Se sua tarefa ficar dentro de arquivos .tsx e .py, o Claude Code é fortíssimo. No momento em que você precisa de uma imagem hero, um diagrama ou um criativo para rede social, você bate numa parede.

Na prática, fica assim:

Você: "Gere uma imagem hero para a landing page do nosso SaaS."

Claude Code: Não consigo gerar imagens.
Posso escrever o HTML/CSS da seção hero e componentes
placeholder. A imagem precisa ser obtida separadamente.

Este guia mostra como fechar essa lacuna.


Por que geração de imagens importa para usuários do Claude Code

Se você usa o Claude Code só para corrigir bugs e gerar boilerplate, a geração de imagens não é essencial. Mas os fluxos de trabalho mais produtivos com Claude Code envolvem entregar recursos completos de ponta a ponta — e recursos completos precisam de ativos visuais:

  • Landing pages precisam de imagens hero, logos e ilustrações de seção
  • Documentação precisa de diagramas, visuais de arquitetura e capturas de tela
  • Lançamentos em redes sociais precisam de artes, banners e miniaturas
  • Protótipos de UI precisam de mockups para mostrar a intenção do design
  • Sites de marketing precisam de imagens de produto, gráficos comparativos e conjuntos de ícones

Sem geração de imagens, cada uma dessas tarefas força você a sair do terminal — quebrando o fluxo de agente autônomo que torna o Claude Code tão poderoso.


Método 1: Servidor MCP (Replicate, Fal.ai ou Bannerbear)

Melhor para: Equipes que já usam servidores MCP e desenvolvedores que querem controle no nível do modelo.

O Model Context Protocol (MCP) é a forma padrão de conectar ferramentas externas ao Claude Code. Vários servidores MCP expõem modelos de geração de imagem:

Opção A: Replicate MCP Server

O Replicate hospeda modelos open source de imagem, como Stable Diffusion, FLUX e SDXL, por trás de uma API. O servidor MCP deles expõe esses modelos como ferramentas do Claude Code.

Configuração:

# Install the Replicate MCP server
claude mcp add replicate -- npx -y @replicate/mcp-server \
  --env REPLICATE_API_TOKEN=r8_your_token_here

Uso no Claude Code:

Você: "Gere uma imagem usando a ferramenta do Replicate:
       um dashboard moderno de SaaS com tema escuro, detalhes em azul,
       usando o modelo black-forest-labs/flux-schnell."

Claude Code: [chama a ferramenta MCP do Replicate]
  Imagem gerada: output.png (1024x1024)

Prós:

  • Acesso a modelos open source, como FLUX e SDXL
  • Preço por uso, sem compromisso mensal
  • Comunidade ativa mantendo o servidor MCP

Contras:

  • Cerca de 15 minutos de configuração (criar conta no Replicate, obter chave de API, configurar MCP)
  • Cerca de 6.000 tokens de overhead no contexto do Claude Code só para descrições de ferramentas
  • A escolha do modelo fica por sua conta — você precisa saber qual ID de modelo usar
  • A saída é um arquivo de imagem bruto — não há URL de CDN a menos que você faça upload separadamente

Opção B: Fal.ai MCP Server

A Fal.ai é especializada em inferência rápida para modelos generativos. A configuração é parecida:

claude mcp add fal -- npx -y @fal-ai/mcp-server \
  --env FAL_KEY=your_fal_key_here

Trade-off: Inferência mais rápida que no Replicate, mas com menos opções de modelos e uma comunidade menor.

Opção C: Bannerbear MCP (para imagens baseadas em templates)

Se você precisa de geração programática de imagens, como templates para redes sociais, imagens OG e banners dinâmicos, o MCP da Bannerbear foi feito exatamente para isso:

claude mcp add bannerbear -- npx -y @bannerbear/mcp-server \
  --env BANNERBEAR_API_KEY=your_key_here

Método 2: AnyCap CLI (um comando, sem configuração)

Melhor para: Desenvolvedores individuais e equipes pequenas que querem geração de imagens agora — não depois de 15 minutos configurando MCP.

A AnyCap é uma capability runtime que reúne geração de imagens, vídeo, busca na web e mais por trás de uma única CLI. O Claude Code a invoca direto do terminal — uma instalação, um comando, um login.

Configuração (30 segundos)

# One command installs the skill and CLI
npx -y skills add anycap-ai/anycap -a claude-code -y
curl -fsSL https://anycap.ai/install.sh | sh
anycap login

Gerar imagens a partir do Claude Code

Depois de instalada, o Claude Code pode gerar imagens diretamente pela CLI anycap:

Geração básica de imagem:

anycap image generate \
  --model seedream-5 \
  --prompt "um dashboard SaaS minimalista em fundo claro, UI limpa, cantos arredondados, detalhe azul" \
  -o dashboard-hero.png

Saída:

Generating image with seedream-5...
Image saved to dashboard-hero.png (1024x1024, 487KB)
CDN URL: https://cdn.anycap.ai/v1/images/abc123/dashboard-hero.png

A URL de CDN é retornada imediatamente — sem etapa separada de upload, sem configuração de S3. O Claude Code pode embuti-la diretamente em HTML ou markdown.

Avançado: gerar várias variações:

anycap image generate \
  --model nano-banana-pro \
  --prompt "desenvolvedor trabalhando em um terminal escuro, iluminação ambiente roxa, plano aberto" \
  --variants 3 \
  -o dev-terminal

Isso gera dev-terminal-1.png, dev-terminal-2.png e dev-terminal-3.png — três versões para escolher.

Refinamento imagem para imagem:

anycap image generate \
  --model seedream-5 \
  --prompt "mesma composição, mas com iluminação laranja quente em vez de azul" \
  --reference dashboard-hero.png \
  -o dashboard-hero-v2.png

Modelos disponíveis via AnyCap

Modelo Melhor para Estilo Velocidade
Seedream 5 Alta qualidade fotorealista e design Fotorealista, UI, produto Média
Nano Banana Pro Iteração rápida, conceitos, rascunhos Versátil Rápida
Nano Banana 2 Landing pages, imagens hero, marketing Limpo, comercial Rápida

O Claude Code não precisa saber IDs de modelo — o runtime escolhe o melhor modelo para o prompt se você não especificar um.

Prós:

  • 2 minutos de configuração — uma instalação, um login, uma credencial
  • Cerca de 2.000 tokens de overhead — contra cerca de 24.000 de cinco servidores MCP separados
  • CDN embutida — imagens geradas recebem URLs públicas automaticamente
  • Vários modelos — alterne entre Seedream 5, Nano Banana Pro e outros sem reconfigurar
  • Uma credencial para tudo — o mesmo login cobre imagem, vídeo, busca, armazenamento e publicação
  • Nativo para Claude Code — os comandos rodam na sua sessão de terminal e a saída vem em JSON estruturado

Contras:

  • Pagamento por uso — sem plano mensal fixo (começa com US$ 5 em crédito grátis)
  • Modelos curados — você usa os modelos oferecidos pela AnyCap, não modelos arbitrários do HuggingFace
  • Internet obrigatória — sem geração totalmente local

Método 3: Integração direta com API (OpenAI, Stability AI)

Melhor para: Desenvolvedores que precisam de controle máximo e se sentem confortáveis escrevendo sua própria integração.

Você pode dar geração de imagens ao Claude Code escrevendo uma ferramenta que chama diretamente uma API de imagens:

# tools/generate_image.py
import requests
import sys

API_KEY = "your-openai-api-key"

def generate(prompt: str, output_path: str = "output.png"):
    response = requests.post(
        "https://api.openai.com/v1/images/generations",
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={"prompt": prompt, "n": 1, "size": "1024x1024"}
    )
    url = response.json()["data"][0]["url"]
    
    # Download the image
    img = requests.get(url)
    with open(output_path, "wb") as f:
        f.write(img.content)
    
    return output_path

if __name__ == "__main__":
    prompt = sys.argv[1]
    path = sys.argv[2] if len(sys.argv) > 2 else "output.png"
    result = generate(prompt, path)
    print(f"Image saved to {result}")

Depois, registre essa ferramenta como uma ferramenta do Claude Code via MCP. Isso dá controle total sobre a API, o modelo e o tratamento da saída — com o custo de escrever e manter a integração por conta própria.

Prós:

  • Controle total sobre a escolha do modelo
  • Tratamento de erros personalizado
  • Sem dependências externas além da própria API

Contras:

  • Você escreve e mantém o código de integração
  • Gerenciamento manual de chaves de API
  • Sem CDN embutida — armazenamento e URLs ficam por sua conta
  • O formato de saída depende do que a API retornar

Comparação: qual método escolher?

Servidor MCP AnyCap CLI API direta
Tempo de configuração 15–30 min 2 min 30–60 min
Chaves de API para gerenciar 1 por servidor 1 no total 1 por API
Overhead de tokens no contexto ~6.000 ~2.000 ~3.000 (sua ferramenta)
Escolha de modelo Manual (saber IDs dos modelos) Curada ou automática Controle manual total
CDN / compartilhamento Upload manual Embutida Manual
Troca entre modelos Reconfigurar servidor MCP Flag de linha de comando Reescrever integração
Melhor para Equipes que já usam MCP Indivíduos e equipes pequenas Controle full-stack

Fluxo real: ponta a ponta com Claude Code + geração de imagens

Veja como fica um fluxo completo de criação de landing page com geração de imagens integrada:

Você: "Crie uma landing page para uma nova ferramenta de IA para desenvolvedores chamada 'CodeLens'.
      Inclua uma seção hero com uma imagem gerada, uma seção de recursos
      em três colunas e uma CTA."

Claude Code:
  1. Pesquisa na web landing pages parecidas de ferramentas para desenvolvedores
  2. Cria a base de um projeto Next.js com Tailwind CSS
  3. Escreve os componentes da landing page
  4. Chama anycap image generate para uma imagem hero:
     "dashboard futurista de análise de código, tema escuro,
      visualização de dados brilhante, estética de ferramenta para desenvolvedores"
  5. Embute a URL de CDN gerada no componente `<Image>`
  6. Gera ícones de recursos para cada seção
  7. Inicia o servidor de desenvolvimento para pré-visualização
  8. Faz commit e push no GitHub

Você: "Faça o deploy."

Claude Code:
  Compila o projeto, publica a página e retorna a URL ao vivo.

Uma sessão. Um terminal. Zero troca de ferramentas. Essa é a diferença entre um assistente de programação e um agente de desenvolvimento completo.


FAQ

O Claude Code consegue gerar imagens sozinho?

Não. O Claude Code é um agente de programação apenas de texto. Ele lê, escreve e edita código e arquivos. Não tem modelo, runtime nem API nativos de geração de imagens. Toda geração de imagem precisa vir de ferramentas externas — servidores MCP, uma capability runtime como a AnyCap ou chamadas diretas de API.

Por que o Claude Code não pode simplesmente chamar uma API de imagens?

Pode — se você configurar isso. O Claude Code tem acesso completo ao shell e pode executar comandos curl ou scripts em Python. O desafio não é que o Claude Code esteja bloqueado de chamar APIs; o desafio é que configurar a ferramenta, gerenciar chaves de API e lidar com os formatos de saída exige uma configuração que o Claude Code não faz sozinho. Os métodos 1 e 2 acima automatizam essa configuração.

A Anthropic pretende adicionar geração de imagens ao Claude Code?

A Anthropic não anunciou planos para adicionar geração de imagens ao Claude Code. O Claude Code é focado em raciocínio sobre código e execução no terminal. Geração de imagem, vídeo e mídia está fora do escopo — por isso existem camadas externas de capability.

Qual é a forma mais barata de gerar imagens a partir do Claude Code?

A AnyCap começa com US$ 5 em crédito grátis, sem pagamento obrigatório, e cobra por uso com os preços dos provedores de modelo, sem margem extra. Servidores MCP individuais, como Replicate, também oferecem cobrança por uso. Para uso ocasional, com algumas imagens por sessão, qualquer uma das abordagens custa centavos por imagem.

Posso usar Midjourney ou DALL-E a partir do Claude Code?

Diretamente, não — nem Midjourney nem DALL-E têm CLI ou servidor MCP oficial. Você pode escrever uma integração personalizada que chame as APIs deles, como no Método 3, mas isso exige criar e manter seu próprio código de ferramenta. Os modelos curados da AnyCap, como Seedream 5 e Nano Banana Pro, oferecem qualidade comparável sem esse trabalho de integração.

Preciso de GPU para gerar imagens a partir do Claude Code?

Não. Os três métodos usam APIs em nuvem — a geração acontece em servidores remotos, não na sua máquina local. Sua sessão de terminal envia um prompt e recebe uma URL ou um arquivo. Não há necessidade de GPU local, download de modelos ou requisitos de hardware além de um terminal.

Como uso a imagem gerada no meu projeto?

No Método 2, com a AnyCap CLI, a imagem é salva localmente no caminho que você especificar e enviada para uma CDN. O Claude Code pode embutir a URL da CDN diretamente:

<Image src="https://cdn.anycap.ai/v1/images/abc123/dashboard-hero.png"
       alt="Imagem hero de dashboard SaaS" width={1200} height={600} />

No Método 1, com MCP, a imagem é salva localmente — se você precisar de URLs públicas, terá de fazer o upload para uma CDN separadamente.


Próximos passos