Блог Zukko
Гайды по Claude Code, Cursor, Codex и API Claude и GPT: настройка, экономия токенов, разбор ошибок.
API-ключ в Docker: как передать безопасно и не запечь в образ
5 мин · · разработка
Ключ в Dockerfile остаётся в слоях образа навсегда. Разбираем env_file, секреты Compose, секреты при сборке, .dockerignore и проверку образа — с примерами для ключа Zukko.
Как нейросеть ищет баги на скриншотах: анализ UI для QA
4 мин · · разработка
Playwright снимает экран, модель с поддержкой изображений возвращает JSON с опечатками, наложениями и пропавшими элементами. Код на Python, промпт и честный расчёт стоимости.
Ошибка 503 model_disabled: что это и как её обработать
4 мин · · ошибки
model_disabled значит, что конкретная модель сейчас выключена, а не что упал весь сервис. Как найти замену, переключить IDE и написать код с запасной моделью.
Как отлаживать запросы к API нейросети: от curl до кодов ошибок
5 мин · · разработка
Чаще всего проблема не в модели, а в запросе: адрес, ключ, лимит, размер тела. Пошаговый порядок отладки и таблица кодов ошибок Zukko с решениями.
/v1/responses или /v1/chat/completions: какой API использовать
4 мин · · API-ключи
Два OpenAI-совместимых эндпоинта с разной формой запроса и ответа. В Zukko Chat Completions работает со всеми моделями, Responses — с Claude и GPT.
Чат в браузере или API: что выбрать для своей задачи
5 мин · · API-ключи
Чат в браузере удобен для ручной работы, API — для автоматизации. Цены за токены одинаковые, а разница — в контроле, истории и в том, как растёт стоимость диалога.
Генерация тестовых данных нейросетью: схема, валидация и фикстуры
5 мин · · разработка
Когда тестовые данные стоит генерировать нейросетью, а когда хватит Faker. Скрипт на Python с валидацией pydantic, батчами, фикстурами для pytest и расчётом стоимости.
PowerShell и Claude API: Invoke-RestMethod, кириллица и стриминг
5 мин · · разработка
Как вызывать Claude из PowerShell так, чтобы кириллица не ломалась ни в запросе, ни в ответе: готовая функция для 5.1 и 7, обработка ошибок HTTP, параллельные запросы и стриминг через HttpClient.
Bash, curl и jq: запросы к нейросети Claude прямо из скриптов
5 мин · · разработка
Готовая библиотека из трёх функций для вызова Claude из shell: сборка JSON через jq, чтение из пайпа, стриминг без лишних утилит, обработка HTTP-ошибок и пакетная обработка файлов.
Rust и async-openai: подключаем Claude через OpenAI-совместимый API
4 мин · · разработка
Как подключить Claude к Rust-приложению: async-openai с with_api_base, флаг chat-completion, стриминг, ограничение параллельности и обработка ошибок. Вариант на reqwest для минимума зависимостей.
Claude API в C# и .NET: HttpClient, OpenAI SDK и ASP.NET Core
4 мин · · разработка
Подключаем Claude к .NET-приложению двумя способами: голый HttpClient и официальный пакет OpenAI. Стриминг, обработка ошибок, таймауты и минимальный API на ASP.NET Core.
ИИ-ревью кода в GitLab CI: комментарий к merge request через API
5 мин · · разработка
Job в GitLab CI получает diff merge request, отправляет его в Claude через Zukko и оставляет в MR комментарий с замечаниями, обновляя его при каждом пуше.
Автоматизация Notion через API: сводки и теги для базы с помощью Claude
5 мин · · автоматизация
Скрипт на Python читает записи базы Notion, получает от Claude сводку и теги и записывает их в свойства страницы. С учётом data sources и лимитов Notion API.
Генерация текстов в WordPress через API: плагин с кнопкой в редакторе
4 мин · · разработка
Небольшой плагин для WordPress: REST-маршрут вызывает Claude через wp_remote_post, а панель в редакторе блоков вставляет сгенерированный текст в запись.
Бот ВКонтакте с нейросетью: Bots Long Poll API и Claude на Python
5 мин · · разработка
Собираем бота для сообщества ВКонтакте, который отвечает через Claude: настройка сообщества, Bots Long Poll API, учёт расходов по usage и полный код.
Telegram-бот на aiogram 3 с Claude через API-шлюз
5 мин · · разработка
Собираем Telegram-бота на aiogram 3, который отвечает через Claude: роутеры, история диалога, ChatActionSender, обработка ошибок и полный рабочий код.
Как тестировать промпты: простой eval harness на Python
4 мин · · разработка
«У меня работает» — не проверка. Собираем небольшой скрипт, который прогоняет промпт на наборе примеров и нескольких моделях и показывает, стало ли лучше.
Логирование LLM-запросов без утечки персональных данных
4 мин · · разработка
Логи нужны для отладки и учёта расходов, но в запросах к модели часто есть личные данные. Показываем, что логировать, как маскировать и как хранить.
Temperature и top_p: что это, что крутить и где их больше нельзя задать
4 мин · · разработка
Temperature и top_p управляют разнообразием ответов. Объясняем, как они работают, почему у новых Claude их больше нет и чем их заменить.
Как узнать список доступных моделей через API и не сломаться при их смене
3 мин · · модели
Каталог моделей меняется: появляются новые, старые отключаются. Показываем, как запросить актуальный список и написать код, который переживёт смену модели.
GPT-5.6 Luna: когда хватит недорогой модели для массовых задач
5 мин · · модели
Для массовой классификации и извлечения данных важна цена за запрос. Считаем, сколько стоит Luna на реальных объёмах, и показываем, как проверить её на своих данных.
Как написать CLAUDE.md — инструкции для Claude Code
4 мин · · разработка
CLAUDE.md — файл инструкций, который Claude Code загружает в начале каждой сессии. Разбираем, что в нём писать и как не переплачивать за контекст.
Анализ отзывов нейросетью: от CSV к выводам на Python
3 мин · · разработка
Загружаете CSV с отзывами, дешёвая модель размечает каждый, pandas считает статистику, второй запрос пишет отчёт. Полный цикл от данных к выводам.
Распознать чек со скриншота нейросетью: пример на Python
4 мин · · разработка
Пользователь фотографирует чек, модель читает дату, сумму и позиции. Показываем, как отправить изображение в запросе и получить структурированные данные.