Agenti di codice in pratica: API, Vibe Code CLI e Vibe Code Web
In questa pagina
Lezione riscritta il 2 novembre 2026. Poiché Devstral è stato rimosso dalle API il 31 luglio 2026, gli esempi di API qui presenti utilizzano Mistral Small 4. La sezione Vibe riflette la documentazione attuale di Vibe Code: installazione, modello integrato (Mistral Medium 3.5) e le tre interfacce—CLI, estensione VS Code e Vibe Code Web. Fonti: Installazione e configurazione · Scegliere sessioni CLI, VS Code o web · Configurazione.
Tre modi per mettere al lavoro un agente
Un modello agentico vale solo quanto il modo in cui lo colleghi al lavoro reale. Mistral offre tre percorsi: le API, dove costruisci il tuo agente; Vibe Code in locale, nel tuo terminale o in VS Code; e Vibe Code Web, che esegue l’agente in una sandbox remota collegata a un repository GitHub. Ognuno si adatta a una diversa parte della giornata di uno sviluppatore.
Tramite le API Mistral
Le API sono l’interfaccia più flessibile: ti permettono di costruire i tuoi flussi di lavoro agentici con i tuoi strumenti e la tua logica di controllo. Inizia dal caso più semplice, una chiamata di chat senza strumenti. Qui inviamo una funzione di autenticazione vulnerabile a Mistral Small 4 e chiediamo una diagnosi. Impostare temperature=0 non è decorativo: per l’analisi della sicurezza, vuoi risultati riproducibili, non variazioni da un’esecuzione all’altra.
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": "You are an expert development agent. Analyze the provided code and propose improvements."
},
{
"role": "user",
"content": """Here is a Python file that handles authentication.
Identify security issues and propose fixes:
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)
La modalità agentica cambia la natura dello scambio. Invece di ricevere testo, dichiari gli strumenti che il modello può richiedere di chiamare, e il modello restituisce tool_calls—un nome di strumento e i suoi argomenti. I tre strumenti seguenti formano la fondazione minima per un agente di codice: leggere un file, scrivere un file, eseguire un comando. Con essi, l’istruzione “aggiungi hint di tipo a tutti i file in src/utils/” diventa eseguibile, mentre in modalità chat rimarrebbe un suggerimento.
tools = [
{
"type": "function",
"function": {
"name": "read_file",
"description": "Read the contents of a source file",
"parameters": {
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "Relative path to the file"
}
},
"required": ["path"]
}
}
},
{
"type": "function",
"function": {
"name": "write_file",
"description": "Write content to a file",
"parameters": {
"type": "object",
"properties": {
"path": {"type": "string"},
"content": {"type": "string"}
},
"required": ["path", "content"]
}
}
},
{
"type": "function",
"function": {
"name": "run_command",
"description": "Execute a shell command",
"parameters": {
"type": "object",
"properties": {
"command": {"type": "string"}
},
"required": ["command"]
}
}
}
]
response = client.chat.complete(
model="mistral-small-2603",
messages=[
{
"role": "user",
"content": "Explore the project and add Python type hints to all files in the src/utils/ directory"
}
],
tools=tools,
tool_choice="auto",
)
# Process the tool calls returned by the model
for tool_call in response.choices[0].message.tool_calls:
print(f"Tool: {tool_call.function.name}")
print(f"Arguments: {tool_call.function.arguments}")
Nota che nulla viene eseguito automaticamente: il ciclo—chiamare lo strumento, restituire l’output al modello, chiedere il passo successivo—rimane interamente tua responsabilità. Questo è il prezzo della flessibilità, ed è esattamente ciò che la CLI di Vibe gestisce per te.
Tramite Vibe Code in locale: la CLI e l’estensione VS Code
Vibe Code è la modalità “code” di Vibe, l’agente di Mistral. In locale, si presenta in due forme che condividono lo stesso motore, configurazione e cronologia delle sessioni: la CLI, nel tuo terminale, e l’estensione VS Code, che aggiunge il contesto dell’editor (file attivo, selezione, diff). L’installazione della CLI richiede una sola riga su macOS e Linux:
# Official installer (installs uv if needed, then the mistral-vibe package)
curl -LsSf https://mistral.ai/vibe/install.sh | bash
# Or manual installation
uv tool install mistral-vibe
Poi naviga nel tuo progetto ed esegui vibe. Al primo avvio, una procedura guidata ti chiede di accedere con il tuo account Mistral (Vibe Code è incluso nei piani, con limiti di utilizzo dipendenti dal piano) o di inserire una chiave API. Quindi parli con l’agente come con un collega che ha le mani sulla tastiera:
Explain this project's architecture.
Add an API route /health that returns the server status, along with its test.
Run the test suite and fix what fails.
Vibe fornisce gli strumenti stessi (lettura/scrittura file, comandi shell) e il ciclo agentico che dovevi scrivere a mano con le API. Include un modello integrato, Mistral Medium 3.5, e il comando /model ti permette di sceglierne un altro tra quelli configurati (Small 4, Codestral, un modello locale…). Le modifiche e i comandi passano attraverso un sistema di approvazione che configuri per ogni agente: rivedilo prima di affidargli un repository importante. Per l’automazione, vibe --prompt esegue un’esecuzione non interattiva, utile nell’integrazione continua.
Tramite Vibe Code Web
Vibe Code Web è la terza interfaccia: un cockpit per agenti remoti. Crei un progetto da uno o più repository GitHub sotto lo stesso proprietario, avvii una sessione con un’istruzione precisa e l’agente lavora in una sandbox gestita nel cloud: clona, pianifica, modifica, esegue comandi e test, poi prepara un branch o una pull request affinché tu la riveda su GitHub. Non è necessaria alcuna copia locale e la tua macchina può rimanere chiusa mentre l’agente lavora. Dalla CLI, il comando /teleport trasferisce una sessione in corso sul web.
Scegli la CLI o l’estensione quando il compito dipende da file, servizi o segreti presenti solo sulla tua macchina.
Confronto tra i tre percorsi
| Criterio | API Python | Vibe Code (CLI, VS Code) | Vibe Code Web |
|---|---|---|---|
| Ciclo agentico | Lo scrivi tu | Integrato | Integrato |
| Accesso ai file | Tramite i tuoi strumenti | Copia di lavoro locale | Sandbox remota, repo GitHub |
| Modello | Quello che chiami | Medium 3.5 integrato, altri opzionali | Motore Vibe Code |
| Modalità non interattiva | Sì | Sì (vibe --prompt, solo CLI) | No |
| Caso d’uso | Pipeline, prodotti personalizzati | Sviluppo quotidiano | Task di lunga durata su repo remoto |
Leggendo da destra a sinistra, questa tabella descrive un gradiente di controllo: più ti sposti verso le API, più decidi tutto, incluso ciò che può rompersi.
Cosa fa la differenza nella pratica
La qualità del risultato dipende meno dal modello che dal modo in cui formuli la tua richiesta. “Aggiungi validazione” lascia all’agente il compito di inventare posizione, stile e regole; “Aggiungi validazione email in src/auth/validators.py usando il pattern esistente” gli fornisce il file, la convenzione e il confine. Nello stesso spirito, cita esplicitamente i file rilevanti e i vincoli del progetto invece di sperare che li indovini.
La verifica rimane non negoziabile: un agente competente può comunque introdurre una regressione, specialmente quando tocca più file contemporaneamente. Prendi l’abitudine di rivedere il diff prima di accettarlo, proprio come faresti per la pull request di un nuovo assunto. E tieni a mente l’impostazione finale: scegliere lo strumento giusto. Usa Vibe Code in locale per lo sviluppo quotidiano, Vibe Code Web per task di lunga durata su un repo remoto e le API per le tue pipeline.
Punti chiave
- Le API danno il controllo totale: scrivi tu gli strumenti e il ciclo agentico
- Vibe Code si installa con
curl -LsSf https://mistral.ai/vibe/install.sh | bash(ouv tool install mistral-vibe) e include Mistral Medium 3.5 - La CLI e l’estensione VS Code condividono configurazione e sessioni;
vibe --promptserve per l’automazione - Vibe Code Web esegue l’agente in una sandbox remota e produce branch e pull request
- Istruzioni precise e revisione dei diff rimangono essenziali