Cline в VS Code: как подключить Claude из России

Короткий ответ: расширение ставится из Marketplace как любое другое, а всё, что блокируется из России, лечится на одном экране настроек. Нужно выбрать провайдера Anthropic, вставить свой API-ключ и подменить адрес API на прокси, который работает без VPN и принимает оплату в рублях. Три поля — и агент отвечает. Ниже разберём каждый шаг и ошибки, на которых обычно застревают.

Что такое Cline и почему он не подключается «из коробки»

Cline — расширение с открытым исходным кодом, которое добавляет в VS Code полноценного агента. Работает он не как автодополнение: вы формулируете задачу словами, агент сам открывает нужные файлы, показывает план, предлагает конкретные правки в виде диффа и просит подтверждение перед каждым действием — включая запуск команд в терминале. Отдельно он умеет подключать внешние инструменты по протоколу MCP, так что к агенту можно прицепить базу данных, трекер или собственный сервис.

Само расширение бесплатное, и это важно понимать правильно: платите вы не за Cline, а за модель, к которой он ходит. Своей модели у расширения нет вообще — это оболочка поверх чужого API. Провайдера вы выбираете сами, и поддерживается их много: Anthropic и OpenAI напрямую, OpenRouter, Google, локальные варианты вроде Ollama.

Вот тут из России всё и упирается. Зарегистрироваться в Anthropic и пополнить баланс без зарубежной карты не выйдет, а прямой запрос к их API из российского IP вернёт отказ ещё до того, как дело дойдёт до оплаты. Локальные модели денег не просят, но агентский цикл — прочитать файлы, составить план, выполнить его по шагам — нагружает модель гораздо сильнее, чем обычный чат: на слабой локальной модели агент начинает терять нить задачи и переспрашивать.

Поэтому люди и приходят с запросами «cline не работает» и «cline в россии», хотя расширение исправно. Не работает доступ к модели, и чинится это в настройках провайдера.

Установка расширения

Marketplace VS Code доступен из России без ухищрений — блокировки касаются API моделей, а не каталога расширений. Поэтому шаг самый простой.

1. Откройте VS Code и перейдите в Extensions: Ctrl+Shift+X, на macOS Cmd+Shift+X.
2. Наберите в поиске Cline.
3. Установите расширение от издателя Cline — в выдаче рядом будут форки вроде Roo Code и Kilo Code, не перепутайте.
4. В левой панели появится иконка Cline, она открывает чат с агентом.

Если иконка не появилась, перезагрузите окно редактора: Ctrl+Shift+P, затем команда Developer: Reload Window.

Дальше агент попросит выбрать провайдера и дать ключ — это и есть единственный по-настоящему содержательный шаг.

Подключение моделей Claude через провайдера Anthropic

Где взять API-ключ и Base URL

Понадобятся две вещи: ключ и адрес, который этот ключ принимает. Обе выдаёт AI для кода — сервис PurpleSchool, который проксирует запросы к моделям, работает из России без VPN и берёт оплату в рублях.

Адрес для клиентов, говорящих на протоколе Anthropic:

https://app.purpleschool.ru/api-v2/public/ai-proxy/anthropic

Тарифы на момент публикации: «Помощник» — 499 ₽/мес, «Напарник» — 1 199 ₽/мес, «Соавтор» — 2 499 ₽/мес, отмена в любой момент. Если вы раньше пробовали получить ключ напрямую у Anthropic и застряли на оплате, разбор способов есть в отдельной статье про API-ключ Claude из России.

Заполняем настройки провайдера в Cline

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

1. Откройте панель Cline и перейдите к настройкам через иконку шестерёнки в её верхней части.
2. В списке провайдеров выберите Anthropic.
3. В поле API Key вставьте ключ из сервиса.
4. Разрешите использовать собственный адрес API — рядом с полем адреса есть отдельный переключатель. После его включения станет доступно поле Base URL, вставьте туда адрес из блока выше.
5. Выберите любую доступную модель Claude из списка и сохраните настройки.

Адрес вставляйте ровно как есть: без завершающего слэша и без дописанного вручную /v1. Суффикс /v1 относится к OpenAI-совместимому адресу, у Anthropic-адреса его быть не должно — именно на этом чаще всего и ломается первое подключение.

Проверить связку проще всего живой задачей: откройте любой проект и попросите агента объяснить, что делает конкретный файл. Ответ пришёл — всё настроено.

Альтернатива: OpenAI-совместимый провайдер

Если переключатель собственного адреса у провайдера Anthropic недоступен или вам просто удобнее второй путь, тот же сервис отдаёт OpenAI-совместимую точку входа. Cline поддерживает её как отдельного провайдера.

1. В списке провайдеров выберите OpenAI Compatible.
2. В поле Base URL вставьте адрес:

https://app.purpleschool.ru/api-v2/public/ai-proxy/openai/v1

3. В API Key вставьте тот же самый ключ.
4. В поле идентификатора модели впишите модель из доступных на вашем тарифе.

Здесь /v1 обязателен — это часть OpenAI-совместимого контракта, без него клиент соберёт неправильные пути и получит 404.

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

Почему на странице сервиса инструкция для JetBrains, а не для VS Code

Момент, который сбивает с толку. У сервиса есть команда автонастройки:

npx @purpleschool/ai-for-code

Она прописывает конфиги сама, но только для клиентов с готовой инструкцией на странице. Cline в этом списке есть — и подписан он как «Cline (JetBrains)». То есть официальные шаги у сервиса описаны для плагина под IDE от JetBrains, а не для расширения под VS Code.

Выглядят они так: поставить плагин через File → Settings → Plugins → Marketplace, открыть настройки по пути

File → Settings → Tools → Cline

выставить провайдера Anthropic, вставить ключ в поле API Key, указать тот же Base URL и выбрать модель.

Сравните с разделом выше — набор полей идентичен. Cline в обеих сборках использует одну и ту же модель настройки провайдера, отличается только путь до экрана: в JetBrains это пункт меню Settings, в VS Code — шестерёнка на панели расширения. Так что отсутствие строчки «Cline (VS Code)» на странице сервиса ничего не значит для работоспособности: ключ и адрес те же самые. Руками вы сделаете ровно то, что автонастройка делает для JetBrains-версии.

Частые ошибки подключения

403. Запрос дошёл, но доступ не дали. Проверьте по очереди: активна ли подписка, тот ли ключ вставлен, доступна ли выбранная модель на вашем тарифе. Если до этого провайдер смотрел на Anthropic напрямую, убедитесь, что адрес реально переписан на прокси: запрос к зарубежному API с российского адреса упрётся именно в эту ошибку.

401. Ключ не распознан. Обычно это обрезанная при копировании строка, лишние пробелы по краям или остаток старого значения в поле. Очистите поле полностью и вставьте ключ заново.

404. Неверный путь. Смотрите на /v1: для Anthropic-адреса его быть не должно, для OpenAI-совместимого он обязателен. Заодно проверьте, что в конце адреса нет лишнего слэша.

Список моделей пришёл пустым. Значит запрос до прокси не дошёл, и модель тут ни при чём — возвращайтесь к ключу и адресу. Правильный порядок такой: сначала сохранить ключ с адресом, и только потом открывать список моделей.

Агент не видит файлы. Это не про доступ к API. Cline работает с открытой папкой: если в редакторе открыт одиночный файл, читать агенту нечего. Откройте директорию проекта: File → Open Folder.

Расширение предлагает войти в аккаунт. При ручной настройке провайдера вход не нужен, запросы идут через ваш ключ. Закройте предложение и проверьте, что в настройках выбран именно ваш провайдер, а не встроенный шлюз.

Cline, Kilo Code или Claude Code — что выбрать

Cline, Kilo Code и Roo Code — одно семейство, форки с общим предком. Подключаются они одинаково: провайдер, ключ, адрес, модель. Если вы настроили одно, второе займёт минуту, и выбирать между ними стоит по интерфейсу и режимам работы, а не по доступу к моделям — здесь они равны. Отдельный разбор форка есть в статье про Kilo Code в VS Code.

С Claude Code разница принципиальнее. Это инструмент от самой Anthropic, он живёт в терминале и подключается переменными окружения, а в VS Code приходит отдельным расширением. Cline при этом остаётся редакторным агентом с наглядным подтверждением каждой правки. Как устроен второй вариант, показано в статье про Claude Code и Codex в VS Code.

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

Итоги

Весь путь укладывается в три действия: установить расширение, переключить провайдера на Anthropic и заполнить два поля — ключ и адрес прокси. Ломается на этом пути обычно одно из двух полей, поэтому и диагностика короткая — сверить ключ и проверить, что /v1 стоит там, где нужен, и отсутствует там, где не нужен.

Ключ, который принимает оплату в рублях и не требует VPN, выдаёт AI для кода. Он один на все агенты сразу — тот же ключ подойдёт и для Cline, и для Claude Code, и для Codex, так что сменить инструмент потом можно без перенастройки доступа.