Блог Zukko
Гайды по Claude Code, Cursor, Codex и API Claude и GPT: настройка, экономия токенов, разбор ошибок.
JetBrains AI Assistant: подключение в IntelliJ и PyCharm
4 мин · · IDE
JetBrains AI Assistant подключает сторонние ключи через раздел кастомных OpenAI-совместимых провайдеров — разбираем, куда именно вписывать адрес и модель.
Zed: настройка ИИ-ассистента на своём ключе
4 мин · · IDE
Zed настраивается через settings.json, и провайдер anthropic там ожидает адрес без /v1 — забытая деталь, которая превращается в постоянные 404 в панели ассистента.
Continue.dev: подключение к шлюзу
4 мин · · IDE
Continue.dev настраивается файлом config.yaml, а не формой в интерфейсе — из-за этого легко оставить старый apiBase или лишний слеш. Разбираем рабочий конфиг.
Roo Code: быстрая настройка за пять минут
4 мин · · IDE
Roo Code — форк Cline с почти идентичными настройками провайдера. Показываем самый короткий путь от установки расширения до первого рабочего запроса.
Cline: подключение к Claude и GPT через свой ключ
5 мин · · IDE
Cline умеет ходить и в Anthropic-режиме, и в OpenAI-режиме — от выбора провайдера зависит, какой base URL вписывать. Разбираем оба варианта и типичный 404 на старте.
Как получать строго структурированный JSON от модели
3 мин · · API
Просить модель «ответь в формате JSON» в системном промпте работает через раз. Разбираем способ понадёжнее — через tools с жёсткой схемой.
Почему модель отвечает медленно и что можно ускорить
4 мин · · производительность
Запрос выполняется десятки секунд вместо привычных двух-трёх. Разбираем, что из этого зависит от вас, а что — нет, и где искать реальный тормоз.
Ошибка 403 model_not_allowed_for_key
4 мин · · ошибки
Ключ рабочий, баланс есть, а модель отвечает 403. Разбираем, как список разрешённых моделей привязывается к конкретному ключу и как это поправить.
Ошибка 422 idempotency_conflict: что значит и как чинить
4 мин · · ошибки
Повторили запрос с тем же ключом идемпотентности, но с другим телом — и получили 422 вместо ожидаемого повтора ответа. Разбираем, что происходит.
Как посчитать стоимость запроса заранее через count_tokens
4 мин · · API
Перед тем как жечь баланс на длинный промпт, можно бесплатно узнать, во сколько токенов он обойдётся. Разбираем, как это сделать одним запросом.
allowed_models: как разрешить ключу только нужные модели
3 мин · · API-ключи
Ключ, который может вызвать любую модель из каталога, — лишняя свобода для интеграции, которой нужна ровно одна модель. Разбираем настройку allowed_models.
Как поставить дневной и месячный лимит на API-ключ
4 мин · · API-ключи
Один скомпрометированный или неправильно настроенный ключ не должен уметь потратить весь баланс за час. Разбираем, как это ограничить в кабинете.
Кэш ответов X-Zukko-Cache: когда запрос бесплатный
5 мин · · API
Одинаковый запрос от одного пользователя можно не оплачивать второй раз. Разбираем, как включается кэш и как проверить, сработал ли он.
Idempotency-Key: как ретраить запросы и не платить дважды
4 мин · · API
Таймаут на клиенте не значит, что запрос не выполнился на сервере. Заголовок Idempotency-Key решает это без ручной проверки истории.
Ошибка model_retired: модель сняли с обслуживания
4 мин · · ошибки
Модель, которая работала вчера, сегодня отвечает 400 с кодом model_retired. Разбираем, что это значит и как обработать это в коде, а не руками.
Claude Code с несколькими аккаунтами и ключами одновременно
4 мин · · Claude Code
Один Claude Code на несколько клиентов или проектов — это не про переключение учёток, а про разные ключи с разными лимитами на один и тот же гейтвей.
Почему цена через шлюз ниже официальной — как это работает
5 мин · · бизнес
Дело не в скидке ради скидки, а в том, что три конкретных механизма — оплата по факту, кэш и локальные платёжные рельсы — убирают лишние расходы из цепочки.
Как самому проверить, что списания по API считаются честно
5 мин · · API
Не нужно верить на слово — стоимость каждого запроса видна прямо в заголовках ответа, а история списаний доступна по курсору в любой момент.
Почему русский текст считается в токенах иначе, чем английский
4 мин · · модели
Одна и та же фраза на русском и английском стоит по-разному не потому, что кто-то накручивает счётчик, а потому, что токенизатор режет кириллицу иначе.
Claude или GPT для ИИ-агента с инструментами — что выбрать
4 мин · · модели
У обеих линеек есть vision, extended thinking и контекст 1M — разница не в характеристиках, а в том, как агент вызывает инструменты и что происходит, когда шаг цикла падает.
Несколько проектов на одном аккаунте: как не запутаться
4 мин · · API-ключи
Баланс на аккаунте один, а проектов пять. Как разложить это так, чтобы в конце месяца было видно, кто сколько потратил, а не гадать по общей сумме.
Зачем заводить отдельный API-ключ на каждый проект
5 мин · · API-ключи
Один ключ на все проекты — это пять минут экономии сейчас и путаница при первом же инциденте. Что именно даёт разделение ключей по проектам.
Мониторинг расхода в реальном времени по заголовкам ответа
4 мин · · API
Не нужно ждать отчёта за сутки, чтобы узнать, сколько стоил запрос — цена и остаток баланса приходят в заголовках каждого обычного (не потокового) ответа. Как это использовать.
Безопасное хранение API-ключей: практики, а не только советы
4 мин · · безопасность
«Не коммить ключи в git» слышали все. Разбираем, что делать дальше: лимиты на ключ, ограничение моделей и план действий, если ключ всё же утёк.