Cómo usar Kimi K3 para programar con Kimi Code

Moonshot AI diseñó Kimi K3 para tareas de codificación que no caben en una sola instrucción: analizar un repositorio grande, leer archivos, ejecutar herramientas, lanzar pruebas, interpretar registros y capturas, y repetir el ciclo hasta completar la tarea. Para usar ese modelo como agente necesitas Kimi Code, la herramienta de terminal e IDE de Moonshot. En esta guía verás cómo configurarlo, asignarle trabajo verificable, controlar su ciclo de iteración y validar las APIs que genere.

Prueba Apidog hoy

TL;DR: ejecutar Kimi K3 para codificación

Kimi K3 es el modelo insignia de Moonshot AI, lanzado el 16 de julio de 2026. Tiene una ventana de contexto de 1 millón de tokens y está ajustado para trabajo a escala de repositorio.

Para programar con K3:

1. Abre tu repositorio con Kimi Code.
2. Selecciona el modelo con /model kimi-k3.
3. Describe una tarea concreta con criterios de aceptación.
4. Deja que el agente lea código, ejecute pruebas y corrija fallos.
5. Verifica los endpoints generados con una herramienta de pruebas de API como Apidog.

K3 destaca en navegación de repositorios grandes, uso de herramientas, depuración e iteración a partir de imágenes, logs, pruebas y feedback de ejecución. Moonshot reporta una tasa de acierto de caché superior al 90%, lo que puede reducir el coste de bucles largos. Sin embargo, genera aproximadamente 62 tokens por segundo y Moonshot reconoce que sigue por detrás de Claude Fable 5 y GPT-5.6 Sol en capacidad bruta.

Para conocer el modelo antes de empezar, consulta qué es Kimi K3.

Qué es Kimi Code

Kimi Code es el agente de codificación de Moonshot. Se ejecuta en la terminal y puede integrarse con tu IDE. A diferencia de un asistente que solo responde preguntas, puede:

• Leer y modificar archivos.
• Ejecutar comandos de shell.
• Buscar referencias en el repositorio.
• Lanzar pruebas y compilaciones.
• Analizar logs, errores y capturas de pantalla.
• Iterar sobre una tarea hasta verificar el resultado.

El modelo aporta razonamiento y uso de herramientas; Kimi Code le aporta acceso al sistema de archivos, al shell y a la salida de tu entorno. Juntos permiten convertir una instrucción en un flujo de trabajo de ingeniería completo.

Kimi Code ya funcionaba con la línea Kimi K2. Si todavía no lo has instalado, consulta la guía de CLI de Kimi Code y la guía más amplia sobre cómo usar Kimi CLI. Los pasos siguientes asumen que la CLI ya está disponible.

Poner en marcha Kimi K3 en Kimi Code

Los comandos y flags de Kimi Code pueden cambiar. Usa esta sección como estructura de trabajo y confirma la sintaxis actual en la documentación oficial de Kimi o en la guía de CLI de Kimi Code.

1. Instala el agente y autentícate

Necesitas una cuenta Kimi y una clave de API de la plataforma de desarrolladores de Kimi.

Guarda la clave en una variable de entorno. Evita incluirla en archivos de configuración que puedan terminar en el repositorio.

# Representativo, no exacto.
# Consulta la documentación oficial para la sintaxis actual.
export KIMI_API_KEY="your-key-here"

# Inicia el agente en el directorio actual
kimi-code

Antes de continuar, añade tus archivos locales de configuración al .gitignore si contienen credenciales.

2. Inicia Kimi Code en la raíz del proyecto

Kimi Code usa el directorio actual como raíz de trabajo. Inícialo desde el repositorio para que pueda inspeccionar la estructura, localizar pruebas y seguir dependencias.

cd mi-proyecto
kimi-code

Evita iniciarlo desde un directorio padre que contenga varios repositorios no relacionados: amplía el contexto y dificulta que el agente encuentre el objetivo correcto.

3. Selecciona K3

Dentro de la sesión de Kimi Code, activa el modelo:

/model kimi-k3

Puedes usar el mismo mecanismo para cambiar entre K3 y modelos anteriores, como Kimi K2.7 Code, si quieres comparar resultados en una tarea específica.

4. Ajusta el esfuerzo de razonamiento

K3 ofrece esfuerzo de razonamiento configurable, incluida una opción de esfuerzo máximo.

Úsalo de forma intencional:

• Ediciones pequeñas: reduce el esfuerzo para obtener una respuesta más rápida.
• Depuración compleja: aumenta el esfuerzo cuando hay varias capas, errores intermitentes o dependencias difíciles de seguir.
• Refactorizaciones grandes: usa más razonamiento y exige pruebas antes de aceptar los cambios.

Si quieres probar K3 sin instalar Kimi Code o sin coste, consulta cómo usar Kimi K3 gratis.

Flujo de trabajo práctico para codificación agéntica

La regla principal es simple: asigna una tarea observable y exige evidencia de que está terminada.

No uses una instrucción como esta:

Mejora el módulo de autenticación.

Usa una instrucción con reproducción, alcance y condición de cierre:

El endpoint /login devuelve un 500 cuando el campo password está vacío. Reproduce el error, identifica la causa, corrígela y añade una prueba que cubra una contraseña vacía. Ejecuta la suite relevante antes de terminar.

Este formato reduce ambigüedad y da al agente un objetivo contra el cual evaluar su propio trabajo.

1. Da contexto y criterios de aceptación

Para tareas más grandes, especifica también restricciones:

Refactoriza el servicio de facturación para extraer la lógica de cálculo de impuestos.

Criterios de aceptación:
- No cambies el contrato público de la API.
- Mantén compatibilidad con los tests existentes.
- Añade pruebas para impuestos de 0%, 10% y 21%.
- Ejecuta lint, tests unitarios y build.
- Resume los archivos modificados y los comandos ejecutados.

La ventana de contexto de 1 millón de tokens permite a K3 mantener una gran parte de la base de código disponible mientras sigue una llamada desde una ruta hasta la capa de servicio, repositorios y pruebas. Aun así, una tarea bien delimitada sigue siendo importante: más contexto no sustituye una especificación clara.

2. Permite que use herramientas

El valor de un agente aparece cuando puede comprobar sus hipótesis usando el entorno real. En Kimi Code, K3 puede buscar código, editar archivos, ejecutar comandos, lanzar pruebas y analizar su salida.

El ciclo esperado es:

1. Lee archivos y encuentra el flujo relevante.
2. Formula una hipótesis sobre la causa del problema.
3. Edita el código.
4. Ejecuta pruebas, compilación o la aplicación.
5. Lee errores, logs o trazas de pila.
6. Ajusta la implementación.
7. Repite hasta que las comprobaciones pasen.

Moonshot describe a K3 como especialmente fuerte en navegación de repositorios grandes, uso de herramientas, depuración e iteración con imágenes, logs, pruebas y feedback de ejecución. No esperes que acierte siempre en el primer cambio: configura el trabajo para que pueda ejecutar, observar y corregir.

3. Usa feedback visual y de ejecución

El feedback no tiene que ser solo texto.

Para frontend, un ciclo útil es:

1. Cambia el componente o CSS.
2. Renderiza la pantalla.
3. Captura una imagen.
4. Revisa el resultado.
5. Ajusta estilos y repite.

Para backend, el equivalente es:

1. Modifica el endpoint o servicio.
2. Envía una solicitud HTTP.
3. Revisa código de estado, cabeceras y JSON.
4. Inspecciona logs si hay fallos.
5. Corrige y vuelve a probar.

K3 puede usar capturas de pantalla para comprobar cambios de interfaz. En tareas de backend, los informes de pruebas, los logs y las respuestas HTTP cumplen la misma función de retroalimentación.

4. Mantén el ciclo controlado con pruebas

Las pruebas son la señal objetiva de que el trabajo está hecho.

Antes de dejar que el agente cambie varios archivos, establece qué debe validar:

npm test -- auth
npm run lint
npm run build

Cuando sea posible, escribe o pide primero la prueba que reproduce el error. Después, deja que K3 itere hasta que esté en verde.

Sin pruebas, una sesión larga puede resolver el síntoma visible y romper otro flujo a varios archivos de distancia.

Kimi K3 vs. Claude Code y Cursor

K3 en Kimi Code es una de varias formas de ejecutar agentes contra una base de código.

Dimensión	Kimi Code (Kimi K3)	Claude Code (Fable 5)	Cursor
Factor de forma	Agente de codificación de terminal e IDE	Agente de codificación de terminal	Editor de código nativo de IA
Modelo predeterminado	Kimi K3, intercambiable mediante /model	Claude Fable 5 y otros modelos Claude	Modelos propios o integrados
Ventana de contexto	1M de tokens	Grande, según el modelo	Según el modelo seleccionado
Navegación del repositorio	Fuerte; diseñada para trabajo de largo alcance	Fuerte; acceso agéntico a archivos y shell	Indexación y recuperación en el editor
Uso de herramientas	Herramientas, shell, pruebas y capturas	Herramientas, shell y MCP	Herramientas de editor, terminal y MCP
Palanca de costes	Económico en bucles con mucha caché, según el acierto reportado	Precio por token de Claude	Suscripción más uso del modelo
Pesos abiertos	Esperados alrededor del 27 de julio de 2026	Cerrado	Editor propietario; modelos variables
Mejor para	Ejecuciones largas a escala de repositorio y con presupuesto limitado	Máxima fiabilidad y razonamiento	Desarrollo asistido dentro del editor

Conclusiones prácticas:

• Para la mayor fiabilidad bruta en tareas complejas, Moonshot reconoce que Fable 5 está por delante de K3. Consulta Claude Fable 5 en Claude Code.
• Si quieres trabajar dentro de un editor con IA integrada, Cursor o Cline pueden encajar mejor. Consulta GLM-5.2 en Claude Code, Cline y Cursor.
• K3 resulta interesante cuando necesitas contexto amplio, navegación de repositorios y muchos ciclos repetitivos de pruebas y correcciones.
• Una vez que se publiquen los pesos, K3 sería el único de los tres que podrías autoalojar.

Fortalezas y límites de K3

Dónde funciona mejor

Contexto a escala de repositorio.

La ventana de 1M de tokens reduce la necesidad de seleccionar manualmente archivos para cada paso, especialmente en monorepositorios o cambios que cruzan varias capas.

Uso de herramientas y autonomía de largo alcance.

K3 está ajustado para mantener sesiones de ingeniería prolongadas, ejecutar herramientas de terminal y corregirse usando resultados reales.

Coste en bucles con mucha caché.

La codificación agéntica reenvía repetidamente contexto como el árbol de archivos, el prompt del sistema e instrucciones de proyecto. El precio de entrada con acierto de caché de K3 es de $0.30 por millón de tokens frente a $3.00 en caso de fallo. Moonshot afirma que Mooncake supera el 90% de acierto de caché en cargas de trabajo de codificación. Consulta el desglose de precios de Kimi K3 para los números completos.

Dónde se queda corto

No es el modelo de frontera.

Moonshot afirma que K3 todavía está por detrás de Claude Fable 5 y GPT-5.6 Sol. En los benchmarks publicados por Moonshot, K3 obtiene 88.3 en Terminal Bench 2.1 frente a 88.8 de GPT-5.6 Sol. En DeepSWE, registra 67.5 frente a 70.0 de Fable 5 y 73.0 de GPT-5.6 Sol. Consulta el análisis de benchmarks de Kimi K3.

No es especialmente rápido.

Según Artificial Analysis, K3 genera alrededor de 62 tokens por segundo, por debajo de la mediana de su nivel de precio. Si necesitas interacción inmediata, compara primero con modelos más rápidos.

Los pesos abiertos aún son un lanzamiento futuro.

Los pesos completos se esperan alrededor del 27 de julio de 2026, no el día del lanzamiento. Si tu arquitectura depende del autoalojamiento, considera esa fecha como una dependencia del proyecto.

Para comparativas directas, consulta:

• Kimi K3 vs Claude Opus 4.8
• Kimi K3 vs GPT-5.6 Sol
• Kimi K3 vs Kimi K2.7 Code

Casos de uso prácticos

K3 encaja mejor en trabajos con varios pasos y una señal clara de validación:

• Refactorizaciones en monorepositorios: seguir el radio de impacto, modificar varios módulos y ejecutar la compilación hasta dejarla en verde.
• Depuración prolongada: reproducir un fallo, leer una traza de pila, aplicar un parche, ejecutar pruebas y repetir.
• Desarrollo de APIs: crear rutas, manejadores, servicios y pruebas, y después validar el contrato HTTP con una herramienta específica.
• Ajustes de interfaz: modificar componentes o CSS, renderizar, revisar capturas y repetir.

Verificar las APIs que construye K3

Las pruebas del repositorio indican que el código funciona según las expectativas internas. No garantizan que un cliente real reciba:

• El código de estado correcto.
• La estructura JSON esperada.
• Cabeceras adecuadas.
• Errores consistentes.
• Autenticación que rechace credenciales inválidas.

Aquí es donde encaja Apidog. Puedes enviar solicitudes reales a los endpoints que K3 cree, revisar cuerpos y cabeceras, y añadir aserciones sobre códigos de estado y estructura de respuesta.

Un flujo recomendado es:

1. Pide a K3 que implemente el endpoint y sus pruebas unitarias.
2. Inicia la aplicación localmente.
3. Importa la especificación OpenAPI si el agente la generó.
4. Envía solicitudes desde Apidog.
5. Añade aserciones para respuestas correctas y casos de error.
6. Guarda tokens, claves y URLs sensibles en variables de entorno de Apidog.

Si trabajas con MCP, consulta la guía sobre depuración visual con el cliente MCP de Apidog. Para mantener las pruebas cerca del código, revisa Apidog en VS Code.

Descarga Apidog para validar la salida de K3 en cuanto se genere, en lugar de depender solo de una suite de pruebas en verde.

Conclusión

Kimi K3 es útil en Kimi Code cuando lo usas para lo que fue diseñado: repositorios grandes, tareas de varios pasos y ciclos de ejecución basados en pruebas, logs y capturas.

Para obtener mejores resultados:

1. Inicia Kimi Code desde la raíz del repositorio.
2. Selecciona /model kimi-k3.
3. Formula una tarea concreta y verificable.
4. Define pruebas, build o solicitudes HTTP como criterios de cierre.
5. Deja que el agente itere sobre feedback real.
6. Valida las APIs con Apidog antes de desplegar.

Para ampliar, consulta qué es Kimi K3 y la guía de la API de Kimi K3.

Preguntas frecuentes

¿Cómo uso Kimi K3 para codificar?

Ejecuta K3 dentro de Kimi Code. Instala y autentica el agente, ábrelo en el directorio de tu proyecto, selecciona el modelo con /model kimi-k3 y asigna una tarea concreta con criterios de aceptación. Después, deja que lea archivos, ejecute herramientas y valide los cambios. Consulta la guía de CLI de Kimi Code para la instalación.

¿Es Kimi K3 bueno para la codificación agéntica?

Sí. Está ajustado para navegar repositorios grandes, usar herramientas, depurar e iterar con pruebas, logs y feedback de ejecución dentro de un contexto de 1M de tokens. Es competitivo en benchmarks de codificación, aunque Moonshot lo sitúa por detrás de Fable 5 y GPT-5.6 Sol.

¿Soporta Kimi K3 llamadas a herramientas?

Sí. La API de K3 soporta llamadas a herramientas, restricciones de selección de herramienta, modo JSON, salida estructurada, búsqueda en internet, carga dinámica de herramientas y esfuerzo de razonamiento configurable. Estas capacidades permiten ejecutar comandos, lanzar pruebas y orquestar un ciclo de agente en Kimi Code. Consulta la guía de la API de Kimi K3.

¿Puedo probar las APIs que escribe Kimi K3?

Sí, y es recomendable. Las pruebas del agente validan el código, pero no siempre el comportamiento esperado por un cliente real. Envía solicitudes a los endpoints generados en Apidog, añade aserciones e importa cualquier especificación OpenAPI producida por el agente para validar el contrato.