Documentation

Modèles personnalisés Trae : Claude et GPT

Ce guide nécessite une clé API

Créez un compte et générez-en une en une minute environ, puis utilisez-la là où les étapes ci-dessous attendent une clé.

Inscription sans carte · un rechargement est requis pour utiliser l’API

Trae est l'IDE IA de ByteDance ; son formulaire de modèle personnalisé accepte un endpoint compatible OpenAI, donc une clé Code By AI couvre Claude et GPT.

Trae embarque des modèles intégrés et une entrée Custom configuration pour les endpoints tiers. Le formulaire demande un format d'API, une URL de requête, un ID de modèle et des identifiants — de quoi pointer l'IDE vers Code By AI sans changer le fonctionnement de l'agent.

Une commande ?

setup.sh ne configure pas Trae. Trae stocke les modèles personnalisés dans l'application et ne documente aucun fichier pour eux : le script n'a rien qu'il puisse modifier sans risque. Utilisez les étapes ci-dessous.

1. Créer une clé API Code By AI

Connectez-vous à Code By AI, ouvrez API Keys et créez une clé. Elle ressemble à sk-proj-....

2. Ouvrir les réglages de modèle

Ouvrez Settings → Models dans Trae et cliquez sur Add model. Le même gestionnaire est accessible depuis le sélecteur de modèle d'un chat.

3. Ajouter une configuration personnalisée

  1. Choisissez Custom configuration.
  2. Réglez API format sur OpenAI Chat Completions.
  3. Mettez l'URL de requête à https://www.codebyai.net/api/agent/v1.
  4. Laissez Full URL désactivé. Trae ajoute /chat/completions ; si vous l'activez, saisissez l'URL complète https://www.codebyai.net/api/agent/v1/chat/completions.
  5. Collez la clé API Code By AI.
  6. Saisissez l'ID de modèle gpt-5.6-terra.
  7. Enregistrez et sélectionnez le modèle dans le sélecteur du chat.

4. Ajouter Claude

Ajoutez une seconde configuration personnalisée avec la même URL et la même clé, puis remplacez l'ID par claude-sonnet-5. La passerelle transfère les ID claude-* vers le canal Claude et les facture aux tarifs Claude.

Dans SOLO, désactivez AUTO avant de choisir un modèle personnalisé ; sinon l'agent peut continuer à router vers un modèle intégré.

5. Vérifier

Envoyez une courte requête dans un nouveau chat. Une réponse normale confirme l'URL, la clé et l'ID. Si le modèle n'apparaît pas, rouvrez le gestionnaire et vérifiez que l'entrée personnalisée est enregistrée et activée.

Dépannage

  • 404 — l'URL de requête et le commutateur Full URL sont incohérents : soit une base URL avec le commutateur désactivé, soit le chemin complet /chat/completions avec le commutateur activé. Ne mélangez pas les deux.
  • 401 / clé invalide — la clé contient des espaces, a été supprimée ou a expiré. Créez-en une nouvelle sur la page API Keys.
  • Solde insuffisant — rechargez sur la page Wallet.
  • Le modèle n'apparaît pas dans le sélecteur — l'entrée personnalisée n'a pas été enregistrée, ou AUTO est encore actif dans SOLO.
  • Les appels d'outils échouent — choisissez un ID de modèle agentique dans le Model Plaza. La passerelle sert les deux familles via Chat Completions, mais le modèle doit lui-même gérer les outils.

Premiers pas

Quatre étapes jusqu’à votre première requête

  1. 01

    Créer un compte gratuit

    Inscrivez-vous avec Google, GitHub ou votre email et définissez un mot de passe. Aucune carte n’est requise.

  2. 02

    Générer une clé API

    Créez une clé en un clic dans le tableau de bord pour authentifier votre CLI auprès de Code By AI.

  3. 03

    Recharger votre solde

    Ajoutez du crédit avant votre première requête ; l’utilisation est facturée au token sur votre solde.

  4. 04

    Pointer votre CLI vers Code By AI

    Exportez une variable d’URL de base, ou ajoutez un bloc de fournisseur de modèle dans config.toml. Les guides d’installation donnent les lignes exactes pour chaque agent.

Utiliser maintenantRecharger pour envoyer une requêteLe coût d’un mois de travail

Inscription sans carte · un rechargement est requis pour utiliser l’API