Блог Zukko

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

Перевод i18n файлов нейросетью без сломанных плейсхолдеров

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

Скрипт, который переводит i18n-файлы через API, сохраняет {name}, %s и ICU-формы и откладывает сомнительные строки на ручную проверку.

Few-shot промптинг: примеры в запросе вместо долгих объяснений

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

Few-shot — несколько примеров правильного ответа прямо в промпте. Разбираем, когда это помогает, как оформлять примеры и как посчитать, окупаются ли они.

10 промптов для программиста: от code review до миграции БД

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

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

Как писать правила Cursor в .cursor/rules и не тратить токены зря

4 мин · · IDE

Правила Cursor — постоянные инструкции для агента. Разбираем формат .mdc, четыре режима применения, примеры и то, как правила влияют на размер каждого запроса.

AGENTS.md для Codex CLI: что это за файл и как его писать

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

AGENTS.md — обычный Markdown с инструкциями для агента: команды сборки, тесты, стиль кода. Разбираем, как Codex находит такие файлы и что в них писать.

Claude Code на удалённом сервере по SSH: установка, ключ и tmux

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

Claude Code — терминальный агент, ему не нужен графический интерфейс. Разбираем установку на сервер, авторизацию ключом Zukko, работу в tmux и защиту ключа.

Claude Code в CI/CD: неинтерактивный режим -p и GitHub Actions

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

Claude Code умеет работать без интерфейса: принимает задачу в -p, выполняет и завершается. Разбираем флаги из документации и рабочий workflow для ревью pull request.

Claude Code на Windows: установка нативно или в WSL и настройка Zukko

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

Claude Code работает на Windows нативно и в WSL. Разбираем официальные способы установки, Git Bash, переменные окружения для Zukko и типичные ошибки.

MCP-серверы в Claude Code: подключение GitHub, баз данных и своих API

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

MCP подключает к Claude Code внешние инструменты: GitHub, базы данных, внутренние API. Разбираем команды, области настройки и влияние на расход токенов.

Субагенты в Claude Code: как делегировать задачи и беречь контекст

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

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

Хуки Claude Code: запуск скриптов до и после действий агента

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

Хуки запускают ваши скрипты на событиях Claude Code: форматируют код после правок, блокируют опасные команды, шлют уведомления. Разбираем схему настройки по официальной документации.

Tool use в Claude: полный цикл вызова инструментов на Python

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

Tool use позволяет Claude вызывать функции вашего кода. Разбираем цикл целиком: описание инструментов, параллельные вызовы, ошибки и ограничения.

Переезд с OpenRouter на Zukko: что поменять в коде и конфигах

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

Переезд с OpenRouter на OpenAI-совместимый API Zukko — это адрес, ключ и названия моделей. Разбираем каждую замену, специфичные параметры OpenRouter и план выката.

Qwen Code CLI с моделями Claude, GPT и GLM через Zukko

4 мин · · IDE

Qwen Code работает не только с моделями Qwen: он поддерживает OpenAI-совместимые API, поэтому через Zukko в нём доступны Claude, GPT и GLM.

Настроить OpenClaw с Zukko — выбор провайдера и конфиг

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

OpenClaw подключается к Zukko как собственный провайдер. Разбираем два варианта API, готовые конфиги openclaw.json и типичные ошибки.

Claude Code в VS Code — расширение и встроенный терминал

5 мин · · IDE

Claude Code работает в VS Code и как расширение с графической панелью, и как CLI во встроенном терминале. Оба читают один settings.json — настраиваем Zukko один раз.

Классификация обращений клиентов нейросетью: пример на Python

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

Обращения в поддержку, жалобы, предложения — одни идут к технической команде, другие к продукту, третьи в архив. Показываем, как это делает нейросеть.

Генерация SQL запросов нейросетью: пример на Python

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

Пользователь пишет вопрос обычными словами, модель генерирует SQL. Передаём схему в промпт и проверяем запрос перед запуском.

Интеграция нейросети в Django: вьюхи, стриминг, Celery и учёт затрат

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

Подключаем модель к Django-проекту: клиент OpenAI SDK, вьюха с кэшем, потоковый ответ, долгие задачи в Celery и таблица расходов в админке. С разбором типичных ошибок.

Next.js Route Handler для нейросети: стриминг ответа в App Router

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

Пишем app/api/chat/route.ts, который стримит ответ модели через OpenAI SDK, и клиентский компонент, который выводит текст по мере генерации. Ключ остаётся на сервере.

Чат с нейросетью на Streamlit: стриминг, история и настройки

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

Собираем чат-приложение на Streamlit: история в session_state, потоковый вывод через st.write_stream, выбор модели в боковой панели, ключ в secrets.toml и расход по usage.

Стриминг ответа нейросети в Node.js Express через OpenAI SDK

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

Рабочий Express-эндпоинт, который получает поток от модели через OpenAI SDK и пересылает его в браузер по SSE. Плюс фронтенд на fetch, отмена запроса и разбор ошибок.

API-ключ в Docker: как передать безопасно и не запечь в образ

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

Ключ в Dockerfile остаётся в слоях образа навсегда. Разбираем env_file, секреты Compose, секреты при сборке, .dockerignore и проверку образа — с примерами для ключа Zukko.

Как нейросеть ищет баги на скриншотах: анализ UI для QA

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

Playwright снимает экран, модель с поддержкой изображений возвращает JSON с опечатками, наложениями и пропавшими элементами. Код на Python, промпт и честный расчёт стоимости.