Coderen met API-sleutels

Con una chiave API Coderen, puoi utilizzare strumenti di programmazione che operano 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:

Dato	Dove trovarlo
API-sleutel	Lo ottieni da un amministratore o docente
Endpoint	https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1
Nome del modello	Ad esempio gpt-5.4-mini, gpt-5.4 o gpt-5.5

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

Quale modello scegliere?

Per la maggior parte degli studenti, GPT-5.4 mini è la migliore partenza. Questo modello è meno costoso e adatto per l'assistenza alla programmazione durante la lezione.

Per docenti o studenti più avanzati, GPT-5.4 o GPT-5.5 potrebbero essere più indicati, ad esempio per progetti più grandi o codice più complesso.

Quale strumento scegliere?

AI-School consiglia due strumenti:

Strumento	Raccomandato per	Perché
Aider	Studenti e programmazione in classe	Funziona in modo esplicito, chiaro e meno agentico
OpenCode	Docenti e utenti avanzati	Strumento 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 rimane relativamente vicino al codice. Si adatta bene all'apprendimento della programmazione: lo studente riceve supporto, ma rimane coinvolto in ciò che accade.

Vedi anche la documentazione ufficiale di Aider.

OpenCode per uso avanzato

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

Vedi anche la documentazione ufficiale di OpenCode.

Gestione sicura delle chiavi

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

Preferisci utilizzare:

• variabili d'ambiente
• un file .env locale che non viene inviato a git
• la configurazione integrata dello strumento

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

AI_SCHOOL_CODEREN_API_KEY=ais.tua-chiave-api

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

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

Attenzione

Non posizionare chiavi API in repository pubblici, chat di Teams, documenti condivisi o screenshot.

Se la chiave non funziona

Verifica quindi:

• se Coderen è attivato per l'ambiente
• se la tua chiave è ancora attiva
• se il budget non è esaurito
• se la chiave rientra nel periodo di validità impostato
• 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 verificare la chiave.