La codificación agentiva está yendo más allá del autocompletado: las herramientas modernas pueden planificar tareas, editar múltiples archivos, ejecutar comandos y repetir en fallos hasta que el resultado realmente funcione. OpenCode es un agente de codificación de código abierto y agnóstico al modelo que puedes ejecutar en la terminal (y también como aplicación de escritorio o extensión de IDE), lo que lo convierte en una forma práctica de probar este flujo de trabajo en tu propio entorno.
💡En esta guía, tendrás:
- Conectar Kimi K2.5 a OpenCode a través de la API de Novita AI
- OpenCode instalado y listo para usar en tu interfaz preferida (terminal/escritorio/IDE)
- Construir un pequeño proyecto demo.
¿Qué es OpenCode?
OpenCode es un agente de codificación de IA de código abierto que puedes ejecutar en múltiples entornos de desarrollo — más comúnmente como una interfaz basada en terminal (CLI + TUI), pero también como aplicación de escritorio o extensión de IDE.
OpenCode vs Claude Code
OpenCode y Claude Code son ambos agentes de codificación de IA basados en terminal, pero toman caminos diferentes.
- OpenCode es un agente de código abierto y agnóstico al proveedor: destaca soporte para “más de 75 proveedores de LLM a través de Models.dev (incluyendo modelos locales)” y se posiciona como una herramienta flexible que puedes conectar a diferentes backends de modelos.
- Claude Code, por el contrario, es el CLI oficial de Anthropic centrado en Claude — una herramienta de línea de comandos para acceder a modelos Claude en la terminal — además de un ecosistema oficial para extensiones (plugins) y conexiones de herramientas/datos a través de MCP.
Tabla comparativa rápida
| Aspecto | OpenCode | Claude Code |
| Posicionamiento | Agente de codificación de terminal de código abierto y multimodelo | Agente de codificación de terminal oficial de Anthropic centrado en Claude |
| Elección de modelo/proveedor | Más de 75 proveedores de LLM a través de Models.dev, incl. modelos locales | Construido alrededor de Claude; se extiende mediante MCP + plugins |
| Automatización de GitHub | Comentarios /opencode o /oc; se ejecuta en el runner de GitHub Actions | Las extensiones se centran en plugins/MCP (ecosistema oficial) |
| Punto de entrada de precios | La herramienta es de código abierto; el costo depende del backend del modelo elegido | Planes de Claude (Pro/Max/Team/Enterprise) |
¿Por qué Kimi K2.5?
Kimi K2.5 reúne multimodalidad nativa, ejecución real de herramientas y orquestación de agentes a gran escala en un solo modelo abierto. Entrenado con ~15T de tokens mixtos de visión y texto, abarca comprensión de imágenes/video, generación de código y depuración visual.
De Kimi
Conclusiones prácticas
- Mejores benchmarks agentivos frente a GPT-5.2, Claude 4.5 Opus y Gemini 3 Pro: En el gráfico, Kimi K2.5 lidera en conjuntos de evaluación agentiva: HLE-Full 50.2, BrowseComp 74.9, DeepSearchQA 77.1. En BrowseComp, K2.5 está por delante de GPT-5.2 (65.8), Claude 4.5 Opus (57.8) y Gemini 3 Pro (59.2) — útil para tareas de largo plazo que requieren navegación, recopilación de evidencia y refinamiento iterativo.
- Codificación competitiva a nivel de repositorio con ventaja multilingüe: K2.5 alcanza SWE-Bench Verified 76.8 y SWE-Bench Multilingual 73.0. Aunque Claude 4.5 Opus es ligeramente más alto en Verified (80.0) y Gemini 3 Pro también lidera allí (80.9), K2.5 sigue siendo fuertemente competitivo y destaca en entornos multilingües — por delante de GPT-5.2 (72.0) y muy por delante de Gemini 3 Pro (65.0) — lo que importa para parches en múltiples archivos en repositorios con lenguajes mixtos.
- Comprensión de imágenes más fuerte para flujos de trabajo de desarrollo (documentos, diagramas, UI): En benchmarks de imágenes, K2.5 está consistentemente en el nivel superior: MMMU Pro 78.5, MathVision 84.2, OmniDocBench 1.5 88.8 — apoyando tareas prácticas como leer PDFs técnicos, interpretar diagramas y convertir requisitos visuales en código.
- Razonamiento de video que ayuda en la iteración real del producto: Para tareas de video, K2.5 obtiene VideoMMMU 86.6 y LongVideoBench 79.8, indicando una comprensión de video de contexto largo más fuerte — útil para analizar demos de productos, depurar grabaciones de UI o extraer requisitos de recorridos.
Cómo instalar OpenCode
OpenCode proporciona algunas opciones de instalación. La más rápida es el script de instalación de una línea, y la más portátil es instalar el paquete npm.
macOS / Linux
Recomendado:
curl -fsSL https://opencode.ai/install | bashO (multiplataforma):
npm install -g opencode-ai
# o
bun add -g opencode-aiIniciar:
opencodeWindows
Recomendado:
npm install -g opencode-ai
# o
bun add -g opencode-ai
curl | bashrequiere un entorno bash (WSL o Git Bash). En PowerShell/CMD, usa npm/bun.
Iniciar:
opencodeCómo usar MiniMax M2.1 en OpenCode
Obtener tu clave API en Novita AI
- Paso 1: Crear o iniciar sesión en tu cuenta Visita
[https://novita.ai](https://novita.ai)y regístrate o inicia sesión. - Paso 2: Navegar a la gestión de claves Después de iniciar sesión, busca “API Keys”.
- Paso 3: Crear una nueva clave Haz clic en el botón “Add New Key”.
- Paso 4: Guardar tu clave inmediatamente Copia y almacena la clave tan pronto como se genere; normalmente se muestra solo una vez.
Agregar tu clave API de Novita a OpenCode
- Inicia OpenCode:
opencode- En el prompt de OpenCode, ejecuta:
/connect- Busca y selecciona Novita AI, luego pega tu clave API de Novita.
- Selecciona Kimi K2.5 (model id:
moonshotai/kimi-k2.5).
Eso es todo—OpenCode enrutará las solicitudes del agente a través de la API de Novita AI usando el modelo que seleccionaste.
Construye tu primer proyecto: Woolf Stream
Para que el demo sea instantáneamente visual (y fácil de compartir en capturas de pantalla), construiremos una aplicación web de una sola página: Woolf Stream. Los usuarios suben una imagen, eligen algunos controles creativos, y la aplicación llama al endpoint de chat compatible con OpenAI de Novita AI con Kimi K2.5 (soporta imagen en chat) para generar prosa de flujo de conciencia solo texto inspirada en técnicas modernistas de principios del siglo XX—sin citar ni imitar a Virginia Woolf textualmente.
Lo que construiremos
- Un demo de una página con Next.js 14 (App Router) con TypeScript + TailwindCSS
- Panel de clave API (campo de contraseña + mostrar/ocultar, guardar/limpiar en localStorage; nunca codificar)
- Subida de imagen por arrastrar y soltar (png/jpg) con vista previa y conversión a base64 data URL del lado del cliente
- Controles:
- Preajustes de longitud: 150 / 300 / 600 / 1000 palabras
- Deslizador de tono: soñador ↔ nítido
- Desplegable de enfoque: sensorial / memoria / tiempo / mirada social
- Flujo de generación:
- Botón “Generar prosa” deshabilitado hasta que existan clave API + imagen
- Indicador de carga + panel de error con código de estado HTTP + pistas de solución
- Salida:
- Una tarjeta de lectura con la prosa generada
- Botón de copiar + Descargar .txt
- Acordeón “Mostrar prompt utilizado” (para transparencia y reproducibilidad)
Cambiar a modo Build y ejecutar
En OpenCode, cambia a modo Build, luego pega el prompt a continuación.
Prompt
Construye un demo de una sola página con Next.js 14 (App Router) + TypeScript + TailwindCSS.
Objetivo: El usuario sube una imagen (png/jpg). La aplicación envía la imagen a un endpoint de chat compatible con OpenAI (soporta imagen en chat) y genera un pasaje de prosa de flujo de conciencia hermoso inspirado en las técnicas modernistas de Virginia Woolf. La salida es SOLO TEXTO.
Requisitos de API (estrictos):
- URL base personalizada compatible con OpenAI: https://api.novita.ai/openai
- Modelo: moonshotai/kimi-k2.5
- El usuario ingresa su propia clave API (campo de contraseña + mostrar/ocultar). Almacenar solo en localStorage. Nunca codificar.
- Las solicitudes incluyen Authorization: Bearer {userKey}.
Requisitos de UI:
- Ambiente de Monet / Nenúfares: paleta pastel suave, textura de papel, fondo de gradiente de pincelada sutil, sombras suaves, tarjetas redondeadas, pequeña animación de onda al pasar el ratón. Responsivo móvil.
- Componentes: guardar/limpiar clave API, subida por arrastrar y soltar + vista previa, controles: longitud (150/300/600/1000 palabras), deslizador de tono (soñador↔nítido), desplegable de enfoque (sensorial/memoria/tiempo/mirada social), botón Generar (deshabilitado si falta clave o imagen), indicador de carga, panel de error.
- Salida: prosa renderizada en una tarjeta de lectura + Copiar + Descargar .txt + acordeón “Mostrar prompt utilizado”.
Llamada multimodal (obligatorio):
- Usar POST /v1/chat/completions.
- Enviar mensajes donde content sea un array con AMBOS:
{type:“text”, text:“…instrucciones…”}
{type:“image_url”, image_url:{url:“data:image/png;base64,…”}}
- Mostrar la respuesta de texto del modelo.
Restricciones de escritura (importante):
- Producir prosa ORIGINAL inspirada en el flujo de conciencia modernista de principios del siglo XX (ritmo lírico, interioridad, detalle sensorial, saltos asociativos, tiempo fluido).
- No citar ni reproducir ningún texto de Woolf. No afirmar ser Woolf. Sin líneas de pastiche directas.
- Anclar a la imagen: reflejar composición, luz, colores, estado de ánimo, movimiento implícito; preservar la ubicación del sujeto.
- Salida: un pasaje continuo (máximo 1–3 párrafos). Sin viñetas, sin análisis.
Entregar:
- Código ejecutable completo + árbol de archivos.
- Un envoltorio de API que inyecte base_url y clave de usuario.
- Conversión de imagen del lado del cliente a base64 data URL.
- Errores claros con código de estado HTTP y pistas de solución.
Ejecutar localmente
Después de que OpenCode genere el proyecto:
npm install
npm run devAbre la URL local que imprime Next.js (normalmente http://localhost:3000) y confirma:
- La página se renderiza con el aspecto de Monet / Nenúfares
- Guardar/limpiar clave API funciona (almacenado solo en localStorage), y mostrar/ocultar alterna correctamente
- La subida por arrastrar y soltar funciona, la vista previa muestra la imagen seleccionada
- “Generar prosa” está deshabilitado hasta que existan clave API + imagen
- La prosa es solo texto, 1–3 párrafos, y claramente anclada a la imagen
- Copiar + Descargar
.txtfuncionan - “Mostrar prompt utilizado” revela el prompt exacto enviado
- Los errores (clave mala / red) muestran código de estado HTTP y pistas claras
Demo: Woolf Stream
OpenCode más allá de la terminal: Aplicación de escritorio + Integraciones IDE
OpenCode se usa a menudo en la terminal, pero también puedes ejecutarlo como aplicación de escritorio (Beta) o dentro de tu IDE—y en ambos casos, puedes seguir usando la API compatible con OpenAI de Novita AI. La interfaz cambia, pero la configuración del modelo/proveedor sigue siendo la misma: selecciona minimax/minimax-m2.1.
Aplicación de escritorio
La versión de escritorio de OpenCode está disponible para macOS, Windows y Linux. Si prefieres una UI independiente para sesiones de agente más largas, la aplicación de escritorio es una excelente opción—y puede usar la misma configuración de proveedor que ya creaste para Novita AI.
Integraciones IDE
OpenCode proporciona flujos de integración oficiales para:
- VS Code
- Cursor
- Zed
- Windsurf
- VSCodium
Conclusión
OpenCode facilita la adopción de flujos de trabajo agentivos sin atarse a un solo proveedor. Con Kimi K2.5 en Novita AI, obtienes una configuración práctica para iteración a nivel de repositorio y tareas de desarrollo multimodal—utilizable desde la terminal (o escritorio/IDE) con la misma configuración de API.
Novita AI es una plataforma en la nube de IA que ofrece a los desarrolladores una forma sencilla de implementar modelos de IA usando nuestra API simple, al mismo tiempo que proporciona GPU en la nube asequible y confiable para construir y escalar.
Preguntas frecuentes
¿Qué es OpenCode?
OpenCode es un framework de agente de codificación de IA de código abierto que permite a los LLM escribir, ejecutar y depurar código dentro de un entorno de desarrollo real, acelerando las construcciones de principio a fin.
¿Quién es el propietario de OpenCode?
OpenCode no es propiedad de un gran laboratorio de IA como Claude o Gemini. Es un proyecto de código abierto mantenido por el equipo/comunidad de OpenCode, con desarrollo liderado por los creadores detrás de opencode.ai. No hay un “propietario del modelo” propietario — el proyecto está diseñado para ser agnóstico al proveedor e independiente de cualquier proveedor de LLM individual.
¿Es OpenCode mejor que Claude?
OpenCode no es estrictamente “mejor” que Claude Code—es diferente. OpenCode es de código abierto y agnóstico al modelo, lo que lo convierte en una mejor opción si deseas flexibilidad y la libertad de ejecutar múltiples modelos (como Kimi K2.5 a través de Novita AI) en un solo flujo de trabajo de agente, mientras que Claude Code es el CLI oficial de Anthropic centrado en Claude que ofrece la experiencia más fluida si estás completamente comprometido con el ecosistema Claude.
¿Es OpenCode seguro?
Sí, OpenCode no almacena ninguno de tus datos de código o contexto, por lo que puede operar en entornos sensibles a la privacidad.
¿Es OpenCode gratuito?
OpenCode es una de esas raras herramientas de código abierto que te hacen pausar. Actualmente está en la cima de GitHub con más de 80k estrellas—y después de probarlo, el impulso tiene sentido. Piénsalo como un agente de codificación de IA en la misma línea que Claude Code, pero completamente gratuito y de código abierto.
