Ir al contenido principal
Español— Elegir un idioma
Menú

Agentes de código en la práctica: API, Vibe Code CLI y Vibe Code Web

Lección 8 de 14 Actualizado el 2 de noviembre de 2026 Desarrollador
En esta página
  1. Tres formas de poner un agente a trabajar
  2. A través de la API de Mistral
  3. A través de Vibe Code localmente: la CLI y la extensión de VS Code
  4. A través de Vibe Code Web
  5. Comparación de las tres vías
  6. Qué marca la diferencia en la práctica
  7. Puntos clave

Lección reescrita el 2 de noviembre de 2026. Dado que Devstral se eliminó de la API el 31 de julio de 2026, los ejemplos de API aquí presentes utilizan Mistral Small 4. La sección de Vibe refleja la documentación actual de Vibe Code: instalación, el modelo integrado (Mistral Medium 3.5) y las tres interfaces: CLI, extensión de VS Code y Vibe Code Web. Fuentes: Instalación y configuración · Elegir sesiones CLI, VS Code o web · Configuración.

Tres formas de poner un agente a trabajar

Un modelo agéntico solo es tan bueno como la conexión que establezcas con el trabajo real. Mistral ofrece tres vías: la API, donde construyes tu propio agente; Vibe Code localmente, en tu terminal o VS Code; y Vibe Code Web, que ejecuta el agente en un entorno aislado remoto contra un repositorio de GitHub. Cada una encaja en una parte diferente del día a día de un desarrollador.

A través de la API de Mistral

La API es la interfaz más flexible: te permite construir tus propios flujos de trabajo agénticos con tus propias herramientas y lógica de control. Comienza con el caso más simple, una llamada de chat sin herramientas. Aquí enviamos una función de autenticación vulnerable a Mistral Small 4 y pedimos un diagnóstico. Establecer temperature=0 no es decorativo: para el análisis de seguridad, necesitas resultados reproducibles, no variaciones de una ejecución a otra.

from mistralai.client import Mistral
import os

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

response = client.chat.complete(
    model="mistral-small-2603",
    messages=[
        {
            "role": "system",
            "content": "Eres un agente de desarrollo experto. Analiza el código proporcionado y propone mejoras."
        },
        {
            "role": "user",
            "content": """Aquí tienes un archivo Python que gestiona la autenticación.
Identifica problemas de seguridad y propone correcciones:

def login(username, password):
    query = f"SELECT * FROM users WHERE username='{username}' AND password='{password}'"
    user = db.execute(query).fetchone()
    if user:
        session['user_id'] = user['id']
        return True
    return False
"""
        }
    ],
    temperature=0,
    max_tokens=2000,
)

print(response.choices[0].message.content)

El modo agéntico cambia la naturaleza del intercambio. En lugar de recibir texto, declaras herramientas que el modelo puede solicitar llamar, y el modelo devuelve tool_calls: un nombre de herramienta y sus argumentos. Las tres herramientas siguientes forman la base mínima para un agente de código: leer un archivo, escribir un archivo, ejecutar un comando. Con ellas, la instrucción «añade anotaciones de tipo a todos los archivos en src/utils/» se vuelve ejecutable, mientras que en el modo chat seguiría siendo una sugerencia.

tools = [
    {
        "type": "function",
        "function": {
            "name": "read_file",
            "description": "Lee el contenido de un archivo fuente",
            "parameters": {
                "type": "object",
                "properties": {
                    "path": {
                        "type": "string",
                        "description": "Ruta relativa al archivo"
                    }
                },
                "required": ["path"]
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "write_file",
            "description": "Escribe contenido en un archivo",
            "parameters": {
                "type": "object",
                "properties": {
                    "path": {"type": "string"},
                    "content": {"type": "string"}
                },
                "required": ["path", "content"]
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "run_command",
            "description": "Ejecuta un comando de shell",
            "parameters": {
                "type": "object",
                "properties": {
                    "command": {"type": "string"}
                },
                "required": ["command"]
            }
        }
    }
]

response = client.chat.complete(
    model="mistral-small-2603",
    messages=[
        {
            "role": "user",
            "content": "Explora el proyecto y añade anotaciones de tipo de Python a todos los archivos del directorio src/utils/"
        }
    ],
    tools=tools,
    tool_choice="auto",
)

# Procesa las llamadas a herramientas devueltas por el modelo
for tool_call in response.choices[0].message.tool_calls:
    print(f"Herramienta: {tool_call.function.name}")
    print(f"Argumentos: {tool_call.function.arguments}")

Ten en cuenta que nada se ejecuta por sí solo: el bucle —llamar a la herramienta, devolver la salida al modelo, pedir el siguiente paso— sigue siendo enteramente tu responsabilidad. Ese es el precio de la flexibilidad, y es exactamente lo que la CLI de Vibe gestiona por ti.

A través de Vibe Code localmente: la CLI y la extensión de VS Code

Vibe Code es el modo «code» de Vibe, el agente de Mistral. Localmente, se presenta en dos formas que comparten el mismo motor, configuración e historial de sesiones: la CLI, en tu terminal, y la extensión de VS Code, que añade contexto del editor (archivo activo, selección, diffs). Instalar la CLI requiere una sola línea en macOS y Linux:

# Instalador oficial (instala uv si es necesario, luego el paquete mistral-vibe)
curl -LsSf https://mistral.ai/vibe/install.sh | bash

# O instalación manual
uv tool install mistral-vibe

Luego navega hasta tu proyecto y ejecuta vibe. En el primer lanzamiento, un asistente te pedirá que inicies sesión con tu cuenta de Mistral (Vibe Code está incluido en los planes, con límites de uso según el plan) o que introduzcas una clave de API. A partir de ahí, hablas con el agente como con un colega que tiene las manos en el teclado:

Explica la arquitectura de este proyecto.
Añade una ruta de API /health que devuelva el estado del servidor, junto con su prueba.
Ejecuta la suite de pruebas y corrige lo que falle.

Vibe proporciona las herramientas en sí (lectura/escritura de archivos, comandos de shell) y el bucle agéntico que tuviste que escribir a mano con la API. Se entrega con un modelo integrado, Mistral Medium 3.5, y el comando /model te permite elegir otro de los configurados (Small 4, Codestral, un modelo local…). Los cambios y comandos pasan por un sistema de aprobación que configuras por agente: revísalo antes de confiarle un repositorio importante. Para la automatización, vibe --prompt ejecuta una ejecución no interactiva, útil en integración continua.

A través de Vibe Code Web

Vibe Code Web es la tercera interfaz: una cabina de mando para agentes remotos. Creas un proyecto a partir de uno o más repositorios de GitHub bajo el mismo propietario, inicias una sesión con una instrucción precisa y el agente trabaja en un entorno aislado gestionado en la nube: clona, planifica, modifica, ejecuta comandos y pruebas, y luego prepara una rama o pull request para que la revises en GitHub. No hace falta una copia local y tu máquina puede permanecer cerrada mientras el agente trabaja. Desde la CLI, el comando /teleport transfiere una sesión en curso a la web.

Elige la CLI o la extensión cuando la tarea dependa de archivos, servicios o secretos presentes solo en tu máquina.

Comparación de las tres vías

CriterioAPI de PythonVibe Code (CLI, VS Code)Vibe Code Web
Bucle agénticoLo escribes túIntegradoIntegrado
Acceso a archivosVía tus herramientasCopia de trabajo localEntorno aislado remoto, repo de GitHub
ModeloEl que llamesMedium 3.5 integrado, otros opcionalesMotor de Vibe Code
Modo no interactivoSíSí (vibe --prompt, solo CLI)No
Caso de usoPipelines, productos personalizadosDesarrollo diarioTareas de larga duración en un repo remoto

Leída de derecha a izquierda, esta tabla describe un gradiente de control: cuanto más te acercas a la API, más decides tú todo, incluido lo que puede romperse.

Qué marca la diferencia en la práctica

La calidad del resultado depende menos del modelo que de cómo formules tu solicitud. «Añade validación» deja que el agente invente la ubicación, el estilo y las reglas; «Añade validación de correo electrónico en src/auth/validators.py usando el patrón existente» le da el archivo, la convención y el límite. En la misma línea, cita explícitamente los archivos relevantes y las restricciones del proyecto en lugar de esperar que los adivine.

La verificación sigue siendo innegociable: un agente competente puede introducir una regresión, especialmente cuando toca varios archivos a la vez. Haz el hábito de revisar el diff antes de aceptarlo, igual que harías con la pull request de un nuevo empleado. Y ten presente el ajuste final: elegir la herramienta adecuada. Usa Vibe Code localmente para el desarrollo diario, Vibe Code Web para tareas de larga duración en un repo remoto y la API para tus propias pipelines.

Puntos clave

  • La API ofrece control total: tú escribes las herramientas y el bucle agéntico
  • Vibe Code se instala con curl -LsSf https://mistral.ai/vibe/install.sh | bash (o uv tool install mistral-vibe) e incluye Mistral Medium 3.5
  • La CLI y la extensión de VS Code comparten configuración y sesiones; vibe --prompt es para automatización
  • Vibe Code Web ejecuta el agente en un entorno aislado remoto y produce ramas y pull requests
  • Las instrucciones precisas y la revisión de diffs siguen siendo esenciales