Conecte Kimi K2.5 a OpenCode con Novita AI: Una guía de codificación agenética

La codificación agentica está yendo más allá del autocompletado: las herramientas modernas pueden planificar tareas, editar múltiples archivos, ejecutar comandos y repetir errores hasta que el resultado realmente funcione. Código abierto es un agente de codificación de código abierto e independiente del modelo que puede ejecutarse en la terminal (y también como una aplicación de escritorio o una extensión IDE), lo que lo convierte en una forma práctica de probar este flujo de trabajo en su propio entorno.

¿Qué es OpenCode?

OpenCode es un agente de codificación de IA de código abierto que puede ejecutarse en múltiples entornos de desarrollo, generalmente como una interfaz basada en terminal (CLI + TUI), pero también como una aplicación de escritorio o una extensión IDE.

OpenCode frente a Claude Code

OpenCode y Claude Code son agentes de codificación de IA basados ​​en terminales, pero toman caminos diferentes.

• Código abierto es un agente de código abierto, independiente del proveedor: destaca el soporte para “75+ LLM proveedores a través de Models.dev (incluidos los modelos locales)” y se posiciona como una herramienta flexible que se puede conectar a diferentes backends de modelos.
• Código de Claude, por el contrario, es la CLI oficial de Anthropic centrada en Claude (una herramienta de línea de comandos para acceder a los modelos de Claude en la terminal), además de un ecosistema oficial para extensiones (complementos) y conexiones de herramientas/datos a través de MCP.

Tabla de comparación rápida

Aspecto	Código abierto	Código de Claude
Posicionamiento	Agente de codificación de terminales multimodelo de código abierto	El agente de codificación de terminal oficial de Claude-first de Anthropic
Elección del modelo/proveedor	75+ LLM proveedores a través de Models.dev, incluidos modelos locales	Desarrollado en torno a Claude; se extiende a través de MCP + complementos
Automatización de GitHub	/opencode o /oc activadores de comentarios; se ejecutan en el ejecutor de GitHub Actions	Las extensiones se centran en los complementos/MCP (ecosistema oficial)
Punto de entrada de precios	La herramienta es de código abierto; el costo depende del modelo backend elegido	Planes de Claude (Pro/Max/Team/Enterprise)

¿Por qué Kimi K2.5?

Kimi K2.5 reúne Multimodalidad nativa, ejecución de herramientas reales y orquestación de agentes a gran escala En un único modelo abierto. Entrenado con aproximadamente 15T de tokens de visión y texto mixtos, abarca la comprensión de imágenes y vídeos, la generación de código y la depuración visual.

Cómo instalar OpenCode

OpenCode ofrece varias 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 | bash

O (multiplataforma):

npm install -g opencode-ai # o bun add -g opencode-ai

Comienza:

código abierto

Windows

Recomendado:

npm install -g opencode-ai # o bun add -g opencode-ai

curl | bash Requiere un entorno bash (WSL o Git Bash). En PowerShell/CMD, use npm/bun.

Comienza:

código abierto

Cómo usar MiniMax M2.1 en OpenCode

Obtener su clave API Novita AI

• Paso 1: Crea o inicia sesión en tu cuenta Visitar https://novita.ai y regístrate o inicia sesión.
• Paso 2: Vaya a Administración de claves Después de iniciar sesión, busque “Claves API”.
• Paso 3: Crear una nueva clave Haga clic en el botón “Agregar nueva clave”.
• Paso 4: Guarde su clave inmediatamente Copie y guarde la clave tan pronto como se genere; normalmente solo se muestra una vez.

Agregue su clave API de Novita a OpenCode

1. Lanzar OpenCode:

código abierto

2. En el indicador de OpenCode, ejecute:

/conectar

3. Busca y selecciona Novita AI, luego pegue su clave API de Novita.
4. Seleccione Kimi K2.5 (identificación del modelo: moonshotai/kimi-k2.5).

Eso es todo: OpenCode enrutará las solicitudes del agente a través de Novita AIAPI de usando el modelo que usted seleccionó.

Construye tu primer proyecto: Woolf Stream

Para que la demostración sea visual al instante (y fácil de compartir en capturas de pantalla), crearemos 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 Novita AIPunto final de chat compatible con OpenAI con Kimi K2.5 (compatible con imágenes en el chat) para generar prosa de flujo de conciencia de solo texto inspirada en técnicas modernistas de principios del siglo XX, sin citar ni imitar a Virginia Woolf textualmente.

Lo que construiremos

• Una demostración de una página de Next.js 14 (App Router) con TypeScript + TailwindCSS
• Panel de claves API (ingreso de contraseña + mostrar/ocultar, guardar/borrar en almacenamiento local; nunca codificar)
• Carga de imágenes mediante arrastrar y soltar (png/jpg) con vista previa y conversión de URL de datos base64 del lado del cliente
• Controles:
  • Ajustes preestablecidos de longitud: 150 / 300 / 600 / 1000 palabras
  • Control deslizante de tono: soñador ↔ agudo
  • Menú desplegable de enfoque: sensorial / memoria / tiempo / mirada social
• Generar flujo:
  • El botón “Generar prosa” estará deshabilitado hasta que Clave API + imagen existe
  • Indicador de carga + panel de error con Estado HTTP + sugerencias para la solución de problemas
• Salida:
  • Una tarjeta de lectura con la prosa generada
  • Botón Copiar + Descargar .txt
  • Acordeón “Mostrar mensaje utilizado” (para transparencia y reproducibilidad)

Cambie al modo de compilación y ejecute

En OpenCode, cambie a Modo de construcción, luego pegue el mensaje a continuación.

Prompt

Cree una demostración de una sola página con Next.js 14 (App Router) + TypeScript + TailwindCSS.

Objetivo: El usuario sube una imagen (png/jpg). La aplicación la envía a un punto de chat compatible con OpenAI (compatible con imágenes en el chat) y genera un hermoso pasaje en prosa inspirado en las técnicas modernistas de Virginia Woolf. El resultado 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 introduce su propia clave API (campo de contraseña + mostrar/ocultar). Se almacena solo en el almacenamiento local. Nunca se codifica.
• Las solicitudes incluyen Autorización: Portador {userKey}.

Requisitos de UI:

• Interfaz de usuario con estilo Monet/Nenúfares: paleta de colores pastel suaves, textura de papel, fondo con degradado sutil de pinceladas, sombras con brillo suave, tarjetas redondeadas y animación de pequeñas ondas al pasar el cursor. Compatible con dispositivos móviles.
• Componentes: guardar/borrar clave API, cargar y previsualizar mediante arrastrar y soltar, controles: longitud (150/300/600/1000 palabras), control deslizante de tono (soñador↔nítido), menú desplegable de enfoque (sensorial/memoria/tiempo/mirada social), botón Generar (deshabilitado si falta la clave o la imagen), indicador de carga, panel de error.
• Salida: prosa renderizada en una tarjeta de lectura + Copiar + Descargar .txt + acordeón “Mostrar mensaje utilizado”.

Llamada multimodal (obligatoria):

• Utilice POST/v1/chat/completions.
• Envía mensajes donde el contenido sea una matriz con AMBOS:

{tipo:”texto”, texto:”…instrucciones…”}

{tipo:”url_de_imagen”, url_de_imagen:{url:”datos: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 cite ni reproduzca ningún texto de Woolf. No pretenda ser Woolf. No se permiten versos directos.
• Anclar a la imagen: reflejar la composición, la luz, los colores, el estado de ánimo, el movimiento implícito; preservar la ubicación del sujeto.
• Resultado: un pasaje continuo (máximo de 1 a 3 párrafos). Sin viñetas ni análisis.

Entregar:

• Código completamente ejecutable + árbol de archivos.
• Un contenedor de API que inyecta base_url y clave de usuario.
• Imagen del lado del cliente -> URL de datos base64.
• Borre errores con el código de estado HTTP y sugerencias para la solución de problemas.

Ejecutar localmente

Después de que OpenCode genere el proyecto:

npm instalar npm ejecutar dev

Abra la URL local impresa por Next.js (normalmente http://localhost:3000) y confirmar:

• La página se muestra con el Monet / Nenúfares mira y siente
• La función de guardar y borrar la clave API funciona (se almacena solo en el almacenamiento local) y los botones para mostrar y ocultar funcionan correctamente.
• La carga mediante arrastrar y soltar funciona, la vista previa muestra la imagen seleccionada
• “Generar prosa” está deshabilitado hasta Clave API + imagen existe
• La prosa es solo texto, 1–3 párrafos, y claramente anclado en la imagen
• Copiar + Descargar .txt Trabaja
• “Mostrar mensaje utilizado” revela el mensaje exacto enviado
• Se muestran errores (clave incorrecta/red incorrecta) Estado HTTP y pistas claras

OpenCode más allá de la terminal: integraciones de aplicaciones de escritorio e IDE

OpenCode se usa a menudo en la terminal, pero también puedes ejecutarlo como una aplicación de escritorio (Beta) o dentro de tu IDE, y en ambos casos, puedes seguir usándolo. Novita AIAPI compatible con OpenAI. La interfaz cambia, pero la configuración del modelo/proveedor permanece igual: seleccione minimax/minimax-m2.1.

Aplicación de escritorio

La versión de escritorio de OpenCode está disponible para macOS, Windows y Linux. Si prefiere una interfaz de usuario independiente para sesiones de agente más largas, la aplicación de escritorio es ideal, ya que puede usar la misma configuración de proveedor que ya creó. Novita AI.

integraciones IDE

OpenCode proporciona flujos de integración oficiales para:

• Código VS
• Cursor
• Zed
• Windsurf
• VSCodium

Conclusión

OpenCode facilita la adopción de flujos de trabajo de agentes sin depender de un solo proveedor. Con Kimi K2.5 en Novita AIObtendrá una configuración práctica para iteraciones a nivel de repositorio y tareas de desarrollo multimodales, utilizables desde la terminal (o escritorio/IDE) con la misma configuración de API.

Novita AI es una plataforma de nube de IA que ofrece a los desarrolladores una manera fácil de implementar modelos de IA utilizando nuestra API simple, al mismo tiempo que proporciona un servicio asequible y confiable. GPU Nube para construir y escalar.

Preguntas frecuentes