# Guide de configuration Trae

> Connectez LLMoxy via un modèle personnalisé dans l'IDE Trae de ByteDance, puis programmez avec des agents grâce à Chat / Builder.

Site web : [https://www.trae.cn (Chine)](https://www.trae.cn) · [https://www.trae.ai (international)](https://www.trae.ai)

Trae (prononcé /treɪ/) est l'IDE IA de ByteDance, basé sur VS Code, avec Chat et Builder intégrés. En plus des modèles intégrés, une configuration personnalisée permet d'envoyer les requêtes à 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

1. Ouvrez le site officiel et téléchargez le `.exe` ou le `.dmg` selon votre système (choisissez ARM pour Apple Silicon).
2. Au premier lancement, choisissez le thème et le chinois simplifié.
3. Facultatif : importez les plugins, raccourcis et paramètres depuis VS Code ou Cursor.
4. Il est recommandé d'installer la ligne de commande `trae`, après quoi vous pourrez ouvrir le répertoire courant avec `trae .`.

![Télécharger Trae](https://fr.llmoxy.com/docs-assets/migrated/tutorial-trae/download.png)

![Importer depuis VS Code / Cursor](https://fr.llmoxy.com/docs-assets/migrated/tutorial-trae/import.webp)

## Connexion à LLMoxy

1. Ouvrez **Paramètres → Modèles**.
2. Cliquez sur **Ajouter un modèle**.
3. Choisissez **Modèle personnalisé** tout en haut (ne choisissez pas les fournisseurs prédéfinis comme DeepSeek ou Alibaba Cloud).
4. Renseignez les champs ci-dessous, puis cliquez sur Ajouter. Trae vérifie d'abord que la clé est valide.

![Ouvrir la gestion des modèles](https://fr.llmoxy.com/docs-assets/migrated/tutorial-trae/models.png)

![Choisir un modèle personnalisé](https://fr.llmoxy.com/docs-assets/migrated/tutorial-trae/add-model.webp)

**Mode compatible OpenAI (recommandé ; GPT / Gemini / la plupart des modèles) :**

| Champ | Valeur |
| --- | --- |
| Format d'API | OpenAI Chat Completions |
| Adresse de requête personnalisée | `https://llmoxy.com/v1` |
| URL complète | **Désactivée** |
| ID du modèle | Par exemple `grok-4.7` |
| Clé API | Jeton LLMoxy |

**Mode compatible Anthropic (série Claude) :**

| Champ | Valeur |
| --- | --- |
| Format d'API | Anthropic Messages |
| Adresse de requête personnalisée | `https://llmoxy.com` |
| URL complète | **Désactivée** |
| ID du modèle | Par exemple `claude-opus-5-5`, `claude-fable-5-2` |
| Clé API | Jeton LLMoxy |

> **💡 Astuce**
> « URL complète » est désactivée par défaut. Une fois activée, vous devez saisir le chemin complet, par exemple `https://llmoxy.com/v1/chat/completions`. Pour GPT-5 / GPT-6, il est conseillé de choisir la « série de modèles » correspondante dans la configuration avancée : Trae adaptera alors automatiquement les champs de la requête.

Une fois l'ajout réussi, désactivez Auto en bas à droite de la zone de saisie du chat, puis choisissez le modèle que vous venez d'ajouter dans la liste.

## Utilisation

Le panneau IA se trouve à droite :

- **Chat** : expliquer du code, chercher des bugs, poser des questions avec du contexte via `@nom-de-fichier`.
- **Builder** : construire un projet de zéro en langage naturel ; il crée les fichiers, installe les dépendances et lance l'aperçu.

![Chat et Builder](https://fr.llmoxy.com/docs-assets/migrated/tutorial-trae/assistant.png)

| Action | macOS | Windows |
| --- | --- | --- |
| Accepter les modifications du fichier courant | `Command + Enter` | `Ctrl + Enter` |
| Refuser les modifications du fichier courant | `Command + Backspace` | `Ctrl + Backspace` |
| Conversation intégrée | `Command + I` | `Ctrl + I` |

Les plugins VS Code sont également compatibles. Si vous préférez Cline, voir le [Tutoriel du plugin Trae Cline](https://fr.llmoxy.com/docs/code-tutorials/trae-cline).

## Questions fréquentes

**L'adresse de requête personnalisée reste en rouge**
Vérifiez d'abord que « URL complète » est désactivée, et saisissez `https://llmoxy.com/v1` (OpenAI) ou `https://llmoxy.com` (Anthropic). N'ajoutez pas `/chat/completions` à l'adresse de base.

**Échec de la vérification de la clé**
Vérifiez que le jeton ne contient pas d'espaces, que le groupe est **auto** et que l'ID du modèle correspond exactement à celui de la console.

**Builder signale une erreur de terminal sous Windows**
Dans Paramètres → Profils de terminal, choisissez PowerShell 6 ou une version ultérieure.

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