Перейти к основному содержанию

Claude Code с OpenRouter и DeepSeek: маршруты, настройка и первые ошибки

Для DeepSeek через OpenRouter задайте адрес OpenRouter, его ключ и модель deepseek/deepseek-v4.1-flash. Для прямого подключения нужны адрес и ключ DeepSeek с моделью deepseek-flash. Проверьте также роли моделей, источник настроек и фактический запрос у провайдера.

LaoZhang AI TeamОпубликованоОбновлено 11 мин чтения
Содержание
Схема подключения Claude Code через OpenRouter, напрямую к DeepSeek и через сторонний прокси

Подключить DeepSeek к Claude Code можно двумя способами: через OpenRouter или напрямую к Anthropic-совместимому API DeepSeek. В первом случае нужны адрес и ключ OpenRouter с моделью deepseek/deepseek-v4.1-flash; во втором — адрес и ключ DeepSeek с моделью deepseek-flash. Локальный прокси для этих документированных вариантов не требуется.

Поменять только ANTHROPIC_BASE_URL недостаточно: выбранная модель, способ авторизации и фоновые роли тоже должны соответствовать провайдеру. Ниже — настройка для терминального Claude Code по документации, проверенной 6 октября 2026 года. Примеры проверены локально на синтаксис; реальные запросы с ключом и работу агента в репозитории для этой статьи мы не выполняли.

Сначала маршрут, потом переменные

Если у вас уже есть доступ и баланс OpenRouter, начните с подключения через него. Если вы хотите оплачивать запросы непосредственно в DeepSeek и использовать его совместимый API, выбирайте прямое подключение. Это разные точки входа, даже когда в обоих случаях отвечает модель DeepSeek.

Что настраиваетсяDeepSeek через OpenRouterПрямой DeepSeek
ANTHROPIC_BASE_URLhttps://openrouter.ai/apihttps://api.deepseek.com/anthropic
КлючКлюч OpenRouterКлюч DeepSeek
Передача ключа в CLIANTHROPIC_AUTH_TOKENANTHROPIC_AUTH_TOKEN
Текущая модель Flashdeepseek/deepseek-v4.1-flashdeepseek-flash; в рецепте для основной модели — deepseek-flash[1m]
Где искать запрос и расходАктивность и учёт расходов OpenRouterДанные использования и баланс DeepSeek

Адреса и способы авторизации взяты из инструкции OpenRouter для Claude Code и инструкции DeepSeek. Текущий ID OpenRouter можно сверить в публичном каталоге моделей; соответствие прямого deepseek-flash модели DeepSeek-V4.1-Flash указано на странице моделей и тарифов DeepSeek.

Не переносите ключ DeepSeek в настройку OpenRouter или наоборот. Наличие модели в каталоге OpenRouter ещё не подтверждает доступ вашего аккаунта, выбор конкретного поставщика или работу инструментов Claude Code.

Уберите конфликтующие учётные данные

Перед подключением нужен установленный терминальный Claude Code, действующий ключ выбранного провайдера и доступ к нужной модели. Если CLI уже работает, переустанавливать его ради другого адреса не нужно.

Начните с отдельного окна терминала и выясните, откуда Claude Code получает настройки. Следующая команда показывает только наличие переменных, без значений ключей:

bash
for name in ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_API_KEY ANTHROPIC_MODEL; do
  if printenv "$name" >/dev/null 2>&1; then
    printf '%s: задана\n' "$name"
  else
    printf '%s: не задана\n' "$name"
  fi
done

Как соотносятся адрес, ключ и модель в разных вариантах подключения Claude Code

Этот вывод относится только к окружению оболочки. Если одноимённая переменная записана в env применимого файла настроек Claude Code, значение из файла может перекрыть экспорт из терминала. Также проверьте, не включён ли облачный режим через CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_VERTEX или CLAUDE_CODE_USE_FOUNDRY. Активный вход в корпоративный Claude apps gateway имеет отдельный приоритет; управляемая политика может запрещать сторонний адрес. В этих случаях новые export не дают гарантированного переключения. Авторизация Claude Code, подключение шлюза.

Если мешает личное переопределение, сохраните его прежнее значение и измените именно этот источник. Не удаляйте все настройки или хранилище входов. Подробный разбор областей файла и приоритетов есть в статье Настройка Claude Code API: ключи, settings.json, модели и шлюзы.

Настройка OpenRouter

Для DeepSeek через OpenRouter используйте ключ OpenRouter, адрес https://openrouter.ai/api и ID deepseek/deepseek-v4.1-flash. В текущем рецепте OpenRouter отдельно требуется пустой ANTHROPIC_API_KEY, чтобы не оставлять конкурирующий API-ключ. Документированное подключение.

Этот пример предназначен для Bash на macOS или Linux. Если ваша оболочка — zsh, сначала откройте Bash командой bash. Ключ вводится скрыто; не вставляйте его в сам текст команды. Предварительно разберите переопределения из предыдущего раздела.

bash
(
  read -r -s -p "Ключ OpenRouter: " OPENROUTER_API_KEY
  printf '\n'
  if [ -z "$OPENROUTER_API_KEY" ]; then
    printf 'Ключ не введён; запуск отменён.\n' >&2
    exit 1
  fi

  export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
  export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
  export ANTHROPIC_API_KEY=""
  export ANTHROPIC_MODEL="deepseek/deepseek-v4.1-flash"
  export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"
  export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
  export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"
  export CLAUDE_CODE_SUBAGENT_MODEL="$ANTHROPIC_MODEL"

  claude --model "$ANTHROPIC_MODEL"
)

Здесь ключ сначала присваивается OPENROUTER_API_KEY, а затем раскрывается в ANTHROPIC_AUTH_TOKEN. Пустая или ранее не определённая переменная не станет действующим ключом сама собой. Обычный файл .env тоже не следует считать автоматически загруженным установщиком Claude Code. Скобки ограничивают изменения окружения этим запуском; после выхода из него родительская оболочка сохраняет свои значения.

Мы задаём не только основную модель, но и соответствия для Opus, Sonnet, Haiku и подагентов. Названия ролей здесь не означают, что OpenRouter запустит Claude Opus: все перечисленные роли направлены на указанный DeepSeek. Если вы хотите использовать Pro, возьмите его точный ID из каталога, например текущий deepseek/deepseek-v4-pro, и осознанно поменяйте нужные назначения с учётом его тарифа. Новые функции CLI могут иметь отдельный выбор модели, поэтому эти настройки не обещают направить на Flash абсолютно любой будущий вызов.

После запуска введите внутри Claude Code, а не в Bash:

/status

Сверьте способ авторизации, адрес и выбранную модель. Затем выполните проверку ответа и инструмента, описанную ниже. Если вы видите сохранённый вход Anthropic вместо ожидаемого подключения, сначала проверьте токен и источники настроек. OpenRouter предлагает /logout при мешающем прежнем входе, но это действие удаляет текущие учётные данные и не снимает настоящий API-ключ из оболочки. Используйте его только если действительно хотите завершить этот вход; очистка Keychain или истории не является частью подключения. Инструкция OpenRouter, правила авторизации Anthropic.

Почему DeepSeek не появился в /model?

Отсутствие в списке выбора не означает, что модели нет в OpenRouter. Текущее обнаружение моделей шлюза включается отдельно:

bash
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

Добавьте переменную в окружение, из которого запускается Claude Code, и начните новый сеанс. OpenRouter возвращает для выбора ограниченную подборку, а не обязательно весь каталог; список обновляется при запуске. Настройка выше с точным ID не зависит от появления DeepSeek в меню. Обнаружение моделей OpenRouter.

Если обнаружение выключено или недоступно, можно добавить отдельный вариант через ANTHROPIC_CUSTOM_MODEL_OPTION="deepseek/deepseek-v4.1-flash". Это запись для меню, а не проверка доступа или совместимости. Сохраняются ограничения availableModels и требования провайдера. Настройка выбора модели.

Настройка прямого DeepSeek

Для прямого подключения нужен ключ DeepSeek, а не OpenRouter. Современная инструкция DeepSeek задаёт deepseek-flash[1m] для основной модели, Opus и Sonnet, а deepseek-flash — для Haiku и подагентов. Ниже эти назначения сохранены. Рецепт DeepSeek для Claude Code.

Пример также для Bash; прежние переопределения в файлах настроек и активные режимы провайдера должны быть разобраны до запуска:

bash
(
  read -r -s -p "Ключ DeepSeek: " DEEPSEEK_API_KEY
  printf '\n'
  if [ -z "$DEEPSEEK_API_KEY" ]; then
    printf 'Ключ не введён; запуск отменён.\n' >&2
    exit 1
  fi

  export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
  export ANTHROPIC_AUTH_TOKEN="$DEEPSEEK_API_KEY"
  unset ANTHROPIC_API_KEY
  export ANTHROPIC_MODEL="deepseek-flash[1m]"
  export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-flash[1m]"
  export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-flash[1m]"
  export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-flash"
  export CLAUDE_CODE_SUBAGENT_MODEL="deepseek-flash"

  claude --model "$ANTHROPIC_MODEL"
)

Кавычки вокруг имени с [1m] нужны, чтобы оболочка не интерпретировала квадратные скобки как шаблон файлов. Суффикс сообщает клиенту о контексте до миллиона токенов; он не создаёт дополнительную ёмкость у произвольного сервера. В OpenRouter этот суффикс снимается перед маршрутизацией. О реальном контексте судите по конкретной модели провайдера, а не по одному флагу. Модели Claude Code, обработка OpenRouter.

В инструкции DeepSeek также есть настройки effort и окна автоматического сжатия. Это параметры рецепта провайдера, а не обязательные реквизиты авторизации. Сначала проверьте подключение с правильным адресом, ключом и моделью; настройки длительной работы применяйте отдельно по актуальной инструкции.

Почему успешный ответ не доказывает нужную модель?

Прямой Anthropic-совместимый API DeepSeek автоматически заменяет неподдерживаемое имя на Flash. Имена Claude Opus отображаются в DeepSeek Pro, имена Haiku и Sonnet — во Flash. Поэтому опечатка или старый псевдоним могут дать ответ вместо явной ошибки модели; назначение Opus может также изменить стоимость. Для прозрачного выбора используйте документированное имя DeepSeek и сверяйте данные запроса у провайдера. Правила отображения моделей.

Текущий прямой deepseek-flash соответствует DeepSeek-V4.1-Flash. Старые deepseek-v4-flash и deepseek-v4-flash-vision-exp ещё принимаются, но обслуживаются новой Flash и оплачиваются по её тарифу. Не переносите это правило автоматически на одноимённые модели OpenRouter: у него свой каталог и маршрутизация. Актуальные модели DeepSeek.

Модель из старого сеанса и settings.local

Если после смены провайдера остался прежний выбор модели, проверьте не только ANTHROPIC_MODEL. В текущем Claude Code модель текущего сеанса, выбранная через /model, имеет приоритет над стартовыми настройками; затем идут --model, ANTHROPIC_MODEL, поле model и ANTHROPIC_DEFAULT_MODEL. Для первой проверки примеры выше запускают новый сеанс с явным --model, а не возобновляют старый.

Прямой вызов /model <имя> и выбор через Enter сохраняют пользовательское значение по умолчанию. Если хотите поменять модель только на время проверки, используйте предусмотренный в меню вариант s для текущего сеанса. Изменение основной модели не заменяет назначения фоновых ролей. Выбор и сохранение модели.

Для постоянной настройки можно использовать личный env в settings, однако JSON не является скриптом оболочки. Запись "ANTHROPIC_AUTH_TOKEN": "$DEEPSEEK_API_KEY" не доказывает, что приложение подставит содержимое переменной. Основной пример выше избегает этой неоднозначности: оболочка сама формирует окружение дочернего процесса.

Если вы всё же храните ключ в файле, вставляйте действительное значение по принятому у вас способу хранения секретов, не коммитьте его и не заменяйте целиком существующий файл небольшим примером. Локальный .claude/settings.local.json, созданный Claude Code, исключается из Git; для файла, созданного вручную, это нужно обеспечить самостоятельно. Gitignore не шифрует ключ. Настройки Claude Code.

Экспорт из терминала относится к запущенным из него процессам. Для проверки входа расширение VS Code использует также свои claudeCode.environmentVariables, Desktop требует отдельной конфигурации стороннего подключения, а обычный облачный сеанс не переключается такими переменными терминала. Если проблема возникает именно там, сверяйте требования соответствующего интерфейса, а не повторяйте терминальный рецепт вслепую. Особенности интерфейсов.

Проверка перед реальной работой

Проверка конфигурации, запроса у выбранного провайдера и чтения тестового файла без раскрытия ключа

Сначала получите ответ на короткое сообщение без файлов, затем проверьте инструмент в отдельной папке с несекретным тестовым файлом. Реальные запросы могут расходовать баланс провайдера.

  1. Проверьте /status. Адрес и авторизация должны соответствовать выбранному варианту. Список источников настроек помогает найти применимые файлы, но не показывает победителя каждого отдельного ключа.
  2. Отправьте короткое сообщение, например просьбу ответить одним словом. Нужен фактический ответ без ошибки авторизации. Ответ «я DeepSeek» сам по себе не подтверждает модель.
  3. Сопоставьте запрос у провайдера: время, выбранную модель, доступные сведения о поставщике, токенах и расходе. Для OpenRouter проверяйте OpenRouter; для прямого подключения — DeepSeek. Успешный ответ вместе с соответствующей записью убедительнее одного локального статуса. Не каждый интерфейс раскрывает все внутренние данные маршрутизации.
  4. Проверьте инструмент чтения. Создайте тестовый текстовый файл без секретов и попросите Claude Code прочитать его, не менять файлы и не выполнять другие действия. Убедитесь, что произошёл вызов инструмента, он вернул содержимое, а ответ соответствует файлу. Обычный текстовый ответ не заменяет такую проверку.
  5. Проверьте возврат. Выйдите из Claude Code и завершите подоболочку примера. Запустите привычную конфигурацию заново и сверьте её статус. Если вы меняли файл настроек или сохраняли /model, восстановите эти изменения отдельно.

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

Что проверить, если текст работает, а инструменты — нет?

Совместимый формат сообщений не означает полную эквивалентность Claude. DeepSeek документирует tool_use, tool_result и определения инструментов, но игнорирует часть параметров, включая cache_control, mcp_servers и disable_parallel_tool_use. Некоторые блоки, например document, mcp_tool_use и code_execution_tool_result, не поддерживаются. Если ошибка относится к такому блоку, повторение того же сообщения или смена ключа не исправляет несовместимость. Таблица совместимости DeepSeek.

Сначала отделите простой инструмент чтения от MCP, веб-поиска и сложного задания. Проверяйте именно ту функцию, которая нужна вам для работы. Веб-поиск DeepSeek имеет отдельную реализацию и дополнительные запросы модели для обработки результатов. Заявленная поддержка tools в каталоге OpenRouter — полезный предварительный признак, но не гарантия поведения всей цепочки. Возможности DeepSeek, каталог OpenRouter.

Первая ошибка: классификация

Не меняйте одновременно адрес, ключ и модель после каждого сбоя. Сначала найдите стадию, на которой произошла ошибка.

СимптомЧто проверить первымСледующее действие
401 или 403Правильный ли провайдер выдал ключ, не пуст ли ввод, какая авторизация активнаИсправить конкретный источник ключа; при запрете доступа проверить разрешения аккаунта или политику организации
404 или model not found в OpenRouterТочный ID с deepseek/, адрес без лишнего /v1, доступность моделиВзять действующий ID из каталога и повторить короткую проверку; сам 404 не подтверждает авторизацию
Прямой DeepSeek отвечает «не той» модельюЯвный ID, сохранённый выбор /model, автоматическое отображение неизвестных имёнНачать новый сеанс с документированной моделью и сверить данные запроса, а не самоназвание в ответе
После export ничего не изменилосьenv в settings, стартовые флаги, облачный режим, Claude apps gatewayНайти применимый источник; не обходить управляемые ограничения
Ответ есть, инструмент зависает или выдаёт ошибкуОтдельный вызов простого инструмента, тип блока и требования протоколаВернуться к подтверждённой конфигурации; сложную функцию проверять отдельно
Сообщение о балансе или лимитеБаланс и ограничения именно выбранного провайдераПроверить его условия; не подменять проблему оплаты случайным ID модели

Ошибка модели через OpenRouter и успешная автоматическая замена модели в прямом DeepSeek — разные случаи. Не используйте один общий способ исправления для обоих.

Как вернуться к прежнему подключению?

Если вы использовали пример в скобках и не меняли файлы, достаточно выйти из Claude Code: значения родительской оболочки сохранятся. Это удобнее, чем снимать все переменные без записи того, что было раньше.

Если настройка записана в shell profile или settings, верните только изменённые значения адреса, токена и ролей из своей сохранённой конфигурации, затем откройте новый сеанс. Если сохраняли /model, отдельно верните прежний выбор. Если выполняли /logout, возврат переменных не восстановит удалённый вход: понадобится предусмотренная для него авторизация. Не пытайтесь исправить это удалением истории или чужих хранилищ ключей.

Стоимость, данные и стоп-правила

Подключение OpenRouter оплачивается через OpenRouter, прямой DeepSeek — через DeepSeek. Смена адреса не переносит баланс и не делает запросы бесплатными. У прямого DeepSeek тариф зависит от модели, входных и выходных токенов, попадания в кэш и времени суток; у OpenRouter проверяйте условия выбранной модели и поставщика. Старый процент «экономии» без этих условий не подходит для сравнения. Тарифы DeepSeek, подключение и учёт OpenRouter.

Не начинайте с рабочего репозитория, если ещё не подтверждены адрес, авторизация и нужный инструмент. Для первого запроса достаточно несекретного текста и тестового файла. При несовместимости обязательной функции вернитесь к варианту, в котором она работает, вместо попытки скрыть ошибку добавлением новых переменных.

Часто задаваемые вопросы

Нужна ли платная подписка Claude для OpenRouter или DeepSeek?

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

Нужен ли Claude Code Router, чтобы подключить DeepSeek?

Нет, для двух описанных прямых подключений локальный CCR не требуется. Сторонний роутер полезен только если вам нужны его собственные правила или адаптация API; его установка и совместимость проверяются отдельно. Прямой рецепт DeepSeek, прямой рецепт OpenRouter.

Что указывать в ANTHROPIC_BASE_URL для OpenRouter?

Для этого подключения — https://openrouter.ai/api. Не копируйте сюда https://openrouter.ai/api/v1 из примера для OpenAI-совместимого клиента: Claude Code использует другой документированный вход. Ключ тоже должен принадлежать OpenRouter. Инструкция OpenRouter.

Можно ли использовать одно имя модели для обоих вариантов?

Нет. Текущий OpenRouter ID — deepseek/deepseek-v4.1-flash, а прямой DeepSeek использует deepseek-flash. Даже если в основе Flash, правила выбора, отображения имён и тарификации принадлежат разным сервисам. Каталог OpenRouter, модели прямого DeepSeek.

Источники9

Внешние страницы, на которые ссылается это руководство, в порядке упоминания. Последнее обновление: 7 окт. 2026 г..

  1. 1.инструкции OpenRouter для Claude Codeopenrouter.ai/docs/cookbook/coding-agents/claude-code-integration
  2. 2.инструкции DeepSeekapi-docs.deepseek.com/quick_start/agent_integrations/claude_code
  3. 3.публичном каталоге моделейopenrouter.ai/api/v1/models
  4. 4.странице моделей и тарифов DeepSeekapi-docs.deepseek.com/quick_start/pricing
  5. 5.Авторизация Claude Codecode.claude.com/docs/en/authentication
  6. 6.подключение шлюзаcode.claude.com/docs/en/llm-gateway-connect
  7. 7.Настройка выбора моделиcode.claude.com/docs/en/model-config
  8. 8.Правила отображения моделейapi-docs.deepseek.com/guides/anthropic_api
  9. 9.Настройки Claude Codecode.claude.com/docs/en/settings
Ещё по теме Claude Code
Варианты подключения Claude Code: подписка, API-ключ и шлюз или облачный провайдер
Claude Code

Настройка Claude Code API: ключи, settings.json, модели и шлюзы

Прямой API подключается через ANTHROPIC_API_KEY с подтверждением в интерактивном сеансе. Для шлюза нужны совместимый API, адрес и его ключ или bearer-токен. Затем проверьте, какие настройки применились и откуда пришёл ответ модели.

11 мин
Флаг Claude Code включает bypassPermissions; права ОС и отдельные защитные проверки рассматриваются отдельно
Claude Code

Claude Code --dangerously-skip-permissions: как включить и что он обходит

Запуск claude --dangerously-skip-permissions включает bypassPermissions: обычные действия инструментов проходят без подтверждения. Флаг --allow-dangerously-skip-permissions только делает этот режим доступным. Правила ask, отдельные защитные проверки и ограничения среды остаются.

11 мин
Иллюстрация утечки Claude Code, публичных правил и выбора пути оплаты
Claude Code

Утечка исходного кода Claude Code: риск бана, актуальные модели и логика аккаунтов (2026)

В марте 2026 года у Claude Code действительно была утечка внутреннего исходного кода. Anthropic говорит, что это была ошибка упаковки релиза, а не внешний взлом, и что чувствительные данные клиентов или учетные данные не утекли. Но пользователям важнее отделить этот факт от слухов о банах, устаревших разговоров о моделях и путаницы вокруг Claude vs Console.

11 мин