Kimi K3 en Claude Code: la guía completa de configuración
Moonshot ofrece un endpoint compatible con Anthropic, así que Claude Code funciona sobre Kimi K3 con un solo bloque de variables en settings.json. Cada valor de configuración de esta guía está copiado del documento oficial de Kimi, y las ocho capturas siguen una sesión real de K3 desde el primer prompt hasta un juego verificado y jugable.
En resumen: Kimi K3 dentro de Claude Code
- La Messages API de Moonshot es compatible con Anthropic: apunta ANTHROPIC_BASE_URL a https://api.moonshot.ai/anthropic, pega tu clave de Kimi en ANTHROPIC_AUTH_TOKEN, y Claude Code conserva todas sus funciones mientras Kimi K3 piensa.
- El settings.json oficial asigna cada nivel de modelo a kimi-k3[1m] (la variante de 1M de contexto), el nivel Haiku a kimi-k2.7-code, y fija CLAUDE_CODE_AUTO_COMPACT_WINDOW en 1000000 y CLAUDE_CODE_EFFORT_LEVEL en max.
- Dos formas de verificar: ejecuta /status y comprueba la Base URL junto al modelo kimi-k3[1m], o simplemente lee el banner de arranque. En la demo dice Using kimi-k3 (from .claude/settings.json).
- K3 funciona con pago por uso en la Kimi API Platform: 3 $ por millón de tokens de entrada, 15 $ por millón de salida, 0,30 $ con caché, contexto de 1M. El modelo en sí es un MoE de 2,8 billones de parámetros con 104B activos y pensamiento siempre activado.
Kimi K3 + Claude Code Demo
Vídeo demostrativo:Data Science in your pocket8:11
Use Kimi in Claude Code — official guide
Datos del producto:platform.kimi.aiKimi API Platform docs
Los pasos 1-4 (instalación, clave de API, bloque de variables, verificación con curl) se documentan a partir de la guía oficial de Kimi porque no existe ninguna grabación limpia del proceso de configuración: todos los tutoriales de YouTube muestran la cara del autor. Los pasos 5-12 son fotogramas de una grabación solo de terminal con Claude Code v2.1.207 sobre kimi-k3.
Los fotogramas son capturas atribuidas al vídeo de origen, cada una enlazada a su marca de tiempo. El texto de esta guía es original: no es una transcripción.
Kimi K3 en Claude Code, paso a paso
1 · Apuntar Claude Code hacia Kimi K3
- 1
Instalar Claude Code
Usa el instalador nativo de Anthropic: curl -fsSL https://claude.ai/install.sh | bash en macOS y Linux, o irm https://claude.ai/install.ps1 | iex en PowerShell de Windows. La vía npm también vale: npm install -g @anthropic-ai/claude-code requiere Node.js 22 o superior. ¿Ya tienes Claude Code? Sáltalo, pero si alguna herramienta de terceros editó ~/.claude/settings.json, limpia antes las entradas ANTHROPIC_* obsoletas del campo env, porque esos valores sobrescriben en silencio todo lo que exportes en la terminal.
- 2
Crear una clave de API de Kimi
Inicia sesión en platform.kimi.ai, abre la consola y crea una clave en API Keys. K3 se desbloquea tras una recarga exitosa y el mínimo es 1 $: con un solo dólar basta para seguir este tutorial entero. Ojo: esta es la Kimi API Platform de pago por uso. Una suscripción a Kimi Code o Kimi Membership es otro producto y no proporciona la clave de API que esta configuración necesita.
- 3
Escribir el bloque de variables en ~/.claude/settings.json
Abre (o crea) ~/.claude/settings.json y rellena el campo env exactamente como indica la guía oficial: ANTHROPIC_BASE_URL en https://api.moonshot.ai/anthropic, ANTHROPIC_AUTH_TOKEN con tu clave de Kimi, ANTHROPIC_MODEL junto con los niveles OPUS, SONNET y FABLE y CLAUDE_CODE_SUBAGENT_MODEL en kimi-k3[1m], ANTHROPIC_DEFAULT_HAIKU_MODEL en kimi-k2.7-code, CLAUDE_CODE_AUTO_COMPACT_WINDOW en 1000000 y CLAUDE_CODE_EFFORT_LEVEL en max. Mapear cada nivel importa: Claude Code envía peticiones de fondo y de subagentes por esos alias, y si falta uno, falla en silencio. El bloque env sobrescribe las variables exportadas en la terminal y guarda tu clave en texto plano: nunca lo subas a git.
- 4
Demostrar endpoint y clave con curl
Antes de arrancar Claude Code, envía una petición de un token directo a la ruta compatible con Anthropic: curl https://api.moonshot.ai/anthropic/v1/messages con una cabecera Authorization: Bearer que lleve tu clave de Kimi y un cuerpo con model kimi-k3 y max_tokens 1. Una respuesta JSON normal significa que endpoint y credenciales funcionan. Un 401 significa que la clave no es válida, que la Base URL no coincide con la plataforma que emitió la clave, o que un ANTHROPIC_API_KEY residual choca con ANTHROPIC_AUTH_TOKEN: elimínalo.
2 · Arrancar y demostrar que K3 está al mando
- 5
Arrancar claude y leer el banner
Ejecuta claude dentro de una carpeta de proyecto. El banner cuenta toda la historia: Claude Code v2.1.207 en la demo, luego kimi-k3 · API Usage Billing y después la línea que importa: Using kimi-k3 (from .claude\settings.json) · /model. Ahí ves el bloque de variables en marcha; un .claude/settings.json a nivel de proyecto funciona igual. Si tu banner todavía muestra una línea de facturación de Claude o Anthropic, vuelve al paso 3 y reinicia Claude Code.
El banner de arranque nombra kimi-k3 y el settings.json del que procede.Ver en 0:22 - 6
Enviar una tarea real, no un quién-eres
La demo abre con help me develop a game called snake and ladders. — un encargo concreto y construible. K3 piensa antes de responder: Thought for 16s y, mientras la respuesta llega en streaming, la línea de estado cuenta Channeling… 25s · ↓1.0k tokens. Olvídate del truco de preguntarle qué modelo es: la configuración mapea los alias de Claude a IDs de Kimi, así que la autoidentificación no prueba nada. /status y el banner son la evidencia.
Primer prompt enviado, K3 pensando: el contador de tokens arranca.Ver en 1:42 - 7
Responder las preguntas aclaratorias
K3 no adivina: pregunta. Aparece un selector con pestañas — Platform, Players, Rules, Submit — con opciones como Web (HTML/CSS/JS), Python console, Python + pygame o texto propio, cada una con su explicación debajo. Enter selecciona, Tab y las flechas navegan, Esc cancela. Ese cuestionamiento estructurado desde el principio es la mitad de la razón por la que el resultado final no necesita rehacerse.
La interfaz de preguntas con pestañas: Enter selecciona, Tab y las flechas navegan, Esc cancela.Ver en 2:04
3 · Un prompt, un juego: el ciclo de trabajo de K3
- 8
Revisar y enviar tus respuestas
Antes de que empiece nada, Claude Code muestra la pantalla Review your answers: las pestañas Platform, Players y Rules aparecen con su marca verde — Python + pygame, 1 player vs computer y Classic en la demo — y Submit answers espera como opción resaltada. Un Enter después, el agente tiene su especificación completa. Revisa con cuidado: el plan se construye exactamente de estas elecciones.
Platform, Players y Rules marcadas — Submit answers está a un Enter de distancia.Ver en 2:12 - 9
Leer el plan y dejar que instale lo que falte
El plan llega en pasos verificables: comprobar el entorno y confirmar Python + pygame; escribir el juego y confirmar que compila; probar lógica y renderizado sin interfaz hasta que las partidas simuladas terminen en una victoria de casilla exacta 100. Detecta Python 3.13, encuentra que falta pygame y ejecuta por su cuenta python -m pip install pygame. Fíjate en el tiempo de pensamiento: 4 min 53 s de una tacada. Así trabaja CLAUDE_CODE_EFFORT_LEVEL=max; K3 usa por defecto el máximo esfuerzo de razonamiento.
El plan en tres partes y la instalación automática de pygame sobre Python 3.13.Ver en 3:42 - 10
Aprobar la escritura y ver la comprobación de compilación
K3 escribe snake_and_ladders.py — 279 líneas en la demo — y después verifica su propio trabajo: primero una comprobación de compilación (python -m py_compile … && echo "compile OK") y luego una prueba de humo sin interfaz que renderiza cada elemento y simula miles de partidas completas. El pie dice accept edits on (shift+tab to cycle), el modo de permisos que deja pasar las escrituras sin confirmar una por una. Una escritura rechazada tiene arreglo: la propia demo se recupera de un rechazo accidental y reintenta.
279 líneas escritas y python -m py_compile en marcha bajo accept edits on.Ver en 6:05
4 · Resultado verificado y listo para ejecutar
- 11
Leer la lista de verificación
All checks pass. The game is done and verified. Y Claude Code enumera la evidencia: Compilación ✓, Renderizado — tablero, serpientes, escaleras y dado se dibujan sin errores ✓, Mapeo del tablero — casilla 1 abajo a la izquierda en zigzag hasta la 100 ✓, Reglas — pasarse anula el turno, ganar exige casilla exacta 100 ✓, y 2000 partidas simuladas que acaban todas con ganador ✓. Debajo imprime el comando de ejecución y un resumen de lo que obtienes. Ese hábito vale la pena copiarlo: nunca confíes en el código, simúlalo.
Compilación, renderizado, mapeo del tablero, reglas y 2000 partidas simuladas: todo en verde.Ver en 6:55 - 12
Ejecutarlo
Lanza el comando impreso — python C:\Users\datas\snake_and_ladders\snake_and_ladders.py en la demo — y se abre la ventana del juego: un tablero de 10x10 con serpientes verdes onduladas y escaleras marrones, un panel lateral SNAKES & LADDERS con indicador de turno, dado y botón verde Roll. Espacio o clic para tirar, R reinicia, Esc sale. De una frase a un juego jugable y autoverificado en unos diez minutos de K3.
La ventana terminada de Snakes & Ladders, lanzada con el comando que imprimió K3.Ver en 7:35