Чтобы начать пользоваться Goose, установите CLI командой curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash, ответьте на вопросы goose configure, выбрав провайдера и модель, затем запустите goose session в проекте и опишите, что нужно сделать. Goose стартует в режиме auto, поэтому запускает команды без вопросов, пока вы не переключитесь в режим approve.
Это руководство разбирает каждый шаг для Goose CLI по состоянию на ноябрь 2026 года (версия 1.58): установку, настройку, режимы, сессии, расширения, файлы инструкций и recipes, а также ошибки, на которые уходит больше всего времени.
Что такое Goose
Goose — универсальный ИИ-агент, который работает на вашем компьютере. Он есть в виде CLI, десктопного приложения для macOS, Linux и Windows и API, и всё это написано на Rust. Goose не привязан к конкретной модели: вы подключаете провайдера — Anthropic, OpenAI, Gemini, OpenRouter или локальную модель, — а Goose берёт на себя вызовы инструментов, правки и работу в shell.
Goose создала компания Block и в декабре 2025 года передала его Agentic AI Foundation под эгидой Linux Foundation вместе с MCP и AGENTS.md. В апреле 2026 года репозиторий переехал в aaif-goose/goose, а документация — на goose-docs.ai. Старые ссылки на block/goose и block.github.io/goose по-прежнему перенаправляют. Goose выходит под лицензией Apache-2.0, новые версии появляются примерно раз в неделю.
Шаг 1: установите CLI
На macOS, Linux или в Git Bash на Windows:
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash
На macOS можно вместо этого использовать Homebrew. В названиях пакетов всё ещё есть «block»:
brew install block-goose-cli # CLI
brew install --cask block-goose # desktop app
В Windows PowerShell:
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/aaif-goose/goose/main/download_cli.ps1" -OutFile "download_cli.ps1"; .\download_cli.ps1
Бинарник для Windows попадает в %USERPROFILE%\.local\bin; возможно, эту папку придётся добавить в PATH. Обновляться потом можно командой goose update. CLI и десктопное приложение используют одну конфигурацию, так что провайдеры и расширения, настроенные в одном, появляются и в другом.
Шаг 2: запустите goose configure
При первом запуске goose configure стартует сам. Есть три пути: войти в OpenRouter, войти в Tetrate Agent Router Service или настроить всё вручную — выбрать провайдера, вставить его ключ и указать модель. Начиная с версии 1.54 он также спрашивает, в каком режиме стартовать.
Ключи сохраняются в системное хранилище ключей (на macOS — в Связку ключей). Если хранилища нет или вы задали GOOSE_DISABLE_KEYRING, они попадают в текстовый файл secrets.yaml в открытом виде. Ключи можно и экспортировать:
export ANTHROPIC_API_KEY=...
export GOOSE_PROVIDER=anthropic
export GOOSE_MODEL=claude-sonnet-5-5
Ключ, записанный в config.yaml, игнорируется. Запускайте goose configure повторно в любой момент, чтобы сменить провайдера, добавить или включить и выключить расширения или открыть настройки режима и разрешений инструментов.
Если вы уже платите за Claude Code или ChatGPT Plus/Pro, посмотрите на ACP-провайдеры: с ними Goose использует этот вход вместо API-ключа.
Шаг 3: начните сессию
cd my-project
goose session -n checkout-fix
Опишите задачу простыми словами. Полезные клавиши и команды внутри сессии:
Ctrl+Jдобавляет новую строку;Ctrl+Cостанавливает текущий запрос, а на пустой строке завершает работу./mode,/model,/extensionи/builtinменяют настройки, не выходя из сессии./compactсокращает разговор, когда он становится длинным;/clearначинает заново./statusпоказывает сессию вместе с её ID.
Чтобы вернуться позже, выполните goose session -r -n checkout-fix. goose session list показывает все сессии, а --fork копирует сессию, чтобы попробовать другое направление, не теряя оригинал.
Шаг 4: выберите режим до настоящей работы
У Goose четыре режима:
| Режим | Что делает |
|---|---|
auto (по умолчанию) | Запускает все инструменты без вопросов |
approve | Спрашивает перед каждым вызовом инструмента |
smart_approve | Спрашивает только перед вызовами, которые считает рискованными |
chat | Без инструментов; только разговор |
Переключайтесь командой /mode approve в сессии, через GOOSE_MODE или выберите режим по умолчанию в goose configure. Для более тонкого контроля задайте разрешения для каждого инструмента в goose configure; они сохраняются в permission.yaml. В репозитории, который вам дорог, начинайте с approve или smart_approve и ослабляйте контроль, когда начнёте доверять настройке.
Шаг 5: расширения и MCP-серверы
Через расширения Goose получает инструменты, и каждый MCP-сервер — это расширение. Расширение Developer (shell и редактирование файлов) включено по умолчанию. Среди других встроенных — Computer Controller, Memory и Auto Visualiser.
Чтобы добавить расширение насовсем, выполните goose configure → Add Extension и выберите сервер командной строки (stdio) или удалённый сервер (Streamable HTTP). Для одной сессии:
goose session --with-extension "memory:npx -y @modelcontextprotocol/server-memory"
goose session --with-streamable-http-extension https://example.com/mcp
Сохранённые расширения хранятся в разделе extensions: файла ~/.config/goose/config.yaml (Windows: %APPDATA%\Block\goose\config\config.yaml). SSE-серверы больше не поддерживаются; используйте Streamable HTTP.
Шаг 6: AGENTS.md и .goosehints
Goose читает AGENTS.md, а затем .goosehints на каждом уровне от рабочей папки до корня git и подхватывает вложенные файлы, когда работает в подпапках. Глобальный файл ~/.config/goose/.goosehints действует для всех проектов.
Если в проекте уже есть CLAUDE.md, копировать его не нужно:
export CONTEXT_FILE_NAMES='["AGENTS.md", ".goosehints", "CLAUDE.md"]'
Держите файл коротким: стек, как запускать тесты, что не трогать и что значит «готово». Что в него писать, рассказывает наше руководство по CLAUDE.md и AGENTS.md.
Шаг 7: goose run и recipes
Для разовых задач без чата используйте goose run:
goose run -t "add a unit test for the price formatter"
goose run -i task.md --output-format json
Recipe — это YAML-файл, в котором сохранена задача с инструкциями, расширениями и параметрами, чтобы коллега или задание по расписанию могли её повторить:
goose run --recipe release-notes.yaml --params version=2.4.0
goose schedule add --schedule-id weekly-notes --cron "0 0 9 * * 1" --recipe-source release-notes.yaml
goose recipe validate проверяет файл, прежде чем вы им поделитесь. Ещё две полезные команды: goose review запрашивает ИИ-ревью вашего git diff, а goose info -v показывает версию и где лежат конфигурация, сессии и логи.
Типичные ошибки
- Оставить режим auto. Режим по умолчанию запускает shell-команды без вопросов. Смените режим до первой задачи в настоящем репозитории.
- Следовать старой документации. Туториалы 2025 года ссылаются на
block/gooseиblock.github.io. Команды в основном работают, но актуальная документация — на goose-docs.ai. - Писать ключи в config.yaml. Там Goose их игнорирует. Используйте хранилище ключей,
goose configureили переменные окружения. - Использовать устаревшие CLI-провайдеры. Чтобы работать через вход в Claude Code или ChatGPT, настройте ACP-провайдер.
- Длинные сессии. Автоматическое сжатие держит контекст под контролем, но новая именованная сессия на каждую задачу даёт более точные ответы.
Goose рядом с другими CLI в AgentVera
У Goose есть своё десктопное приложение, и если Goose — ваш единственный агент, его может хватить. Сложнее становится, когда Goose работает рядом с Claude Code, Codex или Gemini CLI в одном проекте. AgentVera — десктопное приложение, которое запускает эти CLI бок о бок в настоящих терминалах, с вашими собственными установками и ключами. Поддержка Goose устроена так:
- Одна именованная сессия на агента. Каждый агент Goose получает собственное имя сессии, и при следующих запусках AgentVera открывает её через
goose session --resume --name, так что разговор переживает перезапуск приложения. - Ваш провайдер и ваши ключи. Goose продолжает использовать провайдера из
goose configure. В Settings → Accounts можно добавить аккаунты с API-ключами (Anthropic, OpenAI, OpenRouter, Google) для агентов Goose. - Модель, уровень усилий и роль. Выбранная модель передаётся через
--model, уровень усилий — черезGOOSE_THINKING_EFFORT, а роль агента — через--system. - MCP и браузер. Серверы из менеджера MCP AgentVera передаются как
--with-extensionили--with-streamable-http-extension, так что вы настраиваете их один раз для всех CLI. - Панели, worktrees и ревью. Запускайте Goose в сетке workspace рядом с другими агентами, каждого в своём git worktree, и проверяйте их изменения код-ревью.
Бесплатный тариф включает до 18 агентов, MCP, Git, Docker, SSH, код-ревью и экономию токенов. Pro стоит $9,99 в месяц; если у вас ещё не было пробного периода, первый вход в приложение включает Pro на 7 дней без карты. Чтобы попробовать, скачайте AgentVera.
Итоги
Чтобы начать работу с Goose, нужно три команды: установка, goose configure, goose session. Самые важные настройки идут сразу после них: переключиться с auto на approve, добавить нужные расширения и дать проекту AGENTS.md. Как только задача начнёт повторяться, сохраните её как recipe.
Источники: установка Goose, команды CLI, разрешения, расширения, файлы подсказок, релизы.