Cline: подключение к Claude и GPT через свой ключ

Cline — расширение для VS Code, которое можно подключить к любому совместимому API вместо официального аккаунта Anthropic или OpenAI. У него в настройках есть два независимых провайдера с похожими именами моделей, и именно поэтому чаще всего путают base URL.

Какой провайдер выбрать

В панели Cline нажмите на шестерёнку и откройте API Configuration. В списке API Provider два варианта нам подходят:

• Anthropic — если хотите модели Claude через Anthropic-совместимый протокол (/v1/messages).
• OpenAI Compatible — если хотите GPT, GLM или тот же Claude, но через /v1/chat/completions.

Это разные протоколы с разным телом запроса, и base URL у них тоже разный:

• Anthropic-провайдер: https://api.zukko.pro — без /v1, Cline сам допишет путь.
• OpenAI Compatible: https://api.zukko.pro/v1 — с суффиксом.

Перепутанный суффикс — самая частая причина 404 при первом подключении: ключ принят, но каждый запрос улетает на несуществующий путь.

Настройка через Anthropic-провайдер

1. API Provider: Anthropic.
2. Anthropic API Key: ваш ключ вида fetch_... из кабинета https://zukko.pro/app/api-keys↗.
3. Use custom base URL — включить, вписать https://api.zukko.pro.
4. Model: claude-sonnet-5 или claude-opus-5-5 (Claude Opus 5.5; у обеих контекст 1,000,000 токенов и приём изображений).

Ключи показываются один раз при создании — если не уверены, что скопировали правильный, проще выпустить новый в кабинете, чем гадать.

Настройка через OpenAI Compatible

1. API Provider: OpenAI Compatible.
2. Base URL: https://api.zukko.pro/v1.
3. API Key: тот же fetch_....
4. Model ID: например gpt-5.6-sol, gpt-5.6-luna, glm-5.3 или glm-5.3-flash (актуальный список — GET https://api.zukko.pro/v1/models).

Так проще всего перебирать модели разных семейств без переключения провайдера — достаточно поменять Model ID.

Проверка ключа в обход Cline

Прежде чем разбираться, почему Cline не отвечает, проверьте ключ напрямую — это отсекает половину гипотез:

curl https://api.zukko.pro/v1/chat/completions \
  -H "Authorization: Bearer fetch_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"ping"}]}'

Если curl отвечает, а Cline — нет, дело в настройках расширения (не тот провайдер, лишний пробел в поле Base URL, старый кэш конфигурации). Если не отвечает и curl, ошибка в ответе точно скажет, что чинить.

Как читать типичные ошибки

• 401 — ключ не принят: {"error":{"message":"Invalid API key. Use Authorization: Bearer fetch_*","type":"authentication_error"}}. Проверьте, что ключ не обрезан и без пробела в конце.
• 402 — баланс пуст: {"error":{"message":"Недостаточно средств на балансе","code":"insufficient_balance"}}. Проверка баланса происходит до похода к модели, так что неудачная попытка ничего не стоит.
• 404 model_not_found — опечатка в Model ID. Список актуальных id без ключа: curl https://api.zukko.pro/v1/models.
• 400 model_retired — модель сняли с обслуживания, в ответе указана замена.
• 503 model_disabled — модель выключена в каталоге; выберите другую из /v1/models.
• 429 — от Zukko это только лимит конкретного ключа (key_daily_limit_reached со сбросом в 00:00 UTC / key_monthly_limit_reached), если вы задавали лимит на странице ключа в кабинете; общего rate limit на шлюзе нет, прочие 429 приходят от провайдера модели.

Полезные детали, которые пригодятся именно в IDE-режиме

Cline при агентной работе делает много последовательных запросов подряд, и расход по ним стоит отслеживать. Учтите: Cline получает ответы потоково (stream: true), а заголовки стоимости X-Zukko-Cost-Micros и X-Fetch-Balance-Cents приходят только в обычных (не потоковых) JSON-ответах. Поэтому для Cline:

• расход по запросам — в кабинете («Использование») или через GET /v1/usage;
• остаток баланса — GET /v1/balance (поле balance_cents).

Если Cline зависает на середине ответа при длинной генерации, это почти всегда не лимит по токенам, а таймаут сетевого клиента или маленький max_tokens — стоит проверить оба параметра, а не искать проблему в биллинге. Обрыв при этом не останавливает списание: шлюз дочитывает ответ провайдера и списывает всю генерацию.

Пополнить баланс можно СБП, картой через PayPear, криптой или иностранной картой Mastercard EU через Fride (комиссия около 13%, суммы $2–$594); минимальное пополнение — $1. Разово начисляется $0.50 за подписку на Telegram-канал @zukkopro↗ — привяжите Telegram в кабинете, подпишитесь и нажмите «Проверить» (один раз на Telegram-аккаунт). Стартового баланса при обычной регистрации нет.

Если после всех проверок Cline всё равно молчит — быстрее всего описать симптом в поддержке: https://t.me/zukkopro?direct↗.

Оценить стоимость задачи заранее

Прежде чем запускать в Cline длинную агентную задачу с чтением десятков файлов, можно бесплатно узнать её вес в токенах — эндпоинт /v1/messages/count_tokens считает токены, не выполняя сам запрос и не списывая деньги:

curl https://api.zukko.pro/v1/messages/count_tokens \
  -H "Authorization: Bearer fetch_ваш_ключ" \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"текст задачи для Cline"}]}'

Это полезно, если Cline собирается прочитать большой файл контекста целиком — лучше заранее понимать, во сколько токенов это выльется, чем упереться в лимит контекста на середине выполнения.

Веб-поиск для моделей без него

Не у всех моделей в каталоге есть встроенный поиск в интернете. Если задача в Cline требует свежих данных, а выбранная модель (например, GLM) не ищет в сети сама, можно вызвать POST /v1/web-search тем же ключом отдельно от основного диалога и подставить результат в промпт вручную.

История расходов и совместная работа

Полную историю списаний можно поднять через GET /v1/usage — ответ с курсорной пагинацией, удобно смотреть, на что ушёл бюджет за день интенсивной работы с Cline. История там общая на весь аккаунт (все ключи вместе, фильтра по ключу нет), и баланс тоже один на аккаунт. Если ключ используется несколькими людьми в команде, не забудьте про лимиты на странице ключа в кабинете — иначе один длинный агентный прогон может съесть весь дневной бюджет остальных. Заодно стоит заглянуть в реферальную программу: 10% с пополнений приглашённых коллег начисляются на баланс автоматически.