Cline — Интеграция с Ручкой

Cline — AI-агент для VS Code с поддержкой OpenAI-совместимых провайдеров. Ручка подключается за 30 секунд: одна строка baseUrl, рублёвый биллинг, закрывающие документы для юрлица.

Зачем Ручка для Cline

Без VPN — api.ruchka.dev резолвится в российский IP, h3llo.cloud РФ дата-центр.
Без иностранной карты — оплата картой РФ, СБП или по счёту для юрлица.
Закрывающие документы — акт + счёт каждый месяц, ПЭП по 63-ФЗ.
Промпты не пишутся в логи — архитектурно (disable_spend_logs:true + zero-retention callback).

Предварительные требования

VS Code 1.85+
Расширение Cline
API-ключ (sk-ruchka-...) — на раннем доступе выдаём в @ruchkadev_bot

Быстрый старт (30 секунд)

Открой VS Code → Extensions → Cline → Settings (шестерёнка в панели Cline).
Выбери API Provider: OpenAI Compatible.
Заполни поля. Если редактируешь ~/.cline/settings.json напрямую:

{
  "apiProvider": "openai",
  "openAiBaseUrl": "https://api.ruchka.dev/v1",
  "openAiApiKey": "sk-ruchka-YOUR_KEY_HERE",
  "openAiModelId": "kimi-k2.6"
}

Нажми Save → переключись на вкладку Cline → задай первый вопрос.

Проверка подключения

До того как гонять Cline — проверь ключ напрямую через curl:

curl https://api.ruchka.dev/v1/chat/completions \
  -H "Authorization: Bearer sk-ruchka-YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"model": "kimi-k2.6", "messages": [{"role": "user", "content": "Привет"}]}'

Ответ 200 + JSON с choices[0].message.content = всё работает. 401 = проверь ключ.

Рекомендованные модели для Cline

Cline хорошо работает с большим контекстом (он читает много файлов). Выбор модели под задачу:

Модель	Лучше для	Контекст
claude-sonnet-4.6	Агентные цепочки, tool use, большие рефакторинги	200K
gpt-5.1-codex	Код-задачи и tool-calling	400K
kimi-k2.6	Сложные многошаговые задачи, рефакторинг по проекту	128K
deepseek-v4-flash	Быстрые итерации, точечные правки	64K
deepseek-v4-pro	Глубокий анализ, длинные цепочки рассуждений	64K
qwen-3.6-coder	Специализирован под код, autocomplete-стиль	32K
glm-4.6	Баланс скорость/качество для daily-driver	128K
gemma	Дешёвые короткие запросы, коммит-месседжи	8K

Цены ₽/1M токенов — в каталоге на ruchka.dev: списывается ровно цена каталога. Состояние сервисов и история инцидентов → status.ruchka.dev.

Совет: держи kimi-k2.6 для основной работы, переключайся на deepseek-v4-flash когда нужны быстрые мелкие правки — Cline позволяет менять модель в настройках без перезапуска.

Конфигурация по файлу проекта

Создай .cline/settings.json в корне проекта (перекрывает глобальные настройки) — удобно когда разные проекты на разных моделях:

{
  "apiProvider": "openai",
  "openAiBaseUrl": "https://api.ruchka.dev/v1",
  "openAiApiKey": "${env:RUCHKA_API_KEY}",
  "openAiModelId": "kimi-k2.6"
}

Ключ через переменную окружения (не коммить ключ в git):

export RUCHKA_API_KEY=sk-ruchka-YOUR_KEY_HERE

Добавь .cline/settings.json в .gitignore если в нём остаётся литеральный ключ.

Ограничения и лимиты (rate limits)

По умолчанию запросы не ограничены по частоте — Ручка делает fallback на резервный upstream при throttle.
Spend-cap ставится в настройках кабинета → «Лимит расходов» (на ключ или организацию).
При нулевом балансе ключ автоматически приостанавливается — пополни через /billing.

Устранение проблем

401 Unauthorized — неверный или отозванный ключ. Проверь, что openAiApiKey начинается с sk-ruchka- и скопирован целиком из кабинета.

429 Too Many Requests — upstream throttle. Ручка автоматически делает fallback на резервный upstream; если повторяется — напиши в @ruchkadev_bot.

503 Service Unavailable + {"error":"stealth_launch"} — Ручка в режиме закрытого запуска (stealth). Доступ выдаётся вручную founding-команде. Связь: @ruchkadev_bot.

Медленный ответ — для коротких задач переключись с kimi-k2.6 на deepseek-v4-flash или gemma: latency p95 в ~2 раза ниже.

Cline не видит модель / model not found — openAiModelId должен точно совпадать с ID из каталога: строчные буквы, дефисы (kimi-k2.6, не Kimi K2.6).

Пустой ответ / обрыв стрима — проверь, что openAiBaseUrl оканчивается на /v1 (без слеша в конце), а не на /v1/ или корень домена.

Нет VPN. Нет иностранной карты.

Ручка работает через h3llo.cloud (РФ дата-центр, 152-ФЗ). DNS: ruchka.dev → российский IP, без Cloudflare-проксирования на hot-path. Платежи через YooKassa и СБП. Закрывающие документы (акт + счёт) формируются каждый месяц автоматически.

Что-то не работает или нужна расширенная настройка? Пиши в @ruchkadev_bot — отвечаем быстро.