Код команды Настройка BYOK

Подключите TokenHub с помощью командного кода BYOK и проверьте совместимую модель кодирования перед внесением изменений.

Что такое командный код?

Command Code — это агент кодирования с командной строкой и потоком BYOK для поставщиков моделей, совместимых с OpenAI и Anthropic-wire.

Это руководство по командному коду BYOK соответствует официальному рабочему процессу /connect. Он использует корень API, совместимый с OpenAI, сохраняет учетные данные в локальном хранилище аутентификации и позволяет вручную указывать идентификаторы моделей, когда обнаружение недоступно. Официальный поток BYOK хранит учетные данные поставщика локально и позволяет пользователю выбрать результирующую модель с помощью /model. Обдуманно выбирайте канал API, вводите полный идентификатор модели, когда обнаружение пусто, и проверяйте чтение кода и вызовы инструментов, прежде чем разрешить командному коду изменить рабочий репозиторий.

Command Code в настоящее время помечает BYOK как бета-версию. Мастер настройки пользовательского поставщика последовательно запрашивает идентификатор, протокол проводной связи, корень API, ключ и модели; это не общая форма с тремя полями.

Добавьте TokenHub с помощью официального мастера BYOK.

  1. Запустите /connect в Command Code.
  2. Выберите (BYOK) Add your own provider.
  3. В поле Name it введите идентификатор tokenhub в нижнем регистре. Оно становится именем записи в ~/.commandcode/providers.json, а модели маршрутизируются как tokenhub/<model-id>.
  4. В Pick the wire выберите провод OpenAI-compatible по умолчанию, openai-completions. Выбирайте anthropic-messages только для Anthropic Messages.
  5. В Point at the endpoint введите корень API https://us-api.tokenhub.com/v1. Command Code может обрезать случайно вставленный /chat/completions, но вам следует напрямую ввести правильный корень.
  6. В Add the key вставьте свой ключ TokenHub API. Мастер сохраняет его в ~/.commandcode/auth.json; не фиксируйте ключ в репозитории.
  7. По адресу Declare the models позвольте мастеру запросить /models. Если обнаружение ничего не возвращает, введите точный идентификатор модели TokenHub вручную.

На экранах без ввода нажмите h для получения краткой справки или esc для возврата к предыдущему шагу. По завершении установки Command Code открывает /model, где новый поставщик появляется рядом со своими встроенными моделями.

Редактируйте только поставщики.json, если необходимо внести изменения вручную.

Определения провайдеров находятся в ~/.commandcode/providers.json. Снова откройте /connect или /model, чтобы перезагрузить изменения:

{
  "provider": {
    "tokenhub": {
      "name": "TokenHub",
      "baseURL": "__API_BASE_URL__/v1",
      "api": "openai-completions",
      "apiKey": "$TOKENHUB_API_KEY",
      "models": {
        "YOUR_TOKENHUB_MODEL_ID": {}
      }
    }
  }
}

Если /connect уже сохранил ключ, не дублируйте его в файле провайдера. Модель также может объявлять contextWindow, maxOutput, reasoningEfforts и options, но добавлять только возможности, проверенные для этой модели TokenHub.

Поддерживать соединение со своей карты Провайдера

Запустите /connect еще раз и выберите tokenhub. На карточке поставщика отображается конечная точка, количество моделей и статус ключа:

  • r: заменить или сохранить ключ.
  • u: снова получите модели без изменения провода, заголовков или ссылки на ключ.
  • c: очистить сохраненный ключ.
  • d: удалите поставщика и его локальные учетные данные.

Исправный провайдер показывает зеленую галочку и количество моделей. Если providers.json недействителен, Command Code пропускает неверную запись, не перезаписывая файл, и сообщает его путь в /connect или --list-models.

Проверьте маршрутизацию из /model

Запустите /model, выберите модель в группе TokenHub и задайте вопрос о репозитории, доступный только для чтения. Подтвердите идентификатор модели и /v1/chat/completions в журналах TokenHub. Для кода 401 вернитесь к карточке поставщика и нажмите r; для 404 проверьте baseURL и api; если модель отсутствует, нажмите u или объявите ее в providers.json.

Официальная ссылка

Как выбрать модель

НагрузкаВыбор моделиПочему подходит
Сложные задачиМодель рассуждений с инструментамиПодходит для планирования, многошаговых задач и длинного контекста.
Ежедневная работаСбалансированная модельБаланс качества, скорости и стоимости.
Сводки и лёгкие задачиБыстрая недорогая модельСнижает стоимость сводок и простых итераций.
Открыть модели TokenHub

Код команды BYOK Часто задаваемые вопросы

Какой провод выбрать для TokenHub?

Выберите OpenAI-совместимый при использовании корня API TokenHub, заканчивающегося на /v1.

Где командный код хранит ключ API?

Поток /connect сохраняет ключи провайдера в локальном хранилище аутентификации командного кода. Избегайте передачи ключа в поставщики.json.

Что делать, если список моделей пуст?

Введите точный идентификатор модели TokenHub вручную в потоке BYOK или поставщиках.json, а затем выберите его в /model.

Как безопасно протестировать командный код после установки BYOK?

Выберите модель TokenHub с помощью /model и начните с вопроса о репозитории, доступном только для чтения. Проверьте журнал запросов, прежде чем предоставлять разрешения на редактирование или выполнение команд.

Почему командный код достигает неправильной конечной точки?

Проверьте провод, выбранный во время команды /connect. Корень TokenHub /v1 принадлежит OpenAI-совместимому проводу, если только вы намеренно не настроили конечную точку Anthropic Messages.

Источники

Эта настройка основана на TokenHub и официальной документации; последняя проверка: 2026-09-08。