Claude Code + DeepSeek

Claude Code работает с Anthropic-совместимым API. NexGate отдаёт такой endpoint, поэтому Claude Code можно перевести на DeepSeek, не меняя привычный терминальный рабочий процесс. Меняются три переменные окружения.

Получить ключ

Почему это вообще возможно. Claude Code — клиент, а не модель: он отправляет запросы на Anthropic-совместимый адрес /v1/messages. Мы поддерживаем этот протокол, поэтому Claude Code видит обычный API и не знает, что за ним стоит DeepSeek.

Шаг 1. Получите ключ

Регистрация по почте, пополнение от 100 ₽ картой РФ или через СБП, ключ nx_… в кабинете. Он показывается один раз.

Шаг 2. Задайте переменные окружения

Linux и macOS — в ~/.bashrc или ~/.zshrc. Windows PowerShell — в профиле пользователя. Важно: без /v1 в конце Base URL, Claude Code добавляет версию сам.

export ANTHROPIC_BASE_URL="https://nexgate.ru"
export ANTHROPIC_AUTH_TOKEN="nx_ВАШ_КЛЮЧ"
export ANTHROPIC_MODEL="deepseek-flash"

После правки перезапустите терминал или выполните source ~/.bashrc, иначе переменные не попадут в процесс claude.

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

Откройте проект в терминале и запустите claude как обычно. Первый запрос уйдёт на наш endpoint. Проверьте журнал в кабинете: в строке будет модель deepseek-flash, число токенов и списание.

Шаг 4. Настройте режим мышления

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

Бюджет thinkingreasoning_effortКогда
выключено—Простые правки, экономия
около 4 000lowОбычные задачи
около 16 000highРазбор кода, отладка
около 32 000maxСложные архитектурные задачи

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

Какой режим выбрать

Claude Code — не чат, а агент: он читает файлы, правит код и запускает команды. Поэтому «глубоко» на каждый шаг — это дорого и медленно. Практика простая: держите обычный уровень для рутины и повышайте его, когда агент дважды не смог разобраться в причине ошибки.

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

Как устроен маршрут

Claude Code отправляет запрос на /v1/messages в формате Anthropic: сообщения, системный промпт, инструменты и блок thinking. Шлюз принимает его, проверяет ключ и баланс, переводит в формат провайдера и возвращает ответ обратно в формате Anthropic — включая события стриминга. Для клиента это неотличимо от официального API, кроме адреса и ключа.

Если инструмент присылает незнакомые поля, они не ломают запрос: шлюз передаёт поддерживаемые параметры и игнорирует остальные. А если провайдер вернул ошибку, клиент получает её с понятным кодом — 401, 402, 429 или 5xx, — а не общий таймаут.

Ограничения, о которых лучше знать

Через Anthropic-совместимый endpoint работает только DeepSeek Flash. Kimi K3.1 Pro в Claude Code не подключится: у неё нет такого протокола, и подменять его на стороне шлюза мы не будем — это ломает ожидания клиента от модели.

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

Сколько это стоит

Claude Code — агент: он много читает и мало пишет, поэтому большая часть счёта приходится на входные токены и кэш. Цена DeepSeek Flash: 35 ₽ за 1 млн входных, 5 ₽ за 1 млн кэшированных, 100 ₽ за 1 млн выходных. Для сравнения, Kimi K3.1 Pro — 250/90/1300 ₽.

Пример: месяц работы агента — 40 млн входных токенов, из них 30 млн в кэше, и 2 млн выходных. По цене DeepSeek Flash это 700 ₽. Точный расчёт под свой профиль есть в калькуляторе на странице тарифов.

Создать ключ Тарифы

Если не работает

404 на /v1/v1/messages

В ANTHROPIC_BASE_URL остался /v1. Claude Code добавляет версию сам — оставьте только https://nexgate.ru.

401 Unauthorized

Ключ не попал в окружение или скопирован с пробелом. Проверьте echo $ANTHROPIC_AUTH_TOKEN в том же терминале, где запускаете claude.

Claude Code игнорирует переменные

Обычно он запущен из другого профиля или из IDE, где окружение своё. Перезапустите терминал, проверьте переменные и только потом запускайте claude.

402 — закончился баланс

Пополните в кабинете: зачисление сразу после оплаты, чек НПД на почту. Остаток хранится без ограничения срока.

Хочу Kimi в Claude Code

Не получится: у Kimi K3.1 Pro нет Anthropic-совместимого endpoint. Используйте Kimi в Cursor, Cline, Codex CLI или OpenCode — там OpenAI-совместимый протокол.