Come usare Cline — separare i modelli tra Plan e Act e calcolare anche il costo di un'attività

Cline è un agente di coding AI open source che funziona in editor come VS Code. L'utilizzo si articola in 3 fasi — installare l'estensione, configurare il provider API e la chiave (Cline non include modelli), quindi pianificare in modalità Plan ed eseguire in modalità Act. Il costo dipende dai modelli assegnati a Plan e Act: attiva «Use different models for Plan and Act» nelle impostazioni e assegna claude-opus-5 a Plan e claude-haiku-4-5 ad Act con la stessa chiave; un'attività di 20 passaggi scende da circa $2,17 con Opus 5 per tutto a circa $0,69 (calcolato alle tariffe Kunavo).

Molti articoli esplicativi in giapponese si fermano all'installazione e alla prima richiesta, mantenendo il modello fisso su un modello gratuito o su un unico modello a pagamento. Questa pagina va oltre — mostra come assegnare modelli diversi a Plan e Act e come calcolare il costo di un'attività — usando un'unica chiave dall'inizio alla fine.

Che cos'è Cline — le due modalità Plan e Act

Cline è un agente che legge i file, propone differenze, esegue comandi nel terminale, ne legge i risultati e poi apporta ulteriori correzioni, in un ciclo continuo. Esistono due modalità e la documentazione ufficiale di Cline le distingue così:

• Modalità Plan: legge e cerca nel codebase e discute l'approccio. Non può modificare file o eseguire comandi.
• Modalità Act: mantiene il contesto della conversazione in Plan, modifica i file ed esegue i comandi.

Questa distinzione si riflette direttamente anche sui costi. Plan richiede meno scambi e la qualità delle decisioni prese in questa fase influenza le oltre dieci fasi successive. Act richiede più scambi e reinvia ogni volta il contesto dell'attività, quindi il costo dei token si accumula. Usa un modello potente per Plan e uno economico per Act — anche la documentazione di Cline suggerisce un modello con ragionamento forte per la pianificazione e uno veloce per l'implementazione.

Installazione e prima configurazione

1. In VS Code apri la vista delle estensioni (Ctrl / Cmd + Shift + X), cerca «Cline» e installalo. È disponibile anche in Cursor, Windsurf e negli IDE JetBrains.
2. Apri Cline nella barra laterale e, nelle impostazioni (⚙︎), seleziona «OpenAI Compatible» per API Provider.
3. Inserisci Base URL, API Key e Model ID e compila i campi di Model Configuration (lunghezza del contesto, output massimo, supporto alle immagini e prezzi di input e output).

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1   # /v1 まで入れる
API Key        sk-kn-...                    # /app/keys で発行（表示は一度きり）
Model ID       claude-opus-5

Inserisci il Base URL fino a /v1. Cline aggiunge poi solo il percorso, quindi senza /v1 riceverai 404. Se ricevi 401, l'URL è corretto ma la chiave è errata. Prima di affidargli modifiche, è più sicuro verificare la connessione con una piccola richiesta come «spiega questo file». Genera la chiave in /app/keys e salvala subito, perché viene mostrata una sola volta.

In Model Configuration, Input Price / Output Price costituisce la base per il calcolo dei costi visualizzati da Cline durante l'attività. Non viene recuperato automaticamente dall'endpoint, quindi lasciare i campi vuoti o usare i valori predefiniti può rendere imprecisi i costi visualizzati. Inserisci il prezzo per 1M di token del modello utilizzato. L'elenco delle impostazioni è disponibile nella documentazione sull'integrazione di Cline.

Separare i modelli per Plan e Act

Selezionando «Use different models for Plan and Act» nelle impostazioni, puoi scegliere modelli diversi per Plan e Act. Base URL e chiave restano uguali per entrambi; devi cambiare solo Model ID e prezzi.

[✓] Use different models for Plan and Act

── Plan Mode ─────────────────────────────
API Provider       OpenAI Compatible
Base URL           https://api.kunavo.com/v1
API Key            sk-kn-...
Model ID           claude-opus-5
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on
  Input Price        3.50      # 1M トークンあたり USD
  Output Price       17.50

── Act Mode ──────────────────────────────
API Provider       OpenAI Compatible
Base URL           https://api.kunavo.com/v1
API Key            sk-kn-...            # Plan と同じキーでよい
Model ID           claude-haiku-4-5
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on
  Input Price        0.70
  Output Price       3.50

Il motivo per assegnare Opus 5 a Plan è semplice. Plan rappresenta solo una piccola parte dei token totali, ma un approccio errato in questa fase può sprecare interamente i passaggi di Act. Haiku 4.5 è adatto ad Act perché, quando il piano è concreto, il resto consiste in ripetute modifiche ed esecuzioni: è qui che il prezzo dei token incide maggiormente.

Con la modalità Plan impostata su Sonnet 5, ogni passaggio costa circa $0,0434; con Opus 5, circa $0,11.Claude Sonnet 5 costa $1,40 / $7,00 per 1M token.

Se Act si blocca, passa a Opus 5 per Act solo per quell'attività. Ripetere lo stesso errore due volte è il segnale per cambiare modello. Insistere con Haiku e far aumentare il numero di passaggi finisce per costare di più. Basta cambiare un Model ID nelle impostazioni; chiave ed endpoint restano invariati.

Calcolare il costo di un'attività

Cline reinvia a ogni passaggio il prompt di sistema, la cronologia dell'attività e i file letti, quindi il costo dipende dal numero di passaggi, non dal tempo. Come nelle altre pagine dei prezzi di questo sito, il calcolo usa 25.000 token di input / 1.200 di output per passaggio e 20 passaggi per attività (3 Plan + 17 Act).

Separare Plan e Act consente di conservare la qualità di pianificazione di Opus 5 a un costo pari a circa 32% di quello necessario per eseguire tutto con Opus 5. Usare Haiku per tutto costa ancora meno, ma considerando i rifacimenti dovuti agli errori di pianificazione, i $0,26 di differenza sono una polizza assicurativa per Plan a buon mercato. Ecco tutto il codice per la verifica.

# 1 タスクの費用を、ステップ数から出す。
# 単価は Kunavo の 1M トークンあたり USD (input, output)。
RATES = {
    "claude-opus-5":    (3.50, 17.50),
    "claude-haiku-4-5": (0.70, 3.50),
}

def step(model, inp=25_000, out=1_200):
    i, o = RATES[model]
    return inp / 1e6 * i + out / 1e6 * o

all_opus = 20 * step("claude-opus-5")
split = 3 * step("claude-opus-5") + 17 * step("claude-haiku-4-5")

print(round(all_opus, 2))   # -> 2.17  全部 Opus 5
print(round(split, 2))      # -> 0.69  Plan = Opus 5 / Act = Haiku 4.5

Come scegliere i modelli

GPT-5.6 Sol applica al costo dell'intera richiesta un moltiplicatore di 2× sull'input e di 1,5× sull'output quando il prompt supera 272K token. Se lo usi per Plan, è prudente mantenere il Context Window sotto 272K. Per saperne di più sulle differenze tra Opus e Sonnet, consulta Differenze tra Claude Opus e Sonnet; per i prezzi di tutti i modelli Claude, consulta Prezzi di Claude.

5 abitudini per contenere i costi

1. Non prolungare un'attività: dividila e iniziane una nuova. Poiché a ogni passaggio viene reinviata l'intera cronologia, più un'attività è lunga, più ogni passaggio diventa costoso. È l'abitudine più efficace.
2. Se usi la cache dei prompt, passa dal provider Anthropic. Imposta API Provider su «Anthropic», seleziona «Use custom base URL» e specifica https://api.kunavo.com (non aggiungere /v1: il client aggiungerà /v1/messages). La lettura dalla cache di Claude costa il 10% del prezzo dell'input; la scrittura costa 1,25 volte il prezzo dell'input. Il funzionamento è spiegato nella documentazione della cache. La cache dei prompt funziona anche se resti su OpenAI Compatible. Con un prompt lungo, Kunavo imposta da sé i punti di interruzione della cache sul prompt di sistema e sulle definizioni degli strumenti e, quando la conversazione contiene già un turno dell'assistente, anche sull'ultimo messaggio. In un ciclo agentico, questo vale per ogni passaggio dal secondo in poi. Anche un cache_control aggiunto da Cline resta al suo posto. Tramite il provider Anthropic, la richiesta viene inoltrata esattamente come Cline l'ha inviata e non vengono aggiunti punti di interruzione, quindi ciò che finisce nella cache dipende dai punti di interruzione impostati da Cline.
3. Scrivi le decisioni in .clinerules/. È un file Markdown nella radice del progetto e contiene istruzioni valide per tutte le conversazioni. Poiché viene incluso in ogni richiesta, mantienilo breve e limitato alle decisioni (documentazione delle regole di Cline).
4. Limita l'approvazione automatica alle operazioni di lettura. Con Auto Approve puoi autorizzare, per esempio, la lettura dei file e ridurre le richieste di conferma. La modalità YOLO, che approva tutto automaticamente, va usata solo in ambienti usa e getta, come indica esplicitamente la documentazione di Cline, che la definisce pericolosa. Puoi annullare le modifiche con Checkpoints.
5. Crea una chiave dedicata a Cline e stabilisci un limite mensile. In /app/keys puoi impostare per ogni chiave un limite mensile di utilizzo (al raggiungimento del quale restituisce 402) e un elenco di IP autorizzati. Quando vuoi fermare l'editor, ti basta disabilitare quella chiave.

Onestamente: quando convengono un abbonamento o un contratto diretto

Se hai un abbonamento Claude Pro / Max, puoi anche scegliere il provider «Claude Code» di Cline. In questo modo usi la quota dell'abbonamento, anziché pagare per token, passando attraverso il Claude Code CLI installato. Secondo la documentazione di Cline, con questo metodo il caricamento delle immagini e la cache dei prompt sono limitati e le risposte potrebbero non essere trasmesse in streaming per token. La quota è condivisa con la chat e Claude Code: per il funzionamento, consulta Limiti di Claude Pro.

Quando usi una chiave API, tramite Kunavo operi su una capacità condivisa e non hai né una quota dedicata né uno SLA contrattuale. I team che necessitano di garanzie dovrebbero stipulare un contratto diretto con Anthropic. Per singoli utenti o piccoli team che usano Cline, la fatturazione a consumo è adatta perché consente di separare Plan e Act con un'unica chiave.

Differenze rispetto all'uso di Roo Code

Roo Code è un'estensione derivata da Cline e può usare direttamente la configurazione OpenAI Compatible (Base URL, chiave e modello). La differenza riguarda la struttura delle modalità: invece di Plan / Act, ci sono modalità come Architect, Code, Ask e Debug, a ciascuna delle quali assegni un profilo di configurazione API. Puoi applicare lo stesso approccio: Opus 5 per Architect e un modello più economico per Code. Le istruzioni sono nella documentazione di configurazione di Roo Code e in Roo Code + Claude API (in inglese).

Per una spiegazione ancora più dettagliata in inglese, consulta la guida Cline + Claude API; per un confronto con gli agenti da terminale, consulta Cline e Claude Code a confronto e Come usare Claude Code. Per i prezzi di tutti i modelli, consulta la pagina dei prezzi.

Domande frequenti