Una API para todosGuía de uso
Sitio web ↗
Guía de usoConectar herramientas

Kimi Code

Kimi Code es el agente; el modelo lo decide la configuración del proveedor. Esta guía sigue el CLI actual.

Prepara estos tres datos

Con la aplicación ya instalada, abre Autoservicio en esta web e inicia sesión. Crea o consulta tu clave, copia la dirección de API mostrada y un ID exacto de Modelos y precios. No uses la página de inicio, la contraseña de acceso ni un nombre comercial del modelo. Comprueba el saldo y la cuota de la clave.

API_HOST, YOUR_API_KEY y YOUR_MODEL_ID son marcadores: sustitúyelos antes de usar el ejemplo. Sigue las indicaciones sobre /v1; no añadas /chat/completions ni /responses. Los ejemplos no se conectan automáticamente ni incluyen tu clave.

1. Comprueba versión y ruta

Ejecuta kimi --version. La ruta actual es ~/.kimi-code/config.toml, o %USERPROFILE%\.kimi-code\config.toml en Windows. Versiones antiguas pueden usar ~/.kimi; consulta la documentación de tu versión, sin modificar ambas.

2. Añade proveedor y modelo

Integra el ejemplo. provider = "my_api" debe coincidir con [providers.my_api]. my-model es un alias local; model es el ID real. El contexto 32768 es un ejemplo: ajústalo a los límites confirmados.

Esquema de campos · no es una captura
type
openai / openai_responses
base_url
https://API_HOST/v1
model
YOUR_MODEL_ID
api_key_env
MY_API_KEY
Ejemplo de configuración

Guarda una copia del archivo actual. Modifica las entradas existentes sin duplicarlas y conserva los demás ajustes. No compartas archivos o capturas con claves reales.

default_model = "my-model"

[providers.my_api]
type = "openai"
base_url = "https://API_HOST/v1"
api_key_env = "MY_API_KEY"

[models.my-model]
provider = "my_api"
model = "YOUR_MODEL_ID"
max_context_size = 32768

3. Define la clave y selecciona

api_key_env = "MY_API_KEY" lee esa variable explícita. Defínela, ejecuta kimi y selecciona my-model con /model. /login inicia sesión en el servicio oficial, no configura nuestra plataforma.

Si la configuración usa MY_API_KEY, define la variable en la misma terminal desde la que abrirás la herramienta. Introduce tu clave solo en tu ordenador. La variable dura hasta cerrar esa terminal.

Terminal de macOS / Linux
export MY_API_KEY="YOUR_API_KEY"
kimi
PowerShell de Windows
$env:MY_API_KEY = "YOUR_API_KEY"
kimi

4. Elige protocolo

type = "openai" significa Chat Completions. Usa "openai_responses" solo si has confirmado esa ruta para tu modelo. Conserva /v1 en ambos ejemplos.

5. Declara niveles reales

Los modelos reconocidos suelen detectar capacidades. Para un alias desconocido, añade capabilities = ["tool_use", "thinking"] bajo [models.my-model] solo si las admite. Define support_efforts y default_effort según sus capacidades: si admite low/high, usa support_efforts = ["low", "high"] y default_effort = "low". Declararlo no crea nuevas funciones.

Si has confirmado low para este modelo, añade la sección independiente [thinking] para seleccionarlo. Cambia effort por otro valor declarado cuando lo necesites. El valor global prevalece sobre default_effort. Guarda, ejecuta /reload con la sesión en reposo y prueba un mensaje.

[thinking]
enabled = true
effort = "low"

Prueba 1: recibir una respuesta

Crea una carpeta vacía de prueba, selecciónala como espacio de trabajo y abre una conversación nueva. Comprueba el proveedor y modelo elegidos y envía el mensaje siguiente. Una respuesta sin errores confirma la conexión básica, no todas las funciones. Las pruebas generan consumo normal de API.

Responde solo: Conexión correcta.

Resultado: aparece «Conexión correcta». Si ves una pantalla de acceso, un error o una carga interminable, revisa la tabla antes de repetir.

Prueba 2: leer un archivo real

Con un editor de texto, crea hello.txt en esa carpeta y escribe «API connection test 27». Guarda y envía la petición siguiente. Si solicita permiso, permite leer únicamente esa carpeta.

Utiliza la herramienta de lectura para abrir hello.txt en el espacio de trabajo actual y dime su contenido. No modifiques archivos.

Resultado: un registro de herramienta que lea hello.txt y una respuesta con API connection test 27. Una respuesta de texto sin registro no demuestra una llamada. Después puedes borrar la carpeta de prueba.

Revisa el problema según el síntoma

401 / Invalid API key

Comprueba que dirección y clave completa pertenecen al mismo servicio y que la clave está activa. No envíes claves completas a soporte.

404 / model not found

Revisa /v1, el ID exacto y el protocolo. Ver un modelo en la lista no garantiza todos los protocolos.

429 / quota / balance

Revisa saldo, cuota y frecuencia de solicitudes según el error. Más razonamiento no resuelve la falta de cuota.

Responde pero no lee archivos

Comprueba las herramientas del modelo, los permisos de carpeta y el error de ejecución.

No aparece el nivel de razonamiento

Revisa capacidades, modelo y versión. Poder razonar no implica admitir varios niveles.

Referencias oficiales y alcance

Configuración contrastada el 2026-11-08. Los menús pueden cambiar; consulta estas referencias oficiales. Utiliza siempre los datos de conexión actuales de nuestra plataforma.