Подключение Coding Agent

Crush: установка и настройка API Key, Base URL и моделей

Установите Crush, добавьте API Key и Base URL BetterToken в crushrc, выберите модель и проверьте чтение файлов. Устраните ошибку No providers configured.

Подключите Crush к BetterToken с провайдером openai-compat в crushrc. В тестах на macOS с моделью GPT Crush 0.98.2 выполнил все три текстовых запроса при холодном запуске и вызов инструмента для чтения файла через /v1/chat/completions.

Ключевые параметры

Поле	Значение
API Key	API Key BetterToken, передаётся через `--api-key`
Base URL	`https://bettertoken.ai/v1`, передаётся через `--base-url`
Model	`bettertoken/YOUR_MODEL_ID`
Тип провайдера	`openai-compat`
Файл конфигурации	`~/.config/crush/crushrc`

Подготовка

Homebrew для команды установки ниже
API Key BetterToken: зарегистрироваться и получить
Model ID и лимит контекста из каталога моделей

Установка

Используйте команду Homebrew из официального репозитория Crush:

brew install charmbracelet/tap/crush
crush --version

Ручная настройка

Задайте API Key BetterToken в терминале, из которого будете запускать Crush:

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Создайте ~/.config/crush/crushrc в рекомендуемом формате Bash. Замените все YOUR_MODEL_ID и укажите в --context-window лимит из документации выбранной модели. Значение 128000 в примере — объявление на стороне клиента, а не подтверждённый лимит модели BetterToken.

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

Сохраните эти команды в crushrc: Crush выполняет их при запуске. permissions allow view разрешает инструмент просмотра файлов. Разработчики объявили старый формат JSON устаревшим, но он ещё работает; текстовый запрос с ним тоже прошёл тестирование.

Проверка подключения

Перейдите в каталог проекта в том же терминале и выполните:

crush run "Reply with only: OK"

Убедитесь, что итоговый ответ — OK. Для проверки доступа к файлам попросите Crush прочитать известный вам файл проекта. Сверьте и результат инструмента view, и итоговый ответ.

Смена модели

Добавьте другую модель командой model add, обновите выбор model large и model small в crushrc и запустите новый запрос.

Частые ошибки

Симптом	Что проверить
`No providers configured`	Crush сообщает об этом до отправки запроса, если не загружен пригодный провайдер. Проверьте расположение и содержимое `crushrc`, а также настройки проекта, которые могут его переопределять.
`401`	Экспортируйте `BETTERTOKEN_API_KEY` до запуска Crush и проверьте значение.
Модели не указаны явно	В тестах при настройке только провайдера Crush получал модели через `/v1/models`. Явные записи `model add` позволяют задать модель для этого примера.
Доступ к файлам требует разрешения	Проверьте `permissions allow view` в загруженной конфигурации.

См. также

Технические детали

Тестируемый провайдер openai-compat отправлял запросы генерации на /v1/chat/completions. При отсутствии явных записей моделей их список загружался через /v1/models.