Modèles personnalisés ZCode : Claude et GPT

ZCode est l'agent de bureau de Zhipu ; pointez-le vers Code By AI pour exécuter les modèles Claude et GPT via un seul fournisseur compatible OpenAI.

ZCode est un Agentic Development Environment, pas un simple habillage de terminal : l'agent manipule les fichiers, le terminal, Git et un aperçu navigateur depuis le chat. Son panneau Model Settings accepte des fournisseurs personnalisés : seule la connexion au modèle change, l'agent et l'interface restent identiques.

Une commande (macOS / Linux)

Quittez d'abord ZCode. L'application garde son registre de fournisseurs en mémoire et réécrit ~/.zcode/v2/config.json lors d'un enregistrement ou à la fermeture, ce qui effacerait les modifications faites pendant qu'elle tourne.

Copy
1
curl -fsSL https://www.codebyai.net/setup.sh | sh -s -- --zcode

Le script demande votre clé API (saisie masquée), ajoute un fournisseur codebyai avec gpt-5.6-terra et claude-sonnet-5, sauvegarde le fichier et le laisse accessible au seul propriétaire. Le relancer renouvelle la clé ; | sh -s -- --uninstall restaure le fichier d'origine. Les étapes manuelles ci-dessous font la même chose.

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

Dans ZCode, ouvrez le sélecteur de modèle sous la zone de chat et cliquez sur Manage models. Cela ouvre Settings → Model Settings, où les fournisseurs sont ajoutés.

3. Ajouter le fournisseur

1. Cliquez sur Add Provider en bas de la liste des fournisseurs à gauche.
2. Nommez-le Code By AI.
3. Réglez OpenAI API base URL sur https://www.codebyai.net/api/agent/v1.
4. Collez la clé API Code By AI.
5. Enregistrez, cliquez sur Add Model et saisissez gpt-5.6-terra. Cliquez de nouveau sur Add Model pour claude-sonnet-5.
6. Activez l'interrupteur du fournisseur.

Utilisez le protocole OpenAI pour les deux familles. Le mode Anthropic-messages de ZCode envoie un ancien paramètre thinking que les modèles Claude actuels rejettent ; la route Chat Completions de la passerelle transfère les ID claude-* vers le canal Claude et les facture aux tarifs Claude. Un seul fournisseur couvre donc les deux.

4. Choisir le modèle et tester

Ouvrez une session, choisissez l'un des deux modèles dans le sélecteur et posez une question courte. Une réponse normale confirme que le point de terminaison, la clé et l'ID de modèle concordent.

ID de modèle et fenêtre de contexte

Utilisez les ID listés sur le Model Plaza ; les deux ci-dessus sont les exemples de ce guide. Un modèle ajouté à un fournisseur personnalisé démarre avec une fenêtre de contexte de 200 000 tokens dans ZCode. Ouvrez le modèle sous Settings → Model Providers → Advanced pour modifier cette valeur et le nombre maximal de tokens de sortie. Les deux réglages s'appliquent aux nouvelles sessions après enregistrement.

Dépannage

• 404 page not found — la base URL est incomplète ou contient un chemin en trop. Utilisez https://www.codebyai.net/api/agent/v1 ; n'ajoutez pas /chat/completions et ne doublez pas /v1.
• 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 et collez-la à nouveau.
• Solde insuffisant — rechargez sur la page Wallet.
• 400 mentionnant un reasoning level — un fournisseur personnalisé peut refuser le niveau de réflexion le plus élevé proposé par ZCode. Baissez l'effort pour ce modèle ; la passerelle transmet le niveau envoyé par ZCode.
• La liste de modèles du fournisseur est vide — l'interrupteur est désactivé ou Add Model n'a pas été enregistré.
• Le fournisseur disparaît après un redémarrage de ZCode — l'application tournait encore quand le script a écrit le fichier. Quittez-la complètement, relancez la commande, puis rouvrez-la.