Moonshot AI construyó Kimi K3 para trabajos de codificación que no caben en una sola instrucción. La propuesta es ingeniería de largo alcance: apuntar un modelo a un repositorio grande, dejarlo leer archivos, ejecutar herramientas, realizar pruebas, leer los registros y capturas de pantalla que regresan, e iterar hasta que la tarea esté completada. Ese es un trabajo diferente al autocompletado, y necesita un agente de codificación envuelto alrededor del modelo. Moonshot envía uno llamado Kimi Code. Esta guía cubre cómo ejecutar K3 dentro de él, cómo se ve un bucle agéntico real, dónde encaja junto a Claude Code y Cursor, y dónde, honestamente, se queda corto.
TL;DR: Ejecutando Kimi K3 para codificación
Kimi K3 es el modelo insignia de Moonshot AI, lanzado el 16 de julio de 2026, con una ventana de contexto de 1 millón de tokens y una arquitectura ajustada para trabajos a escala de repositorio. Se codifica con él a través de Kimi Code, el agente de codificación de terminal e IDE de Moonshot: selecciona el modelo con un comando /model y asígnale una tarea. K3 es fuerte en la navegación de grandes bases de código, el uso de herramientas, la depuración y la iteración con imágenes, registros, pruebas y retroalimentación en tiempo de ejecución. Es económico en bucles con mucha caché gracias a una tasa de acierto de caché reportada de más del 90%, pero no es el más rápido con aproximadamente 62 tokens por segundo, y el propio Moonshot dice que todavía está por detrás de Claude Fable 5 y GPT-5.6 Sol en capacidad bruta. Cuando K3 construye una API para ti, Apidog es la forma más rápida de acceder a los endpoints que genera y confirmar que funcionan. Para el contexto del modelo, empieza con qué es Kimi K3.
Qué es Kimi Code
Kimi Code es el agente de codificación de Moonshot. Se ejecuta en tu terminal (y se integra con tu IDE), lee y escribe archivos, ejecuta comandos de shell e impulsa una sesión de ingeniería completa en tu nombre en lugar de solo responder una pregunta. Ábrelo dentro de un directorio de proyecto, describe lo que quieres, y planifica, edita, ejecuta y verifica su propio trabajo en un bucle. El modelo por sí solo es un motor de texto y herramientas; Kimi Code es el marco que le proporciona un sistema de archivos, un shell, salida de pruebas y capturas de pantalla para trabajar. Ese marco convierte "un modelo que es bueno en código" en "un agente que puede cerrar un ticket".
Kimi Code no es nuevo con K3; la línea anterior Kimi K2 funcionaba con el mismo agente. Nuestra guía de CLI de Kimi Code cubre la instalación completa desde cero, y cómo usar Kimi CLI es la referencia más amplia de línea de comandos. Este artículo asume que la CLI está instalada y se centra en cómo operar K3.
Poniendo en marcha Kimi K3 en Kimi Code
El comando exacto de instalación y las banderas cambian a medida que Moonshot actualiza la herramienta, así que trata los pasos a continuación como la estructura del flujo de trabajo y confirma la sintaxis precisa en la documentación oficial de Kimi o en nuestra guía de CLI de Kimi Code. Los comandos son representativos, no exactos.
1. Instala el agente y autentícate. Instala la herramienta de línea de comandos una vez, luego inicia sesión para que pueda acceder a la API de Kimi. Necesitarás una cuenta Kimi y una clave de API de la plataforma de desarrolladores de Kimi. Guarda la clave como una variable de entorno en lugar de pegarla en un archivo de configuración que podrías cometer por accidente.
# Representativo, no exacto. Consulta la documentación oficial para la sintaxis actual.
export KIMI_API_KEY="your-key-here"
kimi-code # lanza el agente en el directorio actual
2. Ábrelo dentro de tu proyecto. Navega al repositorio e inicia el agente allí. Kimi Code trata el directorio actual como su raíz de trabajo y lee la estructura del proyecto para construir el contexto, por lo que el lugar donde lo inicias importa.
3. Selecciona K3 como el modelo. Dentro de la sesión, cambia el modelo activo con el comando /model y elige kimi-k3. Este es el mismo mecanismo que usarías para moverte entre K3 y modelos más antiguos, como el Kimi K2.7 Code, centrado en la codificación, en la misma tarea.
/model kimi-k3
4. Establece el esfuerzo de razonamiento. K3 expone un esfuerzo de razonamiento configurable, incluyendo una configuración "máxima". Para depuración compleja o una refactorización grande, más pensamiento ayuda; para ediciones rápidas, redúcelo para no pagar por una profundidad que no necesitas.
Una vez que el modelo esté seleccionado y el agente apunte a tu repositorio, estás listo para asignarle trabajo. Para probar K3 sin instalar Kimi Code, o sin costo alguno, cómo usar Kimi K3 gratis cubre las formas gratuitas.
Un flujo de trabajo de codificación agéntico práctico
El patrón es el mismo ya sea que estés corrigiendo un error o lanzando una característica: dale a K3 una tarea concreta, deja que recopile contexto y haz que demuestre el resultado frente a algo objetivo.
Apúntalo al repositorio y dale una tarea clara
Las instrucciones vagas producen trabajo vago. En lugar de "mejorar el módulo de autenticación", dale al agente una tarea que pueda verificar: "El endpoint /login devuelve un 500 cuando el campo de contraseña está vacío. Reprodúcelo, encuentra la causa, corrígelo y añade una prueba que cubra el caso de contraseña vacía". Un objetivo específico y verificable es la mayor palanca para la calidad de la salida: le da al agente una meta contra la cual autoevaluarse.
El contexto de 1M de tokens de K3 es lo que hace que "apuntarlo a todo el repositorio" sea realista: el agente mantiene una gran parte de tu base de código a la vista a la vez, rastreando una llamada desde el manejador de rutas a través de la capa de servicio sin que tengas que alimentarlo manualmente con los archivos correctos. Moonshot cita la navegación de grandes repositorios como una fortaleza clave de K3.
Permítele usar herramientas y leer la retroalimentación
Aquí es donde un agente se gana su valor. K3 soporta llamadas a herramientas, así que dentro de Kimi Code puede ejecutar tu suite de pruebas, buscar en la base de código (usando grep), ejecutar una compilación o acceder a un servicio en ejecución, para luego leer lo que regresa:
- El agente lee los archivos relevantes y formula una hipótesis.
- Realiza una edición.
- Ejecuta las pruebas o la aplicación.
- Lee la salida fallida, el rastreo de pila o la línea de registro.
- Revisa y repite hasta que las comprobaciones pasen.
Moonshot califica a K3 como “particularmente fuerte en la navegación de grandes repositorios, el uso de herramientas, la depuración y la iteración con imágenes, registros, pruebas y retroalimentación en tiempo de ejecución.” Ese bucle es el corazón del flujo de trabajo: no le estás pidiendo al modelo que acierte a la primera, sino que ejecute, observe y corrija como un ingeniero humano.
Iterar con imágenes y salida en tiempo de ejecución
La retroalimentación no se limita al texto. Moonshot destaca el razonamiento visual como parte del alcance de K3: el agente puede leer una captura de pantalla para confirmar que un cambio de frontend se renderizó correctamente, o usar una imagen capturada para guiar el desarrollo de juegos y el trabajo CAD. Así, un bucle de interfaz de usuario es: cambiar el CSS, renderizar, capturar pantalla, ajustar. Para el trabajo de backend, la retroalimentación es un informe de prueba, un flujo de registros o una respuesta HTTP, y el bucle es el mismo.
Mantén el bucle honesto con pruebas
Las pruebas evitan que un bucle autónomo se desvíe. Con una suite de pruebas que aprobar como objetivo, el agente tiene una clara señal de "hecho" y "roto"; sin una, una ejecución larga puede divagar y romper silenciosamente algo a tres archivos de distancia. Escribe la prueba primero, luego deja que K3 itere hasta que esté en verde.
Kimi K3 vs Claude Code y Cursor para codificación
K3 en Kimi Code no es la única configuración de codificación agéntica. Aquí tienes una comparación honesta de las tres formas más comunes de ejecutar un agente contra tu base de código a mediados de 2026.
| 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 completo |
| Modelo predeterminado | Kimi K3, intercambiable vía /model |
Claude Fable 5, más otros modelos Claude | Modelos de frontera propios o integrados |
| Ventana de contexto | 1M de tokens | Grande, dependiente del modelo | Depende del modelo seleccionado |
| Navegación del repositorio | Fuerte; construido para trabajo de largo alcance en grandes repositorios | Fuerte; acceso a archivos y shell agéntico | Fuerte indexación y recuperación en el editor |
| Uso de herramientas | Llamadas a herramientas, shell, pruebas, capturas de pantalla | Llamadas a herramientas, shell, MCP | Herramientas en el editor, terminal, MCP |
| Palanca de costos | Barato en bucles con mucha caché (90%+ acierto de caché) | Con precio por token de Claude | Suscripción más uso del modelo |
| Pesos abiertos | Esperado alrededor del 27 de julio de 2026 | Cerrado | El editor es propietario; los modelos varían |
| Mejor para | Ejecuciones de agente largas, a escala de repositorio y con presupuesto limitado | Razonamiento y fiabilidad de primer nivel | Desarrolladores que quieren el agente dentro de su editor |
Algunas conclusiones. Para la máxima fiabilidad bruta en una tarea difícil, Fable 5 en Claude Code es el modelo que el propio Moonshot admite que está por delante de K3. Si quieres el agente dentro de un editor pulido, las herramientas tipo Cursor y Cline se ajustan mejor, y puedes ejecutar otros modelos abiertos a través de ellas, como muestra nuestra guía GLM-5.2 en Claude Code, Cline y Cursor. La ventaja de K3 es un contexto muy grande, una fuerte navegación de repositorios y un precio diseñado para los bucles largos y repetitivos que aumentan la factura en un modelo de frontera por token. Una vez que se lancen los pesos, es el único de los tres que puedes autoalojar.
Fortalezas y límites honestos
En qué es bueno K3
Contexto a escala de repositorio. La ventana de 1M de tokens permite al agente mantener una gran base de código a la vista a la vez, reduciendo el problema de "qué archivos le doy" que dificulta el trabajo en monorepositorios a modelos con menor contexto.
Uso de herramientas y autonomía de largo alcance. K3 fue ajustado para mantener sesiones de ingeniería extendidas con mínima supervisión, orquestando herramientas de terminal y corrigiéndose a sí mismo con base en la salida real. Eso es lo que separa cerrar un ticket de sugerir un fragmento de código.
Costo en bucles con mucha caché. La codificación agéntica reenvía el mismo contexto (árbol de archivos, prompt del sistema, instrucciones) en cada paso. 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, una brecha de 10x, y la inferencia de Mooncake de Moonshot supuestamente alcanza una tasa de acierto de caché superior al 90% en cargas de trabajo de codificación. Así, el patrón que hace que los bucles de agente sean caros en otros lugares es donde K3 se mantiene barato. Los números completos están en el desglose de precios de Kimi K3.
Dónde se queda corto K3
No es la frontera, y Moonshot lo dice. La publicación de lanzamiento afirma claramente que K3 "todavía está por detrás de los modelos propietarios más potentes, Claude Fable 5 y GPT-5.6 Sol". En los benchmarks de codificación publicados por Moonshot, el panorama es cercano pero consistente: en Terminal Bench 2.1, K3 obtiene 88.3 frente a 88.8 de GPT-5.6 Sol, y en DeepSWE registra 67.5 frente a 70.0 de Fable 5 y 73.0 de GPT-5.6 Sol. Competitivo, no el primero. Consulta el análisis de benchmarks de Kimi K3 para el panorama completo.
No es rápido. En la lista de Artificial Analysis, K3 genera alrededor de 62 tokens por segundo, por debajo de la mediana para su nivel de precio, y su configuración predeterminada se inclina hacia el máximo esfuerzo de pensamiento. En un bucle interactivo donde observas el flujo de salida, eso es notable. Si la velocidad importa más que los últimos puntos de calidad, compara primero un modelo más rápido.
“Abierto” es un evento programado. Se esperan los pesos completos alrededor del 27 de julio de 2026, no el día del lanzamiento. Si tu plan depende del autoalojamiento, esa es una fecha a tener en cuenta en lugar de un interruptor que puedas activar ahora.
Para las comparativas directas, consulta Kimi K3 vs Claude Opus 4.8, Kimi K3 vs GPT-5.6 Sol, y Kimi K3 vs Kimi K2.7 Code, que cubre la actualización del anterior campeón de codificación en la línea.
Casos de uso en el mundo real
K3 brilla en los trabajos para los que está diseñado el flujo de trabajo anterior: grandes refactorizaciones en un monorepositorio, donde el contexto de 1M muestra todo el radio de impacto a la vez para que pueda trabajar en las ediciones hasta que la compilación esté en verde; largas sesiones de depuración, donde reproduce un fallo, lee el rastreo de pila, aplica parches y vuelve a ejecutar sin que tengas que supervisarlo; y la construcción de una API, donde estructura el manejador, la ruta y, a menudo, las pruebas, para luego ceder el control a una herramienta de API dedicada para la verificación.
Verificando las APIs que K3 construye
Cuando K3 construye o modifica una API dentro de Kimi Code, sus propias pruebas te dicen que el código funciona. No te dicen que el endpoint se comporta como espera un cliente real: códigos de estado correctos, la forma de respuesta adecuada, manejo de errores sensato, autenticación que rechaza un token inválido. Ese es un trabajo de prueba de API.
Aquí es donde Apidog encaja. Envía solicitudes reales al endpoint generado, inspecciona el cuerpo y las cabeceras de la respuesta, y añade aserciones sobre el código de estado y la forma del JSON. Si el agente produjo una especificación OpenAPI, impórtala y Apidog crea la colección de solicitudes por ti, para que valides contra el contrato en lugar de adivinar. Mantén tus claves en variables de entorno de Apidog para que nunca se filtren en una colección compartida.
Dado que Apidog expone una interfaz MCP, también puedes conectar tus herramientas de API directamente al contexto de un agente; nuestra guía sobre depuración visual con el cliente MCP de Apidog muestra cómo, y Apidog en VS Code mantiene el bucle de prueba junto al código que K3 escribe. Descarga Apidog para verificar la salida del modelo en el momento en que se genera, en lugar de confiar únicamente en una ejecución de prueba en verde.
Dónde te deja esto
Kimi K3 es un agente de codificación genuinamente capaz en Kimi Code cuando aprovechas aquello para lo que fue construido: grandes repositorios, largos bucles autónomos y una iteración constante con pruebas, registros y capturas de pantalla. El contexto de 1M y el precio por acierto de caché lo hacen práctico para el trabajo tedioso y de varios pasos que se vuelve costoso rápidamente en otros lugares. No es el mejor codificador disponible en absoluto, y Moonshot merece crédito por decirlo, pero para mucho trabajo real la brecha es pequeña y las ventajas de costo y apertura son reales. Empieza con una tarea concreta y verificable, deja que K3 itere y verifica las APIs que produce con Apidog antes de lanzarlo. Para el contexto del modelo, el pilar qué es Kimi K3 y la guía de la API de Kimi K3 continúan desde allí.
Preguntas frecuentes
¿Cómo uso Kimi K3 para codificar? Ejecútalo dentro de Kimi Code, el agente de codificación de terminal e IDE de Moonshot. Instala el agente, ábrelo en tu directorio de proyecto, selecciona el modelo con /model kimi-k3, luego dale una tarea concreta y verificable y deja que lea archivos, ejecute herramientas e itere. La guía de instalación completa está en nuestra guía de CLI de Kimi Code.
¿Es Kimi K3 bueno para la codificación agéntica? Sí. Está ajustado exactamente para lo que la codificación agéntica necesita: navegar por grandes repositorios, usar herramientas, depurar e iterar con pruebas, registros y retroalimentación en tiempo de ejecución sobre un contexto de 1M de tokens. Es competitivo en los benchmarks de codificación, aunque está ligeramente por detrás de Fable 5 y GPT-5.6 Sol.
¿Soporta Kimi K3 la llamada a herramientas para flujos de trabajo de agente? Sí. La API de K3 soporta llamadas a herramientas, restricciones de elección de herramienta, modo JSON, salida estructurada, búsqueda en internet, carga dinámica de herramientas y esfuerzo de razonamiento configurable, que es lo que le permite ejecutar pruebas, ejecutar comandos de shell y orquestar un bucle de agente completo dentro de Kimi Code. La guía de la API de Kimi K3 cubre los detalles del lado del desarrollador.
¿Puedo probar las APIs que Kimi K3 escribe? Sí, y deberías hacerlo. Las propias pruebas del agente confirman que el código funciona, pero no que el endpoint devuelve los códigos de estado correctos, la forma de respuesta y el comportamiento de autenticación que un cliente real espera. Envía solicitudes reales a los endpoints generados en Apidog, añade aserciones e importa cualquier especificación OpenAPI que el agente haya producido para validar contra el contrato.