Configuración de Coding Agents

Configurar Crush: API Key, Base URL y modelos

Instala Crush y configura BetterToken en crushrc con una API Key y una Base URL. Selecciona un modelo y resuelve No providers configured.

Conecta Crush a BetterToken con un proveedor openai-compat en crushrc. En pruebas en macOS con un modelo GPT, Crush 0.98.2 completó las tres solicitudes de texto desde un inicio en frío y una llamada a la herramienta de lectura de archivos mediante /v1/chat/completions.

Ajustes principales

Campo	Valor
API Key	BetterToken API Key, se pasa con `--api-key`
Base URL	`https://bettertoken.ai/v1`, se pasa con `--base-url`
Modelo	`bettertoken/YOUR_MODEL_ID`
Tipo de proveedor	`openai-compat`
Archivo de configuración	`~/.config/crush/crushrc`

Requisitos previos

Homebrew para el siguiente comando de instalación
Una BetterToken API Key: Regístrate y obtén una
Un Model ID y su límite de contexto de la model plaza

Instalación

Usa el comando Homebrew del repositorio oficial de Crush:

brew install charmbracelet/tap/crush
crush --version

Configuración manual

Define tu BetterToken API Key en el terminal donde se ejecutará Crush:

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Crea ~/.config/crush/crushrc con el formato de configuración Bash recomendado. Sustituye cada YOUR_MODEL_ID y asigna a --context-window el límite documentado del modelo elegido. 128000 en el ejemplo es un valor declarado por el cliente, no un límite de modelo de BetterToken verificado.

provider add bettertoken --type openai-compat --base-url "https://bettertoken.ai/v1" --api-key "$BETTERTOKEN_API_KEY"
model add bettertoken/YOUR_MODEL_ID --name "YOUR_MODEL_ID" --context-window 128000
model large bettertoken/YOUR_MODEL_ID
model small bettertoken/YOUR_MODEL_ID
permissions allow view

Guarda estos comandos en crushrc; Crush los ejecuta al iniciarse. permissions allow view permite usar la herramienta para ver archivos. El formato JSON anterior está obsoleto en el proyecto original, pero sigue funcionando; su solicitud de texto también superó la prueba.

Verificar la conexión

Ejecuta el comando desde tu proyecto y en el mismo terminal:

crush run "Reply with only: OK"

Comprueba que la respuesta final sea OK. Para probar el acceso a archivos, pídele a Crush que lea un archivo conocido de tu proyecto y comprueba tanto el resultado de la herramienta view como la respuesta final.

Cambiar de modelo

Añade otro modelo con model add, actualiza las selecciones model large y model small en crushrc y comienza una nueva ejecución.

Errores frecuentes

Síntoma	Qué comprobar
`No providers configured`	Crush muestra este mensaje antes de enviar una solicitud cuando no hay ningún proveedor utilizable. Comprueba la ubicación y el contenido de `crushrc`, incluida la configuración del proyecto que podría prevalecer.
`401`	Exporta `BETTERTOKEN_API_KEY` antes de iniciar Crush y comprueba su valor.
No hay modelos explícitos en la configuración	En las pruebas, Crush descubrió modelos mediante `/v1/models` cuando solo había un proveedor configurado. Las entradas explícitas de `model add` permiten indicar el modelo de este ejemplo.
El acceso a archivos requiere autorización	Comprueba `permissions allow view` en la configuración cargada.

Enlaces relacionados

Detalles técnicos

El proveedor openai-compat probado envió solicitudes de generación a /v1/chat/completions. La detección de modelos usó /v1/models cuando no se incluyeron entradas de modelos explícitas.