Zoo Code

Connectez l'agent de code VS Code maintenu activement à TokenMix.

Qu'est-ce que Zoo Code

Zoo Code est un agent de code IA intégré à VS Code. Il peut expliquer des fichiers, générer du code, refactorer, déboguer et travailler avec Code, Architect, Ask, Debug et Custom Modes. Pour débuter, utilisez-le dans cet ordre: poser une question, demander un plan, puis autoriser une petite modification.

Zoo Code peut se connecter à TokenMix avec le fournisseur OpenAI Compatible. Vous n'avez pas besoin de déployer Zoo Code ni d'écrire un adaptateur. Il suffit de changer l'endpoint API dans les réglages de l'extension.

Préparer les valeurs TokenMix

Préparez ces valeurs:

• Provider: OpenAI Compatible
• Base URL: https://api.tokenmix.ai/v1
• API Key: TokenMix API Key
• Model: TokenMix model ID, for example <your-model-short-id>

La Base URL doit inclure /v1. N'utilisez pas l'endpoint OpenAI par défaut et n'entrez pas seulement https://api.tokenmix.ai.

Installer Zoo Code

1. Ouvrez VS Code.
2. Ouvrez Extensions.
3. Recherchez Zoo Code.
4. Vérifiez que l'extension ID est ZooCodeOrganization.zoo-code.
5. Cliquez sur Install.
6. Ouvrez le panneau Zoo Code ou les réglages Zoo Code depuis la command palette.

Si vous migrez depuis un autre agent de code pour VS Code, commencez uniquement par la configuration du modèle. Une fois le chat et la génération de code validés, déplacez MCP, les permissions de commande et les règles de projet.

Configurer l'API TokenMix

1. Ouvrez Settings ou Provider settings dans Zoo Code.
2. Cherchez API Provider ou Model Provider.
3. Sélectionnez OpenAI Compatible.
4. Mettez Base URL sur https://api.tokenmix.ai/v1.
5. Renseignez votre TokenMix Key dans API Key.
6. Renseignez un TokenMix model ID dans Model.
7. Gardez Reasoning, Responses API, Embedding, Code Index et Context Window avec leurs valeurs par défaut pour le premier test.
8. Enregistrez les réglages.

Les clés API sont généralement stockées dans VS Code Secret Storage. Ne mettez pas votre clé dans .env, un README, un fichier de configuration du projet ou une capture d'écran.

Premier test

Utilisez d'abord un projet temporaire ou une branche de test. Ne laissez pas l'agent modifier immédiatement un dépôt de production.

Commencez avec Ask mode:

Explain what the current file does. Do not modify any files.

Essayez ensuite Architect mode:

Create a plan for a classic frontend-backend separated architecture diagram, including frontend, backend, database, cache, and object storage. Do not modify files.

Si les réponses sont normales, testez une petite tâche en Code mode:

Create a small TypeScript function that validates an email string and add one simple usage example.

Si ces 3 tests fonctionnent, la Base URL TokenMix, la clé API et l'ID du modèle sont correctement configurés.

Ordre recommandé

1. Ask: expliquer le code sans modifier les fichiers.
2. Architect: écrire un plan avant l'implémentation.
3. Code: faire une petite modification limitée.
4. Debug: analyser une erreur claire.
5. Custom Modes: standardiser les workflows d'équipe.
6. MCP Servers: connecter les outils externes après stabilisation du modèle.

Cet ordre est plus sûr pour les nouveaux utilisateurs. Un agent IDE peut lire et écrire des fichiers et lancer des commandes. Commencez par de petites tâches afin de comprendre les demandes de permission.

MCP

Zoo Code prend en charge MCP Servers. MCP permet à l'agent d'appeler des outils supplémentaires, par exemple lire de la documentation externe, utiliser des outils de design, lancer des requêtes de base de données en lecture seule ou appeler des services internes.

Configuration recommandée:

1. Configurez d'abord seulement le modèle TokenMix.
2. Vérifiez que le chat normal fonctionne.
3. Ajoutez un MCP Server simple.
4. Vérifiez que l'agent voit la tool list.
5. Pour le premier appel MCP, utilisez une tâche en lecture seule.
6. Confirmez séparément les permissions pour l'écriture de fichiers, l'exécution de commandes ou les changements de base de données.

Ne configurez pas le modèle et MCP en même temps lors du premier setup. Des étapes séparées rendent le diagnostic beaucoup plus simple.

Code Index et Embedding

Si vous activez Code Index ou la recherche dans le dépôt, vous devrez peut-être configurer un modèle embedding.

• Les modèles de chat et embedding peuvent être configurés séparément.
• Si l'interface prend en charge OpenAI Compatible embeddings, vous pouvez utiliser les modèles embedding TokenMix.
• La Base URL embedding est aussi https://api.tokenmix.ai/v1.
• Model doit être un TokenMix embedding model ID.
• Si l'interface demande une dimension, utilisez celle du modèle embedding choisi.

Les débutants peuvent laisser Code Index désactivé au départ. Le chat normal, les petites modifications et l'explication de code peuvent fonctionner avant l'indexation du dépôt.

Dépannage

• 401 ou unauthorized: la clé API est incorrecte, expirée ou contient des espaces.
• model not found: ce n'est pas un TokenMix model ID, ou votre compte n'y a pas accès.
• Base URL error: /v1 manque; utilisez https://api.tokenmix.ai/v1.
• Les requêtes partent vers OpenAI: le fournisseur n'est pas OpenAI Compatible, ou la Base URL est encore celle par défaut.
• Sortie interrompue: utilisez un modèle avec plus de contexte ou envoyez moins de fichiers à la fois.
• Tool call refusé: vérifiez les permissions Zoo Code et VS Code workspace trust.
• MCP ne fonctionne pas: confirmez d'abord le chat normal, puis vérifiez que le MCP Server est lancé et que le chemin de configuration est correct.

Conseil pour débuter

Considérez Zoo Code comme un assistant capable d'écrire du code, mais qui doit rester relu par vous. Demandez d'abord une explication, puis un plan, puis seulement une modification. Soyez particulièrement prudent avec les fichiers de paiement, login, base de données, configuration de production et secrets. Après chaque changement, relisez le diff et lancez les tests ou le build du projet.