TokiLabsDocs
Configuration système

Guide de configuration Linux

Pour les principales distributions (Ubuntu, Debian, Fedora, Arch, etc.), ainsi que WSL et les serveurs distants. Les instructions supposent bash.

Une seule clé donne accès à tous les modèles. Votre clé est stockée uniquement dans votre navigateur et n'est jamais envoyée à un serveur.
Pas encore de clé ? Créez-en une dans Obtenir une clé API.

1. Ouvrir un terminal

Sur un bureau, appuyez sur Ctrl + Alt + T pour ouvrir un terminal ; sur un serveur, connectez-vous simplement en SSH. Exécutez les commandes suivantes en tant qu'utilisateur normal, sans sudo (sauf pour installer Node.js).

2. Installer Node.js

Node.js 18 ou plus récent est requis. La version fournie par la distribution est souvent trop ancienne ; nous recommandons nvm, qui ne nécessite pas les droits root :

Terminal · nvm (Recommandé)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
nvm install --lts
node -v
Terminal
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
Avec un Node installé par le gestionnaire de paquets du système, npm install -g peut nécessiter sudo. nvm évite ce problème.

3. Définir les variables d'environnement

Définissez les deux variables ci-dessous. L'adresse de l'API est https://api.tokilabs.xyz.

VariableValeurUtilisée par
ANTHROPIC_BASE_URLhttps://api.tokilabs.xyzClaude Code, SDK Anthropic
ANTHROPIC_AUTH_TOKENsk-votre-cleClaude Code
Terminal · bash
cat >> ~/.bashrc <<'EOF'

# Toki Labs · Claude
export ANTHROPIC_BASE_URL="https://api.tokilabs.xyz"
export ANTHROPIC_AUTH_TOKEN="sk-votre-cle"
EOF
source ~/.bashrc

Vérifier la prise en compte

Avec zsh, remplacez ~/.bashrc par ~/.zshrc ; avec fish, utilisez une syntaxe comme set -Ux ANTHROPIC_BASE_URL https://api.tokilabs.xyz.
Terminal
echo $ANTHROPIC_BASE_URL

4. Vérifier la connexion

Si vous obtenez une liste de modèles JSON contenant "data", l'adresse et la clé sont correctes.

Terminal
curl "$ANTHROPIC_BASE_URL/v1/models" -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"
Une erreur 401 signifie que la clé est incorrecte ou n'est plus valide ; en cas de délai de connexion dépassé, vérifiez les réglages de proxy de votre machine. Voir la FAQ.

5. Installer Claude Code

Terminal · Script d'installation officiel
curl -fsSL https://claude.ai/install.sh | bash

Ou installez avec npm :

Terminal · npm
npm install -g @anthropic-ai/claude-code

Passer la connexion au compte officiel lors du premier lancement :

Terminal
[ -f ~/.claude.json ] || echo '{"hasCompletedOnboarding": true}' > ~/.claude.json

Lancez-le dans le dossier de votre projet :

Terminal
cd votre-projet
claude

Après le lancement, tapez /status : si Base URL affiche https://api.tokilabs.xyz, les requêtes passent par Toki Labs. Tapez /model pour changer de modèle, par exemple claude-opus-5-5. Plus de réglages dans Configuration détaillée de Claude Code.

Serveurs et Docker

Les tâches planifiées et services systemd ne chargent pas ~/.bashrc. Utilisez Environment= dans le fichier unit, ou passez les variables avec -e dans Docker :

Terminal
docker run --rm \
  -e ANTHROPIC_BASE_URL=https://api.tokilabs.xyz \
  -e ANTHROPIC_AUTH_TOKEN=sk-votre-cle \
  your-image

Rétablir la configuration

Si vous n'en avez plus besoin, supprimez ces variables d'environnement pour revenir aux valeurs par défaut :

Terminal
# Ouvrez ~/.bashrc dans un éditeur, supprimez les 2 lignes export sous « # Toki Labs · Claude », puis :
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN