Установка goose и настройка пользовательского Provider

goose — универсальный AI-ассистент, работающий на вашем компьютере. Помимо программирования, он умеет искать информацию, писать тексты, автоматизировать задачи и систематизировать данные. Им можно пользоваться через настольное приложение, терминал или API, причём версии Desktop и CLI используют общую конфигурацию моделей. Он подходит как для повторяющихся задач по программированию, так и для работы с GitHub, базами данных и файлами.

Подготовка к установке

goose можно установить двумя способами: как Desktop или CLI. Desktop — настольное приложение с графическим интерфейсом, а CLI — версия, в которой команды вводятся в терминале. Они используют общую основную конфигурацию, включая Provider и модели. Provider можно понимать как параметры подключения, сообщающие goose, какой сервис моделей следует использовать.

Нужно окно

goose Desktop

Скачать zip для macOS
Или brew cask
Для Linux использовать установочный пакет

Только терминал

goose CLI

download_cli.sh
Или Homebrew CLI
Затем goose session

Windows

Сначала выбрать окружение

Git Bash или MSYS2
Также можно использовать PowerShell
Если команда не найдена, добавить PATH

В macOS можно использовать загрузку файла или Homebrew. В Linux настольная версия устанавливается из пакета для соответствующего дистрибутива. В Windows сначала проверьте требования к терминальной среде.

Перед началом подготовьте ID модели из актуального списка моделей. ID модели — это имя, по которому сервис распознаёт конкретную модель; при использовании его нужно копировать полностью.

Установка и первый запуск

Если нужен графический интерфейс

Для macOS предусмотрены два способа установки:

Загрузить приложение со страницы установки. Там доступны версии macOS Silicon и macOS Intel. После загрузки распакуйте zip-архив и запустите находящееся внутри приложение.
Или использовать Homebrew:

brew install --cask block-goose

При этом загружается то же приложение, а Homebrew также может устанавливать обновления.

Если на Apple Mac M3 после запуска окно не появляется, проверьте права на чтение и запись для ~/.config. goose использует этот каталог для записи журналов.

Настольную версию для Linux загрузите со страницы установки. Доступны пакеты DEB (Ubuntu/Debian), RPM (RHEL/Fedora) и Flatpak. Для Debian или Ubuntu выполните следующие действия: загрузите DEB, перейдите в каталог с сохранённым файлом, выполните sudo dpkg -i (filename).deb, а затем откройте goose из меню приложений. Замените (filename) фактическим именем файла.

Настольную версию для Windows загрузите со страницы установки, распакуйте zip-архив и запустите находящееся внутри приложение.

Если нужен только терминал

В macOS и Linux выполните:

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

Чтобы не выполнять интерактивную настройку во время установки, добавьте перед bash переменную CONFIGURE=false:

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

В macOS также можно выполнить:

brew install block-goose-cli

Для обновления уже установленного CLI используйте:

goose update

В Windows требуется одна из трёх сред: Git Bash, поставляемая вместе с Git for Windows и отмеченная как рекомендуемая, MSYS2 или встроенный в Windows 10/11 PowerShell. В Git Bash и MSYS2 используйте ту же команду download_cli.sh, которая приведена выше. В PowerShell сначала загрузите сценарий, а затем запустите его:

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/aaif-goose/goose/main/download_cli.ps1" -OutFile "download_cli.ps1"
.\download_cli.ps1

Если появляется сообщение, что goose отсутствует в PATH, добавьте ~/.local/bin или %USERPROFILE%\.local\bin в конфигурацию текущей оболочки, как указано на странице установки, а затем перезапустите терминал. PATH — это набор каталогов, в которых терминал ищет программы. Если нужный каталог не добавлен, установленную программу может быть невозможно запустить простым вводом её имени.

По состоянию на 2026-10-09 версия CLI — 1.54.0. По умолчанию сценарий установки помещает программу в ~/.local/bin. Изменить этот каталог можно с помощью переменной окружения GOOSE_BIN_DIR. После такого изменения сценарий не редактирует конфигурацию оболочки автоматически, поэтому терминал сообщит, что каталог отсутствует в PATH. Добавьте этот каталог в PATH или запускайте программу по полному пути.

При первом запуске goose предложит настроить Provider. Встроенных поставщиков пока можно пропустить и добавить пользовательский Provider по инструкции из следующего раздела. В терминале перейдите в каталог, в котором собираетесь работать, и выполните:

goose session

Получение параметров подключения из OmniProxy

Подготовьте адрес, ключ и имя модели из собственной конфигурации OmniProxy. В примере пользовательского Provider параметр base_url заканчивается на /v1/chat/completions, поэтому здесь используется такой же формат:

API URL:  https://your-omniproxy-origin.example/v1/chat/completions
API Key:  <YOUR_OMNIPROXY_API_KEY>
Models:   скопируйте из актуального списка моделей OmniProxy; несколько значений разделите запятыми

Полностью скопируйте имя модели из актуального списка OmniProxy, сохранив также все косые черты. По состоянию на 2026-10-09 в документации поставщиков для сверки приведены два ID: grok-4.7 для Grok и gpt-6-luna в документации OpenAI. gpt-6-luna поддерживает Chat Completions; вызов функций через Chat Completions поддерживается только при значении none параметра reasoning_effort. Не копируйте имена, которых нет в списке.

Ввод конфигурации инструмента

Пользовательский Provider использует формат, совместимый с OpenAI, Anthropic или Ollama. Совместимый формат означает, что инструмент отправляет запросы по правилам соответствующего общего интерфейса. Для подключения к OmniProxy выберите OpenAI Compatible.

Настольная версия

Нажмите кнопку в левом верхнем углу, чтобы открыть боковую панель.
Нажмите Settings.
Нажмите Models.
Нажмите Configure providers.
Нажмите Add Custom Provider в нижней части окна.
В поле Provider Type выберите OpenAI Compatible. В поле Display Name можно указать OmniProxy. В API URL введите адрес из предыдущего раздела. Если требуется ключ, включите требование API Key и введите ключ OmniProxy. В Available Models укажите имена моделей, разделяя несколько значений запятыми.
Нажмите Create Provider.

В настоящее время в этом окне настольной версии нельзя задать пользовательские заголовки запросов. Если они необходимы, после создания Provider отредактируйте файл конфигурации.

Терминал

Выполните:

goose configure

Выберите Custom Providers, а затем Add A Custom Provider. В качестве API Type выберите OpenAI Compatible, после чего по подсказкам укажите имя, API URL, необходимость ключа, имена моделей и поддержку потоковых ответов.

При ручной настройке в Windows, если возникает ошибка хранилища ключей, при запросе о сохранении в keyring выберите отказ от сохранения и используйте переменную окружения. Затем снова выполните goose configure. Хранилище ключей — это небольшое защищённое системное хранилище для секретных ключей.

Файл конфигурации

Используются следующие каталоги:

macOS и Linux: ~/.config/goose/custom_providers/
Windows: %APPDATA%\Block\goose\config\custom_providers\

Файл можно составить по следующему примеру. Замените имя, адрес и модели своими значениями. Храните ключ в переменной окружения, указанной в api_key_env, и не записывайте реальный ключ непосредственно в файл:

{
  "name": "omniproxy",
  "engine": "openai",
  "display_name": "OmniProxy",
  "api_key_env": "OMNIPROXY_API_KEY",
  "base_url": "https://your-omniproxy-origin.example/v1/chat/completions",
  "models": [
    { "name": "grok-4.7", "context_limit": 128000 },
    { "name": "gpt-6-luna", "context_limit": 128000 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}

Для context_limit оставьте числовое значение, как в примере. Фактический размер контекста зависит от модели и OmniProxy; не считайте число из примера официальным ограничением соответствующей модели. Перед использованием выполните:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

После перехода в рабочий каталог выполните:

goose session --provider omniproxy --model grok-4.7

Замените значение --model полным ID из списка. У goose session нет подкоманды start. Параметры --provider и --model также можно задать через переменные окружения GOOSE_PROVIDER и GOOSE_MODEL. Даже если шлюз не проверяет ключ, переменная OMNIPROXY_API_KEY должна содержать значение. Это может быть строка-заполнитель, используемая только на локальном компьютере. По состоянию на 2026-10-09 такая конфигурация позволила прочитать файл.

Окно

Settings

Settings на боковой панели
Страница Models
Add Custom Provider

Терминал

goose configure

Выбрать Custom Providers
Затем выбрать добавление
В типе выбрать OpenAI Compatible

Файл

custom_providers

В macOS и Linux находится в ~/.config
В Windows находится в APPDATA
base_url — по официальному примеру

Все три способа создают конфигурацию одного типа. В качестве типа Provider выберите OpenAI Compatible.

Проверка на реальной задаче

Перейдите в каталог с обычным файлом и запустите goose session, как указано в предыдущем разделе. Попросите ассистента прочитать первую строку выбранного файла. В ответе должно быть содержимое файла, а не только сообщение о сохранении конфигурации.

Для чтения файлов или выполнения команд в сеансе требуется расширение Developer. Его можно понимать как модуль инструментов, позволяющий goose работать с локальными файлами и командами. Обычно оно включено в стандартную конфигурацию. Если ассистент отвечает, что у него нет инструментов для работы с файлами, добавьте к команде:

--with-builtin developer

Не добавляйте одновременно --no-profile, поскольку этот параметр отключает стандартные расширения.

По состоянию на 2026-10-09 goose 1.54.0 успешно прочитал первую строку указанного файла. Первый ответ может занять около минуты.

Затем проверьте источник и имя модели в журнале вызовов OmniProxy.

Запуск

Можно войти в сеанс

goose session
Provider — только что добавленный
Имя модели есть в списке

Задача

Он действительно выполнил задачу

Например, вывести содержимое текущего каталога
Посмотреть его ответ
Не ограничиваться проверкой успешного сохранения

Запись

Шлюз видит запрос

Ориентироваться на пример адреса в документации
Не записывать ключ в репозиторий
ID модели совпадает со списком

После сохранения Provider необходимо проверить его в реальном сеансе.

Распространённые ошибки

Команда goose не найдена: добавьте каталог установки в PATH в соответствии со страницей установки, а затем перезапустите терминал.
На M3 не появляется окно настольной версии: проверьте права на чтение и запись для ~/.config.
Ошибка хранилища ключей: не сохраняйте ключ в keyring, а используйте переменную окружения.
Модели нет в списке: в настольной версии можно выбрать Use custom model и вручную ввести имя модели. В goose configure нельзя ввести пользовательское имя модели; для работы через терминал используйте настольную версию или измените GOOSE_MODEL непосредственно в конфигурации.
Не удаётся подключиться по адресу: убедитесь, что API URL, как и в примере, заканчивается на /v1/chat/completions, а OmniProxy запущен.
Ассистент сообщает, что не может прочитать файл: добавьте расширение Developer и не используйте --no-profile.
Возвращается ошибка unsupported Responses role: system: адрес, как правило, указан правильно. Выберите другой полный ID из списка моделей.

Официальные материалы

Инструкции по установке приведены на странице Install goose. Настройка пользовательского Provider описана на странице goose providers. Использованные в примерах ID моделей приведены на страницах моделей xAI и GPT-6 Luna.

Замените все заполнители значениями из вашей собственной конфигурации OmniProxy. Никогда не публикуйте реальный ключ.

Сохранённый результат или HTTP 200 сами по себе не доказывают полную совместимость Агента. Проверьте источник и модель в журнале вызовов OmniProxy.

Официальные источники · goose ↗