Раздел 49 · Агенты и LLM-разработка: типография «Оттиск»

pi и DeepSeek у себя

middle~45 мин

без входаВойди, чтобы отмечать прогресс, вести заметки и решать задачи в редакторе. войти

Вера Андреевна разворачивает к тебе свой ноутбук. Там таблица расходов типографии: бумага, краска, аренда, свет. Внизу новая строка «Лёва, подписка на агента», каждый месяц одна и та же сумма.

Подписка подходит, когда агентом пользуется один человек и цена отдельного шага ему неинтересна. Типографии нужно другое: платить за сделанную работу и знать цену каждого письма. Модели продаются и так: по ключу, за каждый прочитанный и написанный кусок текста.

В прошлом уроке ты видел, что агент на каждом шаге отправляет модели весь контекст. Сегодня у этого появится цена в долларах. Ты поставишь своего агента у себя: pi на модели DeepSeek Flash со своим ключом. Скачаешь шаблон курса, запустишь первую задачу и найдёшь, где видна цена запуска. Это урок «у себя»: в конце не тест, а чек-лист, который ты отмечаешь сам.

Цена в токенах

Модель читает и пишет текст кусочками, и DeepSeek, как и другие продавцы моделей, считает деньги в этих кусочках.

Токен это кусок текста: короткое слово целиком, длинное по частям, знак препинания отдельно. Как текст режется на токены и почему русский дороже английского, разберёшь в шестом уроке. Сейчас хватит правила: цена запроса это токены на входе, умноженные на цену входа, плюс токены на выходе, умноженные на цену выхода.

Цены модели deepseek-flash за миллион токенов:

вне пикав пик
вход, без кэша$0.15$0.3
вход, попадание в кэш$0.003$0.006
выход$0.6$1.2

Проверено на: DeepSeek deepseek-flash (DeepSeek-V4.1-Flash), api-docs.deepseek.com, 2026-11-11.

Пик у DeepSeek это 01:00-04:00 и 06:00-10:00 по UTC с понедельника по пятницу, кроме праздников КНР. По Москве это 04:00-07:00 и 09:00-13:00 по будням. В остальное время, в выходные и праздники цена вдвое ниже. Попадание в кэш бывает, когда начало запроса совпадает с недавним запросом: такие токены на входе в пятьдесят раз дешевле, подробно в одиннадцатом уроке.

Выход дороже входа вчетверо: каждый токен ответа стоит как четыре токена запроса.

Почему pi

pi, по словам автора, это минимальный harness, который можно сделать своим. Код открыт под лицензией MIT. Системный промпт вместе с описаниями инструментов, как писал автор в 2025 году, короче тысячи токенов, а инструментов по умолчанию четыре: read читает файл, write пишет, edit заменяет кусок текста другим, bash запускает команду. Модель подключается любая, DeepSeek в pi встроен.

Для курса это значит две вещи. Служебного текста в каждом запросе мало: тысяча токенов вне пика стоит $0.00015, полторы сотых цента. И pi не прячет устройство harness: в модуле AG3 ты соберёшь свой Наборщик и будешь сравнивать его с pi строка за строкой.

У минимализма есть цена, и её надо знать до первого запуска. В pi нет системы прав. Он работает с правами пользователя, который его запустил, и не спрашивает разрешения на каждую команду. Если модель пришлёт заявку bash удалить папку, pi удалит. Документация pi советует запускать его в контейнере или виртуальной машине. Для курса правило минимальное: запускай pi только в папке шаблона, не в домашней папке и не там, где лежат ключи и чужие проекты.

Правила для агента в шаблоне лежат в AGENTS.md, и pi их читает. Но это просьба, а не замок: файл говорит модели «не читай .env», а запретить это на деле может только harness. Как ставят настоящие замки, разберёшь в модуле AG3.

Поставь pi

  1. Нужен Node.js 22.19 или новее. Проверь версию: node --version.

  2. Поставь pi одной из двух команд. Через npm:

    npm install -g --ignore-scripts @earendil-works/pi-coding-agent

    Или скриптом с сайта pi:

    curl -fsSL https://pi.dev/install.sh | sh

    Флаг --ignore-scripts не даёт npm запускать скрипты установки пакетов. Скрипт с сайта фиксирует версии зависимостей, а обновляется такая установка командой pi update.

  3. Заведи ключ DeepSeek на platform.deepseek.com. Ключ это пароль, по которому DeepSeek выставляет счёт тебе. Не вставляй его в код, в чаты и на скриншоты.

Проверено на: pi 1.5.2, DeepSeek deepseek-flash, 2026-11-11.

Шаблон курса

Шаблон курса ottisk-template это репозиторий, в котором ты запускаешь у себя всё, что на сайте проверяет Болванка. Забери его и поставь зависимости:

git clone https://github.com/bondiano/ottisk-template
cd ottisk-template
pnpm install
cp .env.example .env

В .env.example две переменные:

# bolvanka: без сети и ключа, ответы по сценарию из src/scenario.ts
# deepseek: настоящая модель deepseek-flash, нужен ключ с platform.deepseek.com
MODEL=bolvanka
DEEPSEEK_API_KEY=

Ключ живёт только в .env. Этот файл перечислен в .gitignore и в репозиторий не попадёт. Шаблон проверяет конфиг при запуске и говорит, какой переменной не хватает.

Первый запуск без сети и без ключа, на Болванке:

pnpm hello
Клиент: Сколько стоят 500 визиток?
Приёмщик (bolvanka): Пятьсот визиток стоят 4500 ₽.
Токены: 99 на входе, 30 на выходе
Цена запуска: $0, это Болванка. С MODEL=deepseek здесь будет цена в долларах.

pnpm hello это приёмщик «Оттиска» с одним инструментом price. Клиент спрашивает цену, модель присылает заявку на price, код считает по прайсу, модель пишет ответ. Получается тот же цикл, что с письмом Анны в первом уроке, только инструмент один. Строка «Токены» складывает оба запроса к модели: первый с вопросом, второй с результатом price. Болванка это модель-дублёр, которая отвечает по сценарию, без сети и бесплатно; как она устроена, разберёшь в следующем уроке.

Теперь переключись на настоящую модель: поставь в .env строку MODEL=deepseek. Если ключ ещё пустой, шаблон остановится с ошибкой, и в выводе будет строка:

Error: MODEL=deepseek, но DEEPSEEK_API_KEY в .env пуст

Шаблон упал раньше первого запроса в сеть: ни одного токена не потрачено. Впиши ключ в .env и запусти pnpm hello ещё раз.

Ты увидишь те же четыре строки, только после слова «Приёмщик» в скобках будет deepseek-flash, токенов станет больше, а последняя строка покажет цену в долларах, сразу два числа:

Цена запуска: $… вне пика, $… в пик (цены на 2026-11-11)

Сколько там будет? Прикинь заранее. Если бы DeepSeek насчитал столько же токенов, сколько Болванка, 99 на входе и 30 на выходе, то вне пика вышло бы:

99 × $0.15 / 1 000 000 + 30 × $0.6 / 1 000 000 = $0.00001485 + $0.000018 ≈ $0.000033

В пик вдвое больше, около $0.000066. Тысяча таких писем вне пика обошлась бы примерно в три цента. Это прикидка, а не прогноз. Настоящие числа будут больше: у DeepSeek свой способ резать текст на токены, а на вход уходит ещё описание инструмента price, которое Болванка не считает. Настоящую цену покажет твой запуск, её ты и запишешь в чек-лист.

MODEL=deepseek pnpm hello ходит в сеть и тратит деньги. Так написано и в AGENTS.md шаблона: агенту запускать эту команду можно только по просьбе человека.

Первая задача в pi

Теперь то же самое, но рулит агент. В папке шаблона:

export DEEPSEEK_API_KEY=...   # или /login внутри pi
pi --provider deepseek --model deepseek-flash

pi берёт ключ из переменной окружения DEEPSEEK_API_KEY. Второй способ это команда /login внутри pi, тогда pi сохранит ключ в своём файле auth.json. Флаг --provider работает только вместе с --model.

Когда pi откроется, дай ему первое задание:

Прочитай price.csv и ответь, сколько стоят 500 визиток и какой у них минимальный тираж.

pi отправит модели твоё задание и описания четырёх инструментов. Модель пришлёт заявку прочитать файл, pi её исполнит и вернёт содержимое price.csv, модель напишет ответ. Заявки и их результаты pi показывает в разговоре, так что видно, каким инструментом агент читал файл.

Теперь сверь ответ сам. Открой price.csv:

изделие,цена за штуку,минимальный тираж
визитки,9,100
листовки А5,4,500
буклеты,35,50
афиши А3,60,10

Пятьсот визиток по 9 ₽ это 4500 ₽, минимальный тираж 100 штук. Совпало? Запиши. Не совпало? Тоже запиши и сохрани ответ агента: к таким ответам ты вернёшься в модуле AG1.

На веру и на сверку

Лёва смотрит тебе через плечо.

Вызов read в истории доказывает одно: содержимое файла попало в контекст. Что ответ взят из файла, он не доказывает. Модель могла прочитать файл и всё равно ошибиться: взять минимальный тираж из соседней строки, где буклеты и 50, округлить цену или написать «около». Почему машина путает строки таблицы, разберёшь в семнадцатом уроке.

Приём, который это снимает, ты уже видел в pnpm hello. Там цену считает не модель, а код: инструмент price умножает цену за штуку на тираж, а модель только зовёт его и пересказывает результат. Число, которое уйдёт клиенту, получено из прайса кодом. Пока такого инструмента нет, сверяет человек, как ты сейчас.

Где видна цена запуска

Цену запуска можно увидеть в трёх местах, и это три разных числа.

  1. Шаблон. Строка «Цена запуска» в pnpm hello. Шаблон считает её по токенам из ответа DeepSeek и по таблице цен в src/client.ts, записанной с датой проверки. Кэш он не учитывает.
  2. pi. Библиотека pi-ai внутри pi считает цену по своему каталогу моделей, и автор pi сам называет этот учёт приблизительным. В каталоге у deepseek-flash записано $0.3 за миллион входных токенов и $1.2 за миллион выходных, то есть пиковые цены. Если pi считает по этой строке, вне пика его оценка выйдет вдвое выше того, что спишет DeepSeek.
  3. Счёт DeepSeek. Это оригинал. Строки в выводе шаблона и pi это копии, посчитанные по своим таблицам. С оригиналом они расходятся, когда DeepSeek меняет цены, когда часть входа попала в кэш (шаблон его не учитывает) или когда pi в непиковый час считает по ценам пика.

Вере Андреевне нужно третье число, но смотреть на первые два полезно после каждого запуска. Они приходят сразу, а счёт в конце месяца.

Когда звать Claude Code или Codex

pi на Flash это рабочая лошадка: дёшево, быстро, цена видна. Но есть задачи, где ошибка стоит дороже всех сэкономленных центов. Для них курс зовёт модели сильнее и дороже через Claude Code от Anthropic или Codex от OpenAI.

ЗадачаЧемПочему
прочитать прайс и ответить, одна правка по брифуpi на Flashрезультат проверяется за минуту, ошибка дешёвая
план большой переделки: перенос калькулятора на базуClaude Code или Codexошибку в плане оплатишь потом каждым шагом работы по нему
ревью диффа, который написал агент на Flashдругой агент, не тот, что писалсвежий взгляд без контекста автора
баг, который не поддался с двух попытокClaude Code или Codexпосле двух неудачных поправок меняют подход, а не повторяют третью

Claude Code работает по подписке Anthropic или с аккаунтом Console, Codex по плану ChatGPT или с ключом API. Поставишь их и сравнишь с pi в модуле AG4. Там же увидишь, что у DeepSeek есть адрес, совместимый с API Anthropic, поэтому Claude Code можно запустить и на DeepSeek.

Проверено на: Claude Code 2.1.322, Codex CLI 0.167.1, 2026-11-11.

Перед сдачей

Отметь пункт, только когда видишь результат своими глазами.

Перед сдачейготово

Практика

Дальше

Сан Саныч давно стоит у тебя за спиной и смотрит, как pi читает прайс.

Ты задаёшь тот же вопрос теми же словами. Ответ приходит другой: слова другие, порядок другой, в конце появилась фраза про доставку, которой в первый раз не было.

В следующем уроке ты узнаешь, как курс проверяет код, который зовёт модель, если модель каждый раз отвечает по-разному и каждый ответ стоит денег.