DeepSeek в Claude Code: подключение и проверка в 2026

DeepSeek можно использовать как модель внутри Claude Code через Anthropic-совместимый API DeepSeek. Это технический режим для CLI и редактора, а не способ получить Claude дешевле: запросы уходят модели DeepSeek и оплачиваются в DeepSeek Platform. Если вам нужен именно Claude без ручной настройки, начните с официального приложения Claude Code.

Что именно получится после подключения

Интерфейс и инструменты Claude Code останутся на компьютере, но ответы модели будет отдавать DeepSeek. Официальная инструкция DeepSeek использует Anthropic-совместимый адрес API, токен DeepSeek и отдельные имена моделей для основных запросов и подзадач. DeepSeek публикует готовую схему переменных для Claude Code.

У этого сценария есть естественная граница. Anthropic предупреждает, что сторонний шлюз должен поддерживать формат Messages и нужные заголовки, иначе часть возможностей работает иначе или пропадает. Кроме того, сторонний шлюз не делает DeepSeek моделью Claude. Требования Claude Code к LLM-шлюзам описаны в документации Anthropic.

Правило выбора: официальный Claude подходит, если нужна предсказуемая совместимость всех функций. DeepSeek через Claude Code подходит, если вы осознанно меняете модель и готовы проверять инструменты на своём проекте.

Что подготовить до настройки

Для большинства задач основной путь начинается с приложения Claude Code. Сторонний API оправдан, когда у вас уже есть конкретная причина использовать DeepSeek. Если терминал пока непривычен, сначала пройдите короткий путь работы с Claude в терминале, затем возвращайтесь к настройке провайдера.

• Установленный Claude Code. Официальный гайд DeepSeek для установки с нуля указывает Node.js 18 или новее, а на Windows также Git for Windows.
• API-ключ DeepSeek из DeepSeek Platform. Не вставляйте его в статью, переписку, снимок экрана или файл проекта.
• Небольшой тестовый репозиторий без секретов и клиентских данных.
• Сохранённое состояние текущих переменных окружения, если Claude Code уже был настроен на другого провайдера.

Перед изменением решите, где будет жить настройка. Для первой проверки используйте только текущее окно терминала. После закрытия окна переменные исчезнут, поэтому откат получится простым. Постоянную запись в .zshrc, .bashrc или профиль PowerShell делайте лишь после успешного теста.

По теме: Claude Code Remote Control: работа с телефона в 2026

Подключение на macOS и Linux без записи ключа в историю

Откройте терминал в папке тестового проекта. Команда read -s принимает ключ скрыто, а переменные действуют только в текущей сессии оболочки. Имена моделей и адрес ниже взяты из актуальной инструкции DeepSeek для Claude Code.

read -s DEEPSEEK_KEY
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="$DEEPSEEK_KEY"
export ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
export CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
claude

Не добавляйте export ANTHROPIC_AUTH_TOKEN=... с настоящим ключом в историю команд. Если оболочка не поддерживает read -s, задайте секрет через штатное хранилище вашей системы или введите переменную в отдельном закрытом окне, которое затем будет завершено.

Подключение в Windows PowerShell

В PowerShell безопаснее запросить ключ как скрытое значение, преобразовать его только в памяти текущего процесса и не сохранять профиль. Остальные переменные повторяют официальный набор DeepSeek.

$secureKey = Read-Host "DeepSeek API key" -AsSecureString
$key = [System.Net.NetworkCredential]::new('', $secureKey).Password
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN=$key
$env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
claude

После закрытия PowerShell эти значения не сохранятся. Это полезный первый запуск: вы не рискуете забыть сторонний адрес в профиле и позже принять DeepSeek за официальный Claude.

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

Не начинайте с большого проекта. Проведите проверку в три уровня: соединение, модель, действия с файлами. Так причина сбоя будет видна сразу.

1. Запустите claude и откройте команду состояния или выбора модели. Убедитесь, что показано имя DeepSeek, а не стандартный псевдоним без пояснения.
2. Попросите агента только перечислить файлы тестового проекта и объяснить, какой файл он предлагает открыть. Не разрешайте изменения на этом шаге.
3. Создайте отдельную ветку или копию одного неважного файла, попросите внести одну заметную правку и запустить безопасную проверку.
4. Сравните git diff с заданием. Если агент изменил лишнее, отмените правку и настройте разрешения до продолжения.

DeepSeek документирует сопоставление имён: запросы к псевдонимам Opus направляются в deepseek-v4-pro, а Sonnet и Haiku могут быть сопоставлены с deepseek-v4-flash. В таблице совместимости также перечислены поля, которые API игнорирует или не поддерживает. Проверьте текущую таблицу Anthropic-совместимости DeepSeek перед переносом рабочего процесса.

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

По теме: Claude overloaded: что значит ошибка и как восстановить работу

Диагностика по симптому

• Ошибка авторизации: проверьте, что используется ключ DeepSeek, а адрес заканчивается на /anthropic. Не печатайте значение ключа для диагностики.
• Открывается официальный Claude: переменные заданы в другом окне терминала или были переопределены профилем. Проверьте только наличие переменных, не выводя токен.
• В списке видно неожиданное имя модели: закройте сессию и явно задайте ANTHROPIC_MODEL и семейные переменные из текущего официального гайда.
• Инструмент или формат ответа работает иначе: сверьте поле с таблицей совместимости DeepSeek. Игнорируемое поле нельзя исправить промптом.
• Подзадачи дают другое качество: проверьте CLAUDE_CODE_SUBAGENT_MODEL. В официальной схеме основной запрос и подагенты могут идти разным моделям.

Как вернуть официальный Claude

Если настройка была только в текущем окне, закройте терминал и откройте новый. Для явного отката удалите переменные, затем войдите обычным способом. На macOS и Linux используйте unset, в PowerShell удалите элементы из Env:.

unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_MODEL
unset ANTHROPIC_DEFAULT_OPUS_MODEL ANTHROPIC_DEFAULT_SONNET_MODEL
unset ANTHROPIC_DEFAULT_HAIKU_MODEL CLAUDE_CODE_SUBAGENT_MODEL

После отката снова откройте состояние модели и выполните один тест только на чтение. Если вы ранее записали переменные в профиль оболочки, удалите именно добавленные строки и перезапустите терминал. Не удаляйте весь профиль.

По теме: Claude Code Router: установка и безопасная настройка в 2026

Когда способ не подходит

Не используйте сторонний API для проекта, если договор или политика клиента разрешает отправку кода только Anthropic. Не выбирайте этот путь ради Remote Control: эта функция требует входа через claude.ai и не работает с API-ключом стороннего провайдера. Если вам нужна полная совместимость Claude Code или командная политика, оставайтесь на официальном провайдере.

Также не подключайте DeepSeek к единственной рабочей копии без контроля версий. Сначала проверьте один малый сценарий, затем решите, подходит ли качество модели. Для осознанного сравнения полезен разбор выбора модели в Claude Code, но названия сторонних моделей всегда сверяйте с документацией их владельца.

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

DeepSeek в Claude Code становится моделью Claude?

Нет. Claude Code остаётся интерфейсом и набором инструментов, а ответы генерирует модель DeepSeek через её API.

Подписка Claude оплачивает запросы DeepSeek?

Нет. Для этого режима нужен отдельный API-ключ DeepSeek, а использование учитывается на стороне DeepSeek Platform.

Можно ли сразу сохранить переменные навсегда?

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

Почему часть функций отличается?

Anthropic-совместимый формат не гарантирует поддержку каждого поля и каждой функции. Смотрите таблицу совместимости DeepSeek и требования шлюза Anthropic.