CLACOROO
EN IT
Scarica

Chiave API

Se preferisci pagare a consumo sull’API Anthropic invece di abbonarti a claude.ai, CLACOROO può configurare Claude Code per autenticarsi con una chiave API. La chiave è salvata nello storage sicuro del tuo sistema (Keychain su macOS, DPAPI su Windows, un file cifrato su Linux quando disponibile) e non lascia mai la tua macchina in chiaro.

Questo è indipendente dal login claude.ai — puoi avere entrambi configurati e scegliere quale usa Claude Code.

Attenzione: la chiave API entra in gioco subito. Dal momento in cui salvi una chiave, Claude Code passa alla fatturazione API su tutte le sessioni aperte, inclusa CLACOROO stessa. L’abbonamento Max non viene più usato finché non rimuovi la chiave. Se esaurisci i crediti API, tutte le sessioni Claude Code smettono di funzionare. Per tornare all’abbonamento, rimuovi la chiave da questo pannello.

Panoramica

Il pannello Chiave API Anthropic vive in Impostazioni, subito sotto il pannello Account Claude. Mostra lo stato corrente e offre azioni:

  • Non configurata — quando nessuna chiave è impostata
  • Configurata · sk-ant-…XXXX — quando una chiave è impostata, mascherata tranne gli ultimi 4 caratteri
  • Test connessione — verifica la chiave contro l’API Anthropic
  • Salva chiave / Sostituisci chiave / Rimuovi chiave — a seconda dello stato
  • Anthropic Console — link diretto alla console Anthropic per creare o gestire chiavi

Cosa mostra

Badge di stato

  • Non configurata — nessuna chiave API salvata
  • Configurata — una chiave è salvata e pronta per essere usata da Claude Code
  • Storage non cifrato — (solo Linux) il file della chiave è chmod 600 ma non cifrato, perché nessun keyring di sistema era disponibile

Backend di storage

Una riga sotto lo stato indica quale backend di storage è in uso:

  • macOS — il Keychain di sistema
  • Windows — DPAPI (Data Protection API)
  • Linux — Secret Service (GNOME Keyring, KWallet) quando disponibile; altrimenti un file chmod 600 in chiaro in ~/.config/clacoroo/

Path dell’helper

CLACOROO punta Claude Code a un piccolo script helper (meccanismo apiKeyHelper di Anthropic) che legge la chiave dal tuo keyring su richiesta. Il path di quell’helper è mostrato per riferimento — vive nella cartella dati di CLACOROO.

Operazioni comuni

Come aggiungere una chiave API

  1. Apri Impostazioni → Chiave API Anthropic
  2. Incolla la chiave nel campo di input — le chiavi iniziano con sk-ant-
  3. (Opzionale) Clicca Mostra per verificare cosa hai incollato
  4. Clicca Test connessione — CLACOROO chiama l’API Anthropic una volta per confermare la validità
  5. Se il test passa, clicca Salva chiave
  6. CLACOROO salva la chiave nel tuo keyring e registra l’apiKeyHelper con Claude Code

Se non hai ancora una chiave, clicca Anthropic Console per aprire il dashboard dove puoi crearne una.

Come testare una chiave esistente

  1. Nel pannello, clicca Test connessione
  2. CLACOROO fa una piccola chiamata API (nessun payload, solo un check di auth)
  3. Un toast verde conferma il successo; un toast rosso mostra il messaggio d’errore dall’API Anthropic

Come sostituire la chiave

  1. Clicca Sostituisci chiave
  2. Incolla la nuova chiave
  3. Test connessione poi Salva
  4. La vecchia chiave viene rimossa dal keyring e la nuova prende il suo posto

Come rimuovere la chiave

  1. Clicca Rimuovi chiave
  2. Conferma nel dialog
  3. CLACOROO cancella la chiave dal keyring e deregistra l’helper

Rimuovere la chiave non tocca la tua sessione claude.ai (se c’è) — quella è gestita separatamente nel pannello Account Claude.

Suggerimenti e scorciatoie

  • Il campo di input valida strettamente la forma della chiave (sk-ant- più caratteri) — questo intercetta copia-incolla parziali prima che arrivino al keyring
  • Testa prima di salvare: CLACOROO non ti impedisce di salvare una chiave non testata, ma testare prima evita di salvare un valore sbagliato
  • Il display mascherato (sk-ant-…XXXX) è mostrato ovunque CLACOROO referenzi la chiave, incluso il pannello Account Claude
  • L’apiKeyHelper di Claude Code è un meccanismo standard — se mai ispezioni claude config get apiKeyHelper, vedrai il path che CLACOROO ha registrato

Casi limite ed errori

  • Test connessione fallisce con “401 Unauthorized”. La chiave è revocata o copiata male. Crea una nuova chiave su console.anthropic.com, incollala, testa di nuovo.
  • Warning “Storage non cifrato” su Linux. Nessun Secret Service (Keyring/KWallet) è disponibile sul tuo sistema. Installa gnome-keyring o libsecret per cifrare correttamente; intanto il file della chiave è almeno chmod 600 così solo il tuo utente lo legge.
  • Claude Code non recepisce la chiave. Assicurati che apiKeyHelper sia quello che Claude Code si aspetta: esegui claude config get apiKeyHelper nel terminale integrato e verifica che punti all’helper CLACOROO.
  • macOS chiede l’accesso al Keychain ogni volta. Apri Accesso Portachiavi, trova la voce CLACOROO, e seleziona “Consenti sempre l’accesso” per l’helper.
  • Sia claude.ai che chiave API sono configurati. La chiave API ha priorità — Claude Code passa alla fatturazione API immediatamente su tutte le sessioni. Rimuovi la chiave per tornare all’abbonamento claude.ai.

Correlati

  • Account Claude — il login con abbonamento, alternativa alla chiave API
  • Notifiche quota — notifiche quando l’utilizzo supera 80% / 95% / 100% (funziona con entrambe le auth)
  • Terminale integrato — utile per lanciare claude config get apiKeyHelper per verificare il setup