Outils

CLI tukai (Claude Code)

Installer la CLI tukai, connecter une machine à votre compte, lancer Claude Code sur votre solde Tukai, suivre la consommation et couper l'accès.

Vérifié le 4 octobre 2026Version Markdown Signaler une erreur sur cette page

tukai lance Claude Code (le paquet officiel @anthropic-ai/claude-code, non modifié) en le branchant sur votre compte Tukai. La consommation est déduite de votre solde Tukai habituel.

Ce qu'il vous faut : Node.js 22 ou plus récent, et un compte Tukai avec un abonnement actif ou des crédits.

Installer et connecter

npm install -g tukai
tukai login
tukai

tukai login affiche un code de 8 caractères et ouvre dans votre navigateur la page d’approbation de Tukai, code déjà rempli (l’adresse est aussi affichée dans le terminal). Vous confirmez avec votre compte déjà connecté ; la machine reçoit alors une clé tuk_sk_…, enregistrée dans ~/.tukai/config.json. La demande expire au bout de 10 minutes.

Paquet publié : tukai sur npm, version 2.2.0 au 3 octobre 2026, publié depuis le dépôt de Tukai.

Commandes

Commande	Effet
`tukai`	Lance Claude Code
`tukai login`	Connecte cette machine
`tukai model`	Choisit un modèle (fournisseur, puis modèle)
`tukai models`	Liste les modèles autorisés pour la clé de cette machine
`tukai status`	Indique le compte connecté
`tukai logout`	Oublie la clé sur cette machine

Toute autre option est transmise telle quelle à Claude Code (tukai --help, tukai -p "…").

Ce que la CLI modifie

Claude Code tourne avec son propre profil dans ~/.tukai/claude : une installation Claude Code existante, avec un compte Anthropic personnel, n'est pas touchée.
La variable ANTHROPIC_API_KEY est retirée de l'environnement transmis à Claude Code, pas de votre terminal.

Une première tâche sans risque

Lancez tukai dans un dossier de test qui ne contient rien de précieux, et demandez par exemple : « Lis le fichier README et résume-le en trois points. » Claude Code demande votre accord avant de modifier un fichier ou de lancer une commande ; gardez ce réglage.

Ce que ça coûte

Une session Claude Code envoie plusieurs requêtes au modèle : une par tour, plus des tâches de fond (titres, résumés) confiées à un petit modèle. Une même question peut donc coûter nettement plus qu'un appel unique de la page Premier appel.

La clé créée par tukai login n'a pas de plafond mensuel. Pour borner la dépense, fixez-en un sur cette clé dans les réglages de l'application (groupe Fournisseurs, onglet Clés API).

L'onglet Utilisation des réglages (groupe Compte et sécurité) montre où en sont vos limites d'usage, toutes surfaces confondues : la consommation n'est pas encore isolée par clé ni par outil.

Couper l'accès

tukai logout efface la clé de la machine — sans la révoquer.
Pour couper vraiment l'accès, révoquez la clé dans l'onglet Clés API de l'application. Faites-le aussi si la machine est perdue ou partagée.

Dépannage

Symptôme	Que faire
`tukai login` n'ouvre pas le navigateur	Ouvrez à la main l'adresse affichée dans le terminal
Le code a expiré	Relancez `tukai login` (validité : 10 minutes)
Erreur `402` dans Claude Code	Le compte n'a ni abonnement ni crédit : rechargez
Erreur `429`	Débit de la clé, plafond mensuel de la clé ou limites d'usage de votre offre
Version de Node trop ancienne	Installez Node.js 22 ou plus récent

Sans la CLI

Claude Code peut aussi être configuré à la main avec une clé créée dans l'application. Chaque modèle qu'il utilise doit être un identifiant Tukai coché sur la clé : sans ces variables, Claude Code demande ses propres identifiants, que Tukai refuse. La CLI fait ce réglage pour vous et isole en plus le profil de Claude Code.

macOS / Linux

export ANTHROPIC_BASE_URL="https://chat.tuk-ai.com"
export ANTHROPIC_AUTH_TOKEN="$TUKAI_API_KEY"
export ANTHROPIC_MODEL="chat-aion-labs-aion-3-0-mini"
export ANTHROPIC_DEFAULT_OPUS_MODEL="chat-aion-labs-aion-3-0-mini"
export ANTHROPIC_DEFAULT_SONNET_MODEL="chat-aion-labs-aion-3-0-mini"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="chat-aion-labs-aion-3-0-mini"
claude