# Guide de configuration Claude Code

> Installez Claude Code et connectez-le à LLMoxy avec CC Switch ou des variables d'environnement pour programmer avec les modèles Claude dans le terminal.

Claude Code est l'agent de terminal d'Anthropic : il lit directement le dépôt, modifie les fichiers et exécute des commandes. Par défaut, il se connecte à l'API officielle ; il suffit de pointer la passerelle vers LLMoxy.

Avant de commencer, préparez un [jeton LLMoxy](https://fr.llmoxy.com/docs/get-started/get-token), de préférence du groupe **auto**.

## Installation

Privilégiez le script officiel (npm n'est plus recommandé) :

```bash
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
```

Vous pouvez aussi utiliser :

```bash
brew install --cask claude-code          # macOS
winget install Anthropic.ClaudeCode      # Windows
```

Vérification :

```bash
claude --version
```

## Connexion à LLMoxy

Claude Code utilise l'interface compatible Anthropic ; l'adresse **ne contient pas** `/v1`.

| Variable | Valeur |
| --- | --- |
| `ANTHROPIC_BASE_URL` | `https://llmoxy.com` |
| `ANTHROPIC_AUTH_TOKEN` | Votre clé API LLMoxy |

### Méthode 1 : CC Switch (recommandée)

Changez de fournisseur depuis une interface graphique, sans modifier les variables d'environnement à la main. Pour le téléchargement et les captures d'écran pas à pas, voir le [Tutoriel CC Switch](https://fr.llmoxy.com/docs/code-tutorials/cc-switch).

- Nom du fournisseur : LLMoxy
- Clé API : le jeton du site
- Adresse de la requête : `https://llmoxy.com`
- Modèle principal : `claude-opus-5-5`

### Méthode 2 : variables d'environnement

**macOS / Linux** (`~/.zshrc` pour Zsh, `~/.bashrc` pour Bash) :

```bash
{
echo ''
echo '# LLMoxy'
echo 'export ANTHROPIC_BASE_URL="https://llmoxy.com"'
echo 'export ANTHROPIC_AUTH_TOKEN="Votre clé API LLMoxy"'
} >> ~/.zshrc
source ~/.zshrc
```

**Windows PowerShell** (après la configuration, ouvrez impérativement une nouvelle fenêtre) :

```powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://llmoxy.com","User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","Votre clé API LLMoxy","User")
```

Vérification : `echo "$ANTHROPIC_BASE_URL"` doit afficher `https://llmoxy.com`.

## Démarrage

Placez-vous dans le répertoire du projet :

```bash
claude
```

Saisissez `/model` et choisissez le nom du modèle que vous venez de configurer (par exemple `claude-opus-5-5`). Saisissez `/` pour voir toutes les commandes.

![Écran d'accueil](https://fr.llmoxy.com/docs-assets/migrated/tutorial-claudecode-runoob/welcome.png)

![Commandes slash](https://fr.llmoxy.com/docs-assets/migrated/tutorial-claudecode-runoob/slash.png)

Facultatif : lancez `claude doctor` pour effectuer une vérification de l'environnement.

## Questions fréquentes

**`claude: command not found`**
Vérifiez que `claude --version` renvoie une sortie, puis rouvrez le terminal.

**La connexion à un compte Claude est toujours demandée**
Vérifiez que `ANTHROPIC_BASE_URL` et `ANTHROPIC_AUTH_TOKEN` sont bien pris en compte. Une fois une passerelle personnalisée configurée, l'authentification se fait par clé API ; il n'est pas nécessaire de se connecter à claude.ai.

**Erreur de permissions lors de l'installation globale avec npm**
N'utilisez pas `sudo npm install -g`. Passez plutôt par le script officiel, Homebrew ou nvm.

**Impossible de se connecter**
Testez le réseau avec `curl -I https://llmoxy.com` ; si un proxy est nécessaire, définissez `HTTPS_PROXY`.

Ceci est la version markdown de https://fr.llmoxy.com/docs/code-tutorials/claude-code.
