Connectez votre modèle local à Tokios

Tokios atteint votre modèle privé via un tunnel sortant uniquement — rien sur votre machine n’écoute le trafic entrant. Ce guide de démarrage rapide vous accompagne à travers 3 jalons : connecter votre runtime, vérifier que le tunnel fonctionne, puis connecter votre client. Connectez-vous sur tokios.com/console et ouvrez l’onglet Setup. (Première visite ? Confirmez votre e-mail via le lien de vérification — il est valide pendant 24 heures.)

Jalon 1 : Connectez votre runtime

Installez le connecteur et enregistrez votre modèle pour que Tokios puisse y accéder.

Apparier un connecteur

Sur l’onglet Setup, nommez éventuellement le connecteur, puis cliquez sur Start pairing. Tokios affiche un code d’appairage unique comme TKS-XXXX-XXXX, valide pendant environ 15 minutes.Le code d’appairage est un identifiant d’appairage — ce n’est pas votre clé API (vous la créez au Jalon 3).

Installer le connecteur et l'approuver

Sur la machine située à côté de votre modèle, exécutez la commande d’installation unique que la console affiche pour votre système d’exploitation :

irm https://tokios.com/downloads/install/windows | iex; tokios-install -Code 'TKS-XXXX-XXXX'

curl -fsSL https://tokios.com/downloads/install/macos | sh -s -- --code TKS-XXXX-XXXX

curl -fsSL https://tokios.com/downloads/install/linux | sh -s -- --code TKS-XXXX-XXXX

Vous avez déjà tokios-connector installé ? Sautez l’installateur et passez le code d’appairage directement :

Already installed

tokios-connector TKS-XXXX-XXXX

Le connecteur établit une connexion sortante via un seul WebSocket — aucun port entrant, aucune IP publique. Retournez dans la console et approve l’appareil. Votre jeton est livré de manière sécurisée via le tunnel ; vous ne le collez jamais dans un fichier.

Enregistrez votre modèle

Dans l’onglet Models, choisissez le modèle à exposer et le nom public que vos clients utiliseront — par exemple, gemma-tunnel. Ce nom public est la valeur "model" dans chaque requête API.

État de réussite : votre modèle apparaît dans l’onglet Models avec un connecteur actif. Le tunnel est en direct — mais vous ne l’avez pas encore testé.

Jalon 2 : Vérifiez le fonctionnement de bout en bout

Testez dans le Playground avant de créer une clé API. Cela confirme que le tunnel et le modèle fonctionnent ensemble.

Essayez dans le Playground

Ouvrez l’onglet Playground, choisissez votre modèle, tapez un prompt, et cliquez sur Run. Le Playground s’authentifie avec votre session actuelle — aucune clé API n’est nécessaire — afin que vous puissiez confirmer que le tunnel fonctionne avant de configurer un client.État de réussite : vous obtenez une réponse de votre modèle local via le point de terminaison Tokios. Si le Playground renvoie une complétion, le tunnel est sain et vous êtes prêt à connecter un client.

Si le Playground expire, vérifiez que votre modèle local est en cours d’exécution et que le connecteur affiche Connected dans la console. Consultez Dépannage pour les corrections courantes.

Jalon 3 : Connectez votre client

Créez une clé API et pointez votre agent de codage vers Tokios.

Créez une clé API

Dans l’onglet Keys, cliquez sur Create key. Donnez-lui un nom d’affichage et, éventuellement, des modèles de modèle pour la limiter (laissez * pour autoriser tous vos modèles). Copiez la clé sk-tok-… immédiatement — elle n’est affichée qu’une seule fois.

Pointez votre client et testez

Choisissez votre client. Chacun a besoin de l’URL de base pour son dialecte, de votre clé sk-tok-…, et de votre nom de modèle public :

Style Anthropic (Claude Code) : https://api.tokios.com
Style OpenAI (Codex, SDKs OpenAI) : https://api.tokios.com/v1

export ANTHROPIC_BASE_URL=https://api.tokios.com
export ANTHROPIC_API_KEY=sk-tok-YOUR_KEY
claude --model gemma-tunnel

export OPENAI_API_KEY=sk-tok-YOUR_KEY
# add a Tokios provider to ~/.codex/config.toml:
#   base_url = "https://api.tokios.com/v1"  ·  wire_api = "responses"
codex --profile tokios

curl https://api.tokios.com/v1/chat/completions \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-tunnel",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Configuration complète par client : Claude Code · OpenAI Codex.Un appel réussi renvoie une complétion adaptée au dialecte de votre client — pour le curl ci-dessus, une réponse formatée OpenAI (abrégée) :

{
  "model": "gemma-tunnel",
  "choices": [
    {
      "message": { "role": "assistant", "content": "Hello! How can I help?" },
      "finish_reason": "stop"
    }
  ]
}

État de réussite : votre client communique avec votre modèle local via Tokios. La réponse provient de votre propre matériel, et non d’un fournisseur cloud.

Et ensuite ?

Utiliser avec Claude Code

Pointez Claude Code vers Tokios et exécutez votre agent de codage contre votre propre modèle local.

Exposer plus de modèles

Servez plusieurs modèles via un seul connecteur avec un fichier de configuration.

Premiers pas

Modèles

Concepts

Référence

Connectez votre modèle local à Tokios

Jalon 1 : Connectez votre runtime

Jalon 2 : Vérifiez le fonctionnement de bout en bout

Jalon 3 : Connectez votre client

Et ensuite ?

Utiliser avec Claude Code

Exposer plus de modèles

​Jalon 1 : Connectez votre runtime

​Jalon 2 : Vérifiez le fonctionnement de bout en bout

​Jalon 3 : Connectez votre client

​Et ensuite ?

Utiliser avec Claude Code

Exposer plus de modèles

Jalon 1 : Connectez votre runtime

Jalon 2 : Vérifiez le fonctionnement de bout en bout

Jalon 3 : Connectez votre client

Et ensuite ?