Гайды

Как подключить DeepSeek к VSCode: три пути

9 октября 2026 · 13 минут чтения

Проверка фактов

Юлия Найпак

Методист по автоматизации. Сверяет паспорт инструмента с документацией вендора.

Автор Р

Редакция

Коллектив авторов, редакторов и иллюстраторов статей на сайте блога онлайн-университета «Зерокодер». Пишем…

Черновик готовит редакция с помощью ИИ. За стандарт издания отвечает главный редактор — Валерий Курземнек.

Материал редакции Зерокодера. Цитаты источников приведены дословно. Обновлено: октябрь 2026.

Как подключить DeepSeek к VSCode: доступны три документированных способа. Официальная документация DeepSeek описывает интеграцию с GitHub Copilot Chat: расширение добавляет модели DeepSeek V4 Pro и Flash в список выбора моделей Copilot. Второй путь — настроить DeepSeek как провайдера модели для Codex, общий конфигурационный файл которого используют Codex CLI, приложение ChatGPT и расширение Codex для VS Code. Третий путь — сторонние расширения из Marketplace, каждое со своим набором настроек.

Выбор зависит от того, есть ли у вас подписка Copilot и нужен ли доступ к агенту с вызовом инструментов. Мы скачали подборку результатов веб-поиска по запросу «как подключить deepseek к vscode»: текст отдали 6 из 10.

Прямой ответ и границы продукта

DeepSeek — это модель и API. Подключение к VS Code всегда идёт через посредника: расширение, клиент или конфигурационный файл. Официальная документация DeepSeek описывает два интеграционных пути. Первый — расширение DeepSeek V4 for Copilot Chat, которое добавляет модели DeepSeek V4 Pro и Flash прямо в список выбора моделей GitHub Copilot Chat. При этом сохраняются агентный режим Copilot, вызов инструментов, навыки и MCP. Второй — настройка Codex как клиента: Codex общается с моделями через Responses API, который DeepSeek API поддерживает нативно.

Сторонние расширения из Marketplace решают ту же задачу иначе. Расширение DeepSeek R1 от colourafredi заявляет работу без входа в аккаунт, поддержку нескольких языков интерфейса и настройку собственного baseUrl. Расширение DeepSeek Code Generator от peterwanghot описывает боковую панель для диалога с DeepSeek и работу с выделенным кодом: объяснение, исправление, рефакторинг, генерация комментариев, тестов и код-ревью. Расширение dsh-vscode от lunnlew строится вокруг DeepSeek Harness и предлагает несколько поверхностей: чат в редакторе, панель Simple Browser, боковую панель сессий и моделей.

Границы важны для планирования. Официальный путь через Copilot требует подписки GitHub Copilot — документация указывает, что бесплатный уровень подходит. Путь через Codex требует установленного Codex CLI или приложения ChatGPT, запущенного хотя бы раз, чтобы появился каталог конфигурации. Сторонние расширения не требуют подписки Copilot, но каждое несёт собственный набор полей настроек, и смешивать имена полей разных расширений нельзя.

Бесплатный веб-чат DeepSeek не означает бесплатный API. Для любого из трёх путей нужен ключ API, который начинается с префикса sk- и создаётся на платформе DeepSeek. Ключ — это учётные данные с оплатой по факту использования, и подписка Copilot его не заменяет.

Собственный прогон редакции по этому запросу: мы скачали подборку результатов веб-поиска и прочитали тексты выдачи. Большинство страниц топа помечены 2026 годом.

Условия доступа и источник актуальных требований

Официальная документация DeepSeek по интеграции с GitHub Copilot перечисляет требования по шагам. Нужна версия VS Code 1.116 или новее. Нужна подписка GitHub Copilot — Free, Pro или Enterprise, причём бесплатный уровень работает. Расширение ставится из репозитория на GitHub. Ключ API создаётся на платформе DeepSeek и начинается с sk-.

Документация отдельно описывает хранение ключа: он сохраняется в системном хранилище ключей операционной системы, на диск не записывается. Это относится к официальному расширению для Copilot Chat. Сторонние расширения хранят настройки по своим правилам: расширение DeepSeek R1 заявляет локальное хранение истории чата и отсутствие загрузки данных. Это утверждение самого расширения, и оно описывает только его собственное поведение.

Источник актуальных требований — документация DeepSeek на api-docs.deepseek.com. Там же публикуются скрипты установки для Codex и справочник полей config.toml. Версии расширений и совместимость с версиями VS Code меняются, поэтому перед установкой сверяйтесь с карточкой расширения в Marketplace и с документацией проекта.

Для пути через Codex требования иные. Документация указывает: все клиенты Codex — Codex CLI, приложение ChatGPT и расширение Codex для VS Code — используют один конфигурационный файл. Настроив его один раз, вы получаете модели DeepSeek во всех трёх клиентах. Перед запуском скрипта установки нужно, чтобы Codex CLI или приложение ChatGPT были установлены и запущены хотя бы раз, чтобы появился каталог ~/.codex.

Доступность сервисов DeepSeek из России в прочитанных источниках не описана. Если доступ из вашего региона критичен, проверьте актуальные условия самостоятельно на стороне платформы DeepSeek перед покупкой подписки или ключа.

Таблица ниже сводит три пути по ключевым условиям.

Порядок действий: официальный путь через Copilot Chat

Документация DeepSeek описывает этот путь как последовательность из четырёх шагов. Первый — установить расширение из репозитория на GitHub. Второй — получить ключ API на платформе DeepSeek. Третий — прописать ключ в VS Code. Четвёртый — выбрать модель и начать диалог.

Установка расширения. Документация указывает ставить расширение из репозитория GitHub. Перед этим убедитесь, что версия VS Code не ниже 1.116 и подписка Copilot активна.

Получение ключа. Перейдите на платформу DeepSeek и создайте ключ API. Скопируйте его: ключ начинается с sk-. Документация подчёркивает, что ключ хранится в системном хранилище ключей и на диск не пишется.

Прописывание ключа. Откройте палитру команд сочетанием Cmd+Shift+P на macOS или Ctrl+Shift+P на Windows и Linux. Выполните команду DeepSeek: Set API Key и вставьте ключ.

Выбор модели и старт. Откройте Copilot Chat сочетанием Cmd+Shift+I или Ctrl+Shift+I. Нажмите на выбор модели в правом верхнем углу панели чата. Выберите DeepSeek V4 Pro или DeepSeek V4 Flash. Дальше работает агентный режим, вызов инструментов и остальные функции Copilot.

Документация описывает дополнительную настройку усилия рассуждения. В списке выбора моделей нажмите значок шестерёнки рядом с моделью DeepSeek и выберите уровень: None — самый быстрый, без рассуждений; High — сбалансированный, используется по умолчанию; Max — глубокие рассуждения для сложных задач.

Отдельный пункт — работа с изображениями. DeepSeek V4 работает с текстом, а расширение обрабатывает картинки автоматически: скриншот, брошенный в чат, проходит через другую установленную модель Copilot — Claude или GPT-4o, — которая описывает изображение перед отправкой в DeepSeek. Команда DeepSeek: Set Vision Proxy Model выбирает модель для описания картинок.

Для сравнения смежного инструмента смотрите как добавить Grok в Visual Studio: логика выбора расширения и настройки ключа там похожа.

Порядок действий: Codex как клиент DeepSeek

Документация DeepSeek описывает два варианта настройки Codex: скрипт автоматической установки и ручное редактирование конфигурации. Скрипт рекомендуется как основной путь.

Перед запуском убедитесь, что Codex CLI или приложение ChatGPT установлены и запущены хотя бы раз: это создаёт каталог ~/.codex. Пользователи macOS и Linux запускают в терминале команду bash с адресом скрипта на cdn.deepseek.com. Пользователи Windows запускают в PowerShell команду irm с адресом скрипта и передают результат в iex.

После запуска скрипт предлагает меню. Пункт 1 настраивает Codex на модель deepseek-flash, которая также принимает изображения на вход. Пункт 2 настраивает deepseek-v4-pro. Пункт 9 возвращает конфигурацию Codex по умолчанию, удаляя настройки DeepSeek. При первом запуске скрипт запрашивает ключ API, начинающийся с sk-.

Повторный запуск скрипта переписывает конфигурацию или возвращает её к состоянию до установки. Повторный выбор пункта 1 или 2 добавляет настройки, появившиеся в новых версиях скрипта, включая show_raw_agent_reasoning и уровни усилия рассуждения, не трогая остальную конфигурацию. Если более старая версия скрипта установила записи deepseek-v4-flash или deepseek-v4-flash-vision-exp, повторный запуск удаляет их и оставляет только deepseek-flash и deepseek-v4-pro.

Ручной вариант описан в документации отдельно. Сначала создаётся файл каталога моделей ~/.codex/models.json с метаданными моделей DeepSeek. Поле input_modalities модели deepseek-flash включает image — именно это сообщает Codex, что модель принимает изображения. Затем редактируется файл ~/.codex/config.toml, при его отсутствии файл создаётся. Поле experimental_bearer_token получает значение вашего ключа API с платформы DeepSeek. Если в config.toml уже есть секция [desktop], строку enabled-reasoning-efforts добавляют в неё: вторая секция [desktop] делает файл невалидным.

Справочник полей config.toml в документации описывает назначение ключей. Одно поле задаёт модель по умолчанию. Другое — провайдера модели, совпадающего с идентификатором секции [model_providers.]. Поля preferred_auth_method и forced_login_method управляют способом входа. Аутентификация по ключу API пропускает вход в аккаунт ChatGPT.

Учебный пример и критерии самостоятельной проверки

Возьмём учебную задачу: подключить DeepSeek к VS Code и проверить, что модель действительно отвечает на запросы по вашему коду. Это упражнение редакции, построенное с нуля.

Шаг первый. Выберите один путь из трёх и не смешивайте настройки разных расширений. Если у вас есть подписка Copilot, начните с официального расширения для Copilot Chat. Если вы уже пользуетесь Codex, настройте провайдера через скрипт.

Шаг второй. Для выбранного облачного пути создайте ключ API на платформе DeepSeek и сохраните его в менеджере паролей. Если выбрано локальное развёртывание DeepSeek R1 через Ollama, настройте локальную модель по инструкции расширения; облачный ключ для этого пути не нужен.

Шаг третий. Откройте небольшой файл в вашем проекте, например функцию на десять строк. Выделите её и попросите модель объяснить, что делает код.

Шаг четвёртый. Сравните ответ с вашим собственным пониманием функции. Модель должна назвать назначение, ключевые ветвления и потенциальные проблемы.

Критерии проверки. Первый: ответ приходит от выбранной модели DeepSeek — это видно по выбору в списке моделей. Второй: модель видит выделенный фрагмент. Третий: ключ API не отображается в тексте ответа и не попадает в логи. Четвёртый: после перезапуска VS Code настройка сохраняется.

Если ответ не приходит, проверьте три вещи по порядку. Версия VS Code соответствует требованию 1.116 или новее. Ключ вставлен полностью и начинается с sk-. Выбранная модель присутствует в списке выбора.

Для тренировки смежного навыка — формулирования запросов к модели — пригодится материал как создать песню в ГигаЧате: там разобрана структура промпта по шагам.

Смежные варианты и выбор по задаче

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

Официальное расширение для Copilot Chat даёт доступ к агентному режиму, вызову инструментов, навыкам и MCP. Если вам нужен агент, который сам правит файлы и запускает команды, этот путь подходит лучше остальных. Он требует подписки Copilot, причём бесплатный уровень работает.

Путь через Codex даёт одну конфигурацию на три клиента: Codex CLI, приложение ChatGPT и расширение Codex для VS Code. Если вы уже работаете в Codex, настройка провайдера добавляет модели DeepSeek во все три места сразу. Скрипт установки делает резервную копию конфигурации и проверяет синтаксис перед записью.

Расширение dsh-vscode строится вокруг DeepSeek Harness. Оно описывает чат в редакторе, панель Simple Browser, боковую панель сессий, боковую панель моделей, панель траектории с журналом событий сессии и экспериментальную панель команды агентов. Английская сборка DeepSeek Harness для VS Code описывает два режима: встроенное окно с веб-интерфейсом DSH и мост в Copilot, регистрирующий DSH как модель чата VS Code.

Таблица помогает выбрать по задаче.

Типичные проблемы и проверяемые способы диагностики

Проблема первая: модель не появляется в списке выбора. Проверьте версию VS Code — документация требует 1.116 или новее. Проверьте, что расширение установлено и редактор перезапущен. Проверьте, что подписка Copilot активна.

Проблема вторая: ключ не принимается. Ключ создаётся на платформе DeepSeek и начинается с sk-. Проверьте, что скопировали его целиком, без пробелов по краям. Если ключ отозван на платформе, создайте новый.

Проблема третья: команда DeepSeek: Set API Key не находится в палитре. Убедитесь, что палитра открыта правильным сочетанием: Cmd+Shift+P на macOS, Ctrl+Shift+P на Windows и Linux. Проверьте, что расширение установлено именно для Copilot Chat.

Проблема четвёртая: скрипт настройки Codex прерывается. Документация указывает, что скрипт проверяет синтаксис config.toml и models.json перед записью и прерывается без изменений при ошибке. Проверьте, что каталог ~/.codex существует: для этого Codex CLI или приложение ChatGPT должны быть запущены хотя бы раз.

Проблема пятая: файл config.toml стал невалидным. Частая причина — две секции [desktop]. Документация прямо предупреждает: при наличии секции [desktop] строку enabled-reasoning-efforts добавляют в неё, а вторую секцию создавать нельзя.

Проблема шестая: изображение не обрабатывается. DeepSeek V4 работает с текстом. В официальном расширении картинки проходят через другую модель Copilot, и команда DeepSeek: Set Vision Proxy Model выбирает, какая модель описывает изображение. В пути через Codex поле input_modalities модели deepseek-flash включает image.

Проблема седьмая: после обновления скрипта остались старые записи моделей. Повторный запуск скрипта удаляет записи deepseek-v4-flash и deepseek-v4-flash-vision-exp и оставляет deepseek-flash и deepseek-v4-pro.

Проблема восьмая: нужно вернуть конфигурацию Codex к исходной. Пункт 9 меню скрипта восстанавливает состояние до установки. Резервная копия лежит в ~/.codex/backup-deepseek/.

Частые вопросы

Как подключить DeepSeek к VS Code бесплатно?

Бесплатный уровень GitHub Copilot подходит для DeepSeek V4 for Copilot Chat, но использование облачного API DeepSeek оплачивается отдельно. Для сторонних расширений проверьте выбранного провайдера: карточка DeepSeek R1 заявляет локальную работу через Ollama без интернета. При таком локальном развёртывании ключ облачного API DeepSeek не требуется; ресурсы компьютера и установка модели остаются на вашей стороне.

DeepSeek для VS Code — какое расширение выбрать?

Для агентной работы с правкой файлов и вызовом инструментов подходит официальное расширение для Copilot Chat. Для одной настройки на все клиенты Codex выбирайте путь через Codex. Для работы без подписки Copilot смотрите сторонние расширения: DeepSeek R1, DeepSeek Code Generator, dsh-vscode. Сверяйте карточку расширения в Marketplace перед установкой.

Как добавить DeepSeek в VS Code, если нет подписки Copilot?

Используйте стороннее расширение из Marketplace. Карточка DeepSeek R1 заявляет работу без входа в аккаунт, собственный baseUrl и локальное развёртывание через Ollama. Для облачного API DeepSeek нужен ключ платформы; при локальной работе через Ollama облачный ключ не требуется. Выберите провайдера в настройках конкретного расширения.

VS Code DeepSeek V4 — какие модели доступны?

Официальное расширение для Copilot Chat добавляет в список выбора модели DeepSeek V4 Pro и DeepSeek V4 Flash. Путь через Codex настраивает модели deepseek-flash, которая принимает изображения, и deepseek-v4-pro. Уровни усилия рассуждения в официальном расширении: None, High по умолчанию и Max.

Что делать, если DeepSeek не отвечает в VS Code?

Проверьте версию VS Code: документация требует 1.116 или новее. Проверьте, что ключ вставлен полностью и начинается с sk-. Проверьте, что выбранная модель присутствует в списке выбора. Для пути через Codex проверьте, что каталог ~/.codex существует и файл config.toml не содержит двух секций [desktop].