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

URL: https://agentvera.dev/ru/blog/how-to-use-goose/ · Опубликовано: 2026-11-10

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

**Коротко:**

- Установите Goose CLI одной командой curl (или brew install block-goose-cli), выберите провайдера и модель в goose configure, затем запустите goose session в проекте и опишите задачу.
- Goose стартует в режиме auto и запускает инструменты без вопросов. Переключитесь на approve или smart_approve через /mode или задайте GOOSE_MODE, прежде чем пускать его в настоящий репозиторий.
- Правила проекта кладут в AGENTS.md или .goosehints, MCP-серверы — это расширения в ~/.config/goose/config.yaml, а goose run --recipe повторяет задачу из YAML-файла.

Чтобы начать пользоваться 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](https://www.linuxfoundation.org/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foundation "Agentic AI Foundation") под эгидой Linux Foundation вместе с MCP и AGENTS.md. В апреле 2026 года репозиторий переехал в [aaif-goose/goose](https://github.com/aaif-goose/goose "Goose на GitHub"), а документация — на [goose-docs.ai](https://goose-docs.ai "Документация Goose"). Старые ссылки на `block/goose` и `block.github.io/goose` по-прежнему перенаправляют. Goose выходит под лицензией Apache-2.0, новые версии появляются примерно раз в неделю.

## Шаг 1: установите CLI

На macOS, Linux или в Git Bash на Windows:

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

На macOS можно вместо этого использовать Homebrew. В названиях пакетов всё ещё есть «block»:

```bash
brew install block-goose-cli        # CLI
brew install --cask block-goose     # desktop app
```

В Windows PowerShell:

```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` в открытом виде. Ключи можно и экспортировать:

```bash
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-провайдеры](https://goose-docs.ai/docs/guides/acp-providers "ACP-провайдеры Goose"): с ними Goose использует этот вход вместо API-ключа.

## Шаг 3: начните сессию

```bash
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). Для одной сессии:

```bash
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`, копировать его не нужно:

```bash
export CONTEXT_FILE_NAMES='["AGENTS.md", ".goosehints", "CLAUDE.md"]'
```

Держите файл коротким: стек, как запускать тесты, что не трогать и что значит «готово». Что в него писать, рассказывает наше руководство по [CLAUDE.md и AGENTS.md](/ru/blog/claude-md-agents-md/ "CLAUDE.md и AGENTS.md").

## Шаг 7: goose run и recipes

Для разовых задач без чата используйте `goose run`:

```bash
goose run -t "add a unit test for the price formatter"
goose run -i task.md --output-format json
```

Recipe — это YAML-файл, в котором сохранена задача с инструкциями, расширениями и параметрами, чтобы коллега или задание по расписанию могли её повторить:

```bash
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](/ru/ "AgentVera") — десктопное приложение, которое запускает эти CLI бок о бок в настоящих терминалах, с вашими собственными установками и ключами. [Поддержка Goose](/ru/agents/goose/ "Goose в AgentVera") устроена так:

- **Одна именованная сессия на агента.** Каждый агент Goose получает собственное имя сессии, и при следующих запусках AgentVera открывает её через `goose session --resume --name`, так что разговор переживает перезапуск приложения.
- **Ваш провайдер и ваши ключи.** Goose продолжает использовать провайдера из `goose configure`. В Settings → Accounts можно добавить аккаунты с API-ключами (Anthropic, OpenAI, OpenRouter, Google) для агентов Goose.
- **Модель, уровень усилий и роль.** Выбранная модель передаётся через `--model`, уровень усилий — через `GOOSE_THINKING_EFFORT`, а роль агента — через `--system`.
- **MCP и браузер.** Серверы из [менеджера MCP](/ru/features/mcp-manager/ "Менеджер MCP") AgentVera передаются как `--with-extension` или `--with-streamable-http-extension`, так что вы настраиваете их один раз для всех CLI.
- **Панели, worktrees и ревью.** Запускайте Goose в сетке [workspace](/ru/features/workspace/ "Workspace") рядом с другими агентами, каждого в своём git worktree, и проверяйте их изменения код-ревью.

Бесплатный тариф включает до 18 агентов, MCP, Git, Docker, SSH, код-ревью и экономию токенов. Pro стоит $9,99 в месяц; если у вас ещё не было пробного периода, первый вход в приложение включает Pro на 7 дней без карты. Чтобы попробовать, [скачайте AgentVera](/ru/download/ "Скачать AgentVera").

## Итоги

Чтобы начать работу с Goose, нужно три команды: установка, `goose configure`, `goose session`. Самые важные настройки идут сразу после них: переключиться с auto на approve, добавить нужные расширения и дать проекту `AGENTS.md`. Как только задача начнёт повторяться, сохраните её как recipe.

Источники: [установка Goose](https://goose-docs.ai/docs/getting-started/installation "Установка Goose"), [команды CLI](https://goose-docs.ai/docs/guides/goose-cli-commands "Команды Goose CLI"), [разрешения](https://goose-docs.ai/docs/guides/managing-tools/goose-permissions "Режимы разрешений Goose"), [расширения](https://goose-docs.ai/docs/getting-started/using-extensions "Использование расширений"), [файлы подсказок](https://goose-docs.ai/docs/guides/context-engineering/using-goosehints "Использование .goosehints"), [релизы](https://github.com/aaif-goose/goose/releases "Релизы Goose").

## Частые вопросы

**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.** AgentVera — настольное приложение для macOS, Windows и Linux от Solviera Teknoloji. Оно запускает 18 ИИ-агентов для программирования (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) рядом, по проектам, в настоящих терминалах с собственными установками CLI и входами пользователя. В бесплатном тарифе количество агентов не ограничено. Скачать: https://agentvera.dev/ru/download/ · Цены: https://agentvera.dev/ru/pricing/