Come usare Claude Code — da dove finiscono le guide introduttive

Esistono molti articoli su come usare Claude Code, ma la maggior parte si ferma a «installarlo e ricevere la prima risposta». Il vero blocco arriva dopo — dover ripetere le stesse spiegazioni ogni volta, ricevere troppe finestre di conferma e vedere chiudersi la finestra di utilizzo di 5 ore nel bel mezzo del lavoro. Questo articolo inizia esattamente dove finiscono le guide introduttive e affronta i tre problemi in sequenza.

Allineiamo una premessa. Claude Code non è uno strumento in cui incollare codice in una chat, ma un agente che opera stabilmente nel repository tramite il terminale. Legge e modifica file, esegue test e arriva fino al commit. Per questo la prima cosa da fare non è memorizzare come usarlo, ma trasmettere le regole del progetto.

I primi tre passaggi — esecuzione, /init, richiesta specifica

Subito dopo l’installazione, vale la pena fare solo queste tre cose. In particolare, se salti il secondo /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 crea CLAUDE.md. Il contenuto generato è una bozza, quindi non lasciarlo così com’è: sistemalo sempre manualmente. La sezione successiva riguarda proprio quel contenuto.

CLAUDE.md — scrivere una volta ciò che spiegavi ogni volta

CLAUDE.md è un file Markdown da collocare nella radice del progetto e viene letto automaticamente in ogni sessione. Qui devi inserire solo «ciò che non si può sapere leggendo il codice».

# CLAUDE.md — 프로젝트 루트에 두고 git에 커밋합니다

## 명령어
- 테스트: npm test (파일 하나만: npm test -- path/to/file)
- 타입 검사: npx tsc --noEmit
- 린트: npm run lint

## 규칙
- 날짜는 date-fns만 사용. moment 금지.
- API 핸들러는 app/api/**/route.ts에만 둔다.
- 커밋 메시지는 한국어, prefix는 feat / fix / docs.

## 건드리면 안 되는 곳
- db/migrations/ — 생성물. 직접 수정 금지.

È altrettanto chiaro cosa non scrivere. La struttura delle directory e le descrizioni delle funzioni emergono dal codice e sono quindi superflue. CLAUDE.md viene incluso in ogni richiesta, quindi più è lungo, più token consuma — breve, solo regole. Eseguendo il commit su git, le stesse regole vengono applicate a tutto il team.

Autorizzazioni — ridurre le finestre di conferma senza disattivarle tutte

Ogni volta che modifichi un file o esegui un comando compare una finestra di conferma. È una misura di sicurezza, quindi invece di disattivarla completamente, nella pratica conviene consentire solo le operazioni di lettura e verifica. Se durante la sessione scegli «Consenti sempre», la scelta viene memorizzata; scrivendola in .claude/settings.json, viene fissata a livello di progetto.

Esiste anche un flag che salta tutte le conferme, ma rende non confermati persino le eliminazioni e i push remoti. Usalo solo in un container sacrificabile o in un worktree temporaneo che puoi buttare via. I criteri sono raccolti in quando usare --dangerously-skip-permissions.

Comandi personalizzati — non digitare ogni volta la stessa richiesta

Le attività da richiedere quasi sempre nello stesso modo, come revisioni, controlli prima del rilascio o sistemazione dei messaggi di commit, possono essere trasformate in comandi. È sufficiente inserire un file Markdown in .claude/commands/.

# .claude/commands/review.md — 파일만 두면 /review로 쓸 수 있습니다
지정된 파일을 리뷰하고 다음 세 가지만 지적하세요.

1. 실제로 실패하는 조건이 있는 버그 (재현 방법 포함)
2. 기존 유틸리티로 대체 가능한 중복
3. 테스트가 없는 분기

스타일 취향은 지적하지 마세요.

In questo modo, con /review src/api/user.ts, viene eseguita una revisione secondo la stessa prospettiva. Se esegui il commit su git, il comando viene condiviso dal team e gli stessi criteri di revisione possono risiedere nel repository. Le forme dei comandi usati nella pratica sono descritte più dettagliatamente in inglese in Claude Code workflows.

Come continuare quando si chiude la finestra di utilizzo

L’utilizzo dell’abbonamento è gestito con una finestra mobile di 5 ore e si chiude proprio nel pomeriggio, quando il lavoro entra nel vivo. Anche passando a un piano superiore, la finestra non si riapre immediatamente. Le opzioni concrete sono tre.

La terza opzione funziona senza annullare l’abbonamento. La fatturazione a consumo si applica solo mentre le due righe qui sotto sono configurate; rimuovendo le variabili, torni all’abbonamento. Se non hai una chiave, inizia con la richiesta di una chiave API Claude.

# 사용량 창이 닫혀도 작업을 이어가는 두 줄.
# 이 변수가 설정된 동안에만 종량제로 청구되고, 지우면 구독으로 돌아갑니다.
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...

# 클로드 코드의 기본 모델과 opus 별칭은 최신 Opus를, sonnet 별칭은 Sonnet 5.5를
# 가리킵니다. Kunavo가 제공하지 않는 모델(Sonnet 5.5, 아직 들어오지 않은 새 Opus)을
# 요청해 404가 나지 않도록 모델을 고정합니다. sonnet을 고정하지 않으면 /model sonnet,
# opusplan의 실행 단계, model: 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

# 보조 작업을 가장 싼 모델로 넘기는 한 줄 (매 세션 효과가 있습니다)
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Le tariffe vengono lette 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 lavori non ci sono addebiti. Il calcolo del punto di pareggio per capire se convenga l’abbonamento o il consumo è disponibile in prezzi di Claude Code; la soluzione ai problemi di pagamento con carte coreane è descritta in prezzi e pagamenti dell’API Claude, mentre la struttura stessa della finestra di utilizzo è spiegata in limiti di Claude Pro.

Richieste che migliorano i risultati e richieste che li peggiorano

Infine, è qui che la differenza nel modo di usare lo strumento emerge maggiormente. Inserire il percorso del file riduce i token usati per l’esplorazione, rendendo il risultato più rapido e preciso — «correggi la logica di validazione» invece di «sostituisci con zod la logica di validazione di src/api/user.ts».

Inoltre, non affidare un’attività grande in una sola volta. Separando modifica → test → modifica successiva, in caso di errore il punto a cui tornare è chiaro. Per capire come distinguere i diversi tipi di errore quando se ne verifica uno, consulta Riepilogo degli errori di Claude Code.

Se vuoi usare l’agente di coding di OpenAI nello stesso modo, come usare Codex spiega come eseguire Codex CLI con una chiave API, senza un piano ChatGPT.

Domande frequenti