Claude API skill

La skill claude-api è un'Agent Skill open-source che fornisce a Claude materiale di riferimento dettagliato e aggiornato per la creazione di applicazioni su due superfici Anthropic:

• Messages API — la superficie principale per singole richieste, chat in streaming, tool use, elaborazione batch, prompt caching, output strutturati e loop di agenti personalizzati.
• Claude Managed Agents (beta) — una superficie proprietaria per agenti stateful gestiti dal server con esecuzione di tool ospitata da Anthropic, configurazioni di agenti persistenti e container per sessione.

Copre 8 linguaggi di programmazione per Messages API (Python, TypeScript, Java, Go, Ruby, C#, PHP e cURL) e 7 linguaggi per Managed Agents (Python, TypeScript, Java, Go, Ruby, PHP e cURL — C# non è attualmente supportato).

La skill viene fornita in bundle con Claude Code ed è disponibile anche nel repository di skill Anthropic open-source, dove puoi installarla in qualsiasi ambiente che supporti Agent Skills.

La skill utilizza progressive disclosure per mantenere il contesto efficiente: Claude carica solo la documentazione rilevante per il linguaggio del tuo progetto, la superficie (Messages API o Managed Agents) e l'attività specifica in questione (tool use, streaming, batch e così via), piuttosto che caricare tutto in una volta.

Cosa fornisce la skill

Quando attivata, la skill fornisce a Claude:

Per Messages API:

• Documentazione SDK specifica del linguaggio: Installazione, quick start, pattern comuni e gestione degli errori per il linguaggio del tuo progetto
• Guida al tool use: Esempi specifici del linguaggio e fondamenti concettuali per function calling, incluso il beta tool runner dove disponibile
• Pattern di streaming: Dettagli di implementazione per la creazione di UI di chat e la gestione della visualizzazione incrementale
• Elaborazione batch: Elaborazione batch offline al 50% di costo
• Prompt caching: Design della stabilità dei prefissi, posizionamento dei breakpoint e audit del silent-invalidator
• Migrazione del modello: Guida passo dopo passo per la migrazione a modelli Claude più recenti (inclusi i breaking changes e i cambiamenti di comportamento su Claude Opus 4.7)
• Informazioni sul modello attuale: ID del modello, dimensioni della finestra di contesto e prezzi
• Errori comuni: Guida dettagliata per evitare errori frequenti durante l'integrazione con l'API

Per Managed Agents (beta):

• Flusso di onboarding: Una procedura guidata basata su interviste per configurare un nuovo Managed Agent da zero, disponibile tramite il sottocomando /claude-api managed-agents-onboard
• Documentazione Managed Agents specifica del linguaggio: Creazione di agenti persistenti, avvio di sessioni, streaming di eventi e gestione delle conferme di tool per Python, TypeScript, Java, Go, Ruby, PHP e cURL
• Pattern client: Riconnessione di stream senza perdite, gate processed_at queued/processed, gestione degli interrupt, gotcha del file-mount e gestione delle credenziali
• Vincoli di distribuzione: Managed Agents è solo proprietario (non disponibile su Amazon Bedrock, Google Vertex AI o Microsoft Foundry) — la skill instrada le distribuzioni di terze parti a Messages API + tool use invece

Quando la skill si attiva

La skill si attiva in due modi:

L'attivazione automatica si verifica quando:

• Il tuo codice importa un SDK Anthropic (anthropic per Python, @anthropic-ai/sdk per TypeScript/JavaScript)
• Chiedi a Claude di aiutarti a costruire, debuggare o ottimizzare qualcosa con Claude API, un SDK Anthropic o Managed Agents
• Aggiungi, modifichi o sintonizzi una funzione Claude in un file (prompt caching, adaptive thinking, compaction, tool use, batch, files, citations, memory) o un riferimento a un modello

Invocazione manuale digitando /claude-api (con sottocomando opzionale o prosa) in qualsiasi ambiente dove la skill è installata.

La skill non si attiva per attività di programmazione generale, lavoro ML/data-science o codice che importa altri SDK AI (come OpenAI).

Linguaggi supportati

La skill rileva automaticamente il linguaggio del tuo progetto esaminando i file del progetto (ad esempio, requirements.txt per Python, tsconfig.json per TypeScript, go.mod per Go) e carica la documentazione appropriata.

Se il tuo progetto utilizza più linguaggi, Claude chiede quale si applica. Per linguaggi non supportati (Rust, Swift, C++), la skill fornisce esempi cURL/HTTP raw.

Come utilizzare la skill

In Claude Code (in bundle)

La skill viene fornita con Claude Code e non richiede installazione. Quando chiedi a Claude di aiutarti a costruire qualcosa con Claude API, o quando il tuo progetto importa già un SDK Anthropic, la skill si attiva automaticamente.

Puoi anche invocarla direttamente:

/claude-api

Per ulteriori informazioni su come funzionano le skill in bundle in Claude Code, consulta la documentazione delle skill di Claude Code.

Dal repository di skill

Il codice sorgente della skill è disponibile nel repository di skill Anthropic. Puoi installarla usando il comando npx:

npx skills add https://github.com/anthropics/skills --skill claude-api

Oppure installala come plugin di Claude Code:

/plugin marketplace add anthropics/skills
/plugin install claude-api@anthropic-agent-skills

Migrazione a un modello Claude più recente

La skill Claude API può eseguire migrazioni di modelli Claude in un codebase. Invocala direttamente con /claude-api migrate:

/claude-api migrate this project to claude-opus-4-7

Puoi anche passare uno scope specifico in anticipo per saltare la domanda di conferma dello scope:

/claude-api migrate everything under src/ to claude-opus-4-7
/claude-api migrate apps/api.py and apps/worker.py to claude-opus-4-7

Quando lo scope è ambiguo (ad esempio, un semplice /claude-api migrate to claude-opus-4-7), la skill ti chiede di scegliere tra l'intera directory di lavoro, una sottodirectory specifica o un elenco di file esplicito prima di modificare qualsiasi file. Questo si applica sia ai chiamanti di Messages API che a Managed Agents.

La skill gestisce:

• Scambi di ID modello, incluse costanti SDK tipizzate (Model.CLAUDE_OPUS_4_6 → Model.CLAUDE_OPUS_4_7) in tutti i linguaggi supportati, e classifica ogni file come un chiamante, un definitor di modello o un riferimento a stringa opaco prima di modificare
• Cambiamenti di parametri di breaking, come la rimozione di temperature, top_p e top_k per Claude Opus 4.7, e la conversione di thinking: {type: "enabled", budget_tokens: N} a thinking: {type: "adaptive"}
• Sostituzione del prefill, conversione di pattern di prefill di messaggi di assistente a output strutturati dove applicabile
• Pulizia dell'intestazione beta, rimozione di intestazioni che sono GA sul modello di destinazione (ad esempio, effort-2025-11-24, fine-grained-tool-streaming-2025-05-14, interleaved-thinking-2025-05-14) e passaggio da client.beta.messages.create a client.messages.create
• Calibrazione dello sforzo, raccomandazione di un punto di partenza output_config.effort per il modello di destinazione (ad esempio, xhigh per coding e casi d'uso agentic su Claude Opus 4.7)
• Sintonizzazione del comportamento del prompt, segnalazione di prompt di controllo della lunghezza, attivazione di tool, subagent e conformità alle istruzioni che potrebbero comportarsi diversamente sul modello di destinazione
• Gestione del silent default, opt-in nella riepilogazione del thinking (thinking.display: "summarized") quando il ragionamento viene visualizzato agli utenti su Claude Opus 4.7

Mentre modifica, la skill spiega ogni cambiamento e la sua motivazione inline. Al completamento, produce una checklist di elementi che richiedono verifica manuale (tipicamente test di integrazione, sintonizzazione del prompt di controllo della lunghezza e re-baselining di costo/limite di velocità).

Per l'elenco completo dei cambiamenti specifici del modello che la skill applica, consulta Migrazione a Claude Opus 4.7.

Configurazione di un Managed Agent

Per scaffoldare un nuovo Managed Agent da zero, invoca il sottocomando managed-agents-onboard:

/claude-api managed-agents-onboard

La skill esegue un'intervista che ti guida attraverso il modello mentale di Managed Agents (configurazioni di Agent rispetto a Sessions), crea un template di una configurazione di agent, configura ambienti e tool, imposta il loop di sessione e emette codice eseguibile per il tuo linguaggio. La skill copre anche il flusso obbligatorio Agent (una volta) → Session (ogni esecuzione) — model, system e tools vivono sull'agent, mai sulla sessione, e gli agent dovrebbero essere creati una volta e referenziati per ID.

Managed Agents richiede l'intestazione beta managed-agents-2026-04-01, che l'SDK imposta automaticamente per tutte le chiamate client.beta.agents.*, client.beta.environments.*, client.beta.sessions.* e client.beta.vaults.*.

Esempio di utilizzo

Ecco esempi di attività che la skill aiuta Claude a gestire:

Creazione di un'applicazione di chat:

Build a streaming chat UI with the Claude API in TypeScript

Migrazione di un progetto esistente:

/claude-api migrate this codebase to claude-opus-4-7 and re-tune effort

Onboarding di un nuovo Managed Agent:

/claude-api managed-agents-onboard

In ogni caso, la skill carica la documentazione specifica del linguaggio rilevante e guida Claude attraverso l'implementazione utilizzando pattern API attuali e best practice.

Passaggi successivi