Zoo Code

Conecta a TokenMix el agente de código para VS Code con mantenimiento activo.

Qué es Zoo Code

Zoo Code es un agente de programación con IA dentro de VS Code. Puede explicar archivos, generar código, refactorizar, depurar y trabajar con Code, Architect, Ask, Debug y Custom Modes. Para empezar, lo más seguro es preguntar primero, pedir un plan después y permitir cambios pequeños al final.

Zoo Code puede conectarse a TokenMix mediante el proveedor OpenAI Compatible. No necesitas desplegar Zoo Code ni escribir un adaptador. Solo tienes que cambiar el endpoint API en la configuración de la extensión.

Preparar los datos de TokenMix

Prepara estos valores:

• 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 debe incluir /v1. No uses el endpoint predeterminado de OpenAI y no escribas solo https://api.tokenmix.ai.

Instalar Zoo Code

1. Abre VS Code.
2. Abre Extensions.
3. Busca Zoo Code.
4. Comprueba que el extension ID sea ZooCodeOrganization.zoo-code.
5. Haz clic en Install.
6. Abre el panel de Zoo Code o la configuración de Zoo Code desde la command palette.

Si migras desde otro agente de código para VS Code, empieza solo con la configuración del modelo. Cuando el chat y la generación de código funcionen, mueve MCP, permisos de comandos y reglas del proyecto.

Configurar la API de TokenMix

1. Abre Settings o Provider settings en Zoo Code.
2. Busca API Provider o Model Provider.
3. Selecciona OpenAI Compatible.
4. Configura Base URL como https://api.tokenmix.ai/v1.
5. Escribe tu TokenMix Key en API Key.
6. Escribe un TokenMix model ID en Model.
7. Mantén Reasoning, Responses API, Embedding, Code Index y Context Window con sus valores predeterminados para la primera prueba.
8. Guarda la configuración.

Las claves API suelen guardarse en VS Code Secret Storage. No pongas tu clave en .env, README, archivos de configuración del proyecto ni capturas de pantalla.

Primera prueba

Usa primero un proyecto temporal o una rama de prueba. No dejes que el agente modifique de inmediato un repositorio de producción.

Empieza con Ask mode:

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

Después prueba 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 las respuestas son normales, prueba una tarea pequeña en Code mode:

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

Si estas 3 pruebas funcionan, la Base URL de TokenMix, la clave API y el ID del modelo están configurados correctamente.

Orden recomendado

1. Ask: explicar código sin editar archivos.
2. Architect: escribir un plan antes de implementar.
3. Code: hacer una modificación pequeña y limitada.
4. Debug: investigar un error claro.
5. Custom Modes: estandarizar flujos repetidos del equipo.
6. MCP Servers: conectar herramientas externas después de estabilizar el modelo.

Este orden es más seguro para usuarios nuevos. Un agente de IDE puede leer y escribir archivos y ejecutar comandos. Empieza con tareas pequeñas para entender los avisos de permiso.

MCP

Zoo Code admite MCP Servers. MCP permite que el agente llame herramientas adicionales, por ejemplo leer documentación externa, usar herramientas de diseño, ejecutar consultas de base de datos de solo lectura o llamar servicios internos.

Configuración recomendada:

1. Configura primero solo el modelo de TokenMix.
2. Confirma que el chat normal funciona.
3. Añade un MCP Server simple.
4. Verifica que el agente vea la tool list.
5. Para la primera llamada MCP, usa una tarea de solo lectura.
6. Confirma por separado los permisos para escribir archivos, ejecutar comandos o cambiar bases de datos.

No configures el modelo y MCP al mismo tiempo durante el primer setup. Separar los pasos facilita encontrar la causa si algo falla.

Code Index y Embedding

Si activas Code Index o búsqueda en el repositorio, quizá necesites configurar un modelo embedding.

• Los modelos de chat y embedding pueden configurarse por separado.
• Si la interfaz admite OpenAI Compatible embeddings, puedes usar modelos embedding de TokenMix.
• La Base URL de embedding también es https://api.tokenmix.ai/v1.
• Model debe ser un TokenMix embedding model ID.
• Si la interfaz pide dimension, usa la dimensión del modelo embedding seleccionado.

Los principiantes pueden dejar Code Index desactivado al principio. El chat normal, los cambios pequeños y la explicación de código pueden funcionar antes de añadir indexación del repositorio.

Solución de problemas

• 401 o unauthorized: la clave API es incorrecta, caducó o tiene espacios extra.
• model not found: no es un TokenMix model ID, o tu cuenta no tiene acceso.
• Base URL error: falta /v1; usa https://api.tokenmix.ai/v1.
• Las solicitudes van a OpenAI: el proveedor no es OpenAI Compatible, o la Base URL sigue siendo la predeterminada.
• La salida se corta: usa un modelo con más contexto o envía menos archivos a la vez.
• Tool call denegado: revisa los permisos de Zoo Code y VS Code workspace trust.
• MCP no funciona: confirma primero el chat normal; después revisa que el MCP Server esté iniciado y que la ruta de configuración sea correcta.

Consejo para empezar

Trata Zoo Code como un asistente que puede escribir código, pero que necesita tu revisión. Pide primero una explicación, luego un plan y finalmente una edición. Ten especial cuidado con archivos de pagos, login, base de datos, configuración de producción y secretos. Después de cada cambio, revisa el diff y ejecuta las pruebas o el build del proyecto.