Configuración de Coding Agents

Configurar Kodacode: API Key, Base URL y errores 429

Configura Kodacode con una API Key de BetterToken, Base URL y Model ID, y soluciona errores 429 y otros problemas habituales. Con configuración y ejemplos.

Para conectar Kodacode con BetterToken, prepara una API Key, introduce la Base URL indicada a continuación y elige un ID de modelo vigente en la model plaza. Si el error aparece en MonkeyCode, consulta la guía independiente de MonkeyCode.

Ajustes principales

Campo	Valor
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Modelo	Un ID de modelo vigente de la model plaza

Requisitos previos

La versión actual de la herramienta está instalada
Una BetterToken API Key: regístrate y obtén una
Un ID de modelo de la model plaza

Regístrate y obtén una BetterToken API Key

¿Ya tienes una cuenta? Inicia sesión, recarga el saldo y crea una clave en la consola.

Requisitos adicionales

VS Code está instalado
La extensión Kodacode / Koda está instalada
Copia el Model ID exacto de la model plaza.

Instalación

Instala o abre Kodacode y continúa con la configuración manual siguiente.

Configuración manual

Campo	Valor
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Modelo	Un ID de modelo vigente de la model plaza

Pasos de configuración

Abre el panel Koda y añade un modelo

Abre el panel KODA en la barra lateral de VS Code, haz clic en el selector situado debajo del cuadro de entrada y elige Add model: Agent.

Selecciona Add model: Agent en el selector de modelos del panel Koda.

Completa los ajustes del modelo compatible con OpenAI

En el cuadro para añadir un modelo, usa estos valores:

Campo	Valor recomendado
Provider	`Any OpenAI-compatible API`
API Base	`https://bettertoken.ai/v1/`
Model ID	Un ID de modelo disponible de la model plaza, por ejemplo, `YOUR_MODEL_ID`
API Key	Tu BetterToken API Key

Haz clic en Connect después de completar los campos.

Selecciona Any OpenAI-compatible API en el cuadro para añadir modelos de Kodacode y completa API Base, Model ID y API Key.

Confirma que el modelo esté activo

Cuando se complete la conexión, selecciona el modelo nuevo, como YOUR_MODEL_ID, en el selector situado bajo el cuadro de entrada de Koda. Envía un mensaje breve para confirmar que responde.

Comprueba config.yaml

Kodacode escribe la configuración en ~/.koda/config.yaml. Abre el archivo para confirmar que se haya añadido el modelo.

config.yaml de Kodacode con la configuración del modelo compatible con OpenAI añadida.

Ejemplo de config.yaml

Usa esta estructura completa como referencia. Sustituye YOUR_API_KEY por tu BetterToken API Key y no incluyas una API Key real en los commits del repositorio.

name: Koda
version: 0.0.1
schema: v1
models:
  - name: Koda Models
    provider: koda-chat-models
    model: AUTODETECT
    roles:
      - agent
      - chat
      - edit
  - name: YOUR_MODEL_ID
    provider: openai
    model: YOUR_MODEL_ID
    apiKey: YOUR_API_KEY
    apiBase: https://bettertoken.ai/v1/
    roles:
      - agent
      - chat
      - edit
context:
  - provider: code
  - provider: docs
  - provider: diff
  - provider: terminal
  - provider: problems
  - provider: folder
  - provider: codebase

Verifica la conexión

Envía un prompt de prueba breve. Si la herramienta responde sin errores de autenticación ni de ID del modelo, la conexión funciona. Reinicia por completo la herramienta después de cambiar la configuración.

Cambia de modelo

Abre el selector de modelos o cambia el campo Model de la configuración. Usa el ID de modelo exacto de la model plaza y reinicia la sesión actual.

Errores habituales

Error	Qué comprobar
`401` o `Unauthorized`	Comprueba la BetterToken API Key y elimina los espacios iniciales o finales.
`404`	Comprueba la Base URL y no añadas una ruta específica de endpoint.
`model not found`	Copia un ID de modelo vigente desde la model plaza.
Los cambios no se aplican	Guarda la configuración y reinicia la herramienta por completo.

Si falla la conexión, confirma que API Base sea https://bettertoken.ai/v1/ y conserva la / final.
Copia el Model ID exacto de la model plaza.
Si falla la autenticación, vuelve a copiar la API Key sin espacios adicionales ni saltos de línea.
Si los cambios de config.yaml no se aplican, reinicia VS Code o ejecuta Developer: Reload Window.
BetterToken normalmente no requiere un User-Agent adicional ni cabeceras personalizadas.

Configuración avanzada

Guías relacionadas

Detalles técnicos

Protocolo, endpoint y campos internos del proveedor

Esta configuración usa https://bettertoken.ai/v1. La herramienta añade la ruta del endpoint compatible con OpenAI. No añadas /chat/completions ni /responses salvo que un campo concreto lo exija explícitamente.