# Freebuff: бесплатный ИИ-агент для кода в терминале

Ставишь Freebuff одной командой, запускаешь в папке проекта и даёшь первую задачу словами - агент сам находит файлы и правит код. Без подписки, кредитов и своего API-ключа.

// Шаг 0

## Что это и где взять

Freebuff - бесплатная версия Codebuff: ИИ-агент, который живёт в терминале. Описываешь задачу обычными словами, а он сам открывает нужные файлы проекта, правит код и гоняет проверки. Платит за это реклама - короткие текстовые строчки в терминале, пока агент работает. Код открытый, лицензия Apache-2.0.

[Сайт Freebuff](https://freebuff.com/)

[Репозиторий на GitHub](https://github.com/CodebuffAI/freebuff)

[Страница Freebuff CLI](https://freebuff.com/cli)

---

// Шаг 1

## Установка и первый запуск

врезка `// Условие`: текст «Нужен Node.js с npm. Проверь командой node -v - если команды нет, поставь Node.js LTS с nodejs.org.»

[Скачать Node.js](https://nodejs.org/en/download)

- 1 «Поставь Freebuff» — Открой терминал и поставь пакет глобально - одной командой.
- 2 «Зайди в папку проекта» — Агент работает с той папкой, где его запустили. Перейди в свой проект через cd.
- 3 «Запусти и войди» — Набери freebuff. При первом запуске он попросит войти в аккаунт - войди, выбери модель и можно работать.

```
npm install -g freebuff
```

_Установка_

```
cd ~/my-project
freebuff
```

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

- [ ] Проверить, что стоит Node.js: node -v
- [ ] Поставить Freebuff: npm install -g freebuff
- [ ] Перейти в папку проекта через cd
- [ ] Запустить freebuff и войти в аккаунт
- [ ] Выбрать модель в списке

---

// Шаг 2

## Первая задача и проверка правок

Пиши задачу как человеку: что сделать и где. Freebuff сам найдёт нужные файлы, внесёт правки и запустит проверки проекта. Начни с маленькой задачи, чтобы увидеть, как он работает.

```
Найди, где в проекте собирается главная страница, и добавь внизу футер с годом и ссылкой на мой GitHub. После правки запусти сборку и скажи, всё ли прошло.
```

_Пример первой задачи_

- 1 «Команды под рукой» — В Freebuff набери / - откроется список команд. /model меняет модель, ? - справка, стрелка ← - история.
- 2 «Большую задачу - по шагам» — Сначала /interview - агент уточнит, что нужно. Потом /plan - план работ. Дальше реализация и /review - разбор того, что получилось.
- 3 «Проверь правки сам» — Агент гоняет сборку, но смотреть результат всё равно тебе. Если проект в git, открой изменения через git diff и запусти проект руками.
- 4 «Сохрани и продолжи» — /export выгрузит переписку сессии в Markdown-файл. freebuff --continue вернёт прошлую сессию.

```
git diff
```

_Посмотреть, что агент поменял в коде_

```
freebuff --continue
```

_Вернуться к прошлой сессии_

врезка `// Совет`: текст «Перед первой задачей закоммить текущее состояние проекта. Не понравились правки - откатишь одной командой git checkout .»

---

// Шаг 3

## Что бесплатно и откуда реклама

- Бесплатно - без подписки, без карты, без кредитов и без своего API-ключа
- Бесплатный план даёт 30 часов в день, остаток сгорает в полночь по местному времени
- Одна сессия - час с неограниченным числом сообщений; модель с множителем 3x тратит три часа за час
- Платит реклама - текстовые строчки в терминале во время работы; файлы проекта рекламщикам не передаются
- Из неподдерживаемого региона или через VPN - урезанный режим: 5 часов в день, через VPN - 4, и не все модели

врезка `// Важно`: текст «Некоторые модели могут использовать твои запросы для обучения - Freebuff предупреждает об этом в выборе модели. Если код закрытый, смотри эту пометку до старта.»

## Если бесплатного мало

У Freebuff есть платные планы - больше часов в день и все модели: Starter - $8 в месяц, 50 часов в день; Plus - $25, 80 часов; Pro - $60, 130 часов. Отдельно есть полный платный Codebuff - со всеми режимами, по подписке или по кредитам.

```
npm install -g codebuff
```

_Платный Codebuff CLI_

[Тарифы Codebuff](https://www.codebuff.com/pricing)

---

// Финиш

## Проверь себя

- [ ] Freebuff стоит: команда freebuff запускается в терминале
- [ ] Вошёл в аккаунт и выбрал модель через /model
- [ ] Запустил агента в папке своего проекта
- [ ] Дал первую задачу словами и дождался правок
- [ ] Посмотрел изменения через git diff и запустил проект
- [ ] Проверил в выборе модели пометку про обучение на данных
- [ ] Знаю, как вернуться к сессии: freebuff --continue

---

Источник: https://localhost:3000/m/freebuff-besplatnyy-ii-agent-dlya-koda-v-terminale