Configuración de clave de API de Kimi Code

Clave de API de Kimi Code: configura tu propia clave en config.toml

Pega el bloque de abajo en config.toml, sustituye por tu propia clave de API y Kimi Code podrá usar modelos Claude. Pago por uso.

~/.kimi-code/config.tomltoml
config
# ~/.kimi-code/config.toml
default_model = "aicodewith/claude-haiku-4-5-20251001"

[providers.aicodewith]
type = "openai"
base_url = "https://api.aicodewith.ai/v1"
api_key = "sk-***"

[models."aicodewith/claude-haiku-4-5-20251001"]
provider = "aicodewith"
model = "claude-haiku-4-5-20251001"
max_context_size = 200000

Pasos de configuración

Guarda esta clave para terminales posteriores

Una vez que inicies sesión, este comando incluye tu propia clave. Cópialo, ejecútalo una vez y la herramienta guardará la clave en la ubicación que probamos.

bash
mkdir -p "$(dirname "$HOME/.kimi-code/config.toml")"
cat > "$HOME/.kimi-code/config.toml" << 'EOF'
# ~/.kimi-code/config.toml
default_model = "aicodewith/claude-haiku-4-5-20251001"

[providers.aicodewith]
type = "openai"
base_url = "https://api.aicodewith.ai/v1"
api_key = "sk-***"

[models."aicodewith/claude-haiku-4-5-20251001"]
provider = "aicodewith"
model = "claude-haiku-4-5-20251001"
max_context_size = 200000
EOF

Los visitantes que no han iniciado sesión solo ven un marcador de posición. Inicia sesión y completaremos tu clave. Sign in · Obtén una clave en la consola

Copiar solo pone el comando en el portapapeles. Aún necesitas ejecutarlo en una terminal o pegar la clave en la configuración de la herramienta. Cómo obtener una clave API

Estos pasos se probaron en Linux (bash). macOS y Windows aún no se han probado, por lo que no se incluyen.

  1. ¿Aún no tienes Kimi Code? Instálalo (omite si ya está instalado)

    Ejecuta el script de instalación de Kimi curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash, luego kimi --version. Un número de versión significa que está instalado.

    Instala kimi-code con curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash. Se instala en ~/.kimi-code/bin/kimi. KIMI_NO_MODIFY_PATH=1 en la captura de pantalla es solo para nuestra máquina de prueba; no lo necesitas. kimi --version muestra 2.1.1
  2. Pega la configuración en config.toml y añade tu clave de API

    Abre ~/.kimi-code/config.toml, pega el bloque de la parte superior de esta página y reemplaza sk-*** con tu clave de API (Obtener una clave de API). Después de guardar, el archivo tiene una línea api_key = "sk-…".

    En [providers.aicodewith], establece api_key = "sk-***" (enmascarado)
  3. Abre una nueva terminal y prueba Kimi Code

    Abre una nueva terminal y ejecuta kimi -m aicodewith/claude-haiku-4-5-20251001 -p "Reply with exactly: OK". • OK significa que Kimi Code está usando tu clave de API.

    Verifica: cierra la terminal, abre una nueva, ejecuta kimi -m aicodewith/claude-haiku-4-5-20251001 -p "Reply with exactly: OK"; una respuesta • OK significa que está configurado
  4. ¿No obtienes OK? Compara tu error

    Compara el error en tu terminal con Errores comunes a continuación. Cada uno enumera la causa y la solución.

  5. Cambia los modelos de Kimi Code: cambia el nombre del modelo

    Reemplaza el nombre del modelo en default_model y en el bloque [models."…"] con el nuevo ID de modelo, y usa el mismo nombre después de -m en el comando de prueba. Los ID de modelo están en Modelos y precios.

Errores comunes

error: failed to run prompt: Provider "aicodewith" declares api_key_env = "AICODEWITH_API_KEY" in config.toml, but the environment variable is not set or is empty.

Qué ves

error: failed to run prompt: Provider "aicodewith" declares api_key_env = "AICODEWITH_API_KEY" in config.toml, but the environment variable is not set or is empty.
Causa
config.toml tiene api_key_env, pero AICODEWITH_API_KEY no está definida en la terminal
Cómo corregirlo
Elimina la línea api_key_env y escribe api_key = "tu clave" como en el paso 2

Volver al paso 2: Pega la configuración en config.toml →

No hay clave configurada: config.toml usa api_key_env = "AICODEWITH_API_KEY" y la nueva terminal no tiene esa variable. kimi falla con Provider "aicodewith" declares api_key_env … but the environment variable is not set or is empty.

error: failed to run prompt: provider.auth_error: 401 "请在请求中提供有效的 API Key。"

Qué ves

error: failed to run prompt: provider.auth_error: 401 "请在请求中提供有效的 API Key。"
(Español: "Proporciona una clave de API válida en la solicitud.")
Causa
El valor de api_key es incorrecto
Cómo corregirlo
Copia la clave de nuevo desde la consola y reemplaza el valor entre comillas

Volver al paso 2: Pega la configuración en config.toml →

Con una clave incorrecta (sk-wrong): error: failed to run prompt: provider.auth_error: 401 "请在请求中提供有效的 API Key。"

404 "不支持的请求路径" (ruta de solicitud no compatible)

Qué ves

error: failed to run prompt: provider.api_error: 404 "不支持的请求路径,请检查 API 地址是否正确 (request_id: req_1791793075991_6c21900c)"
Español: no se pudo ejecutar el prompt: error de API del proveedor 404, ruta de solicitud no compatible, comprueba que la dirección de API sea correcta (request_id: req_1791793075991_6c21900c)
Causa
base_url establecido en "https://api.aicodewith.ai/nope"
Cómo corregirlo
Restaura base_url a https://api.aicodewith.ai/v1.

Volver al paso 2: Pega la configuración en config.toml →

Una ventana muestra la línea de configuración incorrecta base_url = "https://api.aicodewith.ai/nope" y luego kimi -m aicodewith/claude-haiku-4-5-20251001 -p "Reply with exactly: Hello from aicodewith.ai". Error real: error: failed to run prompt: provider.api_error: 404 "不支持的请求路径,请检查 API 地址是否正确 (request_id: req_1791793075991_6c21900c)". Español: no se pudo ejecutar el prompt: error de API del proveedor 404, ruta de solicitud no compatible, comprueba que la dirección de API sea correcta (request_id: req_1791793075991_6c21900c). Después se restauró base_url a https://api.aicodewith.ai/v1 y una ejecución normal respondió Hello from aicodewith.ai.

Preguntas frecuentes

¿Cómo uso mi propia clave de API en Kimi Code?

En ~/.kimi-code/config.toml, bajo [providers.aicodewith], escribe api_key = "tu clave" y establece base_url en https://api.aicodewith.ai/v1. Una terminal nueva la conserva.

¿Por qué no funciona export OPENAI_API_KEY?

Kimi Code no lee OPENAI_API_KEY. Coloca la clave de API en el archivo de configuración.

¿Dónde está el config.toml de Kimi Code?

Por defecto, ~/.kimi-code/config.toml. Cambia la raíz de datos con KIMI_CODE_HOME.

¿Puede Kimi Code añadir la clave de API sin editar el archivo?

Sí. Escribe /provider dentro de Kimi Code, o ejecuta kimi provider en la terminal y sigue las indicaciones.

¿Qué significa type = "openai"?

Kimi Code envía solicitudes en el formato de API de OpenAI. AI Code With acepta ese formato, así que solo estableces base_url y api_key.

Fuentes

Enlaces relacionados