DeepSeek Claude Code: что проверить перед подключением
DeepSeek в Claude Code нельзя считать проверенной связкой только потому, что модель принимает формат Messages. В каталоге Relay у deepseek-v4-pro есть Anthropic Messages и OpenAI Chat Completions. Руководство Claude Code описывает подключение через Messages, но отдельная проверка DeepSeek в этом клиенте не зафиксирована. Ниже показано, как проверить API и выбрать документированный путь, если нужен агент для работы с кодом.
Коротко
Не делайте вывод о совместимости по названию модели или клиента.
Проверьте протокол, базовый адрес и модель отдельно от режима Claude Code.
Когда путь в Claude Code не подтверждён, используйте документированную интеграцию Cline или DeepSeek Harness.
Почему модель и клиент нельзя смешивать
DeepSeek выпускает модели, а Claude Code запускает агентные задачи в терминале. Между ними стоит API-протокол. Даже если один клиент умеет отправлять сообщения в формате Anthropic Messages, это ещё не доказывает, что он примет произвольную модель в этом режиме. И наоборот, модель, доступная через OpenAI Chat Completions, не становится автоматически выбором в интерфейсе Claude Code.
При настройке полезно держать три вопроса раздельно. Первый: есть ли нужная модель в каталоге под точным ID? Второй: какой протокол нужен клиенту и поддерживает ли его Relay для этой модели? Третий: принимает ли текущая версия клиента свой базовый адрес и ключ в требуемом режиме? Ответ на один вопрос не закрывает остальные два.
Такой порядок защищает от ложной диагностики. Если Claude Code ответил ошибкой, нельзя сразу менять модель, ключ и переменные окружения. Сначала воспроизведите один API-вызов без клиента. Затем проверьте руководство Claude Code именно для установленной версии. В конце сопоставьте событие с журналом запросов.
DeepSeek и Claude Code: что подтверждено в Relay
У Relay есть отдельная страница интеграции Claude Code. В ней указаны адрес, переменные и ограничения конкретного сценария. Перед изменением конфигурации прочитайте её вместе с документацией клиента. Не переносите чужие секреты, сессии браузера или старые файлы конфигурации из случайного гайда.
Приём API-запроса не подтверждает весь набор действий клиента в терминале. Функции, зависящие от учётной записи стороннего продукта, не следует обещать через сторонний ключ. Если руководство клиента требует конкретный способ входа для некоторого режима, соблюдайте это требование, а не подменяйте вход ключом Relay.
Как отдельно проверить DeepSeek по API
Сначала выпустите отдельный ключ и выберите в карточке точный ID deepseek-v4-pro. Проверьте его прямым запросом Chat Completions. Такой тест не доказывает поддержку каждой функции Claude Code, но показывает, что ключ, базовый адрес и модель работают как API-связка.
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ.get("RELAY_API_KEY", "sk-demo-not-a-real-key"),
base_url="https://relay-llm.ru/v1",
)
reply = client.chat.completions.create(
model="deepseek-v4-pro",
messages=[{"role": "user", "content": "Ответь одним словом: ping"}],
)
print(reply.choices[0].message.content)При успешном ответе сохраните время запуска и найдите его в журнале кабинета. Если получен 401, проверяйте созданный ключ и его передачу процессу. 404 требует проверить адрес с /v1, а при model_not_found сверьте ID и доступность модели в каталоге. Не добавляйте в такой диагностический запрос инструменты, большой контекст или данные репозитория.
Как проверить нужный протокол без запуска агента
Успешный Chat Completions не проверяет Messages. Если разбираете именно Claude Code, отправьте отдельный запрос на /v1/messages. В отличие от OpenAI SDK, официальный SDK Anthropic получает базовый адрес без /v1; прямой HTTP-запрос ниже содержит полный путь.
curl --fail-with-body https://relay-llm.ru/v1/messages \
-H "x-api-key: $RELAY_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v4-pro","max_tokens":128,"messages":[{"role":"user","content":"Ответь одним словом: ping"}]}'Если ответ содержит текстовые блоки в content, протокол принял запрос. Это ещё не проверка чтения файлов и вызова инструментов агентом. Их выполнение зависит от того, как клиент передаёт описания инструментов, получает вызов и возвращает его результат модели. Схема описана на странице Messages.
Для Claude Code используйте настройки со страницы интеграции: ANTHROPIC_BASE_URL задаёт корень сервиса, ANTHROPIC_AUTH_TOKEN передаёт ключ Relay, ANTHROPIC_MODEL выбирает модель. Назначение дополнительных моделей клиента сверяйте с руководством своей версии. В этой статье нет готового конфига DeepSeek для Claude Code: одного текстового ответа недостаточно для такого обещания.
Когда взять Cline или DeepSeek Harness
Cline предоставляет настройки OpenAI Compatible: укажите адрес https://relay-llm.ru/v1, ключ и модель из каталога. Это путь для случая, когда нужен OpenAI-совместимый API и явная настройка провайдера. Перед настройкой сверяйте экран с руководством вашей версии Cline.
DeepSeek Harness тоже имеет собственную страницу подключения. Не переносите конфиг между профилями наугад: у клиента могут быть отдельные файлы настроек для разных режимов. Каждую интеграцию проверяют коротким запросом и записью в журнале.
Для проверки Cline подготовьте папку с файлом hello.txt. Попросите прочитать его и предложить одну правку. Сначала проверьте чтение, затем подтверждённую запись и полученный diff. Текстовый ответ без чтения файла не доказывает, что инструменты работают.
Как ограничить расходы и собрать диагностику
Используйте отдельный ключ на каждый клиент. Тогда запросы Claude Code, Cline и скриптов не смешаются. В настройках ключа можно задать лимит расхода в день, месяц или на всё время. Эти лимиты не ограничивают права клиента на локальные файлы; доступ к папкам и командам настраивается отдельно. Цену смотрите на странице цен, запросы фильтруйте в журнале по ключу.
При отказе сохраните код ответа, время, модель и x-request-id, если он есть. Секреты, текст закрытых файлов и полный конфиг не передавайте в тикет. Ошибку 429 разбирают по правилам лимитов, не параллельными повторами. При 402 прочитайте код ошибки: проверьте баланс и лимиты ключа. Повторяйте агентное задание после исправления причины; успешно выполненные повторные вызовы тоже оплачиваются.
Проверена ли связка DeepSeek Claude Code в этой статье?
Нет. Показаны проверки API DeepSeek. Они не подтверждают весь агентный цикл Claude Code с этой моделью.
Как проверить модель до настройки клиента?
Сделайте короткий запрос к https://relay-llm.ru/v1 с ключом Relay и моделью из каталога, затем проверьте запись в журнале.
Что делать, если документация Claude Code не подтверждает нужный режим?
Не выдавайте его за рабочий. Проверьте Cline или DeepSeek Harness, если их документированный путь подходит задаче.
Где посмотреть лимиты для пробных запросов?
В документации лимитов. Начните с одного короткого вызова и не повторяйте его параллельно.