Ты хочешь создать ИИ-агента в DeepSeek, но в статьях одна вода. Либо общие слова, либо инструкции для тех, кто уже все знает. Сейчас разложу по шагам, как это делается на практике.
Речь пойдет про DeepSeek-TUI. Это ИИ-агент для кода в терминале, дешевая альтернатива Claude Code. Ставится за вечер, если знать пару подводных камней. Я прошел этот путь, собрал грабли, теперь делюсь картой.
Инструкция подойдет и для Windows, и для macOS, и для Linux. Но я буду честно предупреждать, где обычно ломается. Потому что на ровном месте чаще всего ломается именно Windows.
Поехали.
Что такое ИИ-агент и почему это не просто чат
Чат-бот отвечает на вопросы. ИИ-агент берет задачу и выполняет ее. Разница как между курьером и справочной службой. Курьер привозит пиццу, справочная просто рассказывает, где пиццерия.
DeepSeek-TUI работает прямо в терминале. Вы даете ему задачу, он читает файлы проекта, пишет код, запускает команды. По сути, это джуниор-разработчик, который не спит и не просит зарплату.
Важно понимать: агент не магия. Это модель, обернутая в инструменты. Она может смотреть файлы, редактировать их, выполнять команды в терминале. Все это через API DeepSeek или OpenRouter.
Внутри все устроено просто: модель получает задачу, разбивает ее на шаги, выполняет каждый шаг с помощью доступных инструментов, проверяет результат. Если что-то пошло не так, исправляет и пробует снова.
Готовим доступ к модели: OpenRouter или напрямую DeepSeek
Первый шаг - получить доступ к модели. Тут два пути. Первый: зарегистрироваться на platform.deepseek.com и получить API-ключ напрямую. Второй: использовать OpenRouter, если у вас там уже есть баланс.
У меня был ключ OpenRouter, поэтому пошел через него. Сразу скажу: это путь с граблями. Через OpenRouter работает, но с оговорками. Если нужна стабильность, заводите ключ напрямую у DeepSeek.
На openrouter.ai жмем Sign in, идем в раздел Keys, жмем Create Key. Закидываем хотя бы $5 на баланс. Ключ будет вида sk-or-v1-... Копируем сразу, он показывается один раз. Потеряете, придется создавать новый.
Если регистрируетесь напрямую в DeepSeek, на официальном сайте жмите Start Now. Сервис попросит создать аккаунт, это нужно для сохранения истории генераций. Мобильное приложение DeepSeek есть в AppStore и Google Play, вход по почте или через Google.
Разница между путями в цене и стабильности. Напрямую у DeepSeek дешевле, но нужно пополнять счет с иностранной карты. OpenRouter берет небольшую наценку, зато принимает больше способов оплаты.
Ставим Node.js и терминал, который не подведет
Дальше нужен Node.js. Идем на nodejs.org, качаем LTS-версию. После установки открываем новое окно PowerShell и проверяем:
node -v
Если видите номер версии, все ок. На Windows это чаще всего ломается на ровном месте, так что не пропускайте шаг с проверкой. На macOS и Linux все проще.
LTS нужна, потому что это стабильная версия. Новомодные релизы могут ломать совместимость с npm-пакетами, а агент этого не любит. LTS работает предсказуемо.
На Windows еще совет: используйте Windows Terminal вместо классической консоли. Он лучше работает с Unicode и длинными командами. Это мелочь, но она влияет на удобство.
Устанавливаем DeepSeek-TUI
Сам агент ставится одной командой через npm:
npm install -g deepseek-tui
Кстати, npm-пакет это просто загрузчик готового Rust-бинаря с GitHub Releases. Если антивирус ругается на свежий .exe, добавьте папку %APPDATA%\npm в исключения. Бывает, да.
После установки проверьте, что команда доступна. Наберите deepseek --version. Если видите версию, загрузчик отработал правильно.
Благодаря глобальной установке агент доступен из любой папки. Зашли в проект, запустили агента, работаете.
Пишем конфиг: TOML без сюрпризов
Теперь самое интересное - конфиг. Открываем файл:
notepad $env:USERPROFILE\.deepseek\config.toml
Если файла нет, создаем. Многие пишут конфиг так, как привыкли, во вложенной секции. И получают ошибку. DeepSeek-TUI ждет настройки на верхнем уровне TOML, а не внутри [model]. Это важный момент.
Рабочий конфиг выглядит примерно так:
model = "deepseek/deepseek-v4-flash"
api_base = "https://openrouter.ai/api/v1"
Все ключевые параметры на верхнем уровне. Без вложенных секций, без лишних оберток.
Если используете ключ напрямую от DeepSeek, api_base будет другим. Проверьте актуальный адрес в документации, потому что они меняют эндпоинты.
Ошибка, на которой спотыкаются все
Имя модели нужно писать со слешем: deepseek/deepseek-v4-flash. Без слеша OpenRouter отдаст 404, потому что он ждет формат provider/model. На Reddit в треде про DeepSeek-TUI эта ошибка - самая популярная. В документации DeepSeek-TUI пишут иначе, но на практике работает только со слешем.
Вторая частая ошибка - перепутать api_base. Для OpenRouter это https://openrouter.ai/api/v1, а не основной сайт. Если указать неправильный адрес, агент просто не сможет достучаться до API.
Третья ошибка - забыть ключ. В конфиге должен быть прописан ваш API-ключ. Без него агент запустится, но на первом же запросе получит отказ в доступе.
Четвертая ошибка - неправильный путь к конфигу. На Windows путь должен быть %USERPROFILE%\.deepseek\config.toml. Если положить конфиг в другое место, агент его просто не увидит.
Первый запуск и проверка
Проверяем конфиг, запускаем агента в тестовой папке. Создаем директорию, переходим в нее и стартуем:
mkdir test-agent && cd test-agent
deepseek
Если все сделано правильно, агент поприветствует вас и будет готов к работе. Дайте ему простую задачу: напиши hello world на Python. Посмотрите, как он справится.
Первый запуск всегда волнительный. Агент может задавать уточняющие вопросы, может сразу взяться за дело. Это нормально, зависит от настроек.
Обратите внимание на скорость ответа. Если агент думает слишком долго, возможно, выбрана слишком тяжелая модель. Flash-версии работают быстрее.
DeepSeek-TUI против Claude Code: что выбрать
Claude Code считается золотым стандартом ИИ-агентов для кода. Но стоит дорого. DeepSeek-TUI делает то же самое, но на базе DeepSeek, которая заметно дешевле.
На практике разница в качестве заметна на сложных задачах. Claude лучше держит контекст и реже ошибается. Но для рутины DeepSeek более чем достаточно.
Если бюджет ограничен, начните с DeepSeek-TUI. Он покроет 80% задач. Если упретесь в потолок, тогда смотрите в сторону более дорогих решений.
Главное преимущество DeepSeek-TUI - открытость и простота. Это npm-пакет, который ставится одной командой. Никаких подписок и привязок.
Как выбрать модель под свою задачу
DeepSeek-V4 Flash - это быстрая и дешевая модель для повседневных задач. Она хорошо справляется с кодом, текстами, рутиной. Для большинства сценариев ее достаточно.
Если нужна более глубокая аналитика, можно подключить reasoning-модели. Они думают дольше, но выдают более продуманные ответы. Цена выше, но для сложных задач это оправдано.
На Reddit разработчики советуют начинать с flash-версий, чтобы не переплачивать. В OpenRouter модели DeepSeek доступны в разных вариантах. Смотрите на цену за миллион токенов и выбирайте под бюджет. Flash-версии обычно в разы дешевле.
Не гонитесь за самой мощной моделью сразу. Начните с flash, почувствуйте, как агент работает, потом экспериментируйте.
Промпты для агента: как объяснить задачу без боли
Агент понимает естественный язык, но не читает мысли. Чем конкретнее задача, тем лучше результат. Вместо "исправь код" пишите "исправь ошибку в функции parse_data, которая падает при пустом вводе".
Давайте контекст. Укажите стек, структуру проекта, ожидаемый результат. Агент использует эту информацию при каждом шаге.
Разбивайте большие задачи. Агент лучше справляется с серией мелких шагов, чем с одной огромной задачей. Каждый шаг проверяйте отдельно.
Требуйте объяснений. Попросите агента комментировать свои действия и объяснять, почему он выбрал то или иное решение. Так проще находить ошибки.
Реальные сценарии: где агент экономит часы
Когда агент запущен, начинается самое интересное. Давайте ему реальные задачи: рефакторинг, написание тестов, разбор чужого кода. DeepSeek-V4 Flash достаточно быстрая и дешевая, чтобы гонять ее на повседневных задачах.
Хороший сценарий - привязать агента к репозиторию и настроить автодополнение. Он будет сам предлагать изменения, а вы только ревьюите. Это как парное программирование, только напарник не устает.
Можно настроить агента на конкретный стек. Скажите ему в промпте, что проект на Python + Django, и он будет учитывать это в каждой задаче. Меньше контекста приходится повторять руками.
Для бизнес-задач агент тоже подходит. Автоматическая обработка заявок, генерация ответов клиентам, подготовка отчетов. Все это рутина, которую модель делает за минуты.
Пример из практики: агент поддержки, который отвечает на письма клиентов. Он читает входящее письмо, определяет тему, генерирует ответ по шаблону и отправляет. Настройка заняла полчаса, экономия - несколько часов в день.
Еще пример: планировщик, который каждое утро собирает новости по заданным темам и присылает дайджест. Запускается по расписанию, работает без участия человека.
Агент без кода: для тех, кто не дружит с терминалом
Не все готовы возиться с TOML и npm. Это нормально. Есть способ проще, для этого не нужно программирование. Сервисы вроде Zap Your Agents позволяют собрать ИИ-агента из готовых блоков и подключить к 7000 приложений: почта, Google Sheets, планировщики.
Например, можно сделать агента поддержки, который автоматически отвечает на письма клиентов. Или агента-планировщика, который каждое утро собирает новости о фондовом рынке. Настройка сводится к выбору триггера и описанию задачи своими словами.
Важно правильно задать спецификации, иначе агент начнет галлюцинировать. Чем точнее опишете контекст и ожидаемый формат ответа, тем меньше мусора на выходе.
Такой подход подходит для бизнес-пользователей, которым не нужен код. Они хотят результат: письмо отправлено, отчет сформирован, заявка обработана.
Доступ из России: как получить флагманские модели без иностранной карты
Отдельная боль для всех, кто живет в России. OpenRouter принимает не все карты, а напрямую DeepSeek вообще может быть недоступен. Тут на помощь приходит 3GPT от 3SELLER.
3GPT - это ИИ-роутер, который дает прямой доступ из России к последним флагманским моделям. За 149 рублей в месяц. Без иностранных карт, пополнение российской картой, через СБП или криптой.
Внутри: Chat GPT 6 Astra, Claude Fable 5 и 5.1, Claude Opus 5.5, Chat GPT 5.5, Chat GPT 6.1 Sol, Nano Banana для создания изображений. Плюс генерация видео. Прямо сейчас доступны все топовые модели в одном месте.
Используйте для повседневных задач в бизнесе и работе. Создавайте продающие тексты, сайты, обрабатывайте изображения, делайте видеоролики и генерируйте голос.
Но кроме этого у 3GPT есть фишка - готовые ИИ-агенты под ваши задачи. Выбираете агента, начинаете общение, а модель агента можно менять прямо в чате. Это удобно, когда не хочется возиться с конфигами.
Получить доступ ко всем флагманским моделям из России можно на официальном сайте 3GPT: https://3seller.com/3gpt
Практические советы, которые сэкономят нервы
Эти советы я собрал после трех месяцев использования агента.
Храните API-ключ в безопасном месте. Не коммитьте конфиг с ключом в публичный репозиторий. Если ключ утек, отзовите его и создайте новый.
Следите за балансом. Агент может сжечь приличную сумму за вечер активной работы, если не ограничить лимиты. В OpenRouter есть настройки лимитов, используйте их.
Начинайте с малого. Не давайте агенту сразу весь проект. Пусть сначала разберется с одним модулем, потом расширяйте зону ответственности.
Используйте хорошие промпты. Агент работает настолько хорошо, насколько хорошо вы объяснили задачу. Чем больше контекста, тем лучше результат.
И главное: агент - это инструмент, а не замена человеку. Он хорош в рутине, но решения все равно за вами. Ревью кода, проверка фактов, финальное слово.
Ограничения и подводные камни
Агент не видит весь проект целиком, если вы сами не дадите ему контекст. Держите задачи маленькими и конкретными. Большая задача распадается на серию мелких шагов, каждый со своей проверкой.
Иногда агент зацикливается. Он повторяет одно и то же действие, не видя, что результат не меняется. В таких случаях помогает остановка и новый промпт с более четкой инструкцией.
Галлюцинации никуда не делись. Агент может уверенно выдать несуществующий API или устаревшую документацию. Проверяйте факты, особенно если код идет в продакшн.
Стоимость растет незаметно. Длинные диалоги съедают токены быстрее, чем кажется. Периодически смотрите статистику расходов.
Создать ИИ-агента в DeepSeek реально за вечер. Ключ, Node.js, npm, конфиг с правильным именем модели. Дальше дело практики.
Начните с простой задачи. Пусть агент напишет скрипт, отрефакторит функцию, подготовит отчет. Почувствуйте, как он работает, и постепенно расширяйте зону ответственности.
А если хочется без боли и с флагманскими моделями из России, заходите на 3GPT. Там и агенты готовые есть, и доступ ко всем топовым нейросетям за 149 рублей.