Klepa AI

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. 1

    Установите

    Выполните команду для своей системы. Клёпа встанет в ваш домашний каталог, права администратора не нужны.

    Linux и macOS — в терминале

    curl -fsSL https://klepa.gpt-chat.by/install.sh | bash

    Windows — в PowerShell

    irm https://klepa.gpt-chat.by/install.ps1 | iex

    Нужен PowerShell. В Windows 10 и 11 он уже есть: нажмите «Пуск» и наберите «PowerShell». В «Командной строке» (cmd) команда не сработает. Если PowerShell нет, установите его с сайта Microsoft.

  2. 2

    Войдите

    Откройте ссылку из терминала и войдите через Telegram или Google. Ключ сохранится сам, копировать его не нужно.

    klepa login
  3. 3

    Запустите в проекте

    Перейдите в папку проекта и запустите Клёпу. Опишите задачу обычными словами.

    cd ~/my-project
    klepa

Установщик проверяет целостность архива и ставит Клёпу в ~/.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 | bash

Windows — в PowerShell:

irm https://klepa.gpt-chat.by/install.ps1 | iex