DeepSeek V4 Flash и Pro в Claude Code: настройка и переключение моделей

Настройте DeepSeek в Claude Code через APIMaster. Настройте settings.json на Windows, macOS и Linux, запустите claude, выберите модель командой /model и начните общение.

Настройте APIMaster в settings.json, запустите claude, затем введите /model MODEL_ID в диалоге, чтобы использовать DeepSeek. Доступные ID, рассматриваемые здесь: deepseek-v4-flash, deepseek-v4-pro. Claude Code — это клиент; DeepSeek — модель, которая отвечает.

Перед началом работы

Выполните проверку окружения и настройку Claude Code. Получите API-ключ APIMaster с достаточным балансом и доступом к выбранным моделям.

claude --version

Базовый URL шлюза — https://apimaster.ai, без /v1. Claude Code сам добавляет /v1/messages.

1. Откройте каталог конфигурации

Windows

Нажмите Win + R, введите следующий путь и нажмите Enter:

%USERPROFILE%\.claude

При необходимости создайте папку. Откройте или создайте settings.json. Убедитесь, что файл не называется settings.json.txt.

macOS / Linux

На macOS в Finder нажмите Command + Shift + G и введите:

~/.claude

На Linux откройте тот же каталог с помощью файлового менеджера или редактора. При необходимости создайте его:

mkdir -p ~/.claude

Откройте или создайте там settings.json. Если вы задали пользовательский каталог конфигурации Claude Code, используйте его.

2. Отредактируйте settings.json

Windows, macOS и Linux используют одинаковую конфигурацию. Замените YOUR_APIMASTER_API_KEY на ваш ключ APIMaster:

{
  "model": "deepseek-v4-flash",
  "env": {
    "ANTHROPIC_BASE_URL": "https://apimaster.ai",
    "ANTHROPIC_API_KEY": "YOUR_APIMASTER_API_KEY",
    "ANTHROPIC_AUTH_TOKEN": "",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

Если файл уже существует, сделайте его резервную копию и объедините эти поля с существующим JSON-объектом и объектом env. Сохраните другие нужные вам настройки. Не добавляйте второй JSON-объект и не дублируйте ключ env. JSON не допускает комментарии или висячие запятые.

Общее руководство по Claude Code показывает аутентификацию по токену. Это руководство использует аутентификацию по API-ключу, проверенную в наших интеграционных тестах. Держите ANTHROPIC_AUTH_TOKEN пустым при использовании ANTHROPIC_API_KEY и удалите конфликтующие учётные данные из других настроек или вашего терминала. Используйте ключ APIMaster для этого шлюза.

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

3. Запустите Claude Code

В терминале, открытом в каталоге вашего проекта, выполните:

claude

Пройдите обычные подсказки первого запуска и подтвердите подсказку о доверии к проекту. Стартовой моделью должна быть deepseek-v4-flash. Это обычная интерактивная сессия с привычными инструментами и настройками проекта.

4. Выберите модель и начните общение

В диалоге Claude Code введите одну из следующих команд и нажмите Enter:

/model deepseek-v4-flash
/model deepseek-v4-pro

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

Reply with exactly OK.

Обычный текстовый ответ подтверждает базовое соединение. После этого можно продолжить общение или попросить поработать над вашим проектом. Чтобы переключиться снова в том же диалоге, введите ещё одну команду /model MODEL_ID.

Ввод одной команды /model открывает выбор модели. Пользовательские ID шлюза могут не отображаться в её списке по умолчанию. Вместо этого введите полный ID, как показано выше. Слэш-команда относится к Claude Code, а не к PowerShell или Bash. Названия моделей описывают модели DeepSeek, а не Claude Sonnet или Opus.

Вы также можете выбрать модель при запуске из терминала. Выполняйте по одной команде за раз:

claude --model deepseek-v4-flash
claude --model deepseek-v4-pro

Чтобы явно задать значение по умолчанию для будущих сессий, отредактируйте model в settings.json. Флаг запуска, переменная окружения ANTHROPIC_MODEL или настройка проекта/управляемая настройка могут влиять на выбранную модель; проверьте их, если стартовая модель отличается от сохранённого значения.

Устранение неполадок

Симптом	Проверить
401 / неожиданный запрос на вход	Проверьте ключ APIMaster, базовый URL и конфликтующие переменные аутентификации; перезапустите CLI после редактирования настроек.
404	Используйте `https://apimaster.ai`, без `/v1` или `/v1/messages`.
Настройки не вступают в силу	Проверьте расположение файла, корректность JSON и переопределения из терминала, проекта или управляемых настроек.
Модель отсутствует в списке выбора	Введите `/model MODEL_ID` с точным ID или запустите с `claude --model MODEL_ID`.
Модель недоступна / 403	Проверьте написание, разрешённые модели ключа, баланс аккаунта и текущую доступность маршрута.
`unrecognized_model`	Наблюдалось с пользовательскими ID в наших тестах. Проверьте фактический ответ и результат инструмента; встроенные возможности Claude по умолчанию для DeepSeek не проверялись.
Отказ в доступе к файлу или команде	Просмотрите и одобрите предполагаемую операцию через обычные подсказки разрешений.
429 / 5xx / прерванный ответ	Сохраните ошибку, ID модели, версию CLI, время UTC и ID запроса, если доступно, для поддержки.

Валидация и необязательная диагностика

Записанные интеграционные тесты: 2026-09-07 UTC, Claude Code 2.1.239, Linux. Все перечисленные здесь модели вернули ожидаемый текст и прочитали локальный файл через инструмент. Сложные задачи по программированию выходили за рамки этого тестирования. Windows и macOS не входили в эти записанные запуски.

Предыдущие автоматические проверки использовали «голый» режим для изоляции конфигурации. Обычное повседневное использование следует шагам settings.json и интерактивным шагам выше. «Голый» режим и --setting-sources "" пропускают обычные интеграции или сохранённые настройки, поэтому их не следует добавлять в повседневную команду запуска из этого руководства.

Для быстрой неинтерактивной проверки с использованием вашей сохранённой конфигурации:

claude --model deepseek-v4-flash -p "Reply with exactly OK."

Для проверки инструмента создайте probe.txt с содержимым FILE_PROBE_739182, запустите Claude Code в этом каталоге и попросите прочитать файл с помощью инструмента и вернуть его точное содержимое. Убедитесь, что инструмент действительно выполняется.

Это ограниченные интеграционные проверки, а не гарантия каждой функции Claude Code, поведения длительных сессий или максимального контекста. Документация шлюза Anthropic официально не поддерживает маршрутизацию Claude Code к моделям, отличным от Claude; это руководство описывает интеграцию APIMaster.

FAQ

Оплачивает ли моя подписка Claude эти запросы?

Нет. С этой конфигурацией APIMaster запросы используют ваш ключ и баланс APIMaster.

Могу ли я продолжить общение после переключения модели?

Да, используйте команду переключения модели в открытом диалоге и дождитесь подтверждения перед отправкой следующего сообщения. Для чистого сравнения между моделями запустите отдельную сессию с claude --model MODEL_ID.