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

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

Как пользоваться Crush, терминальным агентом от Charm: установка, выбор провайдера или локальной модели, подтверждения, crush run, возврат к сессиям и crushrc.

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

- Установите через brew install charmbracelet/tap/crush, npm install -g @charmland/crush или winget install charmbracelet.crush, запустите crush в проекте, нажмите Ctrl+L, выберите модель и вставьте ключ или войдите.
- Crush спрашивает перед вызовом инструментов и позволяет разрешить инструмент на всю сессию. crush run выполняет разовые задачи и ввод через pipe; crush -C или crush -s <id> возвращает к сессии.
- С v0.88 настройки хранятся в файле crushrc (Bash с командами Crush); crush.json пока работает, но устарел. AGENTS.md, CRUSH.md и CLAUDE.md Crush читает сам.

Чтобы начать работать с Crush, агентом для программирования от Charm, установите его командой `brew install charmbracelet/tap/crush` (или через npm, winget и другие способы), запустите `crush` в проекте, нажмите `Ctrl+L`, выберите модель, вставьте API-ключ или войдите в аккаунт, а затем опишите задачу. **Crush спрашивает разрешения перед запуском инструментов, а с версии 0.88 его настройки хранятся в файле `crushrc`, а не в `crush.json`.**

Это руководство описывает Crush по состоянию на ноябрь 2026 года (версия 0.101): установка, провайдеры и локальные модели, интерфейс, подтверждения, `crush run`, сессии, конфигурация, файлы контекста, MCP и стоимость.

## Что такое Crush

Crush — терминальный агент для программирования от [Charm](https://github.com/charmbracelet "Charm на GitHub"), команды, которая сделала Bubble Tea и другие инструменты для терминала, и это заметно: у него один из самых проработанных интерфейсов в своей категории. Он работает почти с любой моделью: Anthropic, OpenAI, Gemini, OpenRouter, Groq, xAI, Bedrock, Vertex, Azure, локальные модели и собственный сервис Charm под названием Hyper. Модель можно сменить посреди сессии, не теряя контекст.

Crush ещё не дошёл до версии 1.0 и выпускает минорную версию примерно раз в неделю, а между ними выходят nightly-сборки. Лицензия — FSL-1.1-MIT: исходный код открыт для просмотра, и каждая версия позже переходит под MIT, но сегодня это не open source лицензия в понимании OSI.

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

```bash
brew install charmbracelet/tap/crush      # macOS and Linux
npm install -g @charmland/crush           # any platform with Node
winget install charmbracelet.crush        # Windows
go install github.com/charmbracelet/crush@latest
```

Есть также пакеты для Arch (`yay -S crush`), Nix, FreeBSD и Scoop, а ещё репозитории apt и yum на repo.charm.sh. Crush работает на macOS, Linux, Windows (PowerShell и WSL) и BSD-системах.

## Шаг 2: выберите модель

```bash
cd my-project
crush
```

Нажмите `Ctrl+L`, чтобы открыть выбор модели, выберите провайдера и вставьте его ключ. Crush также берёт ключи из переменных окружения, например `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `GEMINI_API_KEY` или `OPENROUTER_API_KEY`. Чтобы пользоваться подпиской вместо ключа, выполните `crush login` с `copilot`, `openai` (тариф ChatGPT), `grok` или `hyper`.

Для локальной модели добавьте провайдера в конфигурацию (шаг 6):

```bash
provider add ollama --type ollama --base-url "http://localhost:11434/v1/"
```

Список моделей Crush берёт из Catwalk — каталога, который ведёт сообщество и который обновляется сам; `crush models` показывает, что доступно, а `crush update-providers` обновляет список.

## Шаг 3: работайте в сессии

Опишите задачу обычными словами. Клавиши, которые стоит выучить первыми:

- `Ctrl+P` (или `/`) открывает палитру команд: сделать сводку сессии, инициализировать проект, включить или выключить MCP-серверы и skills, сменить тему.
- `Ctrl+L` меняет модель; `Ctrl+N` начинает новую сессию, а `Ctrl+S` показывает список сессий.
- `@` упоминает файл; `Ctrl+F` добавляет файл или изображение; `Ctrl+V` вставляет изображение.
- `Shift+Tab` переключает режимы, включая режим Plan, в котором Crush сначала продумывает шаги, а потом редактирует.
- `Ctrl+O` открывает ваш редактор для длинного сообщения; `Ctrl+G` показывает справку; `Ctrl+C` закрывает Crush.

## Шаг 4: подтверждения и режим yolo

Crush спрашивает перед каждым вызовом инструмента. В диалоге `a` разрешает вызов один раз, `s` разрешает этот инструмент до конца сессии, `d` отклоняет, а `t` показывает diff. Команды только для чтения, такие как `ls` или `git status`, выполняются без вопросов.

Чтобы Crush перестал спрашивать про инструменты, которым вы доверяете, разрешите их в конфигурации; чтобы полностью скрыть инструмент, запретите его:

```bash
permissions allow view ls grep edit
permissions deny bash
```

`crush --yolo` (или `-y`, или `Ctrl+Y` в сессии) отключает вопросы, но по-прежнему блокирует команды, которые Crush считает опасными. `-yy` включает режим sysadmin, который разрешает и их. Используйте оба режима только в контейнерах и на одноразовых машинах.

## Шаг 5: crush run для разовых задач

```bash
crush run "add a unit test for the price formatter"
git diff | crush run "review this diff for bugs"
cat README.md | crush run "tighten the wording" > README.new.md
```

`-m` выбирает модель (`provider/model`), `-q` скрывает индикатор загрузки, а `-s <id>` или `-C` продолжает сессию. Вывода в JSON у `crush run` нет, поэтому, если нужен структурированный результат, попросите нужный формат в промпте и проверьте его.

## Шаг 6: crushrc и конфигурация

С версии 0.88 Crush читает настройки из файла `crushrc` — Bash-скрипта с командами Crush, который выполняет собственный интерпретатор Crush, чтобы на Windows всё работало так же. Crush ищет `.crushrc` или `crushrc` в проекте и `~/.config/crush/crushrc` глобально и объединяет найденное, причём настройки проекта важнее. Небольшой пример:

```bash
model large anthropic/claude-sonnet-5-5
model small anthropic/claude-haiku-5-5
permissions allow view ls grep
mcp add docs --type http --url https://example.com/mcp
lsp add go --command gopls
```

`crush.json` и `.crush.json` по-прежнему работают, но считаются устаревшими и новых возможностей не получают. `crush dirs` показывает, где Crush хранит конфигурацию и данные.

Одно предупреждение: `crushrc` — это код. Всё, что внутри `$(...)`, выполняется при запуске Crush, поэтому прочитайте файл, прежде чем запускать Crush в незнакомом репозитории.

## Шаг 7: AGENTS.md, MCP и LSP

**Файлы контекста.** Crush без всякой настройки читает `AGENTS.md`, `CRUSH.md`, `CLAUDE.md`, `GEMINI.md`, `.cursorrules` и `.github/copilot-instructions.md`, а также `~/.config/crush/CRUSH.md` для всех проектов. **Initialize Project** в палитре команд изучает репозиторий и пишет `AGENTS.md`. Что в него включить, рассказывает наше руководство по [CLAUDE.md и AGENTS.md](/ru/blog/claude-md-agents-md/ "CLAUDE.md и AGENTS.md").

**MCP.** Crush поддерживает серверы stdio, HTTP и SSE, включая вход через OAuth. Добавляйте их через `mcp add` в `crushrc` и включайте или выключайте из палитры.

**LSP.** Языковые серверы дают Crush ту же диагностику, что видит ваш редактор. Добавьте сервер через `lsp add` или позвольте `option auto-lsp` настроить их.

## Сколько стоит Crush (на ноябрь 2026 года)

| Вариант | Цена | Примечания |
|---|---|---|
| Crush | Бесплатно | Свои ключи или локальные модели |
| Hyper с оплатой по факту | От $5 предоплаты | Модели с открытыми весами на хостинге Charm |
| Месячные тарифы Hyper | От $10 до $200 в месяц | Еженедельные кредиты со скользящим 5-часовым окном |
| Свой ключ | Цена вашего провайдера | Anthropic, OpenAI, Gemini, OpenRouter и другие |

По умолчанию Crush отправляет псевдонимизированные метрики использования; чтобы их отключить, задайте `CRUSH_DISABLE_METRICS=1` или `DO_NOT_TRACK=1`.

## Частые ошибки

- **Инструкции для crush.json.** Большинство руководств до августа 2026 года показывают только JSON. Это по-прежнему работает, но новые параметры появляются в `crushrc`.
- **Yolo изменился в v0.100.** `--yolo` теперь блокирует опасные команды, а не спрашивает о них; скриптам, которые полагались на старое поведение, может понадобиться `-yy`.
- **Трейлеры в коммитах.** По умолчанию Crush добавляет в коммиты трейлер `Assisted-by`. Изменить это можно через `option attribution-trailer-style`.
- **Буфер обмена в Linux.** Для копирования и вставки нужен `wl-copy` или `xclip`/`xsel`.
- **Где искать логи.** `crush logs --tail 50` покажет, что пошло не так; логи лежат в папке `.crush` проекта.

## Crush рядом с другими CLI в AgentVera

Если Crush — ваш единственный агент, его собственного интерфейса может вполне хватить. Сложнее становится, когда Crush работает рядом с Claude Code, Codex или Gemini CLI в одном проекте. [AgentVera](/ru/ "AgentVera") — десктопное приложение, которое запускает эти CLI бок о бок в настоящих терминалах, с вашими собственными установками и ключами. [Поддержка Crush](/ru/agents/crush/ "Crush в AgentVera") устроена так:

- **Своя сессия для каждого агента.** AgentVera находит сессию, которую создаёт Crush, через `crush session list --json` и при следующих запусках открывает её с `--session <id>`, так что разговор переживает перезапуск приложения.
- **Свой аккаунт для каждого агента.** Каждый аккаунт Crush в Settings → Accounts получает собственную папку данных и свой `crush login`, а ещё можно добавить ключи Anthropic, OpenAI, OpenRouter или Gemini.
- **MCP и конфликты.** Серверы из [менеджера MCP](/ru/features/mcp-manager/ "Менеджер MCP") AgentVera попадают в Crush через его конфигурацию, а AgentVera добавляет собственный хук, чтобы видеть, какие файлы трогает каждый агент.
- **Панели и ревью.** Запускайте Crush в сетке [workspace](/ru/features/workspace/ "Workspace") рядом с другими агентами и проверяйте их изменения через [код-ревью](/ru/features/code-review/ "Код-ревью").

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

## Итоги

Чтобы начать работать с Crush, нужно два шага: установить его и запустить `crush`, а затем выбрать модель через `Ctrl+L`. Дальше всё важное находится в `crushrc`: какие инструменты могут запускаться без вопросов, какие модели использовать для больших и маленьких задач и какие MCP- и языковые серверы загружать. Держите в проекте `AGENTS.md`, и Crush, как и большинство других агентов, будет ему следовать.

Источники: [Crush на GitHub](https://github.com/charmbracelet/crush "README Crush"), [документация по настройке](https://github.com/charmbracelet/crush/tree/main/docs/config "Настройка Crush"), [релизы](https://github.com/charmbracelet/crush/releases "Релизы Crush"), [лицензия](https://github.com/charmbracelet/crush/blob/main/LICENSE.md "Лицензия Crush"), [Hyper](https://hyper.charm.land "Hyper от Charm").

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

**Crush бесплатный?** Пользоваться Crush можно бесплатно: вы подключаете свои API-ключи или локальную модель. Charm также продаёт Hyper — хостинг моделей с открытыми весами — с месячными тарифами от $10 до $200 или предоплаченным балансом от $5 на ноябрь 2026 года. Crush распространяется по FSL-1.1-MIT — это source-available лицензия, версии под которой позже переходят на MIT.

**Работает ли Crush с локальными моделями?** Да. Добавьте в crushrc провайдер Ollama, LM Studio, llama.cpp или LiteLLM, например provider add ollama --type ollama --base-url "http://localhost:11434/v1/", и Crush сам найдёт его модели.

**Как вернуться к сессии Crush?** crush -C (или --continue) открывает последнюю сессию в проекте, а crush -s <id> — конкретную. crush session list показывает все сессии, а при выходе Crush печатает команду для возврата.

**Читает ли Crush CLAUDE.md или AGENTS.md?** Оба. Crush читает AGENTS.md, CRUSH.md, CLAUDE.md, GEMINI.md, .cursorrules и .github/copilot-instructions.md, если они есть. Команда Initialize Project в палитре команд сама напишет AGENTS.md.

**Что делает crush --yolo?** Отключает запросы на подтверждение, но по-прежнему блокирует команды, которые Crush считает опасными. -yy (режим sysadmin) разрешает и их. Оставьте оба режима для одноразовых окружений.

---

**Об 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 и входами пользователя. В бесплатном тарифе одновременно работают 2 агента. Скачать: https://agentvera.dev/ru/download/ · Цены: https://agentvera.dev/ru/pricing/
