> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> Utilisez TokenLab avec le CLI Claude Code d'Anthropic

## Vue d’ensemble

<Note>
  **Type**: Outil de code

  **Chemin principal**: Anthropic-native

  **Niveau de support**: Chemin natif fort
</Note>

[Claude Code](https://docs.anthropic.com/en/docs/claude-code) est l’outil CLI officiel d’Anthropic pour le développement assisté par IA. Vous pouvez le configurer pour utiliser TokenLab comme fournisseur d’API.

## Installation

Anthropic recommande désormais l’installateur natif. L’installation via npm existe toujours pour des raisons de compatibilité, mais elle est dépréciée en amont.

```bash theme={null}
curl -fsSL https://claude.ai/install.sh | bash
```

Si vous avez spécifiquement besoin du package npm, utilisez :

```bash theme={null}
npm install -g @anthropic-ai/claude-code
```

<Warning>
  N’utilisez pas `sudo npm install -g` pour Claude Code.
</Warning>

## Configuration

### Variables d’environnement

Définissez les variables d’environnement suivantes :

```bash theme={null}
export ANTHROPIC_API_KEY="sk-your-tokenlab-key"
export ANTHROPIC_BASE_URL="https://api.tokenlab.sh"
```

Ajoutez-les à votre profil shell (`~/.bashrc`, `~/.zshrc`, etc.) pour qu’elles persistent.

<Note>
  Pour TokenLab, conservez `ANTHROPIC_BASE_URL` à `https://api.tokenlab.sh` sans suffixe `/v1`. Cela correspond au format des endpoints de style Anthropic et au modèle de gateway unifiée documenté par Claude Code.
</Note>

### Fichier de configuration

Vous pouvez aussi créer ou modifier `~/.claude/settings.json` :

```json theme={null}
{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-tokenlab-key",
    "ANTHROPIC_BASE_URL": "https://api.tokenlab.sh"
  }
}
```

## Utilisation

Après la configuration, utilisez Claude Code normalement :

```bash theme={null}
# Start an interactive session
claude

# Run a single command
claude "Explain this code" < main.py

# Chat mode
claude chat
```

Vérifiez l’installation si nécessaire :

```bash theme={null}
claude --version
claude doctor
```

## Modèles disponibles

TokenLab prend en charge tous les modèles Claude :

| Modèle              | Description                                      |
| ------------------- | ------------------------------------------------ |
| `claude-opus-4-6`   | Le plus performant, raisonnement complexe        |
| `claude-sonnet-4-6` | Performances équilibrées, excellent pour le code |
| `claude-haiku-4-5`  | Le plus rapide, rentable                         |

## Sélection du modèle

Spécifiez un modèle avec l’option `--model` :

```bash theme={null}
claude --model claude-sonnet-4-6 "Review this PR"
```

Ou définissez une valeur par défaut dans votre configuration :

```json theme={null}
{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-tokenlab-key",
    "ANTHROPIC_BASE_URL": "https://api.tokenlab.sh"
  },
  "model": "claude-sonnet-4-6"
}
```

## Réflexion prolongée

Pour les tâches de raisonnement complexes, utilisez des modèles avec extended thinking :

```bash theme={null}
claude --model claude-opus-4-6 "Design a microservices architecture for..."
```

## Résolution des problèmes

<AccordionGroup>
  <Accordion title="Erreurs de connexion">
    Vérifiez que l’URL de base est exactement `https://api.tokenlab.sh` (sans suffixe `/v1` pour les requêtes de style Anthropic).
  </Accordion>

  <Accordion title="Clé API invalide">
    Assurez-vous que votre clé API TokenLab commence par `sk-` et dispose d’un solde suffisant.
  </Accordion>

  <Accordion title="La gateway nécessite un bearer token Authorization">
    Le mode gateway de Claude Code prend également en charge `ANTHROPIC_AUTH_TOKEN`. Continuez à utiliser `ANTHROPIC_API_KEY` pour la configuration standard de TokenLab, sauf si vous avez volontairement modifié le comportement d’authentification de votre gateway.
  </Accordion>

  <Accordion title="Modèle introuvable">
    Vérifiez que le nom du modèle est correct. Utilisez le format `claude-sonnet-4-6`.
  </Accordion>
</AccordionGroup>
