Goose с Claude и GPT: настройка своего API (CLI и Desktop)

Goose — AI-агент с открытым исходным кодом, изначально созданный в Block. Он работает на вашем компьютере как консольная утилита (goose CLI) и как настольное приложение (goose Desktop). Агент правит файлы, запускает команды и подключается к другим инструментам через расширения (MCP-серверы). Своей модели у Goose нет: вы подключаете LLM-провайдера, и каждый шаг сессии — это запрос, который оплачивается у него.

Руководство проверено по документации и исходному коду Goose версии 1.54 (октябрь 2026 года).

APIVAI даёт один ключ для Claude и GPT с оплатой за токены (для большинства моделей ниже официальных цен), с баланса, который вы пополняете сами. Ключ работает и в формате OpenAI, и в формате Anthropic, поэтому подходит для обоих нужных здесь встроенных провайдеров Goose.

Оба параметра хоста принимают только корень сервера. Goose соединяет хост с путём запроса: v1/chat/completions (из OPENAI_BASE_PATH), v1/responses или v1/messages. Хост, оканчивающийся на /v1, даёт /v1/v1/... и ошибку 404.

Выбирайте OpenAI, если нужна одна настройка для всех моделей. С этим провайдером Goose отправляет модели семейств GPT-5 и GPT-6 в Responses API (v1/responses), а остальные, например Claude, — в v1/chat/completions; APIVAI обслуживает оба эндпоинта. Выбирайте Anthropic, если работаете только с Claude: Goose автоматически включает кэширование промптов для моделей Claude у провайдера Anthropic, и повторяющийся контекст оплачивается по цене чтения из кэша — $0.12 за миллион токенов для Claude Sonnet 4.6 — вместо полной цены входа. Запись в кэш стоит $1.44 за миллион.

1. Зарегистрируйтесь на apivai.com по email.
2. Пополните баланс от $10 картой, криптовалютой, через Alipay или WeChat Pay. Бесплатного периода и подписки нет.
3. В Панели создайте ключ и скопируйте его. Задайте лимит бюджета, если хотите жёстко ограничить расходы Goose.

1. Выполните goose configure.
2. Выберите Configure Providers и нажмите Enter.
3. Выберите OpenAI.
4. Когда появится запрос OPENAI_API_KEY, вставьте ключ APIVAI.
5. На вопрос Would you like to configure advanced settings? ответьте Yes и заполните запросы по таблице ниже. Остальные (организация, проект, дополнительные заголовки, тайм-аут) пропустите клавишей Enter.
6. Выберите модель из списка, найдите её поиском или выберите Enter a model not listed... и введите точный ID.
7. Начните работу командой goose session.

В более старых версиях Goose запрос хоста идёт сразу после ключа, без вопроса о дополнительных настройках; значения те же. Goose хранит ключ в системном хранилище ключей (или в secrets.yaml, если хранилища нет), но никогда в config.yaml.

Проверьте, какие ID доступны вашему ключу:

Модели со временем добавляются и снимаются, поэтому копируйте ID из этого списка или со страницы цен.

Снова выполните goose configure, выберите Configure Providers, затем Anthropic. Вставьте тот же ключ как ANTHROPIC_API_KEY, ответьте Yes на вопрос о дополнительных настройках, укажите ANTHROPIC_HOST = https://api.apivai.com и выберите модель Claude. Не добавляйте /v1: Goose отправляет запросы Anthropic на хост плюс v1/messages, то есть на https://api.apivai.com/v1/messages. О формате Anthropic — на странице прокси для Claude API.

1. Откройте боковую панель, нажмите Settings, перейдите на вкладку Models и нажмите Configure providers.
2. Нажмите OpenAI, введите ключ APIVAI и укажите хост (OPENAI_HOST) https://api.apivai.com. Нажмите Submit.
3. На вкладке Models нажмите Switch models, выберите провайдера OpenAI, затем Use custom model, введите claude-sonnet-4-6 и нажмите Select model.

Можно также нажать Add Custom Provider внизу списка провайдеров: в Provider Type выберите OpenAI Compatible, в Display Name — APIVAI, в API URL — https://api.apivai.com/v1, вставьте ключ, перечислите ID моделей в Available Models (через запятую) и нажмите Create Provider. Так APIVAI не смешивается с настоящей настройкой OpenAI.

В Windows PowerShell пишите $env:OPENAI_HOST = "https://api.apivai.com" и так далее. Переменные окружения переопределяют файл конфигурации для этого процесса. Не кладите ключ API в config.yaml: ключи провайдеров оттуда Goose не читает.

Цены за 1M входных / выходных токенов на 2026-10-10:

Goose во всём опирается на вызов инструментов, поэтому выбирайте модели с его поддержкой; все модели в таблице её имеют. Моделям GPT нужен провайдер OpenAI или пользовательский провайдер OpenAI Compatible.

Каждый ход сессии Goose заново отправляет переписку, результаты инструментов и инструкции расширений, поэтому основную часть расходов дают входные токены. Два расчёта:

• Одна рабочая сессия на Claude Sonnet 4.6: около 30 запросов по 30 000 входных и 1 500 выходных токенов. Стоимость: $1.29 с APIVAI, $3.38 по официальным ценам.
• Месяц по две такие сессии в день в течение 22 дней (1 320 запросов): $56.91 с APIVAI, $149 по официальным ценам. Небольшой ежедневный рецепт на Claude Haiku 4.5 (10 запросов по 10 000 входных и 1 000 выходных токенов, 220 в месяц) обойдётся в $1.26.

В расчётах не учтено кэширование промптов у провайдера Anthropic. Токены размышлений считаются выходными. Реальные цифры по каждому запросу — в Панели. Более широкое сравнение — в статье цены Claude API в 2026 году.

• 401 Unauthorized: ключ неверный, удалён или исчерпал лимит бюджета, либо он записан в config.yaml, где Goose его не читает. Выполните goose configure заново или задайте OPENAI_API_KEY / ANTHROPIC_API_KEY.
• 404 Not Found: неправильный /v1. OPENAI_HOST и ANTHROPIC_HOST — это https://api.apivai.com без пути, а OPENAI_BASE_PATH остаётся v1/chat/completions. Не задавайте OPENAI_BASE_URL и OPENAI_HOST с противоречащими значениями.
• Модель не найдена: укажите точный ID, например claude-sonnet-4-6, а не отображаемое название. Сверьтесь с GET /v1/models.
• Пустые или обрезанные ответы: размышления включены по умолчанию и расходуют выходные токены. Установите GOOSE_MAX_TOKENS = 8192 (не меньше 4096).
• 429 Too Many Requests: по умолчанию 60 запросов в минуту на ключ. Подождите немного или попросите поддержку увеличить лимит.

Подробнее о форматах запросов — в документации и на странице OpenAI-совместимый API.

Да. Один ключ APIVAI работает со всеми моделями. С провайдером OpenAI достаточно поменять GOOSE_MODEL или переключить модель в приложении.

Goose собирает адрес из хоста и OPENAI_BASE_PATH, который уже начинается с v1/. Полный запрос уходит на https://api.apivai.com/v1/chat/completions.

OpenAI — для моделей GPT или одной настройки на всё. Anthropic — для работы только с Claude, где Goose включает кэширование промптов; его хост тоже https://api.apivai.com.

Нет. APIVAI обслуживает только чат-модели: чат, вызовы инструментов и расширения работают, а всё, что требует модели эмбеддингов, нужно подключать через отдельного провайдера.

Нет. Содержимое запросов и ответов не записывается; для биллинга сохраняются только данные об использовании: модель, токены и стоимость.

Да. См. руководство по Aider и руководство по OpenCode.

Создайте аккаунт, пополните баланс от $10 и вставьте ключ в Goose.