Руководство по настройке

Руководство по настройке провайдера

Инструкции по настройке и устранению неполадок по инструментам.

Настройка VS Code

VS Code — это редактор кода, а не провайдер моделей. Когда вы используете Claude, GPT, Gemini или модели через провайдеров в VS Code, это обычно происходит через такие расширения, как Cline, Continue или GitHub Copilot; указывать API-ключ (Key), Base URL и название модели нужно непосредственно в настройках конкретного расширения.

Сначала разберём три базовых понятия

VS CodeЭто просто среда для написания кода, отвечающая за открытие проектов, редактирование файлов и установку расширений.
AI-расширенияРасширения вроде Cline, Continue, Copilot и др. отвечают за отправку ваших запросов и контекста кода модели, а также за вывод ответов обратно в VS Code.
Источники моделейClaude, GPT, Gemini, совместимые с OpenAI сторонние провайдеры, локальные модели и т. д. — всё это источники моделей; возможность их использования зависит от поддержки выбранным расширением.
Поэтому эта страница не посвящена «настройке только через Cline / Roo Code». Точнее сказать так: в VS Code вы выбираете AI-расширение, а затем внутри него настраиваете подключение к Claude, GPT, Gemini или OpenAI-совместимым сервисам.

Как выбрать источник модели

Что вы хотите использовать?Как обычно выбирается провайдер?Как заполнять Key / Base URLДля каких задач подходит
ClaudeAnthropic / ClaudeУкажите ключ Anthropic Key; если вы используете стороннего провайдера, выберите OpenAI Compatible или пользовательский вариант по инструкции провайдера.Отлично подходит для понимания и модификации кода, а также работы с большими контекстами.
GPT / OpenAIOpenAIВведите ключ OpenAI Key; при прямом официальном подключении менять Base URL обычно не нужно, адрес API указывается только при работе через провайдера/прокси.Подходит для ответов на общие вопросы, объяснения кода и внесения небольших правок.
Сторонний AI-провайдер / агрегаторOpenAI Compatible / Custom ProviderСкопируйте Key, Base URL и Model ID в точности так, как указано в панели управления провайдера; некоторые Base URL включают /v1, а некоторые нет — ориентируйтесь на панель.Подходит начинающим и тем, кому нужен единый доступ сразу к нескольким моделям.
Gemini / Другие моделиGoogle Gemini или соответствующий провайдерУкажите ключ API соответствующей платформы; Base URL заполняется только в том случае, если расширение поддерживает кастомный эндпоинт.Подходит для сравнения моделей; поддержка зависит от текущей версии расширения.
GitHub CopilotВход через GitHub / CopilotОбычно Key и Base URL вводить не требуется — достаточно войти в аккаунт GitHub и предоставить нужные права доступа.Подходит тем, кто ищет готовый и простой в использовании ассистент внутри официальной экосистемы VS Code.

Инструкция по настройке по шагам

  1. Сначала установите VS Code, затем откройте панель расширений (Extensions Marketplace) на панели слева.
  2. Выберите AI-расширение: новичкам рекомендуется начать с Cline; если вы уже пользуетесь Continue, обратитесь к отдельной инструкции по Continue на нашем сайте; Roo Code больше рассчитан на опытных пользователей и не рекомендуется новичкам для первой установки.
  3. Откройте настройки расширения и найдите пункты вроде Provider, Model Provider или API Provider.
  4. Если вы хотите использовать Claude, выберите Anthropic / Claude; для GPT выберите OpenAI; для стороннего провайдера укажите OpenAI Compatible или Custom Provider.
  5. Укажите ключ (Key). При работе с официальной платформой обычно требуется только API-ключ; при использовании стороннего провайдера необходимо скопировать из личного кабинета и Key, и Base URL.
  6. Выберите модель из списка или введите её название вручную. Не изменяйте имя модели самостоятельно — указывайте его в точности так, как написано в панели провайдера.
  7. Отключите автоматическое выполнение команд и автоматическое изменение файлов, либо установите запрос подтверждения для каждого действия.

Проверка безопасности при первом запуске

Рекомендуемый запрос для первого тестирования
Read only the currently open file. Do not modify files or run commands. Explain what this code does in beginner-friendly language.
Если расширение собирается выполнить команду в терминале или изменить файлы, сначала проверьте, что именно оно собирается сделать. Новичкам настоятельно не рекомендуется включать полностью автоматический режим.