Блог Zukko

Гайды по Claude Code, Cursor, Codex и API Claude и GPT: настройка, экономия токенов, разбор ошибок.

Промпт-инъекция: что это и как защитить бота и агента

5 мин · · разработка

Объясняем, как работает промпт-инъекция через пользовательский ввод и чужие документы, и какие меры снижают ущерб: изоляция данных, права инструментов, лимиты ключа.

Свой прокси к нейросети на Node.js: не показывать API-ключ во фронтенде

4 мин · · разработка

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

DeepSeek API на Python: запросы, стриминг, JSON и обработка ошибок

4 мин · · разработка

Готовый код для DeepSeek V4.1 Flash и V4 Pro на OpenAI SDK: запрос, стриминг, разбор JSON и аккуратная обработка ошибок.

Промпт-инжиниринг: примеры и 12 готовых шаблонов для работы

4 мин · · разработка

Двенадцать шаблонов промптов для рабочих задач: что в них написано, почему именно так и сколько стоит один вызов по API.

Gemini API на Python: запросы через OpenAI SDK и OpenAI-формат

5 мин · · разработка

Рабочий пример Gemini API на Python без отдельной библиотеки: меняем base_url в OpenAI SDK, добавляем стриминг и JSON и сравниваем с google-genai.

Claude Code YOLO: режимы разрешений и работа без подтверждений

6 мин · · агенты

Отдельного режима YOLO в Claude Code нет, зато есть шесть режимов разрешений и гибкие правила. Разбираем, как перестать нажимать «Да» и не лишиться файлов.

Память чат-бота: как хранить историю диалога и не платить за неё дважды

6 мин · · разработка

Модель не помнит предыдущих реплик: историю отправляете вы при каждом запросе. Разбираем, как растёт цена диалога и чем её сдерживать.

OpenAI SDK или LangChain: когда фреймворк нужен, а когда мешает

5 мин · · разработка

Один и тот же сценарий на чистом SDK и на LangChain: сколько кода, где проще отлаживать и как не потерять контроль над расходом токенов.

Anthropic SDK для Python: base_url, ключ и первый запрос через шлюз

5 мин · · разработка

Официальный пакет anthropic для Python нужно только направить на другой адрес. Разбираем base_url, ключ, стриминг, подсчёт токенов, кэш и ошибки.

Перевод субтитров нейросетью: SRT без сбитых таймкодов

6 мин · · автоматизация

Главный риск при переводе SRT нейросетью — сломанная структура файла. Показываем схему, где таймкоды не попадают к модели, и скрипт на Python с проверкой.

Claude Code: чек-лист лучших практик для ежедневной работы

6 мин · · разработка

Привычки, которые делают работу с Claude Code предсказуемой: короткий CLAUDE.md, план перед правками, мелкие задачи, проверка результата и контроль расхода.

Безопасность Claude Code: чек-лист перед запуском агента в проекте

6 мин · · разработка

Агент читает файлы и запускает команды, поэтому настройки безопасности нужны до первого запуска. Чек-лист: разрешения, секреты, песочница, отдельный ключ с лимитом.

Редактирование текстов нейросетью: корректура, стиль и сокращение

5 мин · · разработка

Разные виды редактуры требуют разных промптов. Показываем формулировки для корректуры, стиля и сокращения, как получать правки с объяснением и не терять авторский голос.

MCP-сервер на Java: минимальный пример с одним инструментом

6 мин · · разработка

Пишем минимальный MCP-сервер на Java с одним инструментом, регистрируем его в Claude Code и учимся находить причину, если агент его не видит.

ANTHROPIC_API_KEY и ANTHROPIC_AUTH_TOKEN: где взять ключ и куда прописать

5 мин · · API-ключи

Какая переменная нужна SDK, какая Claude Code, где получить ключ и как прописать его в Windows, macOS и Linux так, чтобы он не попал в git.

Нейросеть для Lua и Roblox: как писать скрипты на Luau с ИИ

6 мин · · разработка

Модель без подсказки может спутать Lua с Luau и предложить устаревший API Roblox. Показываем, как формулировать задачу, проверять код и подключить агента к проекту.

База данных для RAG: где хранить знания — векторная БД, поиск или контекст

6 мин · · разработка

Для RAG не обязательно ставить векторную базу. Разбираем четыре способа хранить знания, считаем стоимость запроса и показываем рабочий пример на SQLite.

Нейросеть для написания скриптов: Bash, PowerShell и Python

5 мин · · разработка

Модель быстро пишет скрипты для рутины, но запускать их вслепую нельзя. Показываем, как ставить задачу, требовать безопасный режим dry-run и проверять результат до запуска.

LangChain agents: инструменты, цикл и ограничение расходов

5 мин · · агенты

Собираем агента на create_agent с двумя инструментами и запускаем на модели через OpenAI-совместимый шлюз. Показываем, как ограничить число шагов и считать токены.

Документация OpenAI API на русском: Chat Completions по параметрам

5 мин · · разработка

Короткий справочник по эндпоинту Chat Completions на русском. Каждый параметр с примером, формат ответа и usage, особенности работы через шлюз и расчёт стоимости одного ответа.

Claude Code Router: нужен ли он, если шлюз понимает Anthropic-формат

6 мин · · агенты

Claude Code Router появился, чтобы натравить Claude Code на модели других поставщиков. Если шлюз уже принимает Anthropic-формат, часть задач решается одной переменной.

Нейросеть для программирования игр: Unity, Godot и браузерные игры

6 мин · · разработка

Агент пишет скрипты, но не видит редактор движка. Разбираем, как построить игровой проект под ИИ, что отдавать агенту, а что делать руками, и сколько это стоит.

Dify в Docker: установка, первичная настройка и подключение моделей

6 мин · · разработка

Ставим Dify через Docker Compose, создаём администратора и подключаем модели Claude, GPT и DeepSeek по одному ключу. Отдельно — что делать, если контейнеры не стартуют.

Рефакторинг кода нейросетью: маленькими шагами и с тестами

5 мин · · разработка

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