Использование DeepSeek в Claude Code: Руководство по настройке V4 Flash / Pro
Запустите DeepSeek V4 Flash и Pro в Claude Code через APIMaster. Установите шлюз и ключ API, переключайте модели, проверяйте инструменты чтения файлов и исправляйте ошибки конфигурации.
Может ли Claude Code использовать DeepSeek? Наши тесты с Claude Code 2.1.239 успешно использовали deepseek-v4-flash и deepseek-v4-pro через конечную точку Messages APIMaster. Установите ANTHROPIC_BASE_URL на https://apimaster.ai, укажите ключ APIMaster и выберите модель явно. Эта конфигурация запускает DeepSeek, даже если клиент называется Claude Code.
Последний тест: 2026-09-07, Claude Code 2.1.239, Linux. Обе модели вернули ожидаемый текст и выполнили цикл инструмента чтения файлов. Все запуски завершились с кодом 0. CLI вывел
unrecognized_model, но протестированные запросы прошли успешно. Эти проверки не устанавливают поддержку всех функций Claude Code, длительных сессий или будущих версий. Команды для Windows / macOS включены; записанный тест выполнялся на Linux.
1. Подготовка CLI и ключа API
Следуйте руководству по окружению и руководству по настройке Claude Code для установки. Проверьте свою версию:
claude --version
Получите ключ API APIMaster с доступом к выбранной модели DeepSeek и достаточной квотой. Используйте настройки сессии из этого руководства; нет необходимости перезаписывать ваш обычный settings.json.
2. Установите шлюз и ключ
Откройте новый терминал, чтобы эти настройки были отделены от вашей обычной сессии CLI.
macOS / Linux:
export ANTHROPIC_BASE_URL='https://apimaster.ai'
export ANTHROPIC_API_KEY='YOUR_APIMASTER_API_KEY'
unset ANTHROPIC_AUTH_TOKEN
Windows PowerShell:
$env:ANTHROPIC_BASE_URL = 'https://apimaster.ai'
$env:ANTHROPIC_API_KEY = 'YOUR_APIMASTER_API_KEY'
Remove-Item Env:ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue
Используйте здесь origin сайта, без /v1: Claude Code добавляет /v1/messages. Ключ API должен быть получен от APIMaster. Эти команды влияют на этот терминал и его дочерние процессы, а не на сохраненные файлы входа. Не помещайте реальный ключ в общий файл настроек или репозиторий.
3. Отправьте минимальный тестовый запрос
claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools "" --output-format json -p "Reply with exactly: DEEPSEEK_TEST_OK"
Ожидается: is_error равен false, result равен DEEPSEEK_TEST_OK, и процесс завершается с кодом 0. Измените --model на deepseek-v4-pro и запустите снова.
Протестированная версия в режиме --bare использует явную аутентификацию по ключу API и пропускает обычные фоновые интеграции. --setting-sources "" исключает сохраненные источники настроек, а --tools "" отключает инструменты для этого одного текстового теста. Это намеренные диагностические настройки, а не требования отключать инструменты при обычном использовании. Более старые версии CLI могут не принимать все эти флаги.
4. Проверьте инструменты чтения файлов
Создайте probe.txt в текущем каталоге с этим содержимым:
TOOL_PROBE_739182
Запустите:
claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools Read --allowedTools Read --output-format json -p "Use the Read tool to read probe.txt in the current directory. Reply with only the exact content. Do not guess."
Ожидается: CLI прочитает файл и вернет TOOL_PROBE_739182. Повторите с deepseek-v4-pro. Это проверяет, что модель может запросить инструмент, получить его результат и затем ответить. Для этого теста включен только инструмент Read.
Для обычной интерактивной работы с теми же настройками терминала:
claude --bare --setting-sources "" --model deepseek-v4-flash
Чтобы начать с Pro:
claude --bare --setting-sources "" --model deepseek-v4-pro
Интерактивные команды опускают --tools "", поэтому доступны стандартные инструменты. Просматривайте запросы разрешений как обычно. --bare пропускает такие удобства, как хуки и автоматические инструкции проекта; включайте свои обычные настройки осознанно после того, как минимальная настройка заработает, и проверяйте, что они не переопределяют шлюз или модель. Закройте этот терминал по завершении, чтобы оставить окружение этой сессии.
Устранение неполадок
| Симптом | Что проверить |
|---|---|
unrecognized_model |
Наблюдается для обоих идентификаторов DeepSeek в 2.1.239. Это не помешало нашим запросам завершиться. Проверьте конечный результат, а не рассматривайте предупреждение само по себе как сбой. |
| 401 или неожиданный запрос входа | Убедитесь, что ANTHROPIC_API_KEY установлен, удалите конфликтующий ANTHROPIC_AUTH_TOKEN в этом терминале и повторите попытку в режиме bare. |
| 404 | ANTHROPIC_BASE_URL должен быть https://apimaster.ai, а не полной конечной точкой /v1/messages или базой, заканчивающейся на /v1. |
Неизвестная опция --bare |
Проверьте свою версию относительно протестированной 2.1.239. Используйте общее руководство по установке для обновления, если это уместно. |
Не удается прочитать probe.txt |
Запускайте из каталога файла. Для теста инструмента включите Read, а не используйте --tools "". |
| Выбрана другая модель | Передайте полный идентификатор модели с помощью --model и проверьте сохраненные настройки или переопределения псевдонимов моделей перед их включением. |
| Ограничение скорости, недостаточная квота или ошибка вышестоящей системы | Прочитайте тело ошибки, проверьте квоту и разрешения модели и запишите временную метку для поддержки. |
Часто задаваемые вопросы
Это то же самое, что использование модели Claude?
Нет. Здесь Claude Code — это клиент; выбранная модель — DeepSeek. Функции, зависящие от конкретной модели Claude, автоматически не покрываются этой настройкой.
Почему базовый URL отличается от примера Python SDK?
Python OpenAI SDK использует https://apimaster.ai/v1 и добавляет /chat/completions. Claude Code использует https://apimaster.ai и добавляет /v1/messages. Используйте формат базы, задокументированный для каждого клиента.
Могу ли я использовать официальный ключ DeepSeek с этим шлюзом?
Это руководство требует ключ, выпущенный APIMaster. Ключи специфичны для поставщика, который их выпускает; изменение только конечной точки не переносит учетные данные или квоту.
Было ли протестировано реальное использование инструментов или только текстовый ответ?
Было протестировано и то, и другое для обеих моделей. Тест инструмента прочитал локальный файл и вернул его содержимое. Это не устанавливает, что все инструменты, фоновые агенты или длительные задачи кодирования поддерживаются.