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

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

Подключите Goose к BetterToken: задайте API Key, адрес OpenAI и Model ID, включите расширение developer и проверьте текстовый запрос и чтение файлов.

Подключите Goose к BetterToken через провайдер OpenAI. В тестах на macOS с моделью GPT Goose 1.55.0 выполнил текстовые запросы и вызовы инструментов для чтения файлов через /v1/responses.

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

Поле	Значение
API Key	API Key BetterToken в `OPENAI_API_KEY`
Base URL	`https://bettertoken.ai` в `OPENAI_HOST`, без `/v1`
Model	`YOUR_MODEL_ID` в `GOOSE_MODEL`
Провайдер	`GOOSE_PROVIDER=openai`

Подготовка

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

Установка

Используйте официальный установщик Goose:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash
goose --version

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

Перед запуском замените YOUR_API_KEY и YOUR_MODEL_ID:

export GOOSE_PROVIDER="openai"
export GOOSE_MODEL="YOUR_MODEL_ID"
export OPENAI_API_KEY="YOUR_API_KEY"
export OPENAI_HOST="https://bettertoken.ai"

В OPENAI_HOST укажите корневой адрес сайта. Не добавляйте /v1, даже если используете провайдер OpenAI.

Для доступа к файлам запустите goose configure, выберите Toggle Extensions и включите developer. Расширение developer предоставляет инструменты для работы с файлами и оболочкой.

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

Выполните команду в том же терминале:

goose run --no-session --max-turns 4 -t "Reply with only: OK"

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

Смена модели

Укажите в GOOSE_MODEL другой точный Model ID из каталога моделей и запустите новый запрос.

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

Симптом	Что проверить
Ошибка авторизации	Проверьте `OPENAI_API_KEY` в терминале, из которого запускаете Goose.
Неверный адрес запроса	Укажите в `OPENAI_HOST` адрес `https://bettertoken.ai` без `/v1` и пути конкретного API.
Недоступны инструменты для файлов	Включите встроенное расширение developer через `goose configure`.
Запросы всё ещё используют Responses	В тестах Goose 1.55.0 даже `OPENAI_BASE_PATH=v1/chat/completions` не изменил маршрут запросов тестируемой модели: они шли на `/v1/responses`. Проверьте фактический путь запроса.

См. также

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

Тестовые текстовые запросы и запросы на чтение файлов использовали /v1/responses. Название провайдера и имена переменных окружения сами по себе не определяют, какой протокол Goose выберет для другой модели.