Vai al contenuto principale

Coderen met API-sleutels

Con una chiave API Coderen puoi utilizzare strumenti di programmazione che lavorano con un'API compatibile OpenAI. Lo strumento invia richieste a AI-School. AI-School controlla la chiave, il budget, la validità e i modelli consentiti.

Successivamente AI-School elabora la richiesta tramite l'integrazione tecnica dell'ambiente.

Di cosa hai bisogno?​

Hai bisogno di tre dati:

DatoDove trovarlo
API-sleutelLo ottieni da un amministratore o da un docente
Endpointhttps://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1
ModelnaamAd esempio gpt-5.6-luna, gpt-5.6-terra o gpt-5.6-sol

La chiave API inizia con ais.. Trattala come una password.

Quale modello scegliere?​

Per la maggior parte degli studenti, GPT-5.6 Luna è un buon punto di partenza. Questo modello veloce è adatto per l’assistenza di programmazione durante la lezione e per domande di codice comuni.

Per docenti o studenti avanzati, GPT-5.6 Terra è adatto a progetti più grandi e codice più complesso. Scegli GPT-5.6 Sol per i compiti più esigenti con molta analisi, pianificazione o ragionamento.

Quale strumento scegliere?​

AI-School consiglia due strumenti:

StrumentoAdatto perPerché
AiderStudenti e coding in aulaFunziona in modo esplicito, chiaro e meno agentico
OpenCodeDocenti e utenti avanzatiStrumento CLI agentico con anche un'app desktop

Aider per studenti​

Aider funziona come uno strumento di pair-programming nel terminale. L'utente chiede aiuto, vede le modifiche e resta relativamente vicino al codice. Si adatta bene all'apprendimento della programmazione: lo studente ottiene supporto ma resta coinvolto in ciò che accade.

Vedi anche la documentazione ufficiale di Aider.

OpenCode per uso avanzato​

OpenCode è più agentico. Lo strumento può eseguire passi in autonomia, modificare file e sviluppare ulteriormente i compiti. È potente, ma richiede anche una maggiore comprensione del codice, git e degli ambienti di sviluppo locali.

Vedi anche la documentazione ufficiale di OpenCode.

Sicurezza delle chiavi​

Non condividere la tua API-sleutel pubblicamente e non inserirla nel codice che condividi.

Preferisci utilizzare:

  • variabili d'ambiente
  • un .env locale che non venga inviato a Git
  • la configurazione integrata dello strumento

Per OpenCode puoi, ad esempio, usare un .env nella cartella del progetto:

AI_SCHOOL_CODEREN_API_KEY=ais.tua-chiave-api

Assicurati che lo strumento carichi effettivamente questa .env. In PowerShell puoi anche impostare temporaneamente la variabile per l'attuale terminale:

$env:AI_SCHOOL_CODEREN_API_KEY="ais.tua-chiave-api"
Attenzione

Non posizionare mai le chiavi API in un repository pubblico, in un Teams-chat, in un documento condiviso o in uno screenshot.

Se la chiave non funziona​

Controlla então:

  • se Coderen è attivato per l'ambiente
  • se la tua chiave è ancora attiva
  • se il budget non è esaurito
  • se la chiave è entro la validità impostata
  • se stai usando un modello consentito
  • se l'endpoint è impostato correttamente
  • se lo strumento invia la chiave API come Authorization: Bearer ...
  • se lo strumento non invia parametri specifici del provider che AI-School Coderen non supporta

In caso di dubbi chiedi a un amministratore o docente di controllare la chiave.

WhatsApp