Orkas Orkas
Inicio Blog Claude Code + Nano Banana
Producto

Cómo generar imágenes en Claude Code con Nano Banana

Claude Code no puede dibujar por sí mismo, pero sí puede llamar a un modelo de imagen. Aquí te explicamos cómo conectar Nano Banana de Google con un servidor MCP o una skill, cuánto cuesta cada imagen y cómo obtener imágenes en Orkas sin una clave de Gemini.

Claude Code escribe código y texto, y puede ver imágenes, pero no puede dibujarlas. Para obtener imágenes, necesitas conectarle un modelo de imagen. Nano Banana, el modelo de imagen de Gemini de Google, es el que elige la mayoría: Claude Code accede a él a través de un servidor MCP o de una skill que envía tu prompt a la Gemini API con tu propia clave. Esta guía explica las dos configuraciones, cuánto cuesta cada imagen, un problema de modelos que hoy hace fallar a muchas de estas herramientas y una opción que no necesita ninguna clave.

La respuesta corta: si quieres imágenes terminadas sin configurar claves de API, usa ImageStudio en Orkas. Es un agente de imagen con un modelo de imagen integrado, y las cuentas nuevas reciben 500 créditos gratis. Si lo que buscas es específicamente Nano Banana, agrega tu clave de Gemini a Orkas: ImageStudio va a usar Nano Banana 2.1. Para llamar a Nano Banana desde Claude Code, agrega un servidor MCP de Nano Banana, pero configura tú el modelo: al 8 de noviembre de 2026, los servidores más populares usan de forma predeterminada ID de modelo que Google ya dio de baja.

¿Claude Code puede generar imágenes?

Por sí mismo, no. El centro de ayuda de Anthropic indica que Claude no genera fotos ni ilustraciones como lo hacen las herramientas de generación de imágenes. Puede escribir código SVG, HTML y de gráficas, lo cual alcanza para íconos, diagramas, banners sencillos y gráficas. Las fotos, las ilustraciones, las imágenes de producto y los estilos pictóricos necesitan un modelo de imagen. Codex, de OpenAI, ya trae generación de imágenes integrada, con gpt-image-2; Claude Code no tiene nada parecido.

Lo que Claude Code sí puede hacer es leer archivos de imagen. Después de que un modelo de imagen guarda una imagen en tu proyecto, Claude puede abrirla, compararla con lo que pediste y reescribir el prompt. Por ese ciclo mucha gente usa los dos juntos: Claude planea y revisa, y el modelo de imagen dibuja.

No existe un plugin oficial de Nano Banana en el marketplace de plugins de Anthropic. La gente lo conecta de una de estas tres maneras, y todas llaman a la Gemini API de Google con una clave que creas en Google AI Studio:

  • Un servidor MCP le da a Claude Code una herramienta nueva que puede llamar cada vez que una tarea necesita una imagen.
  • Una skill es una carpeta con instrucciones y, a veces, un script. Claude Code la carga cuando tu solicitud tiene que ver con imágenes o cuando la llamas por su nombre.
  • La extensión nanobanana de Google para Gemini CLI agrega comandos de imagen a Gemini CLI. Una skill de Claude Code puede ejecutarla por ti.

Sin configuración: ImageStudio en Orkas

Te recomendamos empezar con ImageStudio, el agente de imagen integrado en Orkas. Dale tu brief, tus fotos, tu logo y el texto exacto, y describe el resultado que quieres. Crea diseños para redes sociales, imágenes de producto, portadas, pósteres, infografías, gráficas e ilustraciones. Los titulares, los precios y las etiquetas se colocan como texto real, así que el texto sale exactamente como lo escribiste. Para editar una foto, dile qué cambiar, por ejemplo el fondo o la iluminación, y va a cambiar solo esa parte. Cuando una imagen necesita píxeles nuevos, usa el modelo integrado Seedream 5.5, a 13–23 créditos / imagen de salida + 5 / imagen de entrada. Las tareas de diseño, como cambiar el tamaño, recortar o colocar texto, no llaman a un modelo de imagen.

Si prefieres Nano Banana, agrega tu clave de Gemini en Orkas: abre Configuración, elige Modelos, luego Imagen y Agregar servicio de imágenes, selecciona Google · Nano Banana 2.1 y pega la clave. La clave nueva queda en primer lugar de la lista, así que ImageStudio genera con Nano Banana 2.1, el modelo actual. Google te cobra esas imágenes y Orkas no te descuenta créditos por ellas. Si una solicitud a Google falla, ImageStudio puede recurrir al modelo integrado, que sí usa créditos.

  1. Instala Orkas e inicia sesión. Las cuentas nuevas reciben 500 créditos gratis para los modelos integrados, así que puedes empezar sin una clave de API.
  2. Elige ImageStudio y agrega tus fotos y tu logo.
  3. Describe el resultado: el tamaño o la plataforma, el texto exacto, lo que no debe cambiar y el tipo de archivo que quieres.
  4. Revisa la imagen y pide cambios puntuales, como un titular más grande o un fondo diferente. De forma predeterminada genera una imagen nueva por solicitud, y solo hace otra cuando se la pides.

Recibes archivos PNG, JPG, WEBP, AVIF o TIFF guardados en tu computadora. ImageStudio no crea archivos PSD con capas ni archivos vectoriales.

Créalo con ImageStudio Obtén imágenes terminadas sin configurar un servidor MCP. Orkas es gratis en macOS y Windows. Las cuentas nuevas reciben 500 créditos para los modelos integrados, o puedes agregar tu propia clave de Gemini.
Descarga Orkas gratis

Una solicitud para probar

Agrega la foto de tu producto y tu logo, reemplaza lo que está entre corchetes y envíale esto a ImageStudio:

Crea una publicación de [1080×1350] para [Instagram] sobre [nuestras ofertas de primavera].
Usa [la foto de mi producto] como imagen principal y mantén el producto exactamente como está.
Ponlo sobre un fondo [de estudio color beige suave] con luz natural.
Usa exactamente este titular: "[Ofertas de primavera — 20% de descuento]".
Coloca [mi logo] en la esquina inferior derecha.
Entrega un PNG.

Cuando la imagen esté lista, pide cambios específicos, por ejemplo: "Haz el titular más grande y mueve el logo a la esquina superior derecha". ImageStudio cambia esa parte y deja el resto igual.

Modelos de Nano Banana y cuánto cuestan

Nano Banana es el nombre que Google usa para la generación de imágenes de Gemini. Estos son los modelos de la Gemini API, con los precios de lista de Google por imagen en el nivel de pago:

ModeloID del modeloPrecio por imagenNotas
Nano Banana 2.1gemini-nano-banana-2.1$0.0336 en 1K, $0.0504 en 2K, $0.113 en 4KEl modelo más nuevo, con disponibilidad general desde el 6 de octubre de 2026. Empieza por aquí.
Nano Banana 2 Litegemini-3.1-flash-lite-image$0.0336, solo 1KEl más rápido y económico. No está hecho para usar varias imágenes de referencia ni para ediciones paso a paso.
Nano Banana Progemini-3-pro-image$0.134 en 1K o 2K, $0.24 en 4KPara escenas complejas; razona antes de dibujar.
Nano Banana 2gemini-3.1-flash-image$0.067 en 1K, $0.101 en 2K, $0.151 en 4KObsoleto; Google recomienda 2.1 para proyectos nuevos.
Nano Bananagemini-2.5-flash-image$0.039El modelo original. Google lo da de baja el 15 de marzo de 2027.

Hay tres cosas que toman a muchos por sorpresa:

  • No hay nivel gratuito para imágenes. Para crear imágenes con una clave de API, necesitas vincular una cuenta de facturación y prepagar al menos $5. La prueba gratuita de $300 de Google Cloud no cubre la Gemini API.
  • Los ID de modelo preview ya no funcionan. Google dio de baja gemini-2.5-flash-image-preview el 15 de enero de 2026, y gemini-3.1-flash-image-preview y gemini-3-pro-image-preview el 25 de junio de 2026. Cualquier herramienta que todavía llame a alguno de ellos va a fallar.
  • Cada imagen lleva una marca de agua SynthID invisible. Esto aplica a todos los modelos de la tabla.

Los precios y los ID son de la página de precios de Google y de su guía de generación de imágenes, al 8 de noviembre de 2026.

Comparación de servidores MCP y skills de Nano Banana

Estos son los proyectos que más aparecen para Claude Code. Todos son gratuitos y de código abierto; las imágenes se las pagas a Google. Revisa el modelo antes de instalar:

ProyectoQué esModelo predeterminadoQué cambiar
nanobanana-mcp-serverServidor MCP, se ejecuta con uvUn ID preview de Nano Banana 2 que ya se dio de bajaConfigura NANOBANANA_MODEL como flash, que usa el Nano Banana original
extensión nanobananaExtensión de Google para Gemini CLIUn ID preview de Nano Banana 2 que ya se dio de bajaConfigura NANOBANANA_MODEL como gemini-nano-banana-2.1
cc-nano-bananaSkill de Claude Code que ejecuta la extensión anteriorEl predeterminado de la extensiónLa misma configuración que la extensión
Nano-Banana-MCPServidor MCP, se ejecuta con npxUn ID preview de Nano Banana, escrito directamente en el códigoNo tiene una opción para cambiarlo; mejor no lo uses hasta que actualicen el proyecto

Revisamos el código de cada proyecto el 8 de noviembre de 2026. Lee el README antes de instalar un proyecto: ejecuta código en tu computadora y envía tus prompts e imágenes a Google.

Cómo agregar Nano Banana a Claude Code con un servidor MCP

  1. Crea una clave de la Gemini API en Google AI Studio; luego vincula la facturación y agrega crédito prepagado.
  2. Instala uv, que descarga y ejecuta el servidor por ti.
  3. Agrega el servidor desde la terminal: claude mcp add --env GEMINI_API_KEY=your-key --env NANOBANANA_MODEL=flash --transport stdio nanobanana -- uvx nanobanana-mcp-server@latest. Deja --transport stdio justo antes del nombre; de lo contrario, Claude Code toma el nombre como otra variable.
  4. Verifica que se conectó: inicia Claude Code y escribe /mcp.
  5. Pide una imagen como parte de la tarea, por ejemplo: "Crea una imagen hero de 16:9 para esta landing page, guárdala en public/images y después ábrela y dime qué hay que corregir".

El servidor guarda las imágenes en una carpeta nanobanana-images dentro de tu carpeta de usuario, a menos que definas IMAGE_OUTPUT_DIR. De forma predeterminada, el comando anterior agrega el servidor solo para ti, en el proyecto actual. Agrega --scope user para usarlo en todos tus proyectos. No lo agregues con el alcance de proyecto: eso escribe la clave en un archivo .mcp.json que podrías terminar subiendo en un commit.

La opción flash usa el Nano Banana original, el único modelo de la lista de este servidor que Google todavía ofrece, y Google lo da de baja el 15 de marzo de 2027. Nano Banana 2.1 está en un pull request que todavía no se publica. Para usar 2.1 hoy, sigue el camino de la extensión que se explica más abajo, o usa ImageStudio con tu clave de Gemini.

Otra opción: usar una skill

Una skill guarda tus reglas para imágenes en un solo lugar, como los tamaños que usas y la estructura de prompt que prefieres. La más conocida, cc-nano-banana, funciona a través de la extensión de Google para Gemini CLI:

  1. Instala Gemini CLI y la extensión: npm install -g @google/gemini-cli y luego gemini extensions install https://github.com/gemini-cli-extensions/nanobanana.
  2. Define dos variables en el perfil de tu shell: NANOBANANA_API_KEY con tu clave de Gemini y NANOBANANA_MODEL=gemini-nano-banana-2.1.
  3. Agrega la skill: git clone https://github.com/kkoppenhaver/cc-nano-banana ~/.claude/skills/nano-banana
  4. Pídele una imagen a Claude Code o llama a la skill por su nombre con /nano-banana.

Primero lee su SKILL.md. Le indica a Claude que ejecute Gemini CLI con la opción --yolo, que aprueba todas las acciones de Gemini CLI sin preguntar. Algunos usuarios también reportan que la extensión no recibe la clave desde el shell. Si escribes tu propia skill, pon ahí el ID del modelo y deja la clave en una variable de entorno, no en el archivo de la skill.

Usa Claude Code desde Orkas

No tienes que elegir entre Orkas y la configuración que ya tienes.

  • Tus servidores MCP y skills siguen funcionando. En la barra lateral, elige Conectar agentes y selecciona Claude Code. Orkas ejecuta la copia instalada en tu computadora, con tu sesión iniciada. Agrega sus propias herramientas junto a tus servidores MCP en vez de reemplazarlos, así que el servidor de Nano Banana y las skills que configuraste se siguen cargando.
  • Deja que cada agente haga su parte. Pídele a Claude Code que construya la página o la app, y pídele a ImageStudio las imágenes que se necesiten. ImageStudio guarda los archivos en tu computadora, así que Claude Code puede integrarlos a tu proyecto.

¿Qué opción te conviene?

Tu objetivoEmpieza conQué obtienes
Publicaciones para redes sociales, imágenes de producto o pósteres con el texto exacto, sin configurar nadaImageStudio en OrkasArchivos PNG, JPG, WEBP, AVIF o TIFF; modelo integrado y 500 créditos gratis para empezar
Nano Banana 2.1 sin scripts ni archivos de configuraciónImageStudio con tu clave de GeminiImágenes de Nano Banana; te cobra Google, sin créditos de Orkas
Imágenes mientras programas, sin salir de Claude CodeUn servidor MCP de Nano Banana, con el modelo configuradoImágenes guardadas en tu computadora; Google cobra cada imagen
Un flujo de trabajo de imágenes repetible, con tus propias reglasUna skill de Nano BananaUna skill que tú mismo instalas, lees y actualizas
Íconos, diagramas y gráficasClaude Code por sí mismoCódigo SVG o de gráficas; no necesitas un modelo de imagen

Preguntas frecuentes

¿Claude Code puede generar imágenes por sí mismo?

No. Anthropic indica que Claude no genera fotos ni ilustraciones como lo hacen las herramientas de generación de imágenes. Claude Code puede escribir código SVG, HTML y de gráficas, y puede abrir archivos de imagen para revisarlos, así que funciona bien junto con un modelo de imagen como Nano Banana.

¿Nano Banana es gratis en Claude Code?

No. La Gemini API no tiene nivel gratuito para sus modelos de imagen: necesitas vincular la facturación y prepagar al menos $5, y la prueba gratuita de $300 de Google Cloud no la cubre. Nano Banana 2.1 cuesta $0.0336 por imagen 1K. ImageStudio en Orkas tiene un modelo integrado, y las cuentas nuevas reciben 500 créditos gratis.

¿Qué modelo de Nano Banana me conviene usar?

Empieza con Nano Banana 2.1 (gemini-nano-banana-2.1), el modelo más nuevo. Usa Nano Banana 2 Lite para las imágenes 1K más baratas y Nano Banana Pro para escenas complejas. Evita cualquier ID de modelo que termine en -preview; Google ya los dio de baja.

¿Por qué mi servidor MCP de Nano Banana devuelve un error 404?

Lo más probable es que esté llamando a un modelo que Google ya dio de baja. Google desactivó gemini-2.5-flash-image-preview el 15 de enero de 2026, y gemini-3.1-flash-image-preview y gemini-3-pro-image-preview el 25 de junio de 2026. Configura el servidor con un modelo actual si tiene esa opción, o cambia a una herramienta que te permita elegir el modelo.

¿Necesito una clave de la Gemini API para crear imágenes en Orkas?

No. ImageStudio usa el modelo integrado Seedream 5.5, y las cuentas nuevas reciben 500 créditos gratis. Si agregas tu propia clave de Gemini, ImageStudio usa Nano Banana 2.1 en su lugar, y Google te cobra esas imágenes.

Para seguir trabajando la imagen en Photoshop, revisa Cómo usar Claude con Photoshop. Para más ideas, mira todo lo que puedes crear con ImageStudio. Para probarlo con tus propias fotos, descarga Orkas y empieza con ImageStudio.