Integrare Helvira con Cline in VSCode
Usa i modelli IA di Helvira direttamente nel tuo editor VSCode con l'estensione Cline. Programma con un'IA ospitata in Svizzera mantenendo la completa privacy dei dati.
Cos'è Cline?
Cline è un agente di programmazione IA autonomo per Visual Studio Code che può:
- Creare e modificare file nel tuo progetto
- Eseguire comandi da terminale con la tua approvazione
- Debuggare e correggere automaticamente errori nel codice
- Refactorizzare e migliorare il codice esistente
- Generare funzionalità complete dal linguaggio naturale
Perché Helvira + Cline?
- Privacy dei dati svizzera: Il tuo codice non lascia mai la Svizzera
- Conforme GDPR & nLPD: Sicurezza di livello enterprise
- Modelli IA multipli: Accesso a vari modelli in base al tuo piano Helvira
- Trasparenza dei costi: Prezzi chiari senza costi nascosti
- Integrazione fluida: Funziona come qualsiasi altro provider IA in Cline
Prerequisiti
Prima di iniziare, avrai bisogno di:
- Visual Studio Code installato
- Un account Helvira (registrati qui)
- Una chiave API Helvira (inizia con
sk-...)
Guida all'installazione
Passo 1: Installare l'estensione Cline
- Apri Visual Studio Code
- Clicca sull'icona Estensioni (o premi
Ctrl+Shift+X/Cmd+Shift+X) - Cerca "Cline"
- Clicca su Installa sull'estensione Cline ufficiale
- Attendi il completamento dell'installazione
Passo 2: Ottenere la chiave API Helvira
- Accedi al tuo account Helvira
- Naviga su Impostazioni → Account → Chiavi API → Mostra
- Copia la tua chiave API (inizia con
sk-...)
Passo 3: Configurare Cline per Helvira
- Clicca sull'icona Cline (robot) nella barra delle attività di VSCode
- Clicca sull'icona ingranaggio/impostazioni ⚙️ nell'angolo in alto a destra del pannello Cline
- Configura le seguenti impostazioni:
Dettagli configurazione
Provider API
- Seleziona:
OpenAI Compatible
URL Base
- Inserisci:
https://chat.helvira.ai/api/v1
Chiave API compatibile OpenAI
- Incolla la tua chiave API Helvira (inizia con
sk-...)
ID Modello
- Inserisci l'ID del modello in base al tuo piano Helvira (vedi tabella sotto)
- Clicca su Fatto o chiudi il pannello delle impostazioni
Modelli Helvira disponibili
Scegli il tuo ID modello in base all'abbonamento e alle tue esigenze:
| Nome Modello | ID Modello | Ideale per |
|---|---|---|
| Gemmini Light (Gemma3) Gratuito | helvira-gemmini-light-gemma3-free | Test, modifiche semplici |
| Gemmini Light (Gemma3) Standard | helvira-gemmini-light-gemma3-free-unlimited | Attività veloci, uso illimitato |
| Gemmini (Gemma3) Premium | helvira-gemmini-gemma3-premium | Sviluppo complesso |
| OSS (gpt-oss) Premium | helvira-oss-gpt-oss-premium | Attività di coding avanzate |
Esempio di configurazione
Per un utente del piano Standard con accesso illimitato:
Provider API: OpenAI Compatible
URL Base: https://chat.helvira.ai/api/v1
Chiave API: sk-abc123xyz789...
ID Modello: helvira-gemmini-light-gemma3-free-unlimited
Usare Cline con Helvira
Uso base
- Apri il tuo progetto in VSCode
- Clicca sull'icona Cline per aprire l'interfaccia chat
- Inizia a programmare con prompt in linguaggio naturale
Esempi di prompt
Crea un controller Laravel per l'autenticazione utente
Aggiungi validazione al modello User
Refactorizza questa funzione per migliorare le prestazioni
Correggi la vulnerabilità SQL injection in questa query
Genera documentazione API per questo endpoint
Aggiungi test unitari per la classe UserService
Flusso di approvazione
Cline ti mostra ogni azione prima dell'esecuzione:
- Revisione del piano: Vedi cosa Cline intende fare
- Anteprima codice: Rivedi le modifiche al codice
- Approva/Rifiuta: Tu decidi cosa viene eseguito
- Iterazione sicura: Mantieni il controllo totale
Suggerimenti di configurazione
Abilitare la modalità lettura automatica
Velocizza il tuo workflow:
- Apri le impostazioni Cline (icona ingranaggio)
- Scorri fino a Permessi
- Abilita "Approva sempre le operazioni di sola lettura"
- Cline ora può leggere i file senza chiedere
Cambiare modello
Se hai accesso a più modelli:
- Apri le impostazioni Cline
- Modifica il campo ID Modello
- Salva e continua a chattare
Best practice
1. Sii specifico
❌ "Correggi questo codice"
✅ "Correggi il middleware di autenticazione per gestire correttamente la scadenza del token JWT"
2. Fornisci contesto
"Nel file UserController.php, aggiungi validazione dell'input per il
campo email usando le regole di validazione Laravel"
3. Suddividi le attività
Invece di:
"Costruisci un sistema di autenticazione completo"
Prova:
1. "Crea un modello User con le relazioni appropriate"
2. "Aggiungi un controller di registrazione con validazione"
3. "Implementa la generazione di token JWT"
4. "Aggiungi middleware per le route protette"
4. Fai riferimento ai file
"Aggiungi gestione degli errori alla classe PaymentService in app/Services/PaymentService.php"
5. Verifica sempre
- Leggi attentamente il codice generato
- Testa prima di fare commit
- Verifica le implicazioni di sicurezza
- Controlla i requisiti di conformità svizzera
Funzionalità avanzate
Comandi da terminale
Cline può eseguire comandi:
composer install
php artisan migrate
npm run dev
git commit -m "feat: add user service"
Operazioni sui file
- Creare nuovi file e directory
- Modificare più file simultaneamente
- Cercare e sostituire nei progetti
- Rinominare e organizzare file
Analisi del codice
- Identificare vulnerabilità di sicurezza
- Suggerire miglioramenti delle prestazioni
- Rilevare code smell
- Consigliare best practice
Privacy e sicurezza dei dati
Il tuo codice resta in Svizzera
- Tutte le richieste API vanno a server svizzeri
- I frammenti di codice vengono elaborati in Svizzera
- Nessun dato memorizzato fuori dai confini svizzeri
- Piena conformità GDPR & nLPD
Best practice
- Mai fare commit di chiavi API nei repository
- Usare variabili d'ambiente per dati sensibili
- Controllare il codice per segreti prima di condividere
- Abilitare la lettura automatica solo per progetti fidati
Risoluzione problemi
Errore "Chiave API non valida"
Soluzioni:
- Verifica che la tua chiave API inizi con
sk- - Controlla che il tuo abbonamento Helvira sia attivo
- Assicurati di aver copiato la chiave completa
- Rigenera una nuova chiave nella dashboard Helvira
Errore "Modello non trovato"
Soluzioni:
- Verifica che l'ortografia dell'ID modello corrisponda esattamente alla tabella sopra
- Verifica l'accesso al modello nel tuo piano Helvira
- Copia-incolla l'ID modello per evitare errori di battitura
- Contatta il supporto Helvira se il problema persiste
Errore "Connessione rifiutata"
Soluzioni:
- Verifica che l'URL Base sia:
https://chat.helvira.ai/api/v1 - Controlla che non ci siano spazi extra nell'URL
- Assicurati che il Provider API sia "OpenAI Compatible"
- Testa la tua connessione internet
Risposte lente
Soluzioni:
- Passa a un modello più veloce se disponibile
- Controlla la tua connessione internet
- Verifica lo stato del servizio Helvira su [status.helvira.ai]
- Prova durante le ore non di punta
Cline non si connette
Soluzioni:
- Ricontrolla tutte le impostazioni:
- Provider API:
OpenAI Compatible - URL Base:
https://chat.helvira.ai/api/v1 - Chiave API: inizia con
sk- - ID Modello: corrispondenza esatta dalla tabella
- Provider API:
- Riavvia completamente VSCode
- Reinstalla l'estensione Cline
- Verifica lo stato dell'account Helvira
Prezzi e utilizzo
Costi trasparenti
- Cline mostra l'utilizzo dei token in tempo reale
- Traccia i costi per richiesta
- Monitora le spese mensili nella dashboard Helvira
Confronto modelli
| Modello | Velocità | Qualità | Miglior caso d'uso |
|---|---|---|---|
| Gemmini Light Gratuito | ⚡⚡⚡⚡ | ⭐⭐ | Sviluppo quotidiano - Limitato |
| Gemmini Light Standard | ⚡⚡⚡⚡ | ⭐⭐ | Sviluppo quotidiano - Illimitato |
| Gemmini Premium | ⚡⚡⚡ | ⭐⭐⭐ | Codice di produzione |
| OSS Premium | ⚡⚡ | ⭐⭐⭐⭐⭐ | Logica complessa |
Ottimizzare i costi
- Usa modelli appropriati per ogni attività
- Abilita l'approvazione automatica per le letture (meno chiamate API)
- Sii specifico nei prompt (riduci le iterazioni)
- Imposta avvisi di utilizzo nel tuo account Helvira
Supporto
Hai bisogno di aiuto? Siamo qui per te:
- Supporto Helvira: support@helvira.ai
- Docs Cline: docs.cline.bot
Riepilogo
Helvira + Cline ti offre:
✅ Assistente di coding IA ospitato in Svizzera
✅ Conforme GDPR & nLPD
✅ Accesso a più modelli in base al piano
✅ Controllo totale sulle modifiche al codice
✅ I dati non lasciano mai la Svizzera
✅ Prezzi trasparenti
Inizia a programmare con la privacy dell'IA svizzera oggi!
Pronto per iniziare? Installa Cline e connetti il tuo account Helvira in pochi minuti.
Checklist avvio rapido
- Installare l'estensione Cline in VSCode
- Ottenere la chiave API Helvira (inizia con
sk-) - Aprire le impostazioni Cline (icona ingranaggio)
- Impostare Provider API su "OpenAI Compatible"
- Inserire URL Base:
https://chat.helvira.ai/api/v1 - Incollare la chiave API
- Inserire l'ID modello dalla tabella sopra
- Salvare le impostazioni
- Iniziare a programmare con Helvira!