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

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

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

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

Чтобы начать работать с 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.

Вопросы

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 бесплатно; ваши установленные CLI уже готовы к работе.

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