Чтобы начать работать с 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, команды, которая сделала 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
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: выберите модель
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):
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 перестал спрашивать про инструменты, которым вы доверяете, разрешите их в конфигурации; чтобы полностью скрыть инструмент, запретите его:
permissions allow view ls grep edit
permissions deny bash
crush --yolo (или -y, или Ctrl+Y в сессии) отключает вопросы, но по-прежнему блокирует команды, которые Crush считает опасными. -yy включает режим sysadmin, который разрешает и их. Используйте оба режима только в контейнерах и на одноразовых машинах.
Шаг 5: crush run для разовых задач
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 глобально и объединяет найденное, причём настройки проекта важнее. Небольшой пример:
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.
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 — десктопное приложение, которое запускает эти CLI бок о бок в настоящих терминалах, с вашими собственными установками и ключами. Поддержка Crush устроена так:
- Своя сессия для каждого агента. AgentVera находит сессию, которую создаёт Crush, через
crush session list --jsonи при следующих запусках открывает её с--session <id>, так что разговор переживает перезапуск приложения. - Свой аккаунт для каждого агента. Каждый аккаунт Crush в Settings → Accounts получает собственную папку данных и свой
crush login, а ещё можно добавить ключи Anthropic, OpenAI, OpenRouter или Gemini. - MCP и конфликты. Серверы из менеджера MCP AgentVera попадают в Crush через его конфигурацию, а AgentVera добавляет собственный хук, чтобы видеть, какие файлы трогает каждый агент.
- Панели и ревью. Запускайте Crush в сетке workspace рядом с другими агентами и проверяйте их изменения через код-ревью.
Бесплатный тариф запускает 2 агента одновременно и включает MCP, Git, Docker, SSH, код-ревью и экономию токенов. Pro стоит $9,99 в месяц и не ограничивает число агентов; если у вас ещё не было пробного периода, первый вход в приложение включает Pro на 7 дней без карты. Чтобы попробовать, скачайте AgentVera.
Итоги
Чтобы начать работать с Crush, нужно два шага: установить его и запустить crush, а затем выбрать модель через Ctrl+L. Дальше всё важное находится в crushrc: какие инструменты могут запускаться без вопросов, какие модели использовать для больших и маленьких задач и какие MCP- и языковые серверы загружать. Держите в проекте AGENTS.md, и Crush, как и большинство других агентов, будет ему следовать.
Источники: Crush на GitHub, документация по настройке, релизы, лицензия, Hyper.