# 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.

Source : https://developers.tuk-ai.com/tools/cli · Vérifié le 2026-10-04

`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

macOS / Linux :

```bash
npm install -g tukai
tukai login
tukai
```

Windows (PowerShell) :

```powershell
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](https://www.npmjs.com/package/tukai), 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](https://developers.tuk-ai.com/docs/quickstart).

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

1. `tukai logout` efface la clé de la machine — **sans la révoquer**.
2. 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](https://chat.tuk-ai.com/pay/checkout) |
| 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 :

```bash
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
```