GonkaGate Kilo Code

Подключите Kilo Code к GonkaGate через официальный установщик kilo-setup.

Подключите уже установленный Kilo Code к GonkaGate через официальный установщик. Этот гайд использует поддерживаемый сценарий @gonkagate/kilo-setup, чтобы вам не пришлось вручную править Kilo config или хранить секреты в репозитории.

Быстрая настройка через официальный установщик

Запустите официальный установщик:

Быстрая настройка через официальный установщик

npx @gonkagate/kilo-setup

Этот инструмент настраивает уже установленный локально kilo. Сам Kilo Code он не устанавливает.

Выбирайте этот путь, если хотите быстро получить безопасную настройку без ручной правки конфигов:

не кладет секрет в локальный конфиг репозитория по умолчанию
сохраняет несвязанные Kilo-настройки вместо полной перезаписи файлов
сам выбирает рекомендуемый scope для текущей директории
проверяет результат после записи конфига
оставляет вас в обычном kilo

Перед началом

Kilo Code уже установлен локально и доступен как kilo, либо в PATH есть резервная команда kilocode.
Поддерживается точная версия @kilocode/cli@7.2.0.
Для npx установщика доступен Node >=22.14.0.
У вас уже есть API-ключ GonkaGate в формате gp-....
Установщик сейчас стартует с моделью qwen/qwen3-235b-a22b-instruct-2507-fp8.

Как выбрать правильный scope

У установщика есть два scope:

user: сделать GonkaGate доступным на этой машине в целом.
project: сделать GonkaGate настройкой по умолчанию для текущего репозитория.

По умолчанию интерактивный сценарий выбирает:

внутри git-репозитория: project
вне репозитория: user

Здесь есть одно важное ограничение: project scope commit-safe, потому что в .kilo/kilo.jsonc записываются только activation settings. Сам provider.gonkagate все равно живет в user config, поэтому на каждой машине, где будут работать с репозиторием, нужно один раз запустить установщик.

Настройка без интерактива

Используйте это для скриптов, автоматизации или повторяемой локальной настройки:

Настройка без интерактива

npx @gonkagate/kilo-setup --scope project --yes

С ключом из переменной окружения:

С ключом из переменной окружения

GONKAGATE_API_KEY="$GONKAGATE_API_KEY" npx @gonkagate/kilo-setup --scope user --yes

С ключом через stdin и JSON-выводом:

С ключом через stdin и JSON-выводом

printf '%s' "$GONKAGATE_API_KEY" | npx @gonkagate/kilo-setup --api-key-stdin --scope project --yes --json

Если Kilo упорно открывает последнюю выбранную в UI модель, сразу очистите и этот кэш:

Команда

npx @gonkagate/kilo-setup --scope project --clear-kilo-model-cache --yes

Передавайте ключ только так:

скрытый интерактивный prompt
GONKAGATE_API_KEY
--api-key-stdin

Установщик намеренно не принимает обычный --api-key, чтобы секрет не попадал в историю shell или список процессов.

Как проверить настройку

Если Kilo уже открыт, сначала закройте его. Затем начните новую сессию:

Как проверить настройку

kilo

Дальше:

выполните /models
выберите модель GonkaGate, если она еще не активна
отправьте такой промпт:

Reply with exactly: Kilo Code connected to GonkaGate

Этого достаточно, чтобы подтвердить подключение провайдера до длинной coding-сессии.

Если кажется, что ничего не изменилось, сначала проверьте KILO_CONFIG, KILO_CONFIG_DIR и KILO_CONFIG_CONTENT. Любая из этих переменных может перекрыть сохраненный конфиг. Заодно убедитесь, что вы не остались внутри старой Kilo-сессии с runtime overrides.

Куда пишет kilo-setup

Установщик по умолчанию не хранит секреты в репозитории. Он пишет в три места:

user-level secret: ~/.gonkagate/kilo/api-key
user-level durable config: ~/.config/kilo/kilo.jsonc
project-level durable config: .kilo/kilo.jsonc

Как это разделяется:

user scope пишет provider и activation в user config
project scope держит описание провайдера и привязку секрета в user config, а в конфиг проекта пишет только activation

Частые первые ошибки

Если видите	Обычно это значит	Что делать
Настройка останавливается до записи файлов	`kilo` и `kilocode` одновременно отсутствуют, либо локальная версия Kilo не равна точному `@kilocode/cli@7.2.0`	Исправьте `PATH`, затем еще раз проверьте локальную версию Kilo
Установщик пишет, что постоянная настройка прошла успешно, но текущий shell все еще ведет себя неправильно	Более приоритетный runtime layer вроде `KILO_CONFIG`, `KILO_CONFIG_DIR` или `KILO_CONFIG_CONTENT` все еще перекрывает результат	Выйдите из активной Kilo-сессии, запустите обычный `kilo` и проверьте переменные, которые могут перекрывать конфиг
В другом репозитории Kilo все еще открывается на модели GonkaGate	Kilo переиспользовал последнюю выбранную в UI модель из `~/.local/state/kilo/model.json`	Переключите модель в обычном `kilo` или повторно запустите installer с `--clear-kilo-model-cache`
`project` scope работает на одной машине, но не на другой	Project scope активирует GonkaGate на уровне репозитория, но user-level provider definition остается machine-local	Запустите installer на каждой участвующей машине
Хочется передать `--api-key` напрямую	Обычный `--api-key` намеренно не поддерживается	Используйте скрытый prompt, `GONKAGATE_API_KEY` или `--api-key-stdin`

Текущие ограничения

Этот гайд настраивает уже установленный Kilo Code. Сам Kilo Code он не устанавливает.
Текущий публичный сценарий намеренно ограничен точным @kilocode/cli@7.2.0.
Текущий транспортный путь: OpenAI-compatible chat/completions.
Установщик стартует с моделью qwen/qwen3-235b-a22b-instruct-2507-fp8.
Поддержка production-сценариев на native Windows пока не заявлена.

Официальные источники

См. также

Claude Code для поддерживаемого Anthropic-compatible пути
Настройка Cursor для OpenAI-настроек Cursor
Настройка OpenCode для пути через официальный установщик OpenCode
Настройка OpenClaw для custom-provider сценария
Аутентификация и API-ключи для создания, хранения и ротации ключей
Get Models для актуальных machine-readable model ID, если позже захотите уйти с модели по умолчанию в установщике

Kilo Code

On this page