GonkaGate настройка MiMoCode

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

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

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

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

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

npx @gonkagate/mimo-code-setup

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

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

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

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

MiMoCode уже установлен локально и доступен как mimo в PATH.
MiMoCode версии 0.1.0 или новее.
Для npx установщика доступен Node >=22.14.0.
У вас уже есть API-ключ GonkaGate в формате gp-....
Установщик сейчас стартует с моделью moonshotai/kimi-k2.6.
Поддерживаемые платформы: macOS, Linux, native Windows и WSL.

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

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

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

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

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

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

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

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

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

npx @gonkagate/mimo-code-setup --scope project --yes

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

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

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

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

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

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

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

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

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

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

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

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

mimo

Перед длинной coding-сессией отправьте один короткий prompt:

Reply with exactly: MiMoCode connected to GonkaGate

Установщик до завершения проверяет resolved MiMoCode config и видимость модели. Это не доказывает достаточность баланса, quota или полную готовность первого billable request.

Если нужно доказательство конфига вне chat-сессии, используйте редактированные diagnostics установщика. Не вставляйте сырой вывод mimo --pure debug config в support-запросы: resolved config может содержать подставленные secret values.

Куда пишет mimo-code-setup

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

user-level durable config: ~/.config/mimocode/mimocode.json
имя создаваемого global config, если существующего MiMoCode config target нет: mimocode.jsonc
project-level durable config: .mimocode/mimocode.json
user-level secret: ~/.gonkagate/mimo-code/api-key
install state: ~/.gonkagate/mimo-code/install-state.json
rollback backups для project config: ~/.gonkagate/mimo-code/backups/project-config

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

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

Каноничная привязка секрета: provider.gonkagate.options.apiKey = {file:~/.gonkagate/mimo-code/api-key}. Она должна жить в user config, а не в repository-local .mimocode/mimocode.json.

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

Если видите	Обычно это значит	Что делать
Настройка останавливается до записи файлов	`mimo` отсутствует, либо локальная версия MiMoCode старее поддерживаемого baseline `0.1.0`	Исправьте `PATH` или обновите MiMoCode, затем повторите запуск установщика
Node.js ниже `22.14.0`	Runtime для `npx` слишком старый для установщика	Обновите Node.js и повторите запуск helper
Установщик пишет, что постоянная настройка прошла успешно, но текущий shell все еще ведет себя неправильно	Более приоритетный runtime layer вроде `MIMOCODE_CONFIG`, `MIMOCODE_CONFIG_CONTENT`, `MIMOCODE_CONFIG_DIR`, `MIMOCODE_AUTH_CONTENT` или `MIMOCODE_DISABLE_PROJECT_CONFIG` перекрывает результат	Выйдите из активной MiMoCode-сессии, запустите обычный `mimo` и проверьте переменные, которые могут перекрывать конфиг
`project` scope работает на одной машине, но не на другой	Project scope активирует GonkaGate на уровне репозитория, но user-level provider definition и secret остаются machine-local	Запустите установщик на каждой участвующей машине
Хочется передать `--api-key` напрямую	Обычный `--api-key` намеренно не поддерживается	Используйте скрытый prompt, `GONKAGATE_API_KEY` или `--api-key-stdin`
Первый MiMoCode prompt падает после setup	Проверка конфига доказала provider wiring и видимость модели, но не balance или first-request readiness	Проверьте баланс, quota и выбранную модель перед повтором

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

Этот гайд настраивает уже установленный MiMoCode. Сам MiMoCode он не устанавливает.
Текущая публичная модель setup: moonshotai/kimi-k2.6.
Текущий транспортный путь: OpenAI-compatible chat_completions через https://api.gonkagate.com/v1.
Стабильный provider id: gonkagate, через managed provider.gonkagate config.
Установщик не принимает произвольные custom base URLs в v1.
Установщик не принимает произвольные model IDs в v1.
Эта страница не заявляет поддержку /v1/responses.
Установщик не меняет shell profiles, не генерирует .env files и не хранит секреты в repository-local config.

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

См. также

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

MiMoCode

На этой странице