Documentación

Kimi Code

Kimi Code guarda los proveedores en un archivo TOML; un endpoint de terceros se configura con tres claves: type, base_url, api_key. Configura uno para Kunavo y la CLI se comunicará con los ID de Claude y GPT mediante el protocolo que ya admite.

Kimi Code guarda los proveedores en ~/.kimi-code/config.toml — configura providers.<name>.base_url como https://api.kunavo.com/v1 con type = "openai" y la CLI ejecutará IDs de Claude y GPT con una sola clave.

~/.kimi-code/config.toml

default_model = "kunavo/claude-sonnet-5"

[providers.kunavo]
type = "openai"
base_url = "https://api.kunavo.com/v1"
api_key = "sk-kn-..."

[models."kunavo/claude-sonnet-5"]
provider = "kunavo"
model = "claude-sonnet-5"
max_context_size = 200000

base_url conserva el sufijo /v1. La página de proveedores lo deja claro sin necesidad de inferir nada: el valor predeterminado documentado para type = "openai" es https://api.openai.com/v1, y el ejemplo práctico de un endpoint de terceros en la página de variables de entorno es KIMI_MODEL_BASE_URL="https://api.example.com/v1". Kimi Code solo añade la ruta, así que aquí un origen sin sufijo produce un error 404, no un error de autenticación. Es lo contrario de lo que ocurre con los clientes que usan el protocolo Anthropic, que requieren https://api.kunavo.com sin sufijo.

Exportar una variable de shell no proporciona una clave al proveedor. La página de archivos de configuración de Kimi Code es tajante al respecto: ejecutar export KIMI_API_KEY en la terminal no proporciona una clave a ningún proveedor. El orden de prioridad documentado es api_key o api_key_env — configura exactamente uno; son mutuamente excluyentes —, luego una clave de la subtabla [providers.kunavo.env] si ninguno está presente. Si no está presente ninguno de los anteriores, el inicio falla con un error. Para mantener la clave fuera del archivo, escribe api_key_env = "KUNAVO_API_KEY" en lugar de api_key; si la variable no está configurada o está vacía, la solicitud falla con un error que indica el nombre de la variable.

Kunavo no ha probado este cliente con su propio endpoint. El bloque anterior se basa en la documentación actual de Kimi Code, no en una sesión: aquí no se ha registrado ninguna prueba de streaming ni de llamadas a herramientas desde Kimi Code, así que considera la primera solicitud real como una prueba, no como una confirmación. La página publicada describe la configuración, no la aceptación.

type indica el protocolo, no el proveedor. El conjunto documentado es kimi, anthropic, openai, openai_responses, google-genai y vertexai: la tabla actual no incluye ninguna variante heredada de OpenAI, así que cualquier guía que te indique configurarla está desactualizada. Elegir openai y luego introducir un ID de modelo de Claude es la combinación prevista: el ID se resuelve en la URL base, no en la CLI.

¿Aún no tienes una clave? Crea una cuenta de Kunavo, genera una clave (empieza por sk-kn-) y añade crédito desde $10; las llamadas se pagan con ese saldo y las llamadas fallidas no se facturan. El panel se abre entonces en la configuración de Kimi Code.

Paso a paso

Cree una clave en /app/keys y cópiela: se muestra una sola vez.
Abre ~/.kimi-code/config.toml, que se crea en el primer inicio. Si has cambiado el directorio de datos con KIMI_CODE_HOME, el archivo está en $KIMI_CODE_HOME/config.toml; el nombre del archivo siempre es config.toml.
Añade la tabla [providers.kunavo] anterior. Las tres claves que la documentación muestra para este tipo, en este orden, son type, base_url y api_key.
Declara un alias de modelo en [models."..."] con provider, model y max_context_size; los tres campos son obligatorios. El alias es el nombre que pasas a -m y default_model; el valor de model es el ID que se envía por la conexión. Pon entre comillas cualquier alias que contenga un punto.
Deja capabilities fuera durante la primera configuración. La página de proveedores indica que las capacidades se asignan automáticamente según el prefijo del nombre del modelo, y la tabla de modelos señala que el array solo admite elementos nuevos, nunca los elimina. Por tanto, una etiqueta incorrecta no se puede quitar después editando la configuración.
Ejecuta kimi o kimi -m kunavo/claude-sonnet-5 para elegir el alias de una sesión. Para probar el endpoint sin modificar la configuración, establece KIMI_MODEL_NAME, KIMI_MODEL_API_KEY, KIMI_MODEL_PROVIDER_TYPE=openai y KIMI_MODEL_BASE_URL: la CLI crea un proveedor en memoria y no guarda ningún cambio.

Comprobado con La página de proveedores y modelos de Kimi Code el 21 de septiembre de 2026. La configuración de terceros puede cambiar; si el nombre de un campo ya no coincide con lo que ves, esa página es la autoridad, no esta.

Esta es la versión breve. El tutorial completo —elección del modelo, coste de una sesión real y modos de fallo— está en Kimi Code frente a Claude Code: qué cliente, qué modelo y qué cuenta.

Verifica antes de depurar el cliente

Una solicitud determina si el fallo está en el endpoint, la clave o el archivo de configuración. Si devuelve JSON, la misma URL base y la misma clave funcionan en Kimi Code.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Qué ID de modelo introducir en el campo

Todos los modelos de texto están disponibles mediante un ID de modelo; la lista activa está en GET /v1/models, y el catálogo con precios está en la página de modelos. Las tarifas son USD por 1M de tokens, entrada / salida.

ID de modelo	Entrada / salida de Kunavo	Dónde encaja en Kimi Code
`claude-sonnet-5`	$1.40 / $7.00	el alias predeterminado: el modelo de trabajo para los ciclos de edición y ejecución
`claude-opus-5`	$3.50 / $17.50	un segundo alias para las fases de planificación, donde un plan erróneo resulta caro
`claude-haiku-4-5`	$0.70 / $3.50	el alias económico que debes asignar en [secondary_model] para los subagentes
`gpt-5-6-sol`	$2.00 / $12.00	una segunda opinión de una familia distinta, con la misma clave y la misma tabla de proveedores

La facturación es por token desde un saldo prepago, sin cuota mensual; consulta facturación. Con contexto repetido —que constituye la mayor parte de lo que envía un editor o cliente de chat—, la caché de indicaciones cambia más la factura que la elección del modelo.

Preguntas frecuentes

¿Cómo configuro un endpoint de API personalizado en Kimi Code?

Añade una tabla de proveedor a ~/.kimi-code/config.toml con type = "openai", base_url configurado con la URL de tu endpoint y api_key con tu clave; luego declara un alias de modelo en [models."<alias>"] con provider, model y max_context_size. La página de proveedores de Kimi Code documenta que type = "openai" sirve para el protocolo OpenAI Chat Completions y cualquier servicio de terceros compatible, con base_url personalizable según sea necesario. También puedes abrir el gestor de proveedores con /provider en la TUI, pero su ruta para proveedores conocidos importa datos del catálogo models.dev, así que añadir manualmente un endpoint que no aparece en ese catálogo es más rápido.

¿La base_url de Kimi Code debe terminar en /v1?

Sí, para un endpoint compatible con OpenAI. Kimi Code solo añade la ruta, así que base_url debe ser la raíz /v1; por ejemplo, https://api.kunavo.com/v1. La documentación lo deja claro: el valor predeterminado de base_url para type = "openai" es https://api.openai.com/v1 y el ejemplo de terceros de la página de variables de entorno es https://api.example.com/v1. Si falta /v1, se produce un error 404, no un 401.

¿Por qué Kimi Code dice que falta mi clave de API si la variable está exportada?

Porque no lee las variables de entorno del shell para obtener credenciales, salvo que le indiques cuál debe leer. La página de archivos de configuración afirma que ejecutar export KIMI_API_KEY no proporciona una clave a ningún proveedor. Escribe api_key directamente en config.toml o configura api_key_env con el nombre de la variable; son mutuamente excluyentes, así que debes configurar exactamente una. Solo se consulta la subtabla [providers.<name>.env] cuando ninguna de las dos está presente. Si no está presente ninguna de las tres, el inicio falla con un error.

¿Puede Kimi Code ejecutar modelos de Claude a través de un proveedor externo?

El tipo de proveedor indica el protocolo, no el proveedor, y el valor de model se transmite al valor de base_url que configuraste. Así que un ID de Claude definido en un proveedor de tipo openai se resuelve en ese endpoint y no en la CLI. Kimi Code también tiene un proveedor independiente con type = "anthropic" para el protocolo Anthropic Messages, cuya URL base es el origen sin el sufijo /v1. Kunavo no ha probado una sesión de Kimi Code con su endpoint mediante ninguno de los dos protocolos, así que compruébalo con el curl anterior y considera la primera sesión como una prueba.