Diseño y frontend Guía paso a paso

Restaurar fotos antiguas con Claude Code y Nano Banana (Gemini)

Paso a paso para conectar Claude Code con los modelos de imagen de Google Gemini a través del servidor MCP de código abierto Nano Banana, y usarlo para restaurar fotos viejas, rayadas o desenfocadas. Incluye prompts que priorizan la fidelidad frente a la reinterpretación, consejos de calidad y qué cuidar con la privacidad de las imágenes.

Nivel
Principiante
Qué necesitas
Claude Code, uv (para ejecutar uvx) y una clave de la API de Gemini de Google AI Studio.
Cuánto lleva
Unos 15 minutos la primera vez

Herramientas que usa esta guía

01 Qué vas a montar

Claude no edita imágenes por sí mismo, pero puede usar herramientas externas a través de MCP (Model Context Protocol). Nano Banana MCP Server es un servidor de código abierto que le da a Claude acceso a los modelos de imagen de Gemini para generar y editar fotos. Tú le pasas la imagen y las instrucciones; Claude llama a la herramienta, recibe el resultado y lo guarda en tu disco.

Para restaurar fotos es especialmente útil porque puedes iterar en lenguaje natural: «recupera el detalle de la cara pero no cambies el peinado», «quita las manchas del cielo», «saca una versión en blanco y negro y otra coloreada».

01

Nano Banana 2 (por defecto)

Gemini 3.1 Flash Image: rápido y con salida de hasta 4K. Sirve para la mayoría de restauraciones.

02

Nano Banana Pro

Gemini 3 Pro Image: más razonamiento para escenas complejas o fotos de grupo. Más lento.

03

Selección automática

El servidor elige modelo según tu petición; palabras como «4K» o «profesional» tienden a activar Pro.

02 Paso 1: consigue tu clave de Gemini

  1. 1

    Entra en Google AI Studio

    Inicia sesión con tu cuenta de Google en aistudio.google.com.

  2. 2

    Crea una clave de API

    Desde la sección de claves de API, genera una nueva y cópiala.

  3. 3

    Revisa límites y precio

    Comprueba en AI Studio qué cuota y coste tiene tu clave para los modelos de imagen antes de procesar muchas fotos.

03 Paso 2: añade el servidor MCP a Claude Code

El servidor se ejecuta con uvx, que descarga y lanza la última versión publicada. Si no tienes uv, instálalo antes siguiendo su documentación oficial. Después, desde la terminal (fuera de Claude Code):

bash · Registrar Nano Banana en Claude Code
claude mcp add nanobanana --env GEMINI_API_KEY=TU_CLAVE -- uvx nanobanana-mcp-server@latest

Abre Claude Code y ejecuta /mcp: deberías ver nanobanana conectado con herramientas como generate_image y edit_image. Las imágenes se guardan por defecto en ~/nanobanana-images; puedes cambiar la carpeta añadiendo --env IMAGE_OUTPUT_DIR=/ruta/que/quieras al comando, o pedir a Claude una ruta concreta en cada petición.

bash · Alternativa con pip (si prefieres instalarlo en tu Python)
pip install nanobanana-mcp-server

04 Paso 3: restaura tu primera foto

  1. 1

    Escanea bien el original

    Mejor un escaneo a 600 ppp que una foto con el móvil. Evita reflejos y recorta el marco.

  2. 2

    Abre Claude Code en la carpeta de la foto

    Así puedes referirte a ella por su nombre de archivo.

  3. 3

    Pide la restauración

    Usa uno de los prompts de abajo, indicando la ruta del archivo y dónde guardar el resultado.

  4. 4

    Compara y ajusta

    Abre original y resultado lado a lado. Pide correcciones concretas en vez de repetir el prompt entero.

Prompt · Restauración fiel (el punto de partida recomendado)
Usa la herramienta de edición de Nano Banana sobre fotos/abuelos-1965.jpg y guarda el resultado en fotos/restauradas/.

Objetivo: restaurar, no reinventar.
- Elimina rayas, manchas, polvo y pliegues.
- Recupera nitidez y detalle de forma natural, sin efecto plástico ni piel retocada.
- Mantén exactamente rasgos faciales, expresión, peinado, ropa, encuadre y fondo.
- Respeta la iluminación y el grano propios de una foto de la época.
- No añadas elementos ni cambies el estilo.
Si alguna zona está demasiado dañada para recuperarla con fidelidad, dímelo en lugar de inventar detalle.
Prompt · Colorear después de restaurar
Sobre fotos/restauradas/abuelos-1965.jpg, crea una versión coloreada y guárdala con el sufijo -color. Colores realistas y sobrios, propios de España en los años 60. No modifiques caras, formas ni composición; solo añade color. Si dudas del color de una prenda u objeto, elige tonos neutros.
Prompt · Lote de fotos de un archivo familiar o de empresa
En la carpeta archivo/ hay fotos escaneadas. Procésalas de una en una con la misma instrucción de restauración fiel que usamos antes y guarda cada resultado en archivo/restauradas/ con el mismo nombre. Al terminar, dame una lista con las que han quedado bien y las que conviene revisar a mano, y por qué.

05 Consejos de calidad y de cuidado

  • ✓Conserva siempre el original sin tocar; trabaja sobre copias.
  • ✓Si el resultado cambia la cara, dilo explícitamente: «la nariz y los ojos deben ser idénticos al original».
  • ✓Para formatos concretos, pide la proporción (1:1, 4:3, 16:9, 9:16…) en lugar de recortar después.
  • ✓Restaura y colorea en pasos separados: así puedes quedarte con la mejor versión de cada uno.
  • ✓Las imágenes se envían a la API de Google para procesarse: no subas fotos de terceros sin su permiso ni documentos con datos sensibles.

Preguntas frecuentes

No. Basta con ejecutar un comando en la terminal para registrar el servidor y luego hablar con Claude Code en español.

Sí. El proyecto explica cómo añadirlo al archivo claude_desktop_config.json con el mismo comando uvx y la variable GEMINI_API_KEY.

Porque el modelo regenera la imagen. Pide fidelidad de forma explícita, prohíbe cambios de rasgos y, si hace falta, prueba el modelo Pro, que razona más la composición.

El servidor es gratuito y de código abierto. Lo que tiene coste o límites es el uso de la API de Gemini, según tu cuenta y el modelo; revísalo en Google AI Studio.

Sobre el autor

Equipo editorial de appyweb

Marketing, SEO y desarrollo con IA

Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.

Sigue con estas guías

Guía paso a paso · Principiante

Claude Banana: prompts profesionales para generar imágenes con IA desde Claude Code

Claude Banana es un proyecto para Claude Code que actúa como director de arte: te hace un par de preguntas sobre la imagen que quieres y devuelve un prompt narrativo con sujeto, estilo, entorno, luz, acción, cámara y texturas. Incluye plantillas, presets de marca y scripts opcionales para generar las imágenes con la API de Google.

Cinco minutos para descargarlo y unos minutos por imagen. Leer la guía →
Guía paso a paso · Principiante

Awesome GPT Image 2: cómo usar el mayor catálogo de prompts de imagen con Claude como adaptador

awesome-gpt-image-2 es una colección abierta de miles de prompts de imagen para GPT Image 2 de OpenAI, organizada por usos, estilos y temas. Esta guía explica cómo encontrar una buena base en el catálogo, cómo pedir a Claude que la adapte a tu producto y tu marca, y qué revisar antes de publicar la imagen.

Unos 15 minutos para la primera imagen; después, cinco minutos por pieza Leer la guía →
Guía paso a paso · Intermedio

Monta un estudio creativo con Claude: vídeo, anuncios, tendencias, voz y redacción

Seis piezas que convierten Claude Code en un pequeño estudio de contenido: vídeo programado con Remotion o HyperFrames, análisis de anuncios de la competencia, investigación de tendencias de los últimos 30 días, una skill con tu voz de marca, narración local con Voicebox y redacción con fuentes verificables. Para creadores, equipos de marketing y agencias pequeñas.

Unos 15 minutos por herramienta; empieza solo por la que más te ahorre Leer la guía →
Guía paso a paso · Principiante

Claude para trabajo creativo: conectores con Adobe, Blender, Ableton y otras herramientas

Anthropic ha publicado conectores para que Claude trabaje junto al software creativo profesional: diseño, 3D, música y visuales en directo. Te explicamos qué permite cada uno de verdad, cómo activarlos, qué papel juegan Claude Code y Claude Design, y prompts para empezar en tu disciplina.

Unos 10 minutos para activar un conector y probarlo Leer la guía →
Guía paso a paso · Principiante

Conectar Claude a tus aplicaciones: Google, Shopify, Meta Ads, Higgsfield y más

Los conectores permiten que Claude lea y actúe dentro de tus herramientas: correo, calendario, documentos, tienda online o campañas de publicidad. Verás la diferencia entre los conectores del directorio y los personalizados por URL, cómo activarlos, qué permisos conceder y prompts de trabajo para cada caso, con especial atención a la seguridad.

Unos 10 minutos por conector Leer la guía →

¿Quieres llevar la IA a tu empresa sin pelearte con todo esto?

Diseñamos e implantamos agentes, automatizaciones y asistentes con IA a medida de tu negocio.

Ver nuestros servicios de IA

Cuéntanos tu proyecto. Te respondemos en 48 h.

Auditoría gratuita de IA, campañas, web y SEO, con prioridades y cifras reales de tu negocio.

✓ Sin compromiso ✓ Respuesta en 48 h laborables ✓ Un consultor senior, no un bot
WA WhatsApp