Gonka AI x Claude Code
Оригинал: Gonka AI x Claude Code
Привет всем,
Что мы построили
Мы создали @gonkagate/claude-code, небольшой установщик с открытым исходным кодом для людей, которые хотят использовать Claude Code с Gonka через GonkaGate.
Это специально решает скучную проблему. Большинство людей не хотят экспортировать переменные env вручную, редактировать профили оболочки или создавать файл .env только для того, чтобы Claude Code разговаривал со шлюзом.
Поэтому мы сократили поток. Вы запускаете одну команду, вводите gp-... Ключ API в скрытой подсказке, выберите модель, выберите область действия, и Claude Code готов к использованию.
Почему мы это построили
Сама настройка шлюза не представляет особых сложностей. Самое неприятное — это первая настройка в Claude Code.
Именно в этой части люди по-прежнему проводят проводку вручную чаще, чем следовало бы. Если у кого-то уже есть GP-... Ключ API, позволяющий перейти к обычному рабочему процессу Клауда, не должен включать изменение конфигурации оболочки.
Быстрый старт
npx @gonkagate/claude-code
Что делает установщик
- Просит скрытый gp-... API-ключ
- Позволяет выбрать поддерживаемую модель из тщательно подобранного списка.
- Записывает настройки Claude Code в пользовательской или локальной области.
- Оставляет несвязанные настройки Claude Code без изменений.
- Создает резервную копию перед заменой существующего файла настроек.
- Не затрагивает профили оболочки и не создает файлы .env.
- Помогает сохранить локальные секретные настройки из git во время локальной настройки проекта.
Хост и транспорт шлюза
Под капотом установщик указывает Claude Code на хост шлюза GonkaGate:
https://api.gonkagate.com
Для Claude Code это означает, что на этом хосте есть совместимая с Anthropic конечная точка.
Тот же хост GonkaGate также обслуживает OpenAI-совместимые маршруты /v1/* для клиентов в стиле OpenAI, но этот установщик предназначен специально для Claude Code. Он устанавливает антропный поток на стороне Клода и оставляет путь OpenAI в покое.
Модели прямо сейчас
На данный момент мы держим общедоступный список моделей Claude Code небольшим, но стоит уточнить одну деталь.
GonkaGate не решает, какие модели существуют в сети Gonka. Как провайдер, совместимый с OpenAI и провайдер, совместимый с Anthropic, мы обслуживаем то, что действительно доступно в сети.
Таким образом, список моделей в этом установщике не является пользовательским каталогом, который мы полностью контролируем. Это тщательно подобранный список доступных в сети моделей, которые мы включили в этот поток кода Claude.
На данный момент поддерживается один вариант: qwen3-235b.
По мере появления новых моделей в Gonka Network мы будем исправлять утилиту и добавлять их сюда.
Демо
Больше ссылок
пакет npm: https://www.npmjs.com/package/@gonkagate/claude-code
README: https://github.com/GonkaGate/gonkagate-claude-code#readme
Устранение неполадок: https://github.com/GonkaGate/gonkagate-claude-code/blob/main/docs/troubleshooting.md
- Примечания по безопасности: https://github.com/GonkaGate/gonkagate-claude-code/blob/main/docs/security.md.
Как это работает: https://github.com/GonkaGate/gonkagate-claude-code/blob/main/docs/how-it-works.md
Журнал изменений: https://github.com/GonkaGate/gonkagate-claude-code/blob/main/CHANGELOG.md
- Проблемы и отзывы: https://github.com/GonkaGate/gonkagate-claude-code/issues.
Обратная связь
Если вы используете Gonka с локальными инструментами программирования, нас больше всего интересуют следующие отзывы:
Какие инструменты разработчика нам следует поддерживать дальше
Когда адаптация по-прежнему кажется грубой или запутанной
Какие модели вы на самом деле хотели бы использовать в этом потоке кода Клода, поскольку они появляются в сети Gonka?
Если что-то в установке все еще кажется неудобным на практике, мы хотим услышать именно об этом. Мы будем продолжать корректировать его в зависимости от того, с чем на самом деле сталкиваются люди.
Hi everyone,
What we built
We made @gonkagate/claude-code , a small open source installer for people who want to use Claude Code with Gonka through GonkaGate.
It solves a boring problem on purpose. Most people do not want to export env vars by hand, edit shell profiles, or create a .env file just to get Claude Code talking to a gateway.
So we kept the flow short. You run one command, enter a gp-... API key in a hidden prompt, choose a model, choose a scope, and then Claude Code is ready to use.
Repo: https://github.com/GonkaGate/gonkagate-claude-code
Website: https://gonkagate.com/en
Why we built it
The gateway setup itself is not especially hard. The annoying part is first-time setup in Claude Code.
That is the part people still end up wiring by hand more often than they should. If someone already has a gp-... API key, getting to a normal claude workflow should not involve touching shell config.
Quick start
npx @gonkagate/claude-code
What the installer does
- Asks for a hidden gp-... API key
Lets you choose a supported model from the curated list
Writes Claude Code settings in user or local scope
Leaves unrelated Claude Code settings alone
Creates a backup before replacing an existing settings file
Does not touch shell profiles or create .env files
Helps keep local secret-bearing settings out of git during project-local setup
Gateway host and transport
Under the hood, the installer points Claude Code at the GonkaGate gateway host:
https://api.gonkagate.com
For Claude Code, that means the Anthropic-compatible endpoint on that host.
The same GonkaGate host also serves OpenAI-compatible /v1/* routes for OpenAI-style clients, but this installer is specifically for Claude Code. It sets up the Claude-side Anthropic flow and leaves the OpenAI path alone.
Models right now
We are keeping the public Claude Code model list small for now, but one detail is worth making explicit.
GonkaGate does not decide which models exist on Gonka Network. As an OpenAI-compatible provider and an Anthropic-compatible provider, we serve what is actually available in the network.
So the model list in this installer is not a custom catalog we fully control. It is a curated list of network-available models that we have patched into this Claude Code flow.
Right now there is one supported option: qwen3-235b .
As new models show up in Gonka Network, we will patch the utility and add them here.
Demo
More links
npm package: https://www.npmjs.com/package/@gonkagate/claude-code
README: https://github.com/GonkaGate/gonkagate-claude-code#readme
Troubleshooting: https://github.com/GonkaGate/gonkagate-claude-code/blob/main/docs/troubleshooting.md
Security notes: https://github.com/GonkaGate/gonkagate-claude-code/blob/main/docs/security.md
How it works: https://github.com/GonkaGate/gonkagate-claude-code/blob/main/docs/how-it-works.md
Changelog: https://github.com/GonkaGate/gonkagate-claude-code/blob/main/CHANGELOG.md
Issues and feedback: https://github.com/GonkaGate/gonkagate-claude-code/issues
Feedback
If you are using Gonka with local coding tools, the feedback we would care about most is:
Which developer tools we should support next
Where the onboarding still feels rough or confusing
Which models you would actually want to use in this Claude Code flow as they appear on Gonka Network
If anything in the setup still feels awkward in practice, that is what we want to hear about. We will keep adjusting it based on what people actually run into.
Привет всем,
Что мы построили
Мы создали @gonkagate/claude-code, небольшой установщик с открытым исходным кодом для людей, которые хотят использовать Claude Code с Gonka через GonkaGate.
Это специально решает скучную проблему. Большинство людей не хотят экспортировать переменные env вручную, редактировать профили оболочки или создавать файл .env только для того, чтобы Claude Code разговаривал со шлюзом.
Поэтому мы сократили поток. Вы запускаете одну команду, вводите gp-... Ключ API в скрытой подсказке, выберите модель, выберите область действия, и Claude Code готов к использованию.
Почему мы это построили
Сама настройка шлюза не представляет особых сложностей. Самое неприятное — это первая настройка в Claude Code.
Именно в этой части люди по-прежнему проводят проводку вручную чаще, чем следовало бы. Если у кого-то уже есть GP-... Ключ API, позволяющий перейти к обычному рабочему процессу Клауда, не должен включать изменение конфигурации оболочки.
Быстрый старт
npx @gonkagate/claude-code
Что делает установщик
Хост и транспорт шлюза
Под капотом установщик указывает Claude Code на хост шлюза GonkaGate:
https://api.gonkagate.com
Для Claude Code это означает, что на этом хосте есть совместимая с Anthropic конечная точка.
Тот же хост GonkaGate также обслуживает OpenAI-совместимые маршруты /v1/* для клиентов в стиле OpenAI, но этот установщик предназначен специально для Claude Code. Он устанавливает антропный поток на стороне Клода и оставляет путь OpenAI в покое.
Модели прямо сейчас
На данный момент мы держим общедоступный список моделей Claude Code небольшим, но стоит уточнить одну деталь.
GonkaGate не решает, какие модели существуют в сети Gonka. Как провайдер, совместимый с OpenAI и провайдер, совместимый с Anthropic, мы обслуживаем то, что действительно доступно в сети.
Таким образом, список моделей в этом установщике не является пользовательским каталогом, который мы полностью контролируем. Это тщательно подобранный список доступных в сети моделей, которые мы включили в этот поток кода Claude.
На данный момент поддерживается один вариант: qwen3-235b.
По мере появления новых моделей в Gonka Network мы будем исправлять утилиту и добавлять их сюда.
Демо
Больше ссылок
пакет npm: https://www.npmjs.com/package/@gonkagate/claude-code
README: https://github.com/GonkaGate/gonkagate-claude-code#readme
Устранение неполадок: https://github.com/GonkaGate/gonkagate-claude-code/blob/main/docs/troubleshooting.md
Как это работает: https://github.com/GonkaGate/gonkagate-claude-code/blob/main/docs/how-it-works.md
Журнал изменений: https://github.com/GonkaGate/gonkagate-claude-code/blob/main/CHANGELOG.md
Обратная связь
Если вы используете Gonka с локальными инструментами программирования, нас больше всего интересуют следующие отзывы:
Какие инструменты разработчика нам следует поддерживать дальше
Когда адаптация по-прежнему кажется грубой или запутанной
Какие модели вы на самом деле хотели бы использовать в этом потоке кода Клода, поскольку они появляются в сети Gonka?
Если что-то в установке все еще кажется неудобным на практике, мы хотим услышать именно об этом. Мы будем продолжать корректировать его в зависимости от того, с чем на самом деле сталкиваются люди.