Klepa CLI · Клёпа в терминале
Klepa CLI — AI-агент для кода в терминале
Та же Клёпа, что в VS Code, только в командной строке. Опишите задачу словами — агент разберётся в проекте, поправит файлы и запустит команды. Без VPN, оплата картами МИР и БЕЛКАРТ, аккаунт и баланс общие с плагином.
$ curl -fsSL https://klepa.gpt-chat.by/install.sh | bash
Скачиваю Клёпу для Linux…
Готово. Войдите: klepa login
$ klepa login
# откроется ссылка: войдите через Telegram или Google
$ klepa
Привет, я Клёпа!
› найди, почему падает тест корзины, и починиУстановка на Linux, macOS и Windows
Подходит для Ubuntu и других 64-битных Linux на процессорах Intel или AMD, для Mac с Apple Silicon (M1 и новее) и для 64-битной Windows 10 и 11. Нужен только терминал, на Windows — PowerShell; права администратора не нужны.
- Ubuntu и Linux64 бита, Intel или AMDДоступно
- Windows10 и 11, 64 битаДоступно
- macOSApple Silicon, M1 и новееДоступно
- 1
Установите
Выполните команду для своей системы. Клёпа встанет в ваш домашний каталог, права администратора не нужны.
Linux и macOS — в терминале
curl -fsSL https://klepa.gpt-chat.by/install.sh | bashWindows — в PowerShell
irm https://klepa.gpt-chat.by/install.ps1 | iexНужен PowerShell. В Windows 10 и 11 он уже есть: нажмите «Пуск» и наберите «PowerShell». В «Командной строке» (cmd) команда не сработает. Если PowerShell нет, установите его с сайта Microsoft.
- 2
Войдите
Откройте ссылку из терминала и войдите через Telegram или Google. Ключ сохранится сам, копировать его не нужно.
klepa login - 3
Запустите в проекте
Перейдите в папку проекта и запустите Клёпу. Опишите задачу обычными словами.
cd ~/my-projectklepa
Установщик проверяет целостность архива и ставит Клёпу в ~/.local/bin/klepa, на Windows — в папку %LOCALAPPDATA%\Programs\Klepa. На Linux и macOS, если в текущем окне команда klepa ещё не находится, он покажет полный путь для входа, а в новых окнах терминала всё заработает само. На Windows команда работает сразу в том же окне PowerShell.
Команды запуска
klepaоткрыть Клёпу в текущей папкеklepa ~/projects/siteоткрыть Клёпу в другой папкеklepa -cпродолжить последний диалогklepa run "обнови README"отправить задачу без интерфейса, например из скриптаklepa modelsпоказать доступные моделиklepa --helpполная справка по командам
Как работать в Клёпе
После команды klepa откроется окно с полем ввода. Напишите задачу обычными словами и нажмите Enter, например: «Найди, почему падает тест корзины, и почини». Клёпа сама прочитает нужные файлы, внесёт правки и расскажет, что сделала.
Режимы: клавиша Tab
Режим и модель видны под полем ввода. Tab переключает режим вперёд, Shift+Tab — назад.
- Код — пишет и правит код, запускает команды. Включён сразу после запуска.
- План — разбирает задачу и составляет план. Файлы проекта не меняет.
- Вопросы — объясняет код и отвечает на вопросы, ничего не меняя.
- Отладка — по шагам ищет причину ошибки и исправляет её.
Что Клёпа делает сама, а что спрашивает
Файлы в папке проекта Клёпа читает и правит без вопросов. Перед командой в терминале она спрашивает разрешение — кроме безопасных, вроде ls, cat или git status. Спросит и перед тем, как открыть файл вне папки проекта или файл .env с паролями.
В окне разрешения три варианта: «Разрешить один раз», «Разрешать всегда» — Клёпа запомнит выбор и больше не спросит про такое действие, и «Отказать» — действие не выполнится.
Команды через косую черту
Наберите / в поле ввода — появится список команд. Главные:
/modelsсменить модель: Claude, GPT, Gemini, Qwen, DeepSeek и другие/newначать новый диалог/sessionsвернуться к прошлому диалогу/undoотменить последнее сообщение; в проекте с git откатятся и правки файлов после него/redoвернуть отменённое/compactсжать длинный диалог в короткую сводку/initсоздать файл AGENTS.md с описанием проекта/reviewпроверить правки: незакоммиченные, коммит или ветку/diffпосмотреть изменения в файлах/helpсправка/exitвыйти из Клёпы
Файлы и команды прямо в сообщении
@src/cart.ts объясни, что тутпосле@появится список файлов проекта — выберите нужный, и Клёпа прочитает его!npm test!в начале строки выполняет команду в терминале, результат видит и Клёпа; Esc — вернуться к обычному вводу
Клавиши
- Enterотправить сообщение
- Ctrl+J или Shift+Enterновая строка в сообщении
- Esc два разаостановить агента
- Tab и Shift+Tabсменить режим
- Ctrl+Pсписок всех команд
- ↑ и ↓прошлые сообщения
Правила проекта: AGENTS.md
Клёпа читает файл AGENTS.md из папки проекта в каждом диалоге. Запишите туда, как собирать и тестировать проект и каких правил держаться, — агент будет им следовать. Черновик файла создаст команда /init.
Плагин или CLI: что выбрать
Klepa CLI — если
- привыкли работать в терминале и не хотите держать открытый редактор;
- правите код на сервере по SSH, где нет графической среды;
- хотите запускать задачи агенту из скриптов командой
klepa run.
Плагин для VS Code — если
- удобнее видеть правки прямо в файлах редактора;
- нужны режимы Ask, Plan, Code и Debug в панели и генерация картинок.
Можно пользоваться обоими: вход один, баланс и модели общие.
Обновление и удаление
Начиная с версии 0.6.0 Klepa CLI проверяет обновления автоматически раз в сутки и скачивает их в фоне. Новая версия включается при следующем запуске: текущая работа продолжается без перерыва. Без сети остаётся рабочая версия.
Если у вас версия 0.5.0 или старше, один раз повторите команду установки выше. Вход и настройки сохранятся. Для ручного обновления тоже можно повторить установку. Отключить автообновление можно переменной окружения KLEPA_AUTOUPDATE=0.
Чтобы удалить на Linux и macOS, выполните:
rm ~/.local/bin/klepa && rm -rf ~/.local/share/klepa-cliНа Windows — в PowerShell:
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\Programs\Klepa"Узнавайте о новых версиях
Клёпа сообщит о новом выпуске CLI уведомлением браузера, даже если вкладка сайта закрыта.
Частые вопросы про Klepa CLI
Что такое Klepa CLI?
Это Клёпа для терминала. Агент запускается командой klepa в папке проекта, читает код, правит файлы и выполняет команды — так же, как плагин в VS Code, только без редактора.
На каких системах работает Klepa CLI?
На Ubuntu и других 64-битных Linux на процессорах Intel или AMD, на Mac с Apple Silicon (M1 и новее) и на 64-битной Windows 10 и 11. Mac на процессорах Intel и Windows на ARM пока не поддерживаются — на них работает плагин для VS Code.
Как установить Klepa CLI на Windows?
Нужен PowerShell — в Windows 10 и 11 он уже встроен: нажмите «Пуск» и наберите «PowerShell». Откройте его (не «Командную строку») и выполните irm https://klepa.gpt-chat.by/install.ps1 | iex. Клёпа встанет в папку пользователя без прав администратора, команда klepa заработает сразу в этом окне и в новых окнах.
Нужен ли VS Code для Klepa CLI?
Нет. CLI работает в любом терминале и не зависит от редактора. Поэтому его удобно запускать и на сервере по SSH.
Это аналог Claude Code?
По способу работы — да: агент живёт в терминале и сам ведёт задачу. Разница в доступе: Klepa работает из Беларуси и России без VPN, принимает МИР и БЕЛКАРТ и даёт выбрать модель — Claude, GPT, Gemini, Qwen, DeepSeek и другие.
Сколько стоит Klepa CLI?
Сама программа бесплатна. Оплата — как в плагине: за фактические запросы к платным моделям, без подписки, депозит от 5 BYN. Баланс общий для CLI и плагина.
Как сменить модель в Klepa CLI?
Наберите /models в поле ввода и выберите модель из списка. Модель можно сменить и посреди диалога. Посмотреть все модели без запуска агента — команда klepa models.
Как остановить Клёпу, если она делает не то?
Нажмите Esc два раза. Чтобы отменить последнее сообщение, введите /undo — в проекте с git вернутся и файлы, которые агент успел изменить.
Спрашивает ли Клёпа разрешение перед изменениями?
Файлы в папке проекта она правит без вопросов. Перед командами в терминале (кроме безопасных, вроде ls или git status) и перед доступом к файлам вне проекта — спрашивает. Если выбрать «Разрешать всегда», Клёпа запомнит выбор.
Как войти, если терминал на сервере без браузера?
Выполните klepa login и откройте показанную ссылку в браузере на любом устройстве. После входа на сайте вернитесь в терминал — ключ сохранится сам. Ссылку не передавайте другим: она одноразовая и даёт вход в ваш аккаунт.
Читайте дальше
Поставьте Клёпу в терминал
Одна команда — и через минуту агент готов к работе.
Linux и macOS — в терминале:
curl -fsSL https://klepa.gpt-chat.by/install.sh | bashWindows — в PowerShell:
irm https://klepa.gpt-chat.by/install.ps1 | iex