Cli on GeppettoBarbuto - Wiki

OpenCode.ai: L'Hub degli Agenti Cross-Provider

Thu, 26 Mar 2026 07:32:02 +0000

🔓 OpenCode.ai: L’Hub degli Agenti Cross-Provider

::: info FILOSOFIA “OPEN” OpenCode.ai è un’interfaccia a riga di comando progettata per portare le capacità agentiche (lettura file, esecuzione test, editing multi-file) su qualsiasi modello linguistico. È lo strumento ideale per chi vuole le prestazioni di Claude Code senza i vincoli di fatturazione della Anthropic Console. :::

1. Architettura e Funzionamento

OpenCode agisce come un bridge tra il tuo terminale e le API dei modelli.

Context Management: Scansiona automaticamente la cartella del progetto (rispettando il file .gitignore).
Tool Use: È in grado di invocare comandi shell per verificare se il codice che ha scritto compila o passa i test.

2. Installazione e Primo Avvio

Essendo basato su Node.js, l’installazione è immediata su Linux (Mac Pro), Windows (WSL2) o macOS.

# Installazione globale tramite NPM
npm install -g @opencode/cli

# Inizializzazione e Login
opencode auth login

3. Collegare i tuoi Provider (Ingegneria dei Costi)

Questa è la sezione più importante per ottimizzare il tuo budget.

A. Sfruttare l’abbonamento GitHub Copilot Pro Plus

Dato che hai già Copilot, puoi accedere ai modelli (Claude 3.5 Sonnet, GPT-4o) tramite GitHub Models senza costi aggiuntivi:

Vai su GitHub Marketplace / Models.
Genera un Personal Access Token (PAT) con permessi di lettura per i modelli.
In OpenCode, configura l’endpoint come “OpenAI Compatible” puntando a https://models.inference.ai.azure.com.

B. Collegamento a Ollama (Local Agent)

Per lavorare su codice sensibile che non deve lasciare il tuo Mac Pro o il server Proxmox:

# Assicurati che Ollama sia attivo sulla porta 11434
opencode config set provider ollama
opencode config set model deepseek-coder-v2

4. Workflow Operativo: Esempi Pratici

Analisi di un Bug

Se hai un errore nel terminale, non copiarlo. Chiedi a OpenCode di leggerlo:

opencode ask "Analizza l'ultimo errore di compilazione e suggerisci una correzione"

Refactoring Multi-file (Agent Mode)

L’agente può modificare l’architettura del progetto:

opencode edit "Sposta la logica di validazione da main.py a un nuovo modulo validators.py e aggiorna tutti i riferimenti"

Cosa succede: OpenCode leggerà main.py, creerà validators.py, modificherà gli import e ti mostrerà un “Diff” per l’approvazione.

📉 Topologia di Integrazione (Mermaid 8.8.2)

graph TD
 USER["Engineer (Terminal)"] --> OCODE["OpenCode CLI"]
 
 subgraph Providers [Gateway dei Modelli]
 OCODE -->|BYOK| GH["GitHub Models (Copilot Sub)"]
 OCODE -->|Local| OL["Ollama (Mac Pro / PVE)"]
 OCODE -->|Direct| AN["Anthropic / OpenAI API"]
 end

 subgraph OS_Interaction [Accesso al Sistema]
 OCODE <-->|Read/Write| FS["Project Filesystem"]
 OCODE -->|Execute| CMD["Shell Commands / Tests"]
 end

 style OCODE fill:#f9f,stroke:#333,stroke-width:2px
 style GH fill:#bbf,stroke:#333

🛠️ Configurazione dei Filtri (.opencodeignore)

Per evitare di consumare token inutilmente o inviare dati non necessari, crea un file .opencodeignore nella root del progetto:

# Escludi cartelle pesanti
node_modules/
.venv/
__pycache__/
dist/
build/

# Escludi file di dati giganti
*.csv
*.log

💡 Note dell’Architetto (Critical Thinking)

Sicurezza: Quando colleghi il tuo abbonamento Copilot tramite GitHub Models, ricorda che ci sono dei Rate Limits giornalieri. Per lo sviluppo massivo, alterna l’uso con Ollama per task di routine e usa i modelli cloud solo per il ragionamento logico complesso.
Validation: Anche se OpenCode può eseguire i test, non fidarti ciecamente. Usa sempre la nostra AI Code Review Checklist prima di fare il commit finale.

Tags: #OpenCode #AI #CLI #Copilot #Ollama #Automation*

Claude Code: L'Agente Architetto di Anthropic

Thu, 26 Mar 2026 07:28:54 +0000

🌩️ Claude Code: L’Agente Architetto di Anthropic

::: info DEFINIZIONE Claude Code è un tool a riga di comando (CLI) che trasforma il modello Claude 3.7 Sonnet in un agente autonomo. A differenza della chat di VS Code, Claude Code può eseguire comandi shell, leggere l’intero filesystem, lanciare test, analizzare log di errore e fare commit Git in autonomia. :::

🚀 Funzionalità “Agentiche” (The Power of Tool-Use)

Il vero valore di Claude Code non è solo la scrittura del codice, ma la capacità di utilizzare il terminale come farebbe un essere umano:

Iterazione Autonoma: Se gli chiedi di risolvere un bug, lui scrive il fix, lancia il comando di test (es. pytest), legge l’errore se fallisce e si corregge finché il test non diventa verde.
Architettural Awareness: Scansiona l’intero progetto per capire le dipendenze tra i file, evitando di rompere moduli correlati durante il refactoring.
Ricerca Intelligente: Usa comandi di sistema come grep o find per localizzare variabili o pattern in codebase enormi in pochi secondi.
Integrazione Git: Al termine del task, propone un messaggio di commit tecnico e dettagliato pronto per essere confermato.

🏗️ Architettura del Ragionamento (Claude 3.7)

Con il rilascio di Claude 3.7 Sonnet, Claude Code introduce il Reasoning (Pensiero Esteso).

Come lavora: Prima di scrivere una sola riga di codice, l’agente avvia una fase di “pensiero” in cui modella mentalmente il grafo delle chiamate e prevede gli effetti collaterali.
Perché è superiore: Riduce drasticamente le allucinazioni logiche tipiche dei modelli veloci (come GPT-4o-mini o Gemini Flash).

🛠️ Setup & Configurazione (Technical Guide)

1. Installazione (NPM based)

Essendo un pacchetto Node.js, si installa globalmente:

npm install -g @anthropic-ai/claude-code

2. Autenticazione

Richiede una chiave API ottenuta dalla Anthropic Console (Tier: Build).

claude auth

3. Comandi Operativi

claude : Avvia la sessione interattiva nella cartella corrente.
claude "Fix all the warnings in the terminal" : Task diretto.
claude config set --max-continuous-steps 10 : Limita l’autonomia dell’agente per controllare i costi.

📉 Il Loop Agentico di Claude Code (Mermaid 8.8.2)

graph TD
 PROMPT["Richiesta: 'Aggiungi API Endpoint'"] --> PLAN["Fase di Ragionamento (Thinking)"]
 PLAN --> EXEC{"Loop di Esecuzione"}
 EXEC -->|Tool Use| READ["Lettura File & Schema DB"]
 EXEC -->|Tool Use| WRITE["Scrittura Codice in src/"]
 EXEC -->|Tool Use| TEST["Esecuzione: 'python -m pytest'"]
 
 TEST -- "Fail: Bug Trovato" --> PLAN
 TEST -- "Pass: OK" --> COMMIT["Generazione Messaggio di Commit"]
 COMMIT --> FINISH["Task Completato"]
 
 style EXEC fill:#f9f,stroke:#333,stroke-width:2px
 style PLAN fill:#bbf,stroke:#333

💰 Analisi dei Costi (Pay-per-Use)

Questo è il punto critico per il tuo laboratorio. Claude Code utilizza un sistema di Context Caching per ridurre i costi, ma:

Ogni interazione invia l’intero contesto (o quasi) del progetto ai server Anthropic.
Per un progetto medio, una sessione di 1 ora di sviluppo può costare tra 0.50$ e 3.00$, a seconda della complessità e della lunghezza del codice.
Confronto: Il tuo abbonamento Copilot Pro Plus è “All you can eat”, mentre Claude Code è “Pay for what you think”.

💡 Note dell’Ingegnere (Critical Thinking)

Claude Code è attualmente l’agente più “intelligente” sul mercato, ma è un sistema chiuso. Per il tuo workflow, lo useremo come riferimento per configurare OpenCode.ai o Aider, cercando di emulare lo stesso comportamento (Loop di test -> Fix) ma utilizzando i provider che abbiamo già pagato.

::: tip PRO-TIP Se decidi di testarlo, usa sempre il comando compact durante la sessione per “riassumere” la cronologia della chat e risparmiare token nelle richieste successive. :::

Tags: #AI #ClaudeCode #Anthropic #AgenticAI #CLI*

Matrice Comparativa: Agenti CLI a Confronto

Thu, 26 Mar 2026 07:27:14 +0000

Passiamo al secondo modulo del nostro percorso: la Matrice Comparativa CLI AI.

In qualità di Senior Software Architect, considero questa pagina come lo strumento di “Decision Making” fondamentale. Non tutti gli agenti CLI sono uguali: alcuni sono sistemi chiusi ottimizzati per un solo modello (Claude Code), altri sono piattaforme aperte progettate per collegare diversi provider (OpenCode.ai, Aider).

Per un professionista che ha già un abbonamento GitHub Copilot Pro Plus, la sfida è capire come estendere quel valore al terminale senza dover pagare fatture duplicate.

⚖️ Matrice Comparativa: Agenti CLI a Confronto

Percorso: /ai/coding-assistants/cli/comparison

::: info OBIETTIVO Analisi tecnica delle differenze tra i principali client IA da terminale. Questa matrice aiuta a scegliere lo strumento giusto in base al tipo di progetto, alla sensibilità del codice e al budget operativo. :::

📊 Tabella Comparativa Tecnica

Caratteristica	Claude Code (Anthropic)	OpenCode.ai	Aider (Open Source)
Modelli Core	Claude 3.5 / 3.7 Sonnet	Multi-modello (Claude, GPT, DeepSeek)	Qualsiasi (API / Ollama)
Tool Use	✅ Avanzato (Shell, Git, Test)	✅ Standard (Editing, Analysis)	🟢 Eccellente (Git Integration)
Billing Model	Pay-per-use (Anthropic Console)	Subscription / Credits	Bring Your Own Key (BYOK)
Integrazione Copilot	❌ No	🟡 Sperimentale / Bridge	🟡 Via Proxy (OpenRouter)
Privacy / Local	❌ Solo Cloud	❌ Solo Cloud	✅ Supporto Ollama Nativo
Facilità Setup	Alta (NPM based)	Alta (Web + CLI)	Media (Python / CLI)

🔍 Analisi dei “Big Three”

🌩️ 1. Claude Code: La Precisione Assoluta

È lo strumento ufficiale di Anthropic.

Punti di forza: È l’unico che sfrutta nativamente il Reasoning di Claude 3.7. È incredibilmente bravo a scrivere piani di implementazione complessi prima di toccare una riga di codice.
Contro: Richiede un account Anthropic Console separato. Non puoi “scalare” il tuo abbonamento Copilot qui.

🔓 2. OpenCode.ai: L’Hub Versatile

È la piattaforma che hai individuato come alternativa.

Punti di forza: Interfaccia moderna e possibilità di accedere ai modelli di “frontiera” con piani flessibili. È progettato per chi vuole la potenza degli agenti senza la rigidità dell’ecosistema Anthropic.
Il tuo caso: Permette di configurare diversi provider. Vedremo nella pagina dedicata come tentare il bridge con la tua sottoscrizione Copilot.

🐍 3. Aider: Lo Standard degli Ingegneri

Il progetto open-source più avanzato per il “coding in coppia” via terminale.

Punti di forza: Gestione dei commit Git automatica e magistrale. Quando Aider finisce una modifica, crea un commit con un messaggio tecnico perfetto.
Flessibilità: Funziona con Ollama sul tuo Mac Pro o Proxmox, rendendolo l’unico del gruppo capace di lavorare a costo zero e con privacy totale.

📉 Diagramma Decisionale (Mermaid 8.8.2)

graph TD
 START["Necessità: Coding via CLI"] --> Q1{"Qual è la tua priorità?"}
 
 Q1 -- "Massima Logica / Claude 3.7" --> CCODE["Claude Code"]
 Q1 -- "Flessibilità / Multi-Modello" --> OCODE["OpenCode.ai"]
 Q1 -- "Privacy / Local LLM / Git" --> AIDER["Aider (Consigliato per Lab)"]

 subgraph Cost_Efficiency
 OCODE --> BRIDGE["Integrazione Provider Esistenti"]
 AIDER --> OLLAMA["Zero Cost via Ollama"]
 end
 
 style AIDER fill:#f9f,stroke:#333,stroke-width:2px
 style CCODE fill:#fbb,stroke:#333

💡 Il Problema del “Double Billing” (Riflessione Senior)

Come architetto, noto che il tuo abbonamento Copilot Pro Plus è attualmente “confinato” nelle estensioni ufficiali di Microsoft.

Il Limite: GitHub non espone ancora ufficialmente una “API Key” generica da usare in strumenti come Claude Code o Aider.
La Soluzione: Svilupperemo nel modulo di OpenCode.ai come sfruttare il sistema di “App Connect” o proxy per cercare di massimizzare l’uso della tua licenza esistente, evitando di pagare due volte per lo stesso modello (Claude 3.5).

Tags: #AI #CLI #ClaudeCode #OpenCode #Aider #Comparison*

Terminal AI: L'Evoluzione degli Agenti nel Coding

Thu, 26 Mar 2026 07:17:15 +0000

💻 Terminal AI: L’Evoluzione degli Agenti nel Coding

Focus: Comprendere il passaggio dall’assistente nell’IDE (VS Code) all’agente autonomo nella Shell (CLI).

::: info IL NUOVO PARADIGMA Fino a ieri l’IA era “confinata” in una sidebar (come Copilot Chat). Oggi, con strumenti come Claude Code e OpenCode, l’IA esce dalla finestra di testo e ottiene il controllo del terminale: può leggere log, eseguire compilatori, lanciare test e correggere il codice basandosi sui risultati reali dell’esecuzione. :::

🔄 VS Code vs. CLI: Un’Analisi Architetturale

Sebbene VS Code sia lo standard quotidiano per la scrittura del codice, l’approccio via terminale introduce potenzialità diverse. Ecco un confronto per capire quando switchare:

Caratteristica	Visual Studio Code (IDE)	Terminale (CLI Agents)
Interazione	Visiva, basata su mouse e menu.	Basata su comandi e linguaggio naturale.
Contesto	Limitato ai file aperti o indicizzati.	Accesso totale al filesystem e ai tool di sistema.
Ciclo di Feedback	L’utente deve lanciare i test e copiare l’errore.	L’agente lancia i test, legge l’errore e si corregge.
Autonomia	“Suggeritore” (Copilot).	“Agente” (Claude Code / OpenCode).
Uso Ideale	Sviluppo attivo, UI design, refactoring locale.	Debugging complesso, migrazioni, automazione CI/CD.

Perché esplorare la CLI se ami VS Code?

Il vantaggio della CLI non è la mancanza di grafica, ma il “Tool Use”. Un agente CLI può digitare python main.py, vedere che manca una libreria, fare pip install e riprovare. In VS Code, questo ciclo richiede l’intervento umano costante. La CLI trasforma l’IA in un Junior Developer autonomo a cui deleghi un intero task, non solo una funzione.

🛠️ Gli Strumenti del Hub

In questa sezione della Wiki svilupperemo il know-how per i seguenti client:

⚖️ Matrice Comparativa CLI AI: Un confronto tecnico tra Claude Code, OpenCode e Aider.
🌩️ Claude Code (Anthropic): Analisi dello strumento “Premium” basato sui modelli Sonnet e le loro capacità di ragionamento.
🔓 OpenCode.ai: L’Alternativa Versatile: Come utilizzare una CLI aperta per collegare i tuoi abbonamenti esistenti (come Copilot Pro Plus) e modelli Open Source.

📉 Workflow: Dall’IDE alla Shell (Mermaid 8.8.2)

graph LR
 IDE["IDE (VS Code)"] -- "Scrittura & Design" --> DEV["Sviluppatore"]
 DEV -- "Task Complesso" --> CLI["CLI AI Agent"]
 CLI -- "Read Files" --> FS["Filesystem"]
 CLI -- "Run Command" --> TEST["Compiler / Tests"]
 TEST -- "Error Output" --> CLI
 CLI -- "Apply Fix" --> FS
 FS -- "Code Update" --> IDE
 
 style CLI fill:#f9f,stroke:#333,stroke-width:2px
 style IDE fill:#bbf,stroke:#333

🔑 Integrazione dei Provider (Coming Soon)

Uno degli obiettivi di questa sezione è spiegare come non pagare due volte. Sfrutteremo le potenzialità di OpenCode per collegare:

GitHub Copilot API: Per usare la tua sottoscrizione Pro Plus fuori da VS Code.
OpenAI / Anthropic Keys: Per chi preferisce il pay-per-use.
Ollama (Local): Per mantenere il codice sensibile all’interno del tuo server Proxmox.

Tags: #AI #CLI #OpenCode #ClaudeCode #ProgrammingWorkflow #AgentialAI*