Пригласите друга и получите 1 месяц Pro бесплатноКак это работает

Как пользоваться Goose: пошаговое руководство по Goose CLI

Как пользоваться Goose, open-source ИИ-агентом: установка CLI, goose configure, выбор режима, MCP-расширения, файл AGENTS.md и запуск recipes.

Solviera Teknoloji 6 мин чтения

Чтобы начать пользоваться 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, разрешения, расширения, файлы подсказок, релизы.

Вопросы

Goose бесплатный?

Да. Goose распространяется с открытым исходным кодом по лицензии Apache-2.0 и ничего не стоит. Вы платите провайдеру модели за потраченные токены или запускаете локальную модель через Ollama, LM Studio или Docker Model Runner без затрат на токены.

Кто сейчас развивает Goose?

Goose создала компания Block и в декабре 2025 года передала его Agentic AI Foundation (AAIF) под эгидой Linux Foundation. С апреля 2026 года код лежит на github.com/aaif-goose/goose, а документация — на goose-docs.ai.

Может ли Goose использовать мою подписку Claude Code или ChatGPT?

Да, через ACP-провайдеры: с ними Goose работает через уже существующий вход в Claude Code или ChatGPT Plus/Pro. Старые CLI-провайдеры, которые делали то же самое, объявлены устаревшими в пользу ACP-провайдеров.

Читает ли Goose AGENTS.md или CLAUDE.md?

Goose читает AGENTS.md, а затем .goosehints на каждом уровне от рабочей папки до корня git. Чтобы он загружал ещё и CLAUDE.md или .cursorrules, добавьте их в переменную окружения CONTEXT_FILE_NAMES.

Спрашивает ли Goose разрешения перед запуском команд?

По умолчанию нет. Режим по умолчанию — auto, он запускает инструменты без вопросов. Режим approve спрашивает перед каждым вызовом инструмента, smart_approve — только перед рискованными, а режим chat отключает инструменты.

Соберите своих агентов за одним столом.

Скачайте AgentVera бесплатно; ваши установленные CLI уже готовы к работе.

Другие статьи