Configuration du code de commande BYOK

Connectez TokenHub via Command Code BYOK et validez un modèle de codage compatible avant d'activer les modifications.

Qu'est-ce que le code de commande ?

Command Code est un agent de codage en ligne de commande avec un flux BYOK pour les fournisseurs de modèles compatibles OpenAI et Anthropic-wire.

Ce guide Command Code BYOK suit le flux de travail officiel /connect. Il utilise une racine d'API compatible OpenAI, stocke les informations d'identification dans le magasin d'authentification local et autorise les ID de modèle manuels lorsque la découverte n'est pas disponible. Le flux BYOK officiel stocke les informations d'identification du fournisseur localement et permet à l'utilisateur de sélectionner le modèle résultant avec /model. Choisissez délibérément le fil API, entrez l'ID de modèle complet lorsque la découverte est vide et vérifiez la lecture du code et les appels d'outils avant d'autoriser Command Code à modifier un référentiel de travail.

Command Code marque actuellement BYOK comme version bêta. Son assistant de fournisseur personnalisé demande un identifiant, un protocole filaire, une racine API, une clé et des modèles en séquence ; ce n'est pas un formulaire générique à trois champs.

Ajoutez TokenHub avec l'assistant officiel BYOK

  1. Exécutez /connect dans Command Code.
  2. Choisissez (BYOK) Add your own provider.
  3. Dans Name it, saisissez l'ID en minuscule tokenhub. Cela devient le nom de l'entrée dans ~/.commandcode/providers.json et les modèles sont acheminés sous la forme tokenhub/<model-id>.
  4. Dans Pick the wire, choisissez le fil OpenAI-compatible par défaut, openai-completions. Choisissez anthropic-messages uniquement pour Anthropic Messages.
  5. Dans Point at the endpoint, entrez la racine API https://us-api.tokenhub.com/v1. Command Code peut couper un /chat/completions collé accidentellement, mais vous devez saisir directement la racine correcte.
  6. Dans Add the key, collez votre clé TokenHub API. L'assistant l'enregistre sous ~/.commandcode/auth.json ; ne confiez pas de clé à un référentiel.
  7. À Declare the models, laissez l'assistant demander /models. Si la découverte ne renvoie rien, saisissez manuellement l’ID de modèle TokenHub exact.

Sur les écrans sans saisie, appuyez sur h pour obtenir une aide concise ou sur esc pour revenir à l'étape précédente. Une fois l'installation terminée, Command Code ouvre /model, où le nouveau fournisseur apparaît à côté de ses modèles intégrés.

Modifiez uniquement le fichier Provider.json lorsqu'une modification manuelle est nécessaire

Les définitions du fournisseur résident dans ~/.commandcode/providers.json. Rouvrez /connect ou /model pour recharger les modifications :

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

Si /connect a déjà stocké la clé, ne la dupliquez pas dans le fichier du fournisseur. Un modèle peut également déclarer contextWindow, maxOutput, reasoningEfforts et options, mais ajouter uniquement les fonctionnalités vérifiées pour ce modèle TokenHub.

Maintenir la connexion depuis sa carte Fournisseur

Exécutez à nouveau /connect et sélectionnez tokenhub. La carte Fournisseur affiche le point de terminaison, le nombre de modèles et l'état de la clé :

  • r : remplacez ou enregistrez la clé.
  • u : récupérez à nouveau les modèles sans modifier le fil, les en-têtes ou la référence de clé.
  • c : effacez la clé stockée.
  • d : supprimez le fournisseur et ses informations d'identification locales.

Un prestataire en bonne santé présente un chèque vert et un nombre de modèles. Si providers.json n'est pas valide, Command Code ignore l'entrée incorrecte sans écraser le fichier et signale son chemin dans /connect ou --list-models.

Vérifier le routage à partir de /model

Exécutez /model, choisissez un modèle dans le groupe TokenHub et posez une question de référentiel en lecture seule. Confirmez l'ID du modèle et /v1/chat/completions dans les journaux TokenHub. Pour un 401, revenez à la carte Fournisseur et appuyez sur r ; pour un 404, inspectez baseURL et api ; si le modèle est absent, appuyer sur u ou le déclarer dans providers.json.

Référence officielle

Choisir un modèle

Charge de travailChoix du modèlePourquoi
Tâches complexesModèle de raisonnement avec outilsAdapté à la planification, aux étapes multiples et aux longs contextes.
Usage quotidienModèle équilibréÉquilibre qualité, vitesse et coût.
Résumés et tâches légèresModèle rapide et économiqueRéduit le coût des résumés et itérations simples.
Voir les modèles TokenHub

FAQ BYOK sur le code de commande

Quel câble dois-je choisir pour TokenHub ?

Choisissez OpenAI-compatible lorsque vous utilisez la racine de l’API TokenHub se terminant par /v1.

Où Command Code stocke-t-il la clé API ?

Le flux /connect stocke les clés du fournisseur dans le stockage d’authentification local de Command Code. Évitez de confier une clé à fournisseurs.json.

Que faire si la liste des modèles est vide ?

Saisissez manuellement l’ID exact du modèle TokenHub dans le flux BYOK ou dans fournisseurs.json, puis sélectionnez-le dans /model.

Comment tester le code de commande en toute sécurité après la configuration BYOK ?

Sélectionnez le modèle TokenHub avec /model et commencez par une question de référentiel en lecture seule. Vérifiez le journal des demandes avant d’accorder des autorisations de modification ou de commande.

Pourquoi le code de commande atteint-il le mauvais point de terminaison ?

Vérifiez le fil sélectionné lors de /connect. La racine TokenHub /v1 appartient au fil compatible OpenAI, sauf si vous avez intentionnellement configuré un point de terminaison Anthropic Messages.

Références

Cette configuration s’appuie sur TokenHub et la documentation officielle ; dernière vérification : 2026-09-08。