Блог Zukko
Гайды по Claude Code, Cursor, Codex и API Claude и GPT: настройка, экономия токенов, разбор ошибок.
Как отлаживать запросы к 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 их больше нет и чем их заменить.
Как написать CLAUDE.md — инструкции для Claude Code
4 мин · · разработка
CLAUDE.md — файл инструкций, который Claude Code загружает в начале каждой сессии. Разбираем, что в нём писать и как не переплачивать за контекст.
Анализ отзывов нейросетью: от CSV к выводам на Python
3 мин · · разработка
Загружаете CSV с отзывами, дешёвая модель размечает каждый, pandas считает статистику, второй запрос пишет отчёт. Полный цикл от данных к выводам.
Распознать чек со скриншота нейросетью: пример на Python
4 мин · · разработка
Пользователь фотографирует чек, модель читает дату, сумму и позиции. Показываем, как отправить изображение в запросе и получить структурированные данные.
Модерация комментариев нейросетью: пример на Python
3 мин · · разработка
Спам, оскорбления, реклама, нормальные комментарии — нейросеть раскладывает их по ярлыкам, а спорные отдаёт модератору. Показываем код и считаем стоимость.
Python: параллельные запросы к Claude через AsyncOpenAI
4 мин · · разработка
Как обработать тысячи текстов параллельно и не упереться в лимиты: AsyncOpenAI, семафор, повторы, остановка при нулевом балансе и учёт стоимости.
FastAPI: проксирование потока ответа Claude через SSE
4 мин · · разработка
Как отдать ответ модели в браузер по мере генерации: FastAPI держит ключ на сервере, а фронтенд получает текст через SSE.
Spring AI: подключение Claude API к OpenAI провайдеру
4 мин · · разработка
Spring AI работает с Claude и GPT через OpenAI-модуль. Главное — правильно указать base-url: в Spring AI 1.x и 2.x он разный.
Claude API в PHP: Guzzle и curl для обращения к Zukko
4 мин · · разработка
Как обращаться к Claude и GPT из PHP: Guzzle, встроенный curl, разбор ошибок, стриминг и интеграция в Laravel.