Come usare Claude Code — 4 cose da fare dopo la guida introduttiva

Esistono molti articoli che spiegano come usare Claude Code, ma quasi tutti si fermano a «installalo e avvia la prima sessione». I problemi reali iniziano dopo: scrivere ogni volta le stesse istruzioni, troppi dialoghi di conferma e il raggiungimento del limite di utilizzo di 5 ore nel bel mezzo del lavoro. Questa pagina parte da dove finiscono le guide introduttive e risolve questi tre problemi in ordine.

Partiamo da un presupposto: Claude Code non è uno «strumento in cui incollare codice in una chat», ma un agente che vive nel repository tramite il terminale. Legge e modifica file, esegue test e arriva fino al commit. Perciò la prima cosa da fare non è imparare a usarlo, ma trasmettergli le regole del progetto.

I primi 3 passaggi — avvio, /init, richiesta concreta

Subito dopo l'installazione vale la pena fare solo queste 3 cose. In particolare, se salti il secondo passaggio, /init, dovrai ripetere le stesse spiegazioni in tutte le sessioni successive.

# 1. プロジェクトのディレクトリで起動する（ここが全ての前提）
cd ~/work/my-app
claude

# 2. 最初の一手は /init — リポジトリを読んで CLAUDE.md を書き出す
> /init

# 3. 以降は普通の日本語で頼む。ファイル名を添えるほど精度が上がる
> src/api/user.ts のバリデーションを zod に置き換えて、テストも直して

/init legge il repository e genera CLAUDE.md. Il contenuto generato è una bozza: non lasciarlo così com'è, ma correggilo sempre manualmente. La sezione successiva ne esamina il contenuto.

CLAUDE.md — scrivi una sola volta ciò che spieghi ogni volta

CLAUDE.md è un file Markdown da collocare nella radice del progetto e viene caricato automaticamente a ogni sessione. Qui dovresti scrivere solo «ciò che non si può capire leggendo il codice».

# CLAUDE.md — プロジェクトのルート、git にコミットする

## コマンド
- テスト: npm test（1 ファイルだけなら npm test -- path/to/file）
- 型チェック: npx tsc --noEmit
- Lint: npm run lint

## 決めごと
- 日付は必ず date-fns。moment は使わない。
- API ハンドラは app/api/**/route.ts のみ。lib に書かない。
- コミットメッセージは日本語、prefix は feat / fix / docs。

## 触ってはいけない場所
- db/migrations/ — 生成物。手で編集しない。

È altrettanto chiaro cosa sia meglio non scrivere. La struttura delle directory e la descrizione delle funzioni si capiscono leggendo il codice, quindi non servono. CLAUDE.md viene incluso in ogni richiesta: se è lungo, consumerà sicuramente token — tienilo breve e limita il contenuto alle regole. Se lo committi in git, le stesse regole varranno per tutto il team.

Permessi — ridurre le conferme, senza saltarle eccessivamente

Viene richiesta una conferma a ogni modifica di file o esecuzione di comando. È un dispositivo di sicurezza, quindi una soluzione pratica è «consentire solo le operazioni di lettura e verifica», invece di disattivare tutto. Se durante la sessione scegli «consenti sempre», la scelta viene memorizzata; se la scrivi in .claude/settings.json, puoi fissarla a livello di progetto.

Esiste anche un flag che salta tutte le conferme, ma in questo modo anche eliminazioni e push verso repository remoti avvengono senza conferma. Va usato solo all'interno di container o alberi di lavoro usa e getta che si possano eliminare in caso di danni. I criteri di valutazione e l'uso sicuro sono raccolti in Quando usare --dangerously-skip-permissions.

Comandi personalizzati — non scrivere ogni volta la stessa richiesta

Le attività per cui formuli quasi sempre la stessa richiesta, come revisioni, controlli pre-rilascio e formattazione dei messaggi di commit, possono essere trasformate in comandi. Basta inserire Markdown in .claude/commands/.

# .claude/commands/review.md — 置くだけで /review として使える
指定されたファイルをレビューして、次の 3 点だけ指摘してください。

1. 実際に落ちる条件があるバグ（再現手順を添える）
2. 既存のユーティリティで置き換えられる重複
3. テストが無い分岐

スタイルの好みは指摘しないでください。

In questo modo, digitando /review src/api/user.ts, riceverai una revisione basata sugli stessi criteri. Committendo in git puoi condividerla con il team e conservare nel repository gli stessi criteri di revisione. I modelli di comando più utili nella pratica sono descritti in inglese in Claude Code workflows.

Come continuare quando si chiude la finestra di 5 ore

Il limite di utilizzo dell'abbonamento è gestito come una finestra mobile di 5 ore e può chiudersi nel pomeriggio, proprio quando il lavoro entra nel vivo. Passare a un piano superiore non la riapre immediatamente. In pratica, le opzioni sono 3.

La terza opzione è possibile senza annullare l'abbonamento. Solo mentre sono impostate le due righe seguenti si applica la fatturazione a consumo; eliminando le variabili si torna all'abbonamento originale.

# 5 時間ウィンドウが閉じても作業を続けるための 2 行。
# この変数が設定されている間だけ従量課金になり、消せば元のサブスクに戻る。
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...

# Claude Code の既定モデルと opus エイリアスは最新の Opus を、sonnet エイリアスは
# Kunavo が提供していない Sonnet 5.5 を指す。/model sonnet や opusplan の実行
# フェーズ、sonnet 指定のサブエージェントが 404 にならないようモデルを固定する。
# opus は Opus 5.5 に固定（Claude Code v2.1.280 以降が必要。古ければ claude update）。
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5

# 補助的な処理を一番安いモデルに逃がす 1 行（毎セッション効く）
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Le tariffe vengono caricate direttamente dal catalogo: Claude Sonnet 5 costa $1,40 / $7,00 per 1M di token, mentre Claude Haiku 4.5 costa $0,70 / $3,50. L'importo viene detratto dal saldo prepagato, quindi nei mesi in cui non usi il servizio la fattura è pari a 0. In Prezzi di Claude Code calcoliamo quale opzione sia più economica tra abbonamento e consumo, il costo effettivo per passaggio e il punto di pareggio. Il funzionamento della finestra è descritto in Limiti di Claude Pro; per sapere quale modello impostare come predefinito, consulta Differenze tra Opus e Sonnet.

Come formulare richieste che aumentano o riducono la precisione

Infine, è qui che si vede maggiormente la qualità dell'utilizzo. Specificare nomi di file e percorsi riduce i token usati per l'esplorazione e rende il risultato più rapido e preciso: «correggi la convalida» è meno utile di «sostituisci con zod la convalida di src/api/user.ts».

Inoltre, non inviare una richiesta complessa in un'unica volta. Suddividendola in modifica → test → modifica successiva, anche in caso di errore sarà chiaro a quale punto tornare. La diagnosi degli errori è raccolta in pagine specifiche come Errore 401 di Claude Code.

Se vuoi provare lo stesso approccio con l'agente di OpenAI, in Come usare Codex trovi le istruzioni per eseguirlo con una chiave API senza un piano ChatGPT.

Domande frequenti