Настройка Goose

Как направить provider Anthropic и OpenAI-совместимый provider goose на QCode: что писать в поле HOST, как задать ID моделей и чего не умеет goose configure

Нужен API-ключ? Зарегистрироваться →·Эндпоинты и Base URL →

Последняя проверка: 2026-10-13 · 📄 По официальной документации (goose v1.54.0)

Кратко¶

goose описывает себя как "your native open source AI agent — desktop app, CLI, and API". Проект входит в Agentic AI Foundation, поэтому документация переехала на goose-docs.ai (прежний адрес block.github.io/goose только переадресует), а репозиторий — aaif-goose/goose; formula в Homebrew при этом по-прежнему называется block-goose-cli. Страница сверена со стабильной версией v1.54.0, опубликованной 2026-10-08.

Какой протокол¶

Никогда не вызывайте Claude через OpenAI-совместимую сторону. QCode отдаёт claude-* только на стороне Anthropic Messages; OpenAI-сторона отклоняет такие ID (model_not_available_on_endpoint). Заведите два provider вместо одного и выбирайте нужный при запуске сессии через goose run --provider … --model …. Подробности: Эндпоинты и форматы API.

Поле называется HOST, а не base_url. goose спрашивает ANTHROPIC_HOST, OPENAI_HOST и GOOSE_PROVIDER__HOST. Указывайте только хост и префикс пути: не пишите в поле /v1/messages. Для OpenAI-стороны путь запроса описан отдельным официальным полем: в таблице документация говорит про OPENAI_BASE_PATH — "Request path appended to the host (defaults to v1/chat/completions)". Как именно ANTHROPIC_HOST соединяется с путём сообщений, в официальной документации не указано, поэтому здесь приведено только значение QCode и ничего не заявлено как измеренное.

Установка¶

CLI — через Homebrew или официальным скриптом:

brew install block-goose-cli

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

goose update
goose --version

Desktop: для macOS — Homebrew или кнопки загрузки, а для Linux официальная страница предлагает пакеты .deb / .rpm / Flatpak:

brew install --cask block-goose

Настройка Claude (provider Anthropic)¶

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

goose configure
# Configure Providers (Change provider or update credentials)  -> выберите Anthropic
# Provider Anthropic requires ANTHROPIC_API_KEY, please enter a value  -> ваш ключ QCode
# Enter your desired ANTHROPIC_HOST or press Enter to use the default.  -> https://api.qcode.cc/api

Вместо мастера можно взять переменные, которые официальная страница про переменные окружения относит к custom endpoints:

export GOOSE_PROVIDER="anthropic"
export GOOSE_MODEL="claude-sonnet-5"
export GOOSE_PROVIDER__TYPE="anthropic"
export GOOSE_PROVIDER__HOST="https://api.qcode.cc/api"
export GOOSE_PROVIDER__API_KEY="cr_your_qcode_key"

В config.yaml (macOS/Linux: ~/.config/goose/config.yaml) настройки provider'а лежат в ключах active_provider и providers:

active_provider: anthropic
providers:
  anthropic:
    enabled: true
    model: claude-sonnet-5
    configured: true

• Ключ в этот файл не пишут: официальная формулировка — "Provider API keys do not go in config.yaml". Храните его в keyring (через goose configure), в secrets.yaml или в переменной окружения provider'а.
• Региональные узлы: замените хост на https://asia.qcode.cc/api или https://us.qcode.cc/api; ключ остаётся тот же.
• Модели Claude, доступные в QCode: claude-sonnet-5, claude-sonnet-5-5, claude-opus-5, claude-opus-5-5, claude-haiku-5-5, claude-haiku-4-5-20251001, claude-sonnet-4-6, claude-fable-5, claude-fable-5-1. Оплата за токены; цены по моделям указаны на https://qcode.cc/models

Настройка GPT и китайских моделей (OpenAI-совместимость)¶

Документация говорит, что встроенный OpenAI provider "can connect to OpenAI's official API (api.openai.com) or any OpenAI-compatible endpoint", а для такого шлюза рекомендует: "set OPENAI_HOST to your proxy's root (no trailing path) and OPENAI_BASE_PATH to the path it serves (usually v1/chat/completions)".

export OPENAI_API_KEY="cr_your_qcode_key"
export OPENAI_HOST="https://api.qcode.cc"
export OPENAI_BASE_PATH="openai/v1/chat/completions"
export GOOSE_PROVIDER="openai"
export GOOSE_MODEL="gpt-6.1-sol"

Второй вариант — оставить официальный путь по умолчанию и перенести префикс в хост: export OPENAI_HOST="https://api.qcode.cc/openai", а OPENAI_BASE_PATH оставить равным v1/chat/completions. Оба варианта ведут к задокументированному эндпоинту /openai/v1/chat/completions.

Как именованный custom provider¶

Запустите goose configure, выберите Custom Providers, затем Add A Custom Provider (в меню это читается как "Add a new OpenAI/Anthropic/Ollama compatible Provider"):

Ключ читается из переменной окружения, которую вы назначили этому provider'у. Официальная формулировка — "Then use the api_key_env to set the key for your session", пример такой:

export CUSTOM_CORP_API_API_KEY="your-api-key"
goose session start --provider custom_corp_api

Замените custom_corp_api и CUSTOM_CORP_API_API_KEY на собственные имена. Если JSON пишете вручную, файл лежит в macOS/Linux: ~/.config/goose/custom_providers/. Два замечания: документация требует — "Custom providers must use OpenAI, Anthropic, or Ollama compatible API formats." — и в официальных примерах engine встречается только как "engine": "openai"; значения для стороны Anthropic в документации нет, поэтому custom provider типа Anthropic создавайте через goose configure, чтобы goose сам записал эту строку.

ID китайских моделей QCode: deepseek-v4.1-flash, deepseek-v4-flash, deepseek-v4-pro, glm-5.3, glm-5.2, qwen3.8-max, qwen3.8-flash, qwen3.7-plus, kimi-k3 — см. Китайские модели.

Проверка¶

goose info
goose run --provider anthropic --model claude-sonnet-5 -t "ping"

Про goose info документация пишет: "Shows goose information, including the version, configuration file location, session storage, and logs." Флаги goose run описаны как "Specify the provider to use for this session (overrides environment variable)" и "Specify the model to use for this session (overrides environment variable)".

Прежде чем разбираться с goose, проверьте эндпоинт:

KEY="cr_your_qcode_key"
curl -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'

Если в ответе есть JSON с полем content, значит со стороны эндпоинта всё в порядке и искать надо в настройках goose. Страница собрана только по официальной документации; тестового ключа не было, поэтому ни один запрос здесь не проверялся на QCode.

Известные ограничения¶

Один абзац про оплату: начисление за токены, цены по моделям указаны на https://qcode.cc/models

Похожие материалы¶

• Эндпоинты и форматы API — протокол × семейство моделей
• Совместимость инструментов — какой инструмент по какому протоколу работает
• Настройка OpenCode — тот же набор из двух протоколов у другого терминального агента
• Настройка Crush — те же два provider, но через JSON-файл
• Интеграция Aider — обе стороны выбираются по имени модели
• Выбор модели
• Китайские модели

Enterprise →