Guida a Claude Code — uso quotidiano con una chiave a consumo: cambiare modello, calcolare i costi e gestire il contesto

L'uso di Claude Code si può riassumere in quattro passaggi: esegui claude nella cartella del progetto, esegui una volta /init per generare CLAUDE.md, descrivi l'attività in cinese indicando il percorso dei file e rivedi le modifiche proposte prima di decidere se accettarle. È un assistente di programmazione che vive nel terminale: legge e modifica i file ed esegue i test, chiedendo il consenso prima di agire. Puoi usarlo accedendo con un abbonamento Pro/Max oppure configurando una chiave API a consumo; con la chiave ogni step viene addebitato a token, quindi l'uso quotidiano ruota attorno a tre aspetti: cambiare modello in base all'attività, sapere quanto costa una sessione e mantenere il contesto essenziale.

Quasi tutte le guide online a Claude Code presuppongono l'accesso tramite abbonamento. Questa pagina è per chi non ha un abbonamento o non vuole essere limitato dalla finestra di utilizzo di 5 ore e preferisce una chiave a consumo. Se non l'hai ancora installato, consulta prima Guida all'installazione di Claude Code, poi torna qui dopo averlo installato e collegato.

Il primo utilizzo: quattro azioni

# 1. 一定要在專案資料夾裡啟動——它能看、能改的範圍就是這個資料夾
cd ~/work/my-app
claude

# 2. 第一個指令：讀過整個 repo，產生 CLAUDE.md
> /init

# 3. 之後直接用中文交代任務，附上檔案路徑最準
> 把 src/api/user.ts 的輸入驗證改用 zod，測試也一起修好

# 4. 牽涉很多檔案的任務，先按 Shift+Tab 切到計畫模式，確認做法再動手

Ogni volta che deve modificare un file o eseguire un comando ti chiede conferma. Se la direzione è sbagliata, premi Esc per fermarlo, poi usa /rewind per tornare al checkpoint precedente: codice e conversazione vengono ripristinati insieme. Il CLAUDE.md generato da /init è solo una bozza; più avanti trovi una sezione dedicata a come renderlo più breve.

Come viene addebitata una sessione con una chiave API

A ogni richiesta, Claude Code reinvia il prompt di sistema, CLAUDE.md, l'intera conversazione e il contenuto dei file letti, aggiungendo il nuovo contenuto alla fine. La parte invariata passa dalla cache: le letture dalla cache costano il 10% del prezzo input e le scritture nella cache 1,25 volte il prezzo input. Di conseguenza, il costo maggiore di una sessione è spesso la rilettura della conversazione precedente.

La tabella seguente usa una sessione d'esempio della documentazione ufficiale sui costi Anthropic (1.200 token di input, 5.300 di output, 940.000 letti dalla cache e 50.000 scritti nella cache) e calcola il costo alle tariffe Kunavo per ciascuno dei quattro modelli:

Su Claude Sonnet 5, circa il 85% della fattura di questa sessione riguarda letture e scritture della cache. In altre parole, il costo dipende dalla lunghezza della conversazione, non dal numero di caratteri digitati: è questo il motivo della sezione successiva sull'igiene del contesto.

Per vedere i tuoi valori, esegui /usage in Claude Code (/cost è il suo alias); verranno elencati i quattro tipi di token. L'importo accanto è però una stima locale di Claude Code basata sui prezzi Anthropic. Con Kunavo, l'addebito effettivo è quello della pagina dell'utilizzo nel pannello: mostra i token per ogni modello, comprese letture e scritture della cache, e l'importo addebitato.

Cambiare modello in base all'attività

Per prima cosa, nella sezione env di ~/.claude/settings.json, associa ogni alias al modello effettivo. Inserisci queste impostazioni in questo file, così anche l'estensione dell'editor e i processi in background potranno leggerle; non inserirle nel file .claude/settings.json del progetto che verrà incluso nei commit. Gli alias devono essere associati: il modello predefinito di Claude Code e l'alias opus puntano entrambi all'ultima versione di Opus; se Kunavo non la offre ancora, una configurazione senza associazione riceverà un errore 404 già alla prima richiesta. L'alias sonnet punta invece a Sonnet 5.5, un modello che Kunavo non offre: senza ANTHROPIC_DEFAULT_SONNET_MODEL, /model sonnet, la fase di esecuzione di opusplan e i sottoagenti configurati con model: sonnet riceveranno tutti un errore 404. La configurazione seguente associa l'alias opus a Claude Opus 5.5 (claude-opus-5-5) e richiede Claude Code v2.1.280 o una versione successiva; se la versione è precedente, esegui prima claude update.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kunavo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5"
  }
}

Dopo la configurazione, il cambio richiede una sola riga:

# 工作階段裡切換（別名會對應到上面設定的模型）
> /model haiku
> /model sonnet
> /model opus

# 也可以直接打完整名稱
> /model claude-fable-5

# 或在啟動時指定
claude --model claude-opus-5-5

/model salva la scelta come valore predefinito per le sessioni future; se vuoi cambiarla solo per questa volta, esegui /model senza argomenti e premi s nel menu. Su Kunavo ANTHROPIC_DEFAULT_HAIKU_MODEL è indispensabile: senza, l'alias haiku richiede un nome modello che Kunavo non offre (Haiku 5.5 dalla v2.1.293), quindi /model haiku e i subagenti impostati su haiku restituiscono 404. Determina anche quale modello Claude Code usa per generare autonomamente riepiloghi e titoli in background; impostarlo sul modello meno costoso consente di risparmiare ulteriormente.

Su Kunavo, Claude Opus 5.5 costa $2,80 / $14,00, mentre Claude Sonnet 5 costa $1,40 / $7,00; il prezzo unitario di Claude Haiku 4.5 è circa 1/2 di quello di Claude Sonnet 5, mentre Claude Fable 5 costa 5 volte tanto. Rispetto ai prezzi ufficiali: Claude Sonnet 5 Circa 30% in meno rispetto ad Anthropic, Claude Opus 5.5 Circa 30% in meno rispetto ad Anthropic, Claude Haiku 4.5 Circa 30% in meno rispetto ad Anthropic, Claude Fable 5 Circa 30% in meno rispetto ad Anthropic.

Cambia modello tra un'attività e l'altra, non durante l'attività.La cache di ogni modello è separata: a metà attività /model, quindi la richiesta successiva deve rileggere l'intera conversazione al prezzo non in cache (finché la cache è valida, Claude Code chiederà prima conferma). Prima /clear e poi cambia: resterà da rileggere solo la nuova conversazione, molto breve. I token di ragionamento sono fatturati alla tariffa dell'output; per le attività semplici puoi ridurre il livello di ragionamento con /effort — va impostato anch'esso all'inizio dell'attività e, per la maggior parte dei modelli, cambiare effort durante l'attività invalida la cache.

CLAUDE.md: scrivi solo ciò che dovrai ripetere spesso

# CLAUDE.md — 放在專案根目錄，commit 進 git

## 指令
- 測試：npm test（只跑一個檔：npm test -- path/to/file）
- 型別檢查：npx tsc --noEmit
- Lint：npm run lint

## 規則
- 日期一律用 date-fns，不用 moment。
- API handler 只放在 app/api/**/route.ts。
- commit 訊息用繁體中文，前綴 feat / fix / docs。

## 不要動的地方
- db/migrations/ —— 產生出來的檔案，不要手改。

CLAUDE.md viene caricato all'inizio di ogni sessione di lavoro e poi incluso in ogni richiesta (per lo più fatturata alla tariffa di lettura dalla cache). Anthropic consiglia di mantenere il file entro 200 righe: più è lungo, più consuma contesto e minore è l'aderenza. Non scrivere informazioni deducibili dal codice (struttura delle directory, descrizioni delle funzioni); le note destinate solo alle persone possono essere racchiuse in <!-- --> e verranno rimosse prima dell'invio nel contesto.

C'è anche un equivoco comune: modificare CLAUDE.md durante la sessione non ha effetto immediato; la nuova versione verrà letta solo dopo /clear, /compact o un riavvio.

Igiene del contesto: rendi economico ogni passaggio

• Tra attività non correlate usa /clear.Apre una conversazione completamente nuova, senza costi; in seguito puoi recuperare la conversazione precedente con /resume.
• Se la stessa attività diventa troppo lunga, usa /compact.Puoi indicare i punti da conservare, ad esempio /compact 保留測試輸出和改過的檔案. Invia una richiesta di riepilogo e fallo finché la cache è valida, quando è più economico; se esegui compact dopo una lunga pausa, la richiesta di riepilogo deve rileggere tutta la cronologia al prezzo non in cache.
• Se prendi una direzione sbagliata, usa /rewind.Riporta a una parte precedente già memorizzata nella cache, quindi costa meno di compact.
• In modalità con chiave, la cache dura per impostazione predefinita solo 5 minuti. Se torni dopo più di 5 minuti, il primo passaggio riscrive l'intero contesto precedente nella cache (1,25 volte la tariffa dell'input). Prima di andare a una riunione o a mangiare, usa /compact o /clear per chiudere.
• Usa /context per vedere cosa occupa il contesto.Con Kunavo questo numero è una stima locale: Kunavo al momento non offre /v1/messages/count_tokens, e la compressione automatica e la sessione stessa non ne risentono.
• Disattiva in /mcp i server MCP che non usi.La documentazione Anthropic chiarisce che, se imposti un ANTHROPIC_BASE_URL personalizzato, non c'è la ricerca degli strumenti (tool search): le definizioni degli strumenti MCP non vengono caricate in modo differito e occupano direttamente ogni richiesta.
• Quando assegni un'attività, allega i percorsi dei file.«Modifica la validazione» lo farà cercare ovunque e leggere molti file; «modifica la validazione di src/api/user.ts per usare zod» legge solo ciò che serve.

Per ridurre le domande «posso eseguire?», consenti solo i comandi di lettura e validazione; il flag che salta tutte le conferme va usato soltanto in ambienti che puoi eliminare completamente, come spiegato in --dangerously-skip-permissions (in inglese). Per la fatturazione della cache, consulta la documentazione della cache.

Limiti di spesa e pagamenti

Nella pagina di gestione delle chiavi crea una chiave dedicata a Claude Code e imposta un limite mensile: raggiunto il limite, le richieste di questa chiave restituiranno 402, senza ulteriori addebiti; anche un ciclo fuori controllo si fermerà quindi al limite. Nella stessa pagina puoi impostare una whitelist IP.

L'account è prepagato: la ricarica minima è di $10, il saldo non scade e le richieste non riuscite non vengono addebitate. A Taiwan puoi ricaricare con carte di credito internazionali (Visa, Mastercard, Amex, JCB, UnionPay), Apple Pay o Google Pay; al momento non sono disponibili metodi locali come JKOPay e LINE Pay. Per i dettagli, consulta Costi di Claude Code.

Quando conviene abbonarsi

Per chi interagisce a lungo ogni giorno e compie molti passaggi al mese, il canone fisso dell'abbonamento è di solito più economico della fatturazione a consumo. Basta una divisione: canone mensile ÷ costo per passaggio = numero di passaggi di pareggio; stimando Claude Sonnet 5 a circa $0,043 per passaggio (cache esclusa), se in un mese fai meno passaggi di questo numero conviene il consumo, e nei mesi senza attività il costo è $0. I canoni attuali e il calcolo completo dei piani sono nella pagina Costi di Claude Code; non li ripetiamo qui.

Va chiarito anche il compromesso: tramite Kunavo usi capacità condivisa, senza quota dedicata né SLA contrattuale. I team che necessitano di quota o SLA garantiti dovrebbero acquistare direttamente da Anthropic. La documentazione completa della connessione è nella documentazione d'integrazione di Claude Code (in inglese).

Domande frequenti