Configuración de Coding Agents

Configurar Cline: API Key, Base URL y modelos

Instala Cline, configura la Base URL y la API Key de BetterToken, elige un modelo disponible y resuelve errores frecuentes. En la práctica.

Para conectar Cline a BetterToken, prepara una API Key, introduce la Base URL indicada a continuación y elige un Model ID actual del model plaza. Compara configuraciones similares en Roo Code, Kilo Code y MonkeyCode.

Ajustes principales

Campo	Valor
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	Un Model ID actual del model plaza

Requisitos previos

La versión actual de la herramienta está instalada
Una BetterToken API Key: regístrate y obtén una
Un Model ID del 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 instalado

Instalación

Instalar Cline

Abre VS Code, busca Cline en el marketplace de extensiones e instálalo.

Configuración manual

Realiza esta configuración en la interfaz de Cline. No necesitas editar ningún archivo de configuración.

Campo	Valor
API Key	Tu BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	Un Model ID actual del model plaza

Configuración

Elimina variables de entorno que entren en conflicto

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Abre la interfaz de configuración de Cline

Haz clic en Use your own API key en la barra lateral de Cline.

Configura el proveedor de API

Completa estos campos:

API Provider → OpenAI Compatible
Base URL → https://bettertoken.ai/v1
API Key → tu BetterToken API Key
Model → un Model ID disponible copiado del model plaza

En Model Configuration, introduce los límites de contexto y salida confirmados del modelo elegido. Activa las capacidades de imagen o Computer Use solo cuando el modelo y el endpoint las admitan; consulta los ajustes de proveedor de Cline.

Configura headers adicionales solo cuando lo exija la documentación oficial

La documentación oficial de Cline para una configuración compatible con OpenAI se centra en la Base URL, la API Key y el Model ID. Normalmente no necesitas un User-Agent adicional para conectar BetterToken.

Si también utilizas un gateway personalizado, enrutamiento de tenant o una capa de observabilidad o caché, añade headers solo según la documentación oficial de ese servicio upstream.

Guarda la configuración

Haz clic en Done.

Reinicia Cline

Después de guardar la configuración, reinicia VS Code o recarga la extensión Cline para aplicar los nuevos ajustes.

Verificar la conexión

Usa Verify en los ajustes del proveedor para comprobar la conexión.

Envía un mensaje de prueba corto. Si la herramienta devuelve una respuesta sin errores de autenticación o de Model ID, la conexión funciona. Reinicia por completo la herramienta después de cambiar su configuración.

Cline CLI

Instala el Cline CLI oficial por separado de la extensión de VS Code. En pruebas en macOS con un modelo GPT, Cline CLI 3.0.73 completó solicitudes de texto y llamadas a herramientas de lectura de archivos.

Sustituye YOUR_API_KEY por tu BetterToken API Key y YOUR_MODEL_ID por un ID exacto de la model plaza; después, autentícate:

cline auth --provider openai --apikey YOUR_API_KEY --baseurl https://bettertoken.ai/v1 --modelid YOUR_MODEL_ID

Ejecuta una prueba de texto sin interfaz:

cline --json --retries 2 --timeout 170 --provider openai --model YOUR_MODEL_ID "Reply with only: OK"

Comprueba que la respuesta final contenga OK. En las pruebas, --provider openai se registró como openai-compatible; el valor del comando difiere de la opción OpenAI Compatible del IDE. Si usas --data-dir, indica el mismo directorio de configuración en ambos comandos.

Cambiar de modelo

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

Errores frecuentes

Error	Qué debes 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 la ruta de un endpoint concreto.
`model not found`	Copia un Model ID actual del model plaza.
Los cambios no se aplican	Guarda la configuración y reinicia por completo la herramienta.

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 expresamente.