Розділи бази знань ▾

Навігація

▸ Почніть тут За ролями

Категорії

Інструменти 54
Глосарій 12

Інструменти

Claude Code + DeepSeek V4 Flash: як підключити та скільки коштує задача

Коротко: Claude Code працює з DeepSeek без локальних прошарків на кшталт claude-code-router. Підключити можна двома способами: через офіційний API DeepSeek, у якого є власна адреса у форматі Anthropic, або через JoinGonka Gateway, де відповідає відкрита DeepSeek V4 Flash із мережі Gonka. У другому випадку налаштування — одна команда: npx @joingonka/setup --tool claude-code --model deepseek.

Моделі в двох випадках різні. В API DeepSeek з 10 вересня 2026 року працює наступна версія — V4.1 Flash, а V4 Flash, яку обслуговує мережа Gonka, DeepSeek зі свого API зняла. Нижче — обидва налаштування, чим вони відрізняються в роботі та скільки коштує одна задача агента. За цінами на 2 листопада 2026 року задача на 30 звернень до моделі коштує в DeepSeek близько $0.09 у пікові години і близько $0.05 в решту часу, через шлюз — близько $0.02.

Це не Claude, і вдавати, що різниці немає, ми не будемо: Anthropic прямо пише, що не підтримує роботу Claude Code з моделями не від Claude ні через які шлюзи. Технічно все працює — зв'язку Claude Code 2.1.316 зі шлюзом ми перевірили 2 листопада 2026 року, — але з питаннями йти до нас або до DeepSeek, а не до підтримки Anthropic.

Спосіб 1: офіційний API DeepSeek

У DeepSeek є адреса у форматі Anthropic — https://api.deepseek.com/anthropic — і офіційний гайд для Claude Code. Ключ створюється в кабінеті DeepSeek (platform.deepseek.com), баланс поповнюється заздалегідь. Змінні з гайду DeepSeek станом на 2 листопада 2026 року:

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-your-deepseek-key
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
claude

Що варто знати перед першим запуском:

  • Назва моделі. З 10 вересня 2026 року deepseek-flash — це V4.1 Flash, а з 17 жовтня — її оновлення 1017 за тією ж ціною. Стару назву deepseek-v4-flash DeepSeek поки що приймає, але відповідає на неї тією ж V4.1 Flash. Суфікс [1m] повідомляє Claude Code, що вікно моделі — 1 млн токенів, а CLAUDE_CODE_AUTO_COMPACT_WINDOW задає, за якого обсягу стискати історію.
  • Імена Claude. Якщо залишити в Claude Code модель з іменем Claude, DeepSeek підставить свою: імена на claude-opus переходять у V4 Pro і тарифікуються за ціною V4 Pro, решта — у deepseek-flash. Тому в гайді всі аліаси закріплені явно.
  • Пікові години. З 16 серпня 2026 року DeepSeek бере подвійну ціну в будні з 01:00 до 04:00 та з 06:00 до 10:00 за UTC, крім свят Китаю. За пекінським часом це майже весь робочий день, у Європі — ранок, у США — вечір і ніч.
  • Веб-пошук. Коли Claude Code шукає в інтернеті вбудованим інструментом, пошук виконує сама DeepSeek. З 31 жовтня 2026 року це платно: $0.75 за 1000 успішних запитів, плюс токени, які модель витрачає на читання знайденого.

Спосіб 2: JoinGonka Gateway — одна команда

У мережі Gonka працює DeepSeek V4 Flash у версії 0731 — відкриті ваги під ліцензією MIT. Шлюз сам приймає запити Claude Code у форматі Anthropic (/v1/messages), прошарок між ними не потрібен.

Крок 1. Ключ. Зареєструйтеся в JoinGonka Gateway — новим акаунтам нараховуються 3M безкоштовних токенів — і створіть у кабінеті ключ jg-….

Крок 2. Інсталятор.

npx @joingonka/setup --tool claude-code --model deepseek

Інсталятор запитає ключ, збереже копію ~/.claude/settings.json і впише в блок env тільки свої змінні: адресу шлюзу та ключ; модель для поточної й нових сесій, для аліасів opus, sonnet, fable та для субагентів; MiniMax M2.7 для аліаса haiku, на якому Claude Code тримає фонові завдання; справжні межі моделі — вікно 380 000 токенів і відповідь до 32 768. Решту ваших налаштувань він не чіпає, а файлу з ключем ставить права 600. Наприкінці інсталятор перевірить ключ живим запитом. Той самий інсталятор налаштовує й інші програми — їх уже 25, зокрема Codex CLI та OpenCode.

Крок 3. Перевірка. Запустіть claude і відкрийте /status: там мають бути рядок Anthropic base URL з адресою шлюзу та рядок Auth token з ANTHROPIC_AUTH_TOKEN. Потім дайте завдання щодо коду, наприклад Read calc.py and tell me in one sentence whether it has a bug.

Налаштувати вручну

Додайте блок env у ~/.claude/settings.json — значення з цього файлу важливіші за export в оболонці:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gate.joingonka.ai",
    "ANTHROPIC_AUTH_TOKEN": "jg-your-key",
    "ANTHROPIC_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMaxAI/MiniMax-M2.7",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "380000",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32768"
  }
}

Адреса — без /v1: шлях /v1/messages Claude Code допише сам. Назва моделі — повна й без [1m]: із цим суфіксом Claude Code вирішить, що вікно — 1 млн токенів, а в DeepSeek V4 Flash у мережі воно 380 000. Останні два рядки оголошують справжнє вікно й стелю відповіді. Якщо модель не закріпити, Claude Code надішле свою назву claude-*, і шлюз відповість моделлю за замовчуванням — зараз це GLM-5.3 Flash (zai-org/GLM-5.3-Flash).

Усі варіанти налаштування, включно з Windows і налаштуванням лише для одного проєкту, — у гайді з Claude Code.

Чим відрізняються API DeepSeek і JoinGonka у Claude Code

API DeepSeekJoinGonka
МодельV4.1 Flash, версія 1017V4 Flash, версія 0731
Вікно контексту1 млн токенів380 тис. токенів
Відповідь до384 тис. токенів32 768 токенів
Зображеннячитаєлише текст
Міркування у відповідіє, блоками thinkingнемає
Веб-пошук Claude Codeвласний; з 31.10.2026 — $0.75 за 1000 запитівпошук шлюзу
Ціна за токену пікові години вдвічі вищаодна в будь-яку годину
Кешчитання з кешу в 50 разів дешевше за вхідвесь вхід за однією ціною
Ще моделі на ключіV4 ProGLM-5.3 Flash, MiniMax M2.7

Що це означає в роботі:

  • Версія моделі. V4.1 Flash новіша, і за тестами самої DeepSeek вона сильніша: у Terminal-Bench 2.1 V4.1 Flash має 90,6 проти 82,7 у V4 Flash 0731 (за даними випусків 10 вересня та 31 липня). Потрібні зображення, вікно на мільйон токенів або найновіша версія — беріть офіційний API DeepSeek. Важливіша ціна великого обсягу роботи та одна ціна в будь-яку годину — порівняйте V4 Flash через шлюз на своїх задачах, почати можна на безкоштовних токенах.
  • Довгі сесії. У вікно 380 000 токенів вміщається менше історії, ніж у мільйон. Для звичайної роботи цього достатньо: середній запит Claude Code до DeepSeek V4 Flash через наш шлюз у жовтні 2026 року — близько 96 тис. токенів.

Докладніше про саму модель — у статті про DeepSeek V4 Flash у мережі Gonka.

Скільки коштує задача Claude Code на DeepSeek

Спочатку ціни за 1M токенів на 2 листопада 2026 року — за сторінкою цін DeepSeek та API OpenRouter. Поруч із DeepSeek — та сама V4 Flash 0731 у найдешевших постачальників OpenRouter:

ДеМодельВхідВхід з кешуВихід
API DeepSeek, пікові годиниV4.1 Flash$0.30$0.006$1.20
API DeepSeek, решта часуV4.1 Flash$0.15$0.003$0.60
OpenRouter, DeepInfraV4 Flash 0731$0.06$0.015$0.18
OpenRouter, StreamLakeV4 Flash 0731$0.132$0.0042$0.396
JoinGonka GatewayV4 Flash 0731$0.0062окремої ціни немає$0.019

Звичайний вхід у нас у 24–49 разів дешевший, ніж у DeepSeek, вихід — у 32–65 разів. Але читання з кешу в DeepSeek у пікові години коштує приблизно як наш вхід, а в решту часу — вдвічі дешевше за нього, і Claude Code майже весь час перечитує те саме: системний промпт, опис інструментів та історію сесії. Тому порівнювати треба цілу задачу, а не ціну токена.

Задача. Візьмімо задачу на 30 звернень до моделі — наприклад, знайти помилку, виправити код і прогнати тести. За даними нашого шлюзу за жовтень 2026 року, запит Claude Code до DeepSeek V4 Flash — це в середньому близько 96 тис. токенів на вході та 0,9 тис. на виході. Отже, задача — 2,9 млн токенів входу та 27,5 тис. виходу. Claude Code на кожному кроці надсилає сесію заново, і майже вся вона збігається з попереднім запитом, тому приймемо, що в DeepSeek і OpenRouter 95% входу читається з кешу.

ДеЗадача100 таких задач
API DeepSeek, пікові години~$0.092~$9.20
API DeepSeek, решта часу~$0.046~$4.60
OpenRouter, StreamLake — найдешевший постачальник для такої задачі~$0.041~$4.10
OpenRouter, DeepInfra~$0.054~$5.40
JoinGonka Gateway~$0.018~$1.80

Суми пораховано за цінами на 2 листопада 2026 року; наша ціна за токен на цій сторінці жива й змінюється разом із курсом GNK. Для такої задачі шлюз виходить приблизно в 5 разів дешевше за DeepSeek у пікові години, у 2,5 раза — в решту часу та в 2,3 раза дешевше за найдешевшого постачальника тієї самої моделі на OpenRouter.

Різниця залежить від кешу. Якщо з кешу читається 98% входу, DeepSeek дорожчий за нас приблизно в 1,8 раза поза піком і в 3,7 раза в пікові години. Якщо 90% — у 3,7 та 7,4 раза. У нас частка кешу на суму не впливає: весь вхід коштує однаково. Розрахунок на місяць, варіант із GLM-5.3 Flash та ціни самого Claude для довідки — у статті «Claude Code дешевше».

Чи потрібен claude-code-router

Claude Code Router (CCR) — відкритий проєкт з ліцензією MIT: локальний шлюз на вашому комп'ютері, за замовчуванням http://127.0.0.1:3456. Claude Code та інші агенти надсилають запити йому, а він — обраним провайдерам: перекладає запити між форматами (Anthropic Messages, OpenAI Chat і Responses, Gemini), розводить завдання за моделями за правилами, перемикається на резервну модель у разі збою та веде журнал запитів із токенами й оцінкою вартості. Встановлюється застосунком для macOS, Windows і Linux або командою npm install -g @musistudio/claude-code-router (потрібен Node.js 22 або новіший).

Для одного DeepSeek він не потрібен: у DeepSeek є власна адреса у форматі Anthropic, і JoinGonka Gateway теж приймає запити Claude Code напряму. CCR має сенс, якщо ви хочете:

  • тримати кількох провайдерів і правила, яке завдання куди надсилати;
  • автоматично переходити на резервну модель, коли основна не відповідає;
  • бачити журнал запитів, токенів і витрат в одному місці;
  • підключити провайдера, який розуміє лише формат OpenAI.

Свою адресу (custom endpoint) CCR підключає з протоколом Anthropic Messages або OpenAI Chat, і обидва протоколи у шлюзу є: базова адреса https://gate.joingonka.ai для Anthropic і https://gate.joingonka.ai/v1 для OpenAI. Подробиці — в документації Gonka API, розділ Anthropic Messages.

Який ключ вписати в Claude Code і як повернутися на Claude

Ключ стороннього API Claude Code бере з однієї з двох змінних:

  • ANTHROPIC_AUTH_TOKEN — ключ іде заголовком Authorization: Bearer і діє одразу. Так роблять і гайд DeepSeek, і наш інсталятор.
  • ANTHROPIC_API_KEY — ключ іде заголовком x-api-key; в інтерактивному режимі Claude Code один раз запитає, чи використовувати його.

DeepSeek і JoinGonka приймають обидва заголовки. Поки змінна з ключем задана, підписка claude.ai не витрачається: Claude Code пам'ятає ваш вхід, але не надсилає його, а запити оплачуються з балансу цього ключа. Якщо задати лише адресу без ключа, Claude Code надішле на нову адресу свій вхід claude.ai, і запит не пройде.

Ключ зберігайте в ~/.claude/settings.json або в .claude/settings.local.json проєкту, але не в спільному .claude/settings.json репозиторію — його зазвичай комітять. Інсталятор із прапорцем --scope local пише в settings.local.json і сам додає його до .gitignore.

Повернутися на Claude — прибрати з блоку env рядки, які вказують на DeepSeek або шлюз, і перезапустити Claude Code: він знову візьме ваш вхід у claude.ai.

DeepSeek у Claude Code підключається двома способами: офіційний API DeepSeek — V4.1 Flash з вікном у 1 млн токенів і подвійною ціною в пікові години — або JoinGonka Gateway: відкрита V4 Flash 0731 однією командою інсталятора і одна ціна будь-коли. claude-code-router для цього не потрібен. За цінами на 2 листопада 2026 року типова задача на 30 звернень до моделі через шлюз вийшла в 2,5–5 разів дешевше, ніж у DeepSeek. Натомість — вікно 380 000 токенів, лише текст і попередня версія моделі.

Бажаєте дізнатися більше?

Вивчіть інші розділи або почніть заробляти GNK прямо зараз.

Отримати ключ і безкоштовні токени →