TokiLabsDocs
Configuration système

Guide de configuration macOS

Pour macOS 12 et plus récent (puces Intel et Apple). macOS utilise zsh par défaut ; la configuration va dans ~/.zshrc.

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

Appuyez sur ⌘ + Espace, recherchez « Terminal » et ouvrez-le. Les terminaux tiers comme iTerm2 conviennent aussi.

2. Installer Node.js

Nous recommandons d'installer Node.js 18 ou plus récent avec Homebrew. Si vous n'avez pas Homebrew, installez-le d'abord :

Terminal
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Terminal
brew install node
node -v
Si vous ne voulez pas installer Homebrew, téléchargez le programme d'installation .pkg LTS sur nodejs.org.

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 · zsh
cat >> ~/.zshrc <<'EOF'

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

Vérifier la prise en compte

Si vous avez remplacé le shell par défaut par bash, remplacez ~/.zshrc par ~/.bash_profile dans les commandes ci-dessus. echo $SHELL affiche le shell actuel.
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 utilisez Homebrew / npm :

Terminal
brew install --cask claude-code
# ou
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.

Les applications graphiques ne voient pas les variables ?

Les applications ouvertes depuis le Dock ou le Launchpad (comme VS Code ou Cursor) ne chargent pas forcément ~/.zshrc. Le plus simple est de lancer VS Code depuis le terminal avec code . ; ou saisissez directement l'adresse et la clé dans les réglages de l'extension, voir VS Code / Cline / Cursor.

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 ~/.zshrc dans un éditeur, supprimez les 2 lignes export sous « # Toki Labs · Claude », puis :
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN