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

Навігація

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

Категорії

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

Інструменти

Claude Code + Gonka AI — LLM для терміналу

Claude Code — потужний AI-асистент для розробки прямо в терміналі. Працює з Git, файловою системою, запускає тести, рефакторить код. Але нативний Claude Sonnet 4.6 коштує $3-15 за 1M токенів, і при активній роботі рахунок за тиждень може перевищити $200.

JoinGonka Gateway підтримує нативний Anthropic API (/v1/messages) — Claude Code підключається напряму, без проксі. Моделі MiniMax M2.7, DeepSeek V4 Flash та GLM-5.3 Flash через децентралізовану мережу Gonka за $0.0069/1M токенів — у сотні разів дешевше, при співставній якості на задачах кодингу.

Налаштування займає 2 хвилини: одна команда інсталятора або кілька змінних оточення.

Крок 1: Отримати API-ключ

Якщо у вас ще немає ключа JoinGonka Gateway:

  1. Зареєструйтеся на gate.joingonka.ai/register.
  2. Отримайте бонус 3M безкоштовних токенів.
  3. Створіть API-ключ у Dashboard → API Keys.
  4. Скопіюйте ключ (формат: jg-xxx).

Один ключ працює з будь-яким OpenAI-сумісним інструментом: Cursor, Aider, LangChain і т.д.

Крок 2: Підключити Claude Code

JoinGonka Gateway нативно підтримує Anthropic Messages API (/v1/messages) — проксі не потрібен.

Рекомендований спосіб — інсталятор в одну команду:

npx @joingonka/setup --tool claude-code

Це універсальний інсталятор JoinGonka: запустіть без прапорця — npx @joingonka/setup — і він запропонує вибрати інструмент зі списку. Їх уже 25: Claude Code, Codex CLI, OpenClaw, Cursor, Cline та інші — повний список у README пакета.

Інсталятор запитає API-ключ, зробить бекап ~/.claude/settings.json і прописатиме в блок env лише свої поля, не зачіпаючи решту ваших налаштувань: адресу шлюзу (ANTHROPIC_BASE_URL), ключ (ANTHROPIC_AUTH_TOKEN), модель (ANTHROPIC_MODEL і аліаси opus, sonnet, haiku) та її реальні ліміти — CLAUDE_CODE_MAX_CONTEXT_TOKENS і CLAUDE_CODE_MAX_OUTPUT_TOKENS. Ліміти важливі: для незнайомого ідентифікатора Claude Code передбачає власне вікно контексту й не встигає вчасно стиснути історію, а в моделей мережі вікно своє — від 200K до 390K токенів. Файл із ключем отримує права 600. За замовчуванням ставиться DeepSeek V4 Flash, іншу модель вибирає прапорець --model minimax|deepseek|glm. З прапорцем --scope local налаштування пишуться в .claude/settings.local.json поточного проєкту, а сам файл додається в .gitignore.

Налаштувати вручну (план Б)

Або вручну — через змінні середовища:

export ANTHROPIC_BASE_URL=https://gate.joingonka.ai
export ANTHROPIC_AUTH_TOKEN=jg-your-key
export ANTHROPIC_MODEL=deepseek-ai/DeepSeek-V4-Flash-0731
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=380000
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=32768
claude

Перші дві змінні направляють Claude Code на шлюз: запити йдуть у нативному Anthropic-форматі, Gateway конвертує їх у запити до мережі Gonka і повертає відповідь у форматі Anthropic. ANTHROPIC_MODEL закріплює модель мережі — без неї Claude Code відправить власний ідентифікатор claude-*, і шлюз підставить модель за замовчуванням. Дві останні оголошують реальне вікно контексту й стелю відповіді вибраної моделі (потрібен Claude Code 2.1.223 або новіший): інакше для незнайомого ідентифікатора Claude Code передбачає власне вікно й не встигає вчасно стиснути історію. Значення для інших моделей мережі — у розділі «Поради щодо роботи» нижче.

Що підтримується:

  • Streaming — відповідь починає відображатися одразу (SSE у форматі Anthropic: message_start, content_block_delta, message_stop)
  • Tool calling — Claude Code активно використовує функції для роботи з файлами та командами. Нативний tool calling у всіх моделей мережі.
  • System prompts — системні промпти передаються як є

Перевірка: у Claude Code задайте будь-яке питання. Якщо відповідь з'явилася — все працює.

Для Windows/PowerShell:

$env:ANTHROPIC_BASE_URL="https://gate.joingonka.ai"
$env:ANTHROPIC_AUTH_TOKEN="jg-your-key"
$env:ANTHROPIC_MODEL="deepseek-ai/DeepSeek-V4-Flash-0731"
$env:CLAUDE_CODE_MAX_CONTEXT_TOKENS="380000"
$env:CLAUDE_CODE_MAX_OUTPUT_TOKENS="32768"
claude

Колишній вузький інсталятор npx @joingonka/claude-code замінено універсальним @joingonka/setup і більше не розвивається — використовуйте новий.

Порівняння вартості з Anthropic

Claude Code — один з найбільш «ненажерливих» AI-інструментів: він надсилає повний контекст файлів, історію команд та diff'и. Типова сесія споживає 20-50M токенів.

ПровайдерМодельЦіна input/output за 1MСесія 4год (~30M токенів)Місяць (20 робочих днів)
JoinGonkaMiniMax M2.7 / DeepSeek V4 Flash / GLM-5.3 Flash$0.0069 / $0.021$0.14$2.9
AnthropicClaude Sonnet 4.6$3.00 / $15.00$210$4,200
OpenAIGPT-5.5$5.00 / $30.00$300$6,000

Різниця — три порядки. За $2.9 на місяць через JoinGonka ви отримуєте те, що коштує $4,200+ у Anthropic. Для інді-розробника це різниця між «можу дозволити AI-асистента» і «не можу».

Поради щодо роботи

Кілька рекомендацій для ефективної роботи з Claude Code через Gonka:

  • Контекст: у MiniMax M2.7 контекстне вікно 200K токенів (~100K слів) — достатньо для більшості проектів, у DeepSeek V4 Flash — 380K, у GLM-5.3 Flash — 390K. Максимальна довжина відповіді через Gateway — 8192 токенів у MiniMax M2.7 та GLM-5.3 Flash, 32768 у DeepSeek V4 Flash. Для довгих генерацій може знадобитися розбити задачу на частини. Актуальний список моделей мережі — GET https://gate.joingonka.ai/v1/models.
  • Streaming: Gateway підтримує streaming у нативному Anthropic-форматі — відповідь починає відображатися одразу, як при нативному Claude.
  • Tool calling: усі моделі мережі підтримують нативний tool calling, що важливо для Claude Code — інструмент активно використовує функції для роботи з файлами та командами.
  • Затримка: перший запит може зайняти 5-10 секунд (холодний старт ноди). Наступні — 1-3 секунди.
  • Інші інструменти: JoinGonka Gateway сумісний і з OpenAI API — Aider, OpenCode, Cursor підключаються через /v1/chat/completions.

Для розробників, які віддають перевагу іншим термінальним інструментам, див. також: Aider, OpenCode.

Claude Code + Gonka = потужний термінальний AI-асистент за ~$0.60/місяць замість $4,200 у Anthropic. Пряме підключення через Anthropic API — без проксі: одна команда інсталятора, 2 хвилини. Безкоштовні токени на старті.

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

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

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