Что такое килограммовый код?
Kilo Code от Kilo AI — это агент кодирования искусственного интеллекта с открытым исходным кодом, доступный в VS Code, JetBrains и CLI, с настраиваемыми поставщиками моделей.
В этом руководстве по настройке Kilo Code используются элементы управления поставщика, совместимые с OpenAI, для подключения TokenHub. Начните с задачи, доступной только для чтения, затем проверьте изменения и команды с помощью модели, поддерживающей инструменты. Kilo Code предоставляет связанные рабочие процессы в VS Code, JetBrains и CLI, но область конфигурации может различаться между этими клиентами. Подтвердите активный профиль и поставщика в клиенте, который вы фактически используете, затем сравните качество модели, надежность инструмента, задержку, длину контекста и стоимость репрезентативной задачи репозитория.
Kilo Code может направлять запросы к моделям через совместимый API-шлюз TokenHub OpenAI compatible. Используйте официальный способ установки, затем замените только API key, Base URL и model ID.
Endpoint TokenHub для этого руководства: https://us-api.tokenhub.com/v1/chat/completions.
Когда использовать
Начните с небольшого репозитория или тестового проекта. Сначала попросите инструмент читать файлы, объяснять код или составлять план, затем включайте правки.
Установите или откройте инструмент
Следуйте официальной документации Kilo Code для установки или запуска. Если интерфейс изменился, ориентируйтесь на актуальную документацию.
Для CLI-инструментов сначала убедитесь, что исполняемый файл доступен, и только потом добавляйте учетные данные TokenHub:
# open the tool, then open its model or provider settingsПодготовьте учетные данные TokenHub
Создайте TokenHub API key и выберите подходящую модель в списке моделей TokenHub.
export TOKENHUB_API_KEY="sk-..."Храните ключ в локальном shell, секретном хранилище IDE или защищенном поле API key инструмента. Не коммитьте ключ в репозиторий.
Настройте провайдера TokenHub
В настройках Models, Providers, API Keys или OpenAI Compatible укажите следующие значения.
Значения provider
| Поле | Значение |
|---|---|
| Провайдер | OpenAI Compatible или Custom |
| Base URL | https://us-api.tokenhub.com/v1 |
| API Key | Значение TOKENHUB_API_KEY |
| Модель | gpt-4.1 или другой model ID TokenHub |
Расположение настроек
| Поле | Значение |
|---|---|
| Provider settings | Kilo Code → Providers → Custom provider |
| Provider API | OpenAI Compatible |
| Required fields | Provider ID, Base URL, API Key, Model ID |
Save the custom provider in Kilo Code, let it fetch /v1/models when available, or add the TokenHub model ID manually. Verify a chat request before enabling agent edits.
Если инструмент разделяет chat, edit, apply и fast models, для первого теста используйте одну и ту же модель TokenHub. После проверки разделите их по стоимости, задержке и силе рассуждения.
Временные переменные только для диагностики
Если schema принадлежит extension, сначала используйте UI настроек. Он сохранит те же значения на уровне пользователя и не требует угадывать внутренние ключи, которые могут меняться.
Используйте временные переменные только для проверки ключа, сети и имени модели. После проверки перенесите те же значения в постоянную конфигурацию выше.
Проверьте подключение
Сначала используйте read-only prompt, чтобы убедиться, что модель читает контекст и не меняет файлы. Потом проверяйте редактирование и agent tasks.
Прочитай README проекта и кратко опиши его в трех предложениях. Не изменяй файлы.После успешного prompt проверьте в логах TokenHub имя модели, endpoint, расход tokens и billing group.
Устранение неполадок
| Симптом | Что сделать |
|---|---|
| 401 или ошибка аутентификации | Проверьте, что TOKENHUB_API_KEY действителен и сохранен в том же terminal, IDE или профиле клиента. |
| 404 или модель не найдена | Используйте model ID, который есть в рабочей области TokenHub и подходит выбранному протоколу. |
| Неверный endpoint | Оставьте Base URL точно как указано выше. OpenAI-compatible tools обычно требуют /v1; Claude-compatible tools обычно нет. |
| Таймаут запроса | Проверьте сеть до https://us-api.tokenhub.com, proxy settings и allowlist рабочей области. |
| Инструмент использует другую модель | Проверьте все поля chat, edit, apply, fast и autocomplete. |
Как выбрать модель
Часто задаваемые вопросы по пользовательскому API Kilo Code
Почему Kilo Code не может прочитать список моделей TokenHub?
Неудачное автоматическое обнаружение модели не обязательно означает, что API недоступен. Скопируйте точный идентификатор модели из TokenHub и введите его вручную.
Что делать, если чат работает, а завершение с помощью Tab — нет?
Чат и вкладка могут использовать разные слоты модели. Настройте для Tab модель с малой задержкой, совместимую с завершением, и проверьте ее отдельно.
Почему IDE не может прочитать TOKENHUB_API_KEY?
IDE, запущенная с помощью значка на рабочем столе, может не наследовать переменные среды терминала. Используйте безопасное поле API-ключа Kilo Code для завершения первоначальной проверки.
Используют ли расширения Kilo Code CLI и IDE одну конфигурацию модели?
Они могут использовать одну и ту же модель TokenHub, но объем конфигурации и профили могут различаться. Проверьте базовый URL-адрес, ключ, модель и активный профиль в каждом клиенте.
Что, если Kilo Code может общаться в чате, но не может редактировать код?
Убедитесь, что модель поддерживает вызовы собственных инструментов и структурированные аргументы, затем проверьте разрешения на редактирование и одобрение команд. Базовая генерация текста не проверяет цепочку инструментов агента.
Источники
Эта настройка основана на TokenHub и официальной документации; последняя проверка: 2026-09-04。
