Как подключить DeepSeek Flash или Pro к Claude Code: настройка и цены
Практическая настройка Claude Code для DeepSeek Flash и Pro: безопасный ввод ключа, выбор модели, проверка подключения, ограничения инструментов, разбор ошибок и сравнение цен.
Содержание
Claude Code можно направить прямо на Anthropic-совместимый endpoint DeepSeek — отдельный proxy для этого не нужен. Для обычной разработки разумно начать с актуальной официальной схемы deepseek-flash[1m], а deepseek-v4-pro включать только для основной сессии, когда сложная архитектура, большой рефакторинг или длинная диагностика действительно оправдывают более высокую цену.
Здесь есть две неочевидные детали. Текущий пример DeepSeek явно назначает Flash даже для Opus, поэтому автоматическое сопоставление моделей не срабатывает. Кроме того, неподдерживаемое имя модели без ошибки переводится на deepseek-flash. Обычный ответ Claude Code подтверждает связь с API, но сам по себе не доказывает, что запрос обработал Pro.
Сначала выберите профиль моделей
По состоянию на 27 сентября 2026 года инструкция DeepSeek для Claude Code предлагает экономичный профиль, где основные роли работают на Flash. В отдельном описании совместимости Anthropic API сказано: имена, начинающиеся с claude-opus, сопоставляются с deepseek-v4-pro, а claude-sonnet и claude-haiku — с deepseek-flash.
| Профиль | Основная модель / Opus | Sonnet | Haiku и subagent | Когда выбирать |
|---|---|---|---|---|
| Официальный вариант, приоритет скорости | deepseek-flash[1m] | deepseek-flash[1m] | deepseek-flash | Ежедневная разработка, чтение репозитория, много небольших задач |
| Pro для основной сессии | deepseek-v4-pro | deepseek-flash[1m] | deepseek-flash | Архитектура, трудный рефакторинг, критичная диагностика |
| Автоматическое сопоставление | claude-opus* → deepseek-v4-pro | claude-sonnet* → deepseek-flash | claude-haiku* → deepseek-flash | Только если вы понимаете, какое Claude-имя отправляет клиент |
Явные переменные окружения имеют приоритет. Если задать ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-flash[1m], выбор Opus в Claude Code всё равно приведёт к Flash.
1. Установите Claude Code и проверьте локальную часть
Нужен Node.js 18 или новее; в Windows также потребуется Git for Windows. Сначала убедитесь, что CLI запускается и показывает версию, чтобы не принять проблему установки за ошибку API.
npm install -g @anthropic-ai/claude-code
claude --version
IFS= read -rs ANTHROPIC_AUTH_TOKEN
export ANTHROPIC_AUTH_TOKEN
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
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"
export CLAUDE_CODE_EFFORT_LEVEL="max"
export CLAUDE_CODE_AUTO_COMPACT_WINDOW="786432"Команда IFS= read -rs ANTHROPIC_AUTH_TOKEN ждёт вставки API Key и не показывает ввод. Вставьте ключ, нажмите Enter, после чего следующая строка экспортирует его только в текущую оболочку. Не помещайте настоящий ключ в команду, историю shell, script или репозиторий.
Для PowerShell можно считать секрет безопасно и передать его текущему процессу:
npm install -g @anthropic-ai/claude-code
claude --version
$secure = Read-Host -AsSecureString
$ptr = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($secure)
try {
$env:ANTHROPIC_AUTH_TOKEN = [Runtime.InteropServices.Marshal]::PtrToStringBSTR($ptr)
} finally {
[Runtime.InteropServices.Marshal]::ZeroFreeBSTR($ptr)
}
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_MODEL="deepseek-flash[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-flash[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-flash[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"
$env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="786432"Переменные действуют для Claude Code, запущенного из этого терминала. Сначала проверьте временную конфигурацию; только затем переносите несекретные параметры в защищённый профиль, а сам ключ храните в подходящем secret store.
2. Переведите на Pro только основную сессию
На текущей странице моделей и цен точный ID Pro указан как deepseek-v4-pro, версия — DeepSeek-V4-Pro-0813. Актуальная страница интеграции показывает суффикс [1m] только для Flash и не приводит пример deepseek-v4-pro[1m]. Поэтому безопаснее использовать точный ID из таблицы моделей, не конструируя новое имя.
export ANTHROPIC_MODEL="deepseek-v4-pro"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-flash[1m]"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-flash"
export CLAUDE_CODE_SUBAGENT_MODEL="deepseek-flash"Основная сессия и ветка Opus теперь идут через Pro, а Sonnet, Haiku и subagent остаются на Flash. Поиск по репозиторию, чтение файлов и мелкие делегированные правки могут породить много вызовов; нет смысла оплачивать Pro для каждого из них, если глубокое рассуждение требуется только в главной ветке.
Что означает [1m]
В текущей документации DeepSeek нет отдельного определения суффикса [1m]. Документы показывают, что он используется для основной Flash-модели и переопределений Opus/Sonnet, тогда как Haiku и CLAUDE_CODE_SUBAGENT_MODEL остаются обычным deepseek-flash; таблица моделей при этом указывает контекст 1M. Поэтому безопаснее понимать [1m] как обозначение Claude Code для запроса маршрута с миллионным контекстом только там, где его прямо показывает страница интеграции, а не как новую модель, отдельную цену или миллион выходных токенов.
Учитывайте ограничения:
- максимальный output в таблице моделей — 384K, а не 1M;
- пример задаёт
CLAUDE_CODE_AUTO_COMPACT_WINDOW=786432, оставляя запас до предела контекста; - расчёт цены ведётся по ID
deepseek-flashиdeepseek-v4-pro; не добавляйте суффикс к модели, для которой текущая страница интеграции его не показывает.
3. Выполните короткую проверку до запуска большой задачи
Откройте небольшой или тестовый проект:
test -n "${ANTHROPIC_AUTH_TOKEN:-}"
test "$ANTHROPIC_BASE_URL" = "https://api.deepseek.com/anthropic"
claude --version
cd /path/to/your/project
claudeДайте наблюдаемое задание без изменений файлов, например: «Прочитай package.json или pyproject.toml, перечисли доступные scripts и ничего не редактируй». Успех — нормальный ответ и завершённый tool call чтения файла без 401, 402, 429, ошибок соединения или модели. Взаимодействие синхронное: job ID и polling здесь не нужны, результат появляется в текущей сессии.
Если Claude Code не работает, отделите endpoint от клиента с помощью официальной схемы Anthropic SDK и сохраните ответ в файл:
python3 -m pip install anthropic
python3 - <<'PY'
import os
from pathlib import Path
import anthropic
client = anthropic.Anthropic(
base_url=os.environ["ANTHROPIC_BASE_URL"],
api_key=os.environ["ANTHROPIC_AUTH_TOKEN"],
)
message = client.messages.create(
model="deepseek-flash",
max_tokens=200,
messages=[{"role": "user", "content": "Reply with: endpoint OK"}],
)
text = "\n".join(block.text for block in message.content if block.type == "text")
Path("deepseek-smoke.txt").write_text(text, encoding="utf-8")
print("saved deepseek-smoke.txt")
PYЕсли deepseek-smoke.txt создан, а Claude Code по-прежнему падает, ищите конфликт переменных, другой settings-файл или незакрытый старый процесс. Если не работает и SDK, сначала проверьте Base URL, ключ, баланс и состояние сервиса.
DeepSeek предупреждает, что неподдерживаемое имя автоматически переводится на deepseek-flash. SDK-проверка подтверждает транспорт, а read-only задача Claude Code — ещё и один базовый вызов tool; ни одна из них не доказывает идентичность модели. Перед сравнением качества или бюджета Pro проверьте доступные у провайдера request-, usage- или billing-данные. Если модель там не указана, не считайте успешный ответ доказательством работы Pro.
Совместимость tools, thinking и веб-поиска имеет границы
Anthropic Messages поддерживается на уровне основных полей, но это не делает DeepSeek полным поведенческим аналогом Claude. В таблице совместимости для Claude Code важны следующие пункты:
| Возможность | Статус | Практическое следствие |
|---|---|---|
tools, tool_use, tool_result | Основные поля поддерживаются | Есть протокольная основа для локальных файловых и командных инструментов |
tool_choice | Поддерживается, но disable_parallel_tool_use игнорируется | Нельзя рассчитывать, что этот флаг строго запретит параллельные tools |
| Web Search | Нативно поддерживается интеграцией Claude Code | Суммаризация найденного создаёт дополнительные LLM-вызовы и расход токенов |
Anthropic cache_control | Игнорируется | Нельзя выводить факт cache hit из директив Anthropic |
| Thinking | Поддерживается; budget_tokens игнорируется, effort поддерживается | В примере задан CLAUDE_CODE_EFFORT_LEVEL=max; бюджет Claude здесь не управляет расходом |
Входные блоки document и search_result | Не поддерживаются | Сценарии, завязанные на эти блоки, сначала проверяйте на малом примере |
code_execution_tool_result и mcp_tool_use | Не поддерживаются | Серверное выполнение кода и специальные Anthropic MCP-блоки не эквивалентны |
tool_result.is_error | Игнорируется | Middleware не должно передавать смысл ошибки только этим полем |
DeepSeek отдельно сообщает о поддержке Web Search в Claude Code. Поиск запускается, когда модель считает его нужным, а затем дополнительные запросы суммаризируют результаты. Поэтому в оценку стоимости включайте не только исходный prompt, но и поиск, длинный контекст, повторные tools и retries.
Ищите причину по симптому
| Симптом | Что проверить первым | Как исправить и перепроверить |
|---|---|---|
| 401 / authentication failure | Ключ, пробелы, наличие переменной именно в этом терминале | Введите ключ заново скрытым способом, перезапустите Claude Code и повторите короткое чтение |
| 402 / insufficient balance | Баланс DeepSeek | Пополните баланс и повторите тот же короткий запрос |
| 400 / 422 | Поля запроса, ID модели, переписывающий запрос proxy | Верните официальные переменные; собственный Thinking + tools клиент обязан возвращать весь reasoning_content |
| 429 | Частота запросов и параллельные сессии | Снизьте concurrency и повторите с паузой |
| 500 / 503 | Сбой или перегрузка сервиса | Немного подождите, повторите и зафиксируйте время, если ошибка сохраняется |
| Ответ есть, но Pro не ощущается | Опечатка или fallback неподдерживаемого имени | Используйте точный deepseek-v4-pro и проверьте модель/тариф в кабинете |
| Настройки будто не изменились | Старый процесс или другой слой настроек | Закройте все процессы, откройте новый терминал, задайте переменные и запустите снова |
| Web Search не вызван | Модель могла решить, что поиск не нужен | Явно запросите актуальные данные из веба; отсутствие поиска не означает разрыв соединения |
Официальный список ошибок отдельно описывает 401, 402, 429, 500 и 503. Меняйте по одному параметру и каждый раз повторяйте один и тот же короткий тест — иначе невозможно понять, какая правка помогла.
Сравнение цен DeepSeek и BetterToken на 27 сентября 2026 года
Все суммы ниже — USD за 1 млн токенов. DeepSeek делит тариф на peak и off-peak, а BetterToken публикует единую каталожную цену без аналогичного расписания. Перед большим запуском заново проверьте официальные цены DeepSeek и единственную страницу цен BetterToken.
Официальные цены DeepSeek
| ID / текущая версия | Период | Input без cache hit | Input с cache hit | Output |
|---|---|---|---|---|
deepseek-flash / DeepSeek-V4.1-Flash | Off-peak | $0.15 | $0.003 | $0.60 |
deepseek-flash / DeepSeek-V4.1-Flash | Peak | $0.30 | $0.006 | $1.20 |
deepseek-v4-pro / DeepSeek-V4-Pro-0813 | Off-peak | $0.66 | $0.022 | $1.98 |
deepseek-v4-pro / DeepSeek-V4-Pro-0813 | Peak | $1.32 | $0.044 | $3.96 |
Peak действует по будням 01:00–04:00 и 06:00–10:00 UTC, кроме государственных праздников Китая; остальное время относится к off-peak. В журнале изменений от 10 сентября сказано, что deepseek-flash теперь вызывает V4.1 Flash, а старые имена deepseek-v4-flash временно маршрутизируются на новую модель.
Публичный каталог BetterToken
| ID BetterToken / текущая модель | Типы endpoint | Input | Cache hit | Output |
|---|---|---|---|---|
deepseek-flash / последняя Flash, сейчас V4.1 Flash | Anthropic, OpenAI | $0.132 | $0.00264 | $0.528 |
deepseek-pro / последняя Pro, сейчас V4-Pro-0813 | OpenAI | $0.5808 | $0.01936 | $1.7424 |
deepseek-v4-pro-0813 / V4-Pro-0813 | Anthropic, OpenAI | $0.5896 | $0.0176 | $1.7644 |
deepseek-pro немного дешевле, но в каталоге для него указан только OpenAI endpoint. Сходное имя и цена не делают его подходящим для Anthropic Messages в Claude Code. Для Pro через BetterToken проверять нужно deepseek-v4-pro-0813, у которого явно указан Anthropic.
Пример для 1 млн входных токенов без cache hit и 200 тыс. выходных токенов, без поиска и retries:
- Flash: около $0.27 у DeepSeek в off-peak, $0.54 в peak и $0.2376 по каталогу BetterToken.
- Pro: около $1.056 у DeepSeek в off-peak, $2.112 в peak и $0.9425 у Anthropic-совместимого Pro ID BetterToken.
Это снимок каталога на 27 сентября 2026 года, а не обещание, что BetterToken всегда дешевле. Итог меняют длина контекста, циклы tools, Web Search, retries и будущие цены.
Как оценить маршрут через BetterToken, не придумывая mapping
В публичном каталоге BetterToken у deepseek-flash и deepseek-v4-pro-0813 указан Anthropic endpoint, а deepseek-pro доступен только через OpenAI. Этого достаточно для сравнения цен и выбора кандидатов, но недостаточно, чтобы считать конкретный mapping Claude Code подтверждённым.
Текущая инструкция BetterToken для Claude Code описывает Base URL https://bettertoken.ai без /v1, авторизацию, перезапуск и mapping для Claude, Kimi и GLM. Отдельного DeepSeek-профиля на странице нет. Для Claude provider документ также прямо запрещает вручную задавать ANTHROPIC_MODEL и ANTHROPIC_DEFAULT_*_MODEL. Поэтому не создавайте постоянную DeepSeek-конфигурацию только по записи в ценовом каталоге.
Если в актуальном Setup BetterToken или новой документации появится DeepSeek profile, используйте показанный там точный model ID и повторите короткую read-only задачу и SDK smoke test из предыдущего раздела. Для Pro рассматривайте только deepseek-v4-pro-0813 с Anthropic support, не подставляя OpenAI-only deepseek-pro. Пока специальный mapping не описан или не подтверждён в вашем аккаунте, известной конфигурацией остаётся прямой endpoint DeepSeek.
Для оценки маршрута сначала проверьте текущие цены, затем создайте аккаунт и API Key.
Какой вариант выбрать
- Большинство задач разработки: прямой endpoint DeepSeek и
deepseek-flash[1m]— это текущая официальная схема с разумной ценой для итераций. - Сложная и дорогая ошибка: основная ветка и Opus на
deepseek-v4-pro, Sonnet, Haiku и subagent на Flash. До масштабирования исключите silent fallback. - Единый баланс или несколько провайдеров: оценивайте BetterToken только если текущий Setup показывает DeepSeek profile. Считайте
supported_endpoint_typesфильтром кандидатов, затем проверьте mapping, точный ID и цену в тот же день. - Нужны специфические блоки Anthropic или поведенческая эквивалентность Claude: используйте модель Claude. Совместимый транспорт не гарантирует одинаковое поведение и полный набор tools.
Перед работой с важным репозиторием замкните проверку: версия CLI видна, ключ не отображается, Base URL точный, короткое чтение успешно, а идентичность модели либо подтверждена доступными данными, либо явно остаётся неподтверждённой. Тогда изменение alias, mapping или цены не превратится в долгую слепую диагностику.
