Vai al contenuto principale
Italiano— Scegli una lingua
Menu

La variabile d'ambiente XAI_API_KEY

Lezione 3 di 14 Aggiornata il 30 luglio 2026 Sviluppatore
In questa pagina
  1. Archivia la tua chiave in sicurezza
  2. Imposta XAI_API_KEY
  3. Verifica la configurazione
  4. Ambienti di produzione
  5. Errori comuni
  6. Punti chiave

Archivia la tua chiave in sicurezza

Una chiave API non deve mai apparire in chiaro nel tuo codice sorgente. L’approccio standard consiste nell’archiviarla in una variabile d’ambiente che la tua applicazione legge all’avvio. Questo separa la configurazione dal codice e protegge i tuoi segreti.

Imposta XAI_API_KEY

La convenzione utilizzata da xAI e da tutti gli SDK ufficiali è la variabile XAI_API_KEY. Ecco come impostarla sul tuo sistema.

Linux e macOS

Nel tuo terminale, aggiungi la variabile al profilo della shell:

echo 'export XAI_API_KEY="xai-your-key-here"' >> ~/.bashrc
source ~/.bashrc

Per Zsh (il predefinito su macOS), sostituisci .bashrc con .zshrc.

Windows (PowerShell)

$env:XAI_API_KEY = "xai-your-key-here"

Per renderla permanente, utilizza le variabili d’ambiente di sistema tramite le impostazioni avanzate, oppure esegui:

[System.Environment]::SetEnvironmentVariable("XAI_API_KEY", "xai-your-key-here", "User")

File .env (progetti locali)

Per i progetti che utilizzano un framework (Node.js, Django, Flask), crea un file .env nella root:

XAI_API_KEY=xai-your-key-here

Devi aggiungere .env al tuo file .gitignore per evitare di inviare i tuoi segreti a un repository Git:

# .gitignore
.env
.env.local
.env.*.local

Verifica la configurazione

Testa che la variabile sia disponibile:

echo $XAI_API_KEY

Dovresti vedere la tua chiave. Se il comando restituisce una riga vuota, ricarica il profilo della shell o riavvia il terminale.

In Python, puoi verificarla così:

import os
key = os.getenv("XAI_API_KEY")
print("Key configured" if key else "Variable missing")

Ambienti di produzione

In produzione, non usare un file .env. Utilizza invece i meccanismi integrati della tua piattaforma:

  • Docker: docker run -e XAI_API_KEY=xai-xxx my-image
  • Kubernetes: un Secret montato come variabile d’ambiente
  • Vercel / Netlify / Railway: variabili nella dashboard del progetto
  • GitHub Actions: segreti del repository (${{ secrets.XAI_API_KEY }})

Questi sistemi cifrano i segreti a riposo e li iniettano solo al momento dell’esecuzione.

Errori comuni

  • Virgolette extra nella chiave: se la tua variabile contiene virgolette letterali, le richieste falliranno con un errore di autenticazione
  • Variabile impostata in un’altra shell: le variabili da un terminale non sono disponibili in un altro a meno che non siano esportate nel tuo profilo
  • Spazi attorno al segno =: in un file .env, la sintassi XAI_API_KEY = value con spazi potrebbe fallire a seconda della libreria che utilizzi

Punti chiave

  • Usa la variabile XAI_API_KEY, riconosciuta da ogni SDK xAI
  • Non inserire mai la chiave direttamente nel tuo codice sorgente
  • Aggiungi .env al .gitignore di tutti i tuoi progetti
  • In produzione, usa i segreti integrati della tua piattaforma di hosting