Abbonamento Claude Code in Vercel AI SDK: chi paga il conto

Vercel il 14 settembre 2026 ha cambiato l'account a cui può essere addebitato un agente di coding integrato. AI SDK può ora utilizzare l'abbonamento di un agente supportato già autenticato sull'host, per esempio un abbonamento Claude Code: la successiva esecuzione idonea del modello avrà così un costo incrementale di $0 finché non si esaurisce la quota del piano. Il calcolo in Sandbox resta invece una voce separata.

Cambia chi paga, non l'agente

AI SDK offre un livello che esegue agenti di coding completi dietro un'unica interfaccia HarnessAgent. Vercel definisce ogni adapter un harness perché non incapsula soltanto la chiamata al modello: l'agente porta con sé strumenti, modalità di lavoro nel workspace, stato della sessione, permessi e compattazione.

La distinzione è importante. Questa novità non rende Claude Code, Codex, Cursor o un altro agente più bravo a programmare. Offre all'adapter un nuovo posto in cui cercare le credenziali: la sessione di un abbonamento nativo salvata sulla macchina che esegue l'applicazione.

Prima servivano credenziali esplicite del provider oppure di AI Gateway per avviare un'esecuzione integrata. Ora un adapter idoneo può ripiegare sull'abbonamento già autenticato sull'host. Il rilevamento non richiede modifiche al codice dell'applicazione né nuove impostazioni.

L'annuncio di rilascio elenca nove adapter: Claude Code, Cline, Codex, Cursor, fx, GitHub Copilot, Grok Build, OpenCode e Pi. Non significa che la funzione sia garantita per qualsiasi account. L'agente sottostante deve comunque supportare l'accesso tramite abbonamento, mentre le regole del suo piano stabiliscono quanta capacità può utilizzare quella sessione.

L'effetto pratico sui costi è semplice: la stessa chiamata agent.generate() può finire su tre budget diversi in base alle credenziali disponibili.

L'ordine delle credenziali decide chi paga

Le modalità di autenticazione sono tre. Quella predefinita è auto. Per gli adapter diretti, come Claude Code e Codex, l'ordine effettivo è questo:

È qui che una variabile d'ambiente dimenticata cambia la contabilità. Un'esecuzione di Claude Code in modalità direct userà ANTHROPIC_API_KEY oppure ANTHROPIC_AUTH_TOKEN prima dell'abbonamento Claude. Codex userà OPENAI_API_KEY oppure CODEX_API_KEY prima dei diritti inclusi in ChatGPT.

auto aggiunge un ulteriore livello di precedenza. Se trova una credenziale Gateway, AI Gateway prevale sia sulla chiave del provider sia sull'abbonamento.

Percorso di rete e fonte di addebito non coincidono per tutti gli adapter. fx continua a inviare le richieste al modello tramite AI Gateway nelle modalità direct e ai-gateway, ma ora può individuare un abbonamento nativo supportato quando non è impostata alcuna credenziale d'ambiente applicabile e non è stata scelta la modalità ai-gateway. Prima di applicare questa tabella come mappa universale del traffico, va verificata la pagina del singolo adapter.

Il confine di sicurezza è più solido rispetto alla copia di un token OAuth grezzo dentro una macchina isolata. Vercel risolve le credenziali sull'host e aggiorna lì il token OAuth. Quando la Sandbox supporta la trasformazione delle richieste, l'agente vede un segnaposto e l'host inserisce la credenziale reale soltanto nella richiesta in uscita corrispondente.

Questo protegge il segreto dalla Sandbox. Non trasforma però un abbonamento personale in capacità condivisa dall'azienda.

Abbonamento Claude Code e altri percorsi: come tornano i conti

L'addebito del modello può spostarsi su una quota inclusa. Quello del runtime no.

Quota inclusa nell'abbonamento

Claude Code è oggi l'esempio più chiaro. Claude Pro costa $20 con pagamento mensile oppure $200 all'anno; Claude Max costa $100 o $200 al mese per un utilizzo pari a 5x o 20x quello di Pro. Se uno di questi piani è già attivo, un'esecuzione idonea con autenticazione nativa non aggiunge un costo separato per il modello finché non si esaurisce la quota condivisa.

La parola condivisa è decisiva. Anthropic precisa che Claude Agent SDK, claude -p e le applicazioni Agent SDK di terze parti continuano a consumare i limiti dell'abbonamento. Anche claude.ai, Claude Code e Claude Desktop incidono sullo stesso limite di utilizzo. Poiché l'adapter Claude Code di Vercel usa l'Agent SDK di Anthropic, in pratica il lavoro integrato compete con le altre attività Claude dell'abbonato.

OpenAI segue lo stesso schema di budget, ma con contatori diversi. ChatGPT Plus costa $20 al mese, Codex è incluso nei piani ChatGPT e i limiti variano in base al piano. Codex condivide una quota per gli agenti con ChatGPT Work, ChatGPT for Excel e Workspace Agents nei mercati in cui questi prodotti sono disponibili. Gli utenti Plus e Pro idonei possono acquistare crediti dopo avere consumato l'utilizzo incluso, ma non si tratta di crediti API.

Il percorso tramite abbonamento, quindi, non equivale a inferenza gratuita. È capacità prepagata con un tetto variabile. Spostare i job in background nell'adapter può ridurre oggi i costi API e accorciare domani la sessione interattiva della persona.

API diretta del provider

Se prevale una chiave del provider, paga il relativo account a consumo. Claude Sonnet 4.6 costa attualmente $3 per milione di token in input e $15 per milione di token in output alle tariffe API standard. GPT-5.6 Luna di OpenAI costa $0.20 per milione di token in input, $0.02 per milione di token in input memorizzati nella cache e $1.20 per milione di token in output.

Queste tariffe rendono il percorso API facile da attribuire. Non rendono però prevedibile un'attività svolta da un agente di coding: dimensioni del repository, cronologia della conversazione, livello di ragionamento, tentativi ripetuti e cicli degli strumenti modificano tutti il consumo di token. La metrica utile sono le attività completate, non i prompt.

AI Gateway

Se prevale una credenziale Gateway, l'utilizzo confluisce in AI Gateway. Vercel applica il prezzo di listino del provider a monte, senza maggiorazioni sui token né commissioni di piattaforma. In genere si paga con credito Gateway prepagato; i clienti Enterprise possono invece ricevere una fattura Vercel consolidata.

Questo percorso riunisce la spesa del team in un unico punto. Permette inoltre di usare i budget di Gateway. Quei controlli non seguono un'esecuzione che evita Gateway per usare un abbonamento nativo: la scelta tra risparmio marginale e controllo centralizzato del budget deve quindi essere intenzionale.

Calcolo in Sandbox

Ogni runtime per agenti AI SDK continua a operare in una sandbox. Nella regione predefinita iad1 di Vercel, Sandbox costa $0.128 per ora di CPU attiva e $0.0212 per GB-ora allocato. La CPU si mette in pausa mentre il processo attende il modello o operazioni I/O di rete, ma la memoria continua a essere conteggiata per l'intera durata effettiva.

L'esempio di Vercel per la validazione del codice con l'AI dura cinque minuti e usa due vCPU e quattro GB di memoria. Con la CPU al 100% costa circa $0.03. Se l'intero credito Pro di $20 fosse disponibile soltanto per quel carico esatto, il calcolo darebbe un limite indicativo di 666 esecuzioni prima di passare all'uso a pagamento di Sandbox. La capacità reale sarà diversa: altri servizi Vercel possono consumare il credito, le attività richiedono risorse differenti e traffico dati o archiviazione possono aggiungere costi.

Il budget completo è quindi questo:

• Percorso abbonamento: prezzo del piano esistente, quota condivisa e Sandbox.
• Percorso provider: token del provider a consumo e Sandbox.
• Percorso Gateway: token al prezzo di listino del provider, addebitati sul saldo o sulla fattura Gateway, e Sandbox.

Quale percorso scegliere in base al caso d'uso

Founder indipendente con un assistente interno per il repository

Chi ha già Claude Pro o ChatGPT Plus può mettere dietro HarnessAgent uno strumento a basso volume per correggere test o riassumere un repository, scegliere direct e affidare al piano nativo il lavoro del modello idoneo. Durante il progetto pilota si evita così di aprire un altro saldo per il modello.

Conviene mantenere l'ambito interno e controllare la pagina di utilizzo del provider. Lo stesso abbonamento paga anche il lavoro del founder nel terminale e nelle app, quindi un job in background può consumare la capacità che servirà più tardi nella giornata.

Responsabile tecnico di un'agenzia che standardizza i job operativi

Un'agenzia può assegnare a ciascun operatore identificato un'attività circoscritta sul repository e usare sull'host il suo abbonamento idoneo. Il controllo decisivo non è la scelta dell'adapter, ma la verifica che le variabili API del provider siano assenti prima dell'avvio.

La regola per l'amministrazione diventa chiara: prima la quota del piano per lavori interni e limitati; l'API del provider soltanto quando una chiave è stata montata deliberatamente. Si evita anche di condividere l'accesso di una sola persona con l'intera agenzia.

Team di una piattaforma per sviluppatori con automazioni condivise

Di norma, un team di piattaforma dovrebbe fissare i job non presidiati o condivisi su ai-gateway. Rinuncia così alla finestra di costo incrementale pari a $0 offerta dall'abbonamento, ma ottiene un solo titolare della fatturazione, un unico fondo di crediti o una fattura unica e controlli di spesa legati al servizio invece che a una persona.

La precedente guida all'adapter fx conserva un dettaglio importante: entrambe le modalità di fx inviano le richieste del modello tramite AI Gateway. Il 14 settembre è cambiato il fallback delle credenziali. Le sezioni su configurazione e costi devono ora considerare un abbonamento nativo supportato quando nessuna credenziale con priorità maggiore prende il sopravvento.

Founder SaaS che vende ai clienti il lavoro degli agenti

Una funzione di coding rivolta ai clienti non dovrebbe basare la propria capacità sull'abbonamento di un dipendente. Il traffico dei clienti è condiviso, variabile e deve continuare anche quando cambia il personale. È preferibile usare AI Gateway oppure un account API del provider con un titolare esplicito, includendo poi Sandbox nei costi unitari.

Il confronto dedicato agli agenti utilizzabili con abbonamenti esistenti aiuta il singolo sviluppatore a scegliere un client locale o open source da usare con un piano già pagato. Questa novità riguarda invece l'integrazione di un runtime supportato in un'applicazione AI SDK. L'accesso può sembrare simile; il modello operativo non lo è.

Eseguire un job Claude Code usando la quota del piano

Questo percorso è pensato per un'attività interna e circoscritta, su un host dove l'utente identificato ha già effettuato l'accesso a Claude Code. Seleziona volutamente direct tramite la configurazione documentata dell'adapter Claude Code, in modo che il token OIDC di Vercel possa autenticare Sandbox senza instradare il lavoro del modello verso Gateway.

1. 1

   Installare i pacchetti documentati

   In un progetto Node esistente, aggiungere il pacchetto principale dell'agente, l'adapter Claude Code e l'adapter Vercel Sandbox.

   pnpm add @ai-sdk/harness @ai-sdk/harness-claude-code @ai-sdk/sandbox-vercel

2. 2

   Effettuare l'accesso sull'host

   Avviare Claude Code sullo stesso host e scegliere l'account Claude associato all'abbonamento idoneo.

   claude

   Mantenere VERCEL_OIDC_TOKEN disponibile per Sandbox. Controllare l'ambiente del processo e rimuovere ANTHROPIC_API_KEY e ANTHROPIC_AUTH_TOKEN da questa esecuzione se deve pagare l'abbonamento. Entrambe le variabili del provider hanno la precedenza sull'accesso nativo.

3. 3

   Forzare il percorso direct

   Salvare il file come agent.mjs. Il codice usa il selettore documentato direct, l'attuale runtime Sandbox node24 e la porta esposta 4000 richiesta dal bridge.

   import { HarnessAgent } from '@ai-sdk/harness/agent';
   import { createClaudeCode } from '@ai-sdk/harness-claude-code';
   import { createVercelSandbox } from '@ai-sdk/sandbox-vercel';
   
   const agent = new HarnessAgent({
     harness: createClaudeCode({ auth: 'direct' }),
     model: 'claude-sonnet-4-6',
     sandbox: createVercelSandbox({
       runtime: 'node24',
       ports: [4000],
     }),
   });
   
   const session = await agent.createSession();
   
   let exitCode = 0;
   try {
     const result = await agent.generate({
       session,
       prompt: 'Create a short TODO.md for this repository.',
     });
   
     console.log(result.text);
   } catch (err) {
     exitCode = 1;
     console.error(err);
   } finally {
     await session.destroy();
     process.exit(exitCode);
   }

4. 4

   Verificare entrambi gli addebiti

   Eseguire una sola attività innocua. Controllare che la pagina di utilizzo del provider registri il consumo della quota del piano e nessun nuovo addebito API. Verificare poi la voce Sandbox in Vercel Usage.

   Se AI Gateway registra la richiesta al modello, ha prevalso una credenziale Gateway. Se compare un addebito nella dashboard API del provider, ha prevalso una credenziale del provider. Prima di ampliare il progetto pilota, fermarsi e correggere l'ambiente.

I limiti da considerare senza scorciatoie

L'accesso nativo è legato all'host. Non è un flusso OAuth già pronto per ogni cliente dell'applicazione e non aggrega in un unico fondo le quote individuali di un team.

Anche la capacità del piano varia. OpenAI afferma che i limiti di Codex dipendono dal piano e dall'attività. Anthropic indica che l'uso di Claude cambia in base a modello, complessità dell'attività, contesto e livello di impegno. Nessuno dei due assegna a questo percorso Vercel un numero fisso di job di produzione.

I pacchetti per agenti AI SDK restano sperimentali e possono introdurre modifiche incompatibili tra una release e l'altra. È un rischio accettabile per un progetto pilota interno e misurato. Prima di trasformarlo in una promessa ai clienti, è invece opportuno bloccare le versioni delle dipendenze, verificare la selezione delle credenziali e predisporre un percorso Gateway o provider alternativo.

La mossa da fare lunedì

Scegliere un'attività interna sul repository e un solo utente idoneo. Impostare l'adapter su direct, fare l'inventario delle variabili del provider presenti sull'host, eseguire una volta l'attività e annotare quale dashboard di fatturazione è cambiata, se la quota dell'abbonamento è diminuita, il costo di Sandbox e l'esito dell'attività.

Vale la pena agire questa settimana se esiste già un piano supportato e il workflow interno è ben delimitato. Meglio attendere se l'agente sottostante non consente l'accesso tramite abbonamento o se lo stato sperimentale del pacchetto non rientra nelle regole sulle dipendenze. Conviene restare su ai-gateway quando budget centrali e titolarità condivisa della produzione contano più del risparmio marginale sul modello. Chi usa soltanto i normali provider di modelli AI SDK e non utilizza mai HarnessAgent non è interessato dal cambiamento.

Per ricevere altre analisi operative sugli strumenti AI che stanno cambiando budget e workflow reali, è possibile iscriversi alla newsletter.