No necesitas aprender la CLI: deja que Claude Code ejecute Wonda por ti

La mayoría de los desarrolladores nunca memorizan los comandos CLI. Buscan, copian, pegan y olvidan. El cambio de comportamiento no es que a los ingenieros de repente les encante la sintaxis de terminal. Es que cada vez más esperan que un agente de IA cubra la brecha entre intención y ejecución.

La encuesta de herramientas de 2026 de Pragmatic Engineer reveló que el 95% de los encuestados usa herramientas de IA al menos semanalmente, el 75% usa IA para al menos la mitad de su trabajo de ingeniería y el 55% ahora usa agentes de IA regularmente (Pragmatic Engineer, 2026). La implicación va más allá de "la IA es popular". Significa que los desarrolladores se están acostumbrando a describir el resultado que quieren y dejar que un agente opere la cadena de herramientas.

Esa es toda la filosofía de diseño detrás de la CLI de Wonda. No fue construida para que la memorices. Fue construida para que Claude Code la lea.

Si estás intentando específicamente automatizar flujos de publicación, empieza con Cómo automatizar publicaciones en Instagram desde la terminal con agentes de IA y Cómo construir un pipeline de TikTok en piloto automático en 30 días. Si estás eligiendo modelos para el paso de generación, usa Guía para desarrolladores sobre generación de vídeo con IA en 2026. Este post es sobre la capa de control: cómo Claude Code convierte la CLI de Wonda en una interfaz de lenguaje natural.

Puntos clave

• La CLI de Wonda está diseñada como interfaz para agentes, no como ejercicio de memorización humana.
• Claude Code lee el archivo de skill de Wonda y descubre cada comando, flag y flujo de trabajo automáticamente.
• Describes la intención en lenguaje natural. El agente lo traduce a los comandos CLI correctos.
• Desde generación de imágenes hasta anuncios en vídeo y publicación social, todo el pipeline se ejecuta desde una conversación.

El problema: las CLIs son poderosas pero nadie lee la documentación

La encuesta de desarrolladores de Stack Overflow 2025 reveló que el 84% de los encuestados usa o planea usar herramientas de IA en su proceso de desarrollo, y el 51% de los desarrolladores profesionales ahora usa herramientas de IA a diario (Stack Overflow, 2025). Al mismo tiempo, más desarrolladores desconfían de la precisión del output de IA (46%) de los que confían en ella (33%). Hay una brecha entre lo que las herramientas pueden hacer y para qué la gente realmente las usa. Las CLIs caen justo en esa brecha.

Las herramientas de línea de comandos son las interfaces más poderosas del software. Se componen, se scriptean, se automatizan. Pero tienen una curva de aprendizaje brutal. Necesitas saber los nombres exactos de los flags, el orden de argumentos, qué opciones chocan entre sí. Te equivocas en un detalle y obtienes un error críptico.

Así que la mayoría recurre a GUIs. Hacen clic en dashboards web. Arrastran y sueltan archivos en formularios de subida. Pierden horas en flujos manuales que podrían ejecutarse en segundos.

¿Y si el problema no fuera la CLI en sí? ¿Y si fuera suponer que un humano necesita operarla?

El insight: la CLI no es para ti. Es para tu agente de IA.

Según la encuesta de 2026 de Pragmatic Engineer, el 55% de los desarrolladores ahora usa agentes de IA regularmente, y Claude Code pasó de cero a la herramienta de programación con IA más usada en solo ocho meses (Pragmatic Engineer, 2026).

Ese crecimiento te dice algo. Los desarrolladores no están aprendiendo más herramientas. Están aprendiendo menos herramientas y delegando el resto a los agentes.

Wonda se construyó con esto en mente. La CLI es la API. Es una interfaz estructurada y componible que un agente de IA puede leer, entender y ejecutar. No necesitas saber que --model nano-banana-2 genera imágenes o que --aspect-ratio 9:16 configura el modo vertical. Claude Code ya lo sabe, porque Wonda se lo dice.

Cómo funciona: tres pasos, cero memorización

La configuración tarda unos dos minutos. Le dices a Claude Code qué hacer y se encarga del resto.

Paso 1: Instala Wonda

Abre Claude Code (o cualquier terminal con Claude Code ejecutándose) y di:

Install the Wonda CLI from wonda.sh.

Claude Code ejecuta:

curl -fsSL https://wonda.sh/install.sh | bash

Un comando. Wonda está en tu PATH. Sin Docker, sin node_modules, sin dependencias de runtime.

Paso 2: Deja que Claude Code descubra el archivo de skill

Este es el paso clave conceptualmente, pero no es tan manual como la mayoría supone. Wonda sincroniza automáticamente su archivo de skill orientado a agentes en ~/.wonda/skill/wonda-cli.md en segundo plano con cada comando. Cuando Claude Code ejecuta wonda --help, puede ver dónde vive ese archivo y leerlo.

Si quieres forzar una actualización del archivo o copiarlo a un directorio local de herramientas de IA, puedes pedirle a Claude Code que ejecute:

Refresh Wonda's skill file and sync it locally.

Claude Code ejecuta:

wonda skill install

En planes de pago, ese comando fuerza la actualización del archivo de skill principal y puede sincronizarlo también con directorios locales de herramientas de IA. Lo importante no es el comando en sí. Lo importante es que Claude Code tenga acceso a un manual de operaciones actualizado y legible por agentes para Wonda.

Paso 3: Simplemente describe lo que quieres

A partir de aquí, hablas con Claude Code en lenguaje natural. Traduce tu intención a los comandos CLI exactos.

Sin sintaxis que recordar. Sin páginas man que buscar. Solo describe el resultado.

Ejemplos reales: lenguaje natural entra, comandos CLI salen

Así se ve en la práctica. Cada ejemplo muestra lo que tú dices y lo que Claude Code realmente ejecuta.

"Genera una foto de producto para mi marca de café"

Tú dices:

Generate a hero image for my coffee brand. Show a ceramic mug
with latte art, morning light, clean background. Portrait for Instagram.

Claude Code ejecuta:

wonda generate image \
  --model nano-banana-2 \
  --prompt "ceramic coffee mug with latte art, soft morning light, clean minimal background, product photography" \
  --aspect-ratio 9:16 \
  --wait -o coffee-hero.png

Eligió el modelo correcto (nano-banana-2 es el default para imágenes), configuró la relación de aspecto para Instagram y escribió un prompt limpio. Obtuviste una imagen lista para producción sin abrir una sola página de documentación. Para una mirada más profunda a la selección de modelos y patrones de prompt para generación de imágenes, consulta Cómo generar imágenes con IA desde la línea de comandos.

"Crea un anuncio de vídeo de 10 segundos del mismo producto"

Tú dices:

Now make a 10-second video ad of that coffee mug.
Steam rising, camera slowly pushing in. Use Sora.

Claude Code ejecuta:

MEDIA=$(wonda media upload coffee-hero.png --quiet)
wonda generate video \
  --model sora2 \
  --prompt "steam rising gently from the mug, camera slowly pushes in, warm ambient lighting shifts" \
  --attach $MEDIA \
  --duration 10 \
  --aspect-ratio 9:16 \
  --wait -o coffee-ad.mp4

Observa cómo subió la imagen anterior como referencia, usó un prompt de imagen a vídeo que describe solo el movimiento (no el contenido de la imagen) y encadenó el output del paso uno al paso dos. Ese es el tipo de conocimiento de flujo de trabajo integrado en el archivo de skill.

"Publica esto en Instagram con un pie de foto"

Tú dices:

Publish that video to my Instagram with a caption about morning rituals.

Claude Code ejecuta:

ACCOUNT_ID=$(wonda accounts instagram --jq '.[0].id')
VID_MEDIA=$(wonda media upload coffee-ad.mp4 --quiet)
wonda publish instagram \
  --media $VID_MEDIA \
  --account $ACCOUNT_ID \
  --caption "The best mornings start slow. New blend, same ritual. #coffee #morningroutine"

Verificó tus cuentas conectadas, subió el medio, escribió un pie de foto acorde con tu indicación y lo publicó. Todo el ciclo de generación a publicación se ejecutó en una sola conversación.

"Scrapea el Instagram de mi competidor y crea contenido similar"

Aquí es donde los flujos impulsados por agentes realmente brillan. Tú dices:

Scrape @bluebottlecoffee on Instagram, identify their recurring
visual style, and generate three original images for my brand.

Claude Code encadena múltiples comandos:

# Research the competitor
wonda scrape social --handle @bluebottlecoffee --platform instagram --wait

# Analyze the results, identify recurring visual patterns, then generate
wonda generate image \
  --model nano-banana-2 \
  --prompt "minimalist pour-over coffee setup, natural light, earth tones, overhead angle" \
  --aspect-ratio 1:1 --wait -o variation-1.png

wonda generate image \
  --model nano-banana-2 \
  --prompt "hands holding a ceramic coffee cup, soft bokeh background, warm palette" \
  --aspect-ratio 1:1 --wait -o variation-2.png

wonda generate image \
  --model nano-banana-2 \
  --prompt "coffee beans scattered on marble surface, single cup in frame, editorial product shot" \
  --aspect-ratio 1:1 --wait -o variation-3.png

Un pipeline de investigación a creación de múltiples pasos. Sin necesidad de scripting. Claude Code leyó el feed del competidor, identificó patrones recurrentes y generó contenido original inspirado en ese estilo sin copiar el material fuente.

El archivo de skill: cómo Claude Code aprende cada comando

El archivo de skill es el puente entre el lenguaje natural y la ejecución CLI. Wonda mantiene ese documento sincronizado automáticamente en segundo plano, y wonda --help expone la ruta para que Claude Code pueda encontrarlo. Si ejecutas explícitamente wonda skill install, estás forzando la actualización del archivo, no creando el concepto desde cero.

Ese documento cubre:

• Cada comando con sus flags y argumentos
• Lógica de selección de modelo (cuándo usar Sora vs. Kling vs. NanoBanana)
• Reglas de escritura de prompts (los prompts de imagen a vídeo describen movimiento, no la imagen)
• Patrones de encadenamiento (cómo redirigir el output de un comando al siguiente)
• Reglas específicas por plataforma (Instagram siempre lleva formato retrato 9:16, TikTok necesita --aigc)

Piénsalo como darle a tu agente un manual de operaciones completo. El agente no adivina. Lee, razona y ejecuta.

Esto importa porque los agentes de IA son tan buenos como el contexto que reciben. La encuesta de Stack Overflow 2025 reveló que más desarrolladores desconfían de la precisión del output de IA (46%) de los que confían en ella (33%) (Stack Overflow, 2025). El archivo de skill reduce esa brecha de confianza dándole a Claude Code instrucciones precisas y verificadas en vez de depender de datos de entrenamiento generales.

Por qué esto importa: la CLI es la API para los agentes

La razón por la que esto importa no es hype abstracto del mercado. El cambio de flujo ya está aquí. La encuesta de 2026 de Pragmatic Engineer reveló que el 55% de los encuestados ahora usa agentes de IA regularmente, y la encuesta de 2025 de Stack Overflow muestra que los desarrolladores ya están tejiendo la IA en el trabajo de desarrollo cotidiano sin dejar de exigir verificación (Pragmatic Engineer, 2026, Stack Overflow, 2025). La gente no quiere otro dashboard. Quiere un agente que pueda operar herramientas reales de forma predecible.

Las CLIs son la interfaz natural para este cambio. Son estructuradas, componibles y deterministas. Un agente puede ejecutar un comando CLI y obtener un resultado predecible. Puede encadenar comandos en pipelines. Puede reintentar tras un fallo con parámetros ajustados.

Las GUIs no funcionan así. No le puedes decir a un agente "haz clic en el tercer botón de la barra lateral". Pero sí puedes decirle "genera un vídeo con Sora y publícalo en TikTok". Si la CLI existe, el agente puede operarla.

Esa es la apuesta que hace Wonda. La CLI no es una función para usuarios avanzados. Es la interfaz principal, diseñada desde el día uno para que los agentes la lean y ejecuten. Los humanos describen la intención. Los agentes se encargan de la ejecución.

Empieza en 60 segundos

El camino más rápido de cero a tu primer contenido generado por IA:

# 1. Install Wonda
curl -fsSL https://wonda.sh/install.sh | bash

# 2. Log in
wonda auth login

# 3. Let Claude Code inspect the CLI
wonda --help

# Optional on paid plans: force-refresh the skill file
wonda skill install

Luego abre Claude Code y di: "Genera una imagen de producto para mi marca y publícala en Instagram."

Eso es todo. Claude Code lee la ayuda CLI, encuentra el archivo de skill, elige los modelos correctos, genera el contenido y lo publica. Describiste lo que querías. El agente hizo el resto.

Preguntas frecuentes

¿Necesito conocer algún comando CLI para usar Wonda con Claude Code?

No. Ese es el punto. Wonda está diseñado para que Claude Code pueda operar la CLI en tu nombre. Describes lo que quieres en lenguaje natural y Claude Code lo traduce a los comandos correctos. Si quieres ver la misma idea aplicada a un flujo concreto, Cómo automatizar publicaciones en Instagram desde la terminal con agentes de IA muestra el ciclo completo de generación a publicación.

¿El archivo de skill se actualiza automáticamente?

Sí. Wonda sincroniza automáticamente el archivo de skill principal en segundo plano con cada comando. wonda skill install es la ruta de actualización forzada y el helper de sincronización local, no la única forma en que existe el archivo. Una nota práctica: los comandos de skill están en planes de pago, así que si estás en un nivel inferior, Claude Code aún puede descubrir la ruta del archivo de skill auto-sincronizado a través de wonda --help.

¿Puedo usar esto con otros agentes de IA además de Claude Code?

El archivo de skill es un documento markdown. Cualquier agente de IA que pueda leer archivos y ejecutar comandos de shell puede usarlo. Claude Code tiene la integración más profunda porque admite nativamente archivos de skill, pero la CLI de Wonda en sí es agnóstica respecto al agente.

¿Qué pasa si Claude Code ejecuta el comando incorrecto?

Los comandos CLI son explícitos e inspeccionables. Puedes ver exactamente qué va a ejecutar Claude Code antes de que lo ejecute. A diferencia de la automatización GUI que hace clic en estados invisibles, cada comando CLI es una cadena legible. Si algo no parece bien, lo detienes. Según la encuesta de Stack Overflow 2025, el 80% de los desarrolladores usan herramientas de IA en sus flujos pero siguen verificando los outputs manualmente (Stack Overflow, 2025). La CLI hace que esa verificación sea trivial.

¿Tiene algún coste usar Wonda con Claude Code?

Si inicias sesión en el plan gratuito, Wonda cubre generación de imágenes y vídeo más el stack de edición. La publicación, scraping, analíticas y subida de medios también funcionan en planes inferiores, incluyendo cuentas anónimas. El análisis de vídeo y los comandos de skill explícitos como wonda skill install requieren un plan de pago. Consulta wonda.sh para precios actuales.