DeepSeek в Claude Code: настройка через AITUNNEL
Claude Code можно направить не на серверы Anthropic, а на любой Anthropic-совместимый адрес. Так агентные сессии идут на более дешёвых моделях, а оплата проходит в рублях. Ниже — рабочая схема через AITUNNEL: три переменные окружения, выбор модели и список ошибок, на которых обычно спотыкаются.
Зачем это нужно
Агентный режим сильно расходует токены: инструмент многократно пересылает одно и то же начало контекста, читает файлы, запускает команды и снова просит модель подумать. Одна рабочая сессия легко превращается в миллионы токенов. Поэтому разработчики пробуют подставлять в привычный интерфейс модели подешевле, в том числе DeepSeek, а оплату брать через агрегатор в рублях.
Технически это возможно, потому что у Claude Code адрес API задаётся переменной окружения, а AITUNNEL заявляет совместимость с форматом Anthropic на адресе без суффикса /v1.
Настройка по шагам
Получите ключ
Создайте аккаунт в сервисе и API-ключ вида
sk-aitunnel-.... Для агента удобно завести отдельный ключ и задать на нём лимит бюджета: так перерасход ограничен заранее.Задайте переменные окружения
Адрес без
/v1, токен авторизации, а стандартный ключ Anthropic оставьте пустым, иначе Claude Code может использовать его вместо токена.Укажите модель
Идентификатор берите из каталога сервиса: он отличается от официальных названий DeepSeek. Claude Code читает выбор основной модели из переменной
ANTHROPIC_MODEL, а лёгкой фоновой — изANTHROPIC_SMALL_FAST_MODEL; названия переменных могут меняться между версиями, сверяйтесь с документацией инструмента.Запустите и проверьте короткой задачей
Попросите объяснить один файл проекта. Если ответ пришёл, а в личном кабинете сервиса появилась запись о расходе, схема работает.
export ANTHROPIC_BASE_URL="https://api.aitunnel.ru"
export ANTHROPIC_AUTH_TOKEN="sk-aitunnel-..."
export ANTHROPIC_API_KEY="" # обязательно оставить пустым
# модель — идентификатор из каталога AITUNNEL (пример, сверьте с каталогом)
export ANTHROPIC_MODEL="deepseek-v4.1-flash"
claude
Ключ для Claude Code в рублях
Anthropic-совместимый адрес, лимит бюджета на каждый ключ и каталог моделей разных провайдеров по одному аккаунту.
Типичные проблемы
| Симптом | Причина и решение |
|---|---|
| 401 или «неверный ключ» | Ключ от другого сервиса. Ключ AITUNNEL начинается с sk-aitunnel-; ключ DeepSeek с sk- здесь не подойдёт. |
| Инструмент просит войти в аккаунт Anthropic | Осталось значение в ANTHROPIC_API_KEY или переменные заданы не в той сессии терминала. Очистите ключ и перезапустите оболочку. |
| Модель не найдена | Указано официальное имя вместо идентификатора из каталога сервиса. Список доступен по GET /v1/models. |
| Пустой или обрезанный ответ у «думающей» модели | Слишком малый лимит вывода: токены уходят на рассуждения. Сервис рекомендует не меньше 50 000 для таких моделей. |
| Отклонён запрос по балансу | Перед запросом проверяется запас средств на самый дорогой сценарий. Пополните баланс или уменьшите лимит вывода. |
Чего ожидать по качеству
Claude Code разработан под модели Claude: промпты, формат вызова инструментов и сообщения об ошибках настроены под них. На другой модели результат может отличаться: агент чаще ошибается в многошаговых задачах или хуже следует инструкциям. Прежде чем переводить на такую связку рабочий проект, прогоните 5–10 типичных задач и сравните с привычной моделью. Для простых правок, рефакторинга и тестов deepseek-flash нередко хватает, для сложной отладки имеет смысл проверять и старшую модель, см. сравнение flash и v4-pro.
Если цель — именно недорогой агент на DeepSeek, у DeepSeek есть собственная открытая оболочка, написанная под его модели: DeepSeek Harness (dsh). Сравнение подходов — в статье Harness, Claude Code и Codex.
Частые вопросы
Можно ли использовать Claude Code с DeepSeek
Да, если направить инструмент на Anthropic-совместимый адрес, который поддерживает нужные модели, например на адрес агрегатора. Это не официальный сценарий Anthropic, поэтому качество работы зависит от выбранной модели.
Нужен ли VPN
Для обращения к агрегатору VPN не нужен: это обычный HTTPS-адрес. Подробности доступа и оплаты — в статье про оплату из России.
Как ограничить расходы агента
Заведите отдельный ключ под агента с лимитом бюджета, задавайте разумный лимит вывода и следите за расходом в кабинете. Ещё больше способов — в статье как сэкономить на токенах.
Ещё по теме
- Подключение через AITUNNEL Один ключ, оплата в рублях, OpenAI- и Anthropic-совместимые адреса.
- DeepSeek Harness (dsh): что это и как подключить Открытый агентный рантайм DeepSeek.
- Ошибки и настройка DeepSeek Harness UNKNOWN_MODEL, провайдер, порт, модели.
- Harness, Claude Code и Codex: сравнение Что выбрать для агента.