Python

pip install claude-code-sdk
npm install -g @anthropic-ai/claude-code  # Dipendenza richiesta

pip install ipython

# legal-agent.py
import asyncio
from claude_code_sdk import ClaudeSDKClient, ClaudeCodeOptions

async def main():
    async with ClaudeSDKClient(
        options=ClaudeCodeOptions(
            system_prompt="Sei un assistente legale. Identifica i rischi e suggerisci miglioramenti.",
            max_turns=2
        )
    ) as client:
        # Invia la query
        await client.query(
            "Rivedi questa clausola contrattuale per potenziali problemi: 'La parte accetta una responsabilità illimitata...'"
        )

        # Trasmetti la risposta in streaming
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                # Stampa il contenuto in streaming mentre arriva
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text, end='', flush=True)

if __name__ == "__main__":
    asyncio.run(main())

python legal-agent.py

await main()

import asyncio
from claude_code_sdk import ClaudeSDKClient, ClaudeCodeOptions

async def main():
    async with ClaudeSDKClient(
        options=ClaudeCodeOptions(
            system_prompt="Sei un ingegnere delle prestazioni",
            allowed_tools=["Bash", "Read", "WebSearch"],
            max_turns=5
        )
    ) as client:
        await client.query("Analizza le prestazioni del sistema")

        # Trasmetti risposte in streaming
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text, end='', flush=True)

# Esegui come script
asyncio.run(main())

# O in IPython/Jupyter: await main()

from claude_code_sdk import query, ClaudeCodeOptions

async for message in query(
    prompt="Analizza le prestazioni del sistema",
    options=ClaudeCodeOptions(system_prompt="Sei un ingegnere delle prestazioni")
):
    if type(message).__name__ == "ResultMessage":
        print(message.result)

from claude_code_sdk import ClaudeCodeOptions

options = ClaudeCodeOptions(
    # Configurazione principale
    system_prompt="Sei un assistente utile",
    append_system_prompt="Istruzioni di sistema aggiuntive",
    max_turns=5,
    model="claude-3-5-sonnet-20241022",
    max_thinking_tokens=8000,
    
    # Gestione degli strumenti
    allowed_tools=["Bash", "Read", "Write"],
    disallowed_tools=["WebSearch"],
    
    # Gestione della sessione
    continue_conversation=False,
    resume="session-uuid",
    
    # Ambiente
    cwd="/percorso/alla/directory/di/lavoro",
    add_dirs=["/directory/contesto/aggiuntiva"],
    settings="/percorso/alle/impostazioni.json",
    
    # Permessi
    permission_mode="acceptEdits",  # "default", "acceptEdits", "plan", "bypassPermissions"
    permission_prompt_tool_name="mcp__approval_tool",
    
    # Integrazione MCP
    mcp_servers={
        "my_server": {
            "command": "npx",
            "args": ["-y", "@modelcontextprotocol/server-example"],
            "env": {"API_KEY": "your-key"}
        }
    },
    
    # Avanzate
    extra_args={"--verbose": None, "--custom-flag": "value"}
)

import asyncio
from claude_code_sdk import ClaudeSDKClient, ClaudeCodeOptions

async def advanced_agent():
    """Esempio che mostra le opzioni di configurazione avanzate"""
    
    async with ClaudeSDKClient(
        options=ClaudeCodeOptions(
            # Directory di lavoro personalizzata e contesto aggiuntivo
            cwd="/radice/progetto",
            add_dirs=["/librerie/condivise", "/utilità/comuni"],
            
            # Configurazione del modello e del ragionamento
            model="claude-3-5-sonnet-20241022",
            max_thinking_tokens=12000,
            
            # Controllo avanzato degli strumenti
            allowed_tools=["Read", "Write", "Bash", "Grep"],
            disallowed_tools=["WebSearch", "Bash(rm*)"],
            
            # Impostazioni personalizzate e argomenti CLI
            settings='{"editor": "vim", "theme": "dark"}',
            extra_args={
                "--verbose": None,
                "--timeout": "300"
            }
        )
    ) as client:
        await client.query("Analizza la struttura del codebase")
        
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text, end='', flush=True)

asyncio.run(advanced_agent())

from claude_code_sdk import ClaudeSDKClient, ClaudeCodeOptions

async with ClaudeSDKClient() as client:
    # Messaggio di testo
    await client.query("Analizza questo codice per problemi di sicurezza")

    # Messaggio con riferimento all'immagine (l'immagine verrà letta dallo strumento Read di Claude)
    await client.query("Spiega cosa è mostrato in screenshot.png")

    # Messaggi multipli in sequenza
    messages = [
        "Prima, analizza il diagramma dell'architettura in diagram.png",
        "Ora suggerisci miglioramenti basati sul diagramma",
        "Infine, genera il codice di implementazione"
    ]

    for msg in messages:
        await client.query(msg)
        async for response in client.receive_response():
            # Elabora ogni risposta
            pass

# L'SDK gestisce i file di immagine attraverso lo strumento Read integrato di Claude
# Formati supportati: PNG, JPG, PDF e altri formati comuni

import asyncio
from claude_code_sdk import ClaudeSDKClient, ClaudeCodeOptions, query

# Metodo 1: Utilizzo di ClaudeSDKClient per conversazioni persistenti
async def multi_turn_conversation():
    async with ClaudeSDKClient() as client:
        # Prima query
        await client.query("Rifacciamo il modulo di pagamento")
        async for msg in client.receive_response():
            # Elabora la prima risposta
            pass

        # Continua nella stessa sessione
        await client.query("Ora aggiungi una gestione completa degli errori")
        async for msg in client.receive_response():
            # Elabora la continuazione
            pass

        # Il contesto della conversazione viene mantenuto per tutto il tempo

# Metodo 2: Utilizzo della funzione query con gestione della sessione
async def resume_session():
    # Continua la conversazione più recente
    async for message in query(
        prompt="Ora rifai questo per prestazioni migliori",
        options=ClaudeCodeOptions(continue_conversation=True)
    ):
        if type(message).__name__ == "ResultMessage":
            print(message.result)

    # Riprendi una sessione specifica
    async for message in query(
        prompt="Aggiorna i test",
        options=ClaudeCodeOptions(
            resume="550e8400-e29b-41d4-a716-446655440000",
            max_turns=3
        )
    ):
        if type(message).__name__ == "ResultMessage":
            print(message.result)

# Esegui gli esempi
asyncio.run(multi_turn_conversation())

import asyncio
from claude_code_sdk import ClaudeSDKClient, ClaudeCodeOptions

async def specialized_agents():
    # Agente di risposta agli incidenti SRE con streaming
    async with ClaudeSDKClient(
        options=ClaudeCodeOptions(
            system_prompt="Sei un esperto SRE. Diagnostica i problemi sistematicamente e fornisci soluzioni attuabili.",
            max_turns=3
        )
    ) as sre_agent:
        await sre_agent.query("L'API è down, investiga")

        # Trasmetti il processo diagnostico in streaming
        async for message in sre_agent.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text, end='', flush=True)

    # Agente di revisione legale con prompt personalizzato
    async with ClaudeSDKClient(
        options=ClaudeCodeOptions(
            append_system_prompt="Includi sempre una gestione completa degli errori e test unitari.",
            max_turns=2
        )
    ) as dev_agent:
        await dev_agent.query("Rifai questa funzione")

        # Raccogli la risposta completa
        full_response = []
        async for message in dev_agent.receive_response():
            if type(message).__name__ == "ResultMessage":
                print(message.result)

asyncio.run(specialized_agents())

import asyncio
from claude_code_sdk import ClaudeSDKClient, ClaudeCodeOptions

async def mcp_enabled_agent():
    # Agente legale con accesso ai documenti e streaming
    # Nota: Configura i tuoi server MCP secondo necessità
    mcp_servers = {
        # Configurazione di esempio - decommenta e configura secondo necessità:
        # "docusign": {
        #     "command": "npx",
        #     "args": ["-y", "@modelcontextprotocol/server-docusign"],
        #     "env": {"API_KEY": "your-key"}
        # }
    }

    async with ClaudeSDKClient(
        options=ClaudeCodeOptions(
            mcp_servers=mcp_servers,
            allowed_tools=["mcp__docusign", "mcp__compliance_db"],
            system_prompt="Sei un avvocato aziendale specializzato nella revisione di contratti.",
            max_turns=4
        )
    ) as client:
        await client.query("Rivedi questo contratto per i rischi di conformità")

        # Monitora l'uso degli strumenti e le risposte
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'type'):
                        if block.type == 'tool_use':
                            print(f"\n[Uso strumento: {block.name}]\n")
                        elif hasattr(block, 'text'):
                            print(block.text, end='', flush=True)
                    elif hasattr(block, 'text'):
                        print(block.text, end='', flush=True)

            if type(message).__name__ == "ResultMessage":
                print(f"\n\nRevisione completata. Costo totale: ${message.total_cost_usd:.4f}")

asyncio.run(mcp_enabled_agent())

import asyncio
from claude_code_sdk import ClaudeSDKClient, ClaudeCodeOptions

async def use_permission_prompt():
    """Esempio di utilizzo dello strumento di richiesta permessi personalizzato"""

    # Configurazione del server MCP
    mcp_servers = {
        # Configurazione di esempio - decommenta e configura secondo necessità:
        # "security": {
        #     "command": "npx",
        #     "args": ["-y", "@modelcontextprotocol/server-security"],
        #     "env": {"API_KEY": "your-key"}
        # }
    }

    async with ClaudeSDKClient(
        options=ClaudeCodeOptions(
            permission_prompt_tool_name="mcp__security__approval_prompt",  # Cambiato da permission_prompt_tool
            mcp_servers=mcp_servers,
            allowed_tools=["Read", "Grep"],
            disallowed_tools=["Bash(rm*)", "Write"],
            system_prompt="Sei un auditor di sicurezza"
        )
    ) as client:
        await client.query("Analizza e risolvi i problemi di sicurezza")

        # Monitora l'uso degli strumenti e i permessi
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'type'):  # Aggiunto controllo per l'attributo 'type'
                        if block.type == 'tool_use':
                            print(f"[Strumento: {block.name}] ", end='')
                    if hasattr(block, 'text'):
                        print(block.text, end='', flush=True)

            # Controlla i rifiuti di permesso nei messaggi di errore
            if type(message).__name__ == "ErrorMessage":
                if hasattr(message, 'error') and "Permission denied" in str(message.error):
                    print(f"\n⚠️ Permesso negato: {message.error}")

# Esempio di implementazione del server MCP (Python)
# Questo sarebbe nel codice del tuo server MCP
async def approval_prompt(tool_name: str, input: dict, tool_use_id: str = None):
    """Gestore personalizzato della richiesta di permessi"""
    # La tua logica personalizzata qui
    if "allow" in str(input):
        return json.dumps({
            "behavior": "allow",
            "updatedInput": input
        })
    else:
        return json.dumps({
            "behavior": "deny",
            "message": f"Permesso negato per {tool_name}"
        })

asyncio.run(use_permission_prompt())

# Output di testo predefinito con streaming
async with ClaudeSDKClient() as client:
    await client.query("Spiega il file src/components/Header.tsx")

    # Trasmetti il testo mentre arriva
    async for message in client.receive_response():
        if hasattr(message, 'content'):
            for block in message.content:
                if hasattr(block, 'text'):
                    print(block.text, end='', flush=True)
                    # L'output viene trasmesso in tempo reale: Questo è un componente React che mostra...

# Raccogli tutti i messaggi con metadati
async with ClaudeSDKClient() as client:
    await client.query("Come funziona il livello dati?")

    messages = []
    result_data = None

    async for message in client.receive_messages():
        messages.append(message)

        # Cattura il messaggio di risultato con metadati
        if type(message).__name__ == "ResultMessage":
            result_data = {
                "result": message.result,
                "cost": message.total_cost_usd,
                "duration": message.duration_ms,
                "num_turns": message.num_turns,
                "session_id": message.session_id
            }
            break

    print(result_data)

import asyncio
from claude_code_sdk import ClaudeSDKClient

async def process_inputs():
    async with ClaudeSDKClient() as client:
        # Input di testo
        await client.query("Spiega questo codice")
        async for message in client.receive_response():
            # Elabora la risposta in streaming
            pass

        # Input di immagine (Claude userà automaticamente lo strumento Read)
        await client.query("Cosa c'è in questo diagramma? screenshot.png")
        async for message in client.receive_response():
            # Elabora l'analisi dell'immagine
            pass

        # Input multipli con contenuto misto
        inputs = [
            "Analizza l'architettura in diagram.png",
            "Confrontala con le migliori pratiche",
            "Genera una versione migliorata"
        ]

        for prompt in inputs:
            await client.query(prompt)
            async for message in client.receive_response():
                # Elabora ogni risposta
                pass

asyncio.run(process_inputs())

import asyncio
from claude_code_sdk import ClaudeSDKClient, ClaudeCodeOptions

async def investigate_incident(incident_description: str, severity: str = "medium"):
    """Agente automatizzato di risposta agli incidenti con streaming in tempo reale"""

    # Configurazione del server MCP per strumenti di monitoraggio
    mcp_servers = {
        # Configurazione di esempio - decommenta e configura secondo necessità:
        # "datadog": {
        #     "command": "npx",
        #     "args": ["-y", "@modelcontextprotocol/server-datadog"],
        #     "env": {"API_KEY": "your-datadog-key", "APP_KEY": "your-app-key"}
        # }
    }

    async with ClaudeSDKClient(
        options=ClaudeCodeOptions(
            system_prompt="Sei un esperto SRE. Diagnostica i problemi sistematicamente e fornisci soluzioni attuabili.",
            max_turns=6,
            allowed_tools=["Bash", "Read", "WebSearch", "mcp__datadog"],
            mcp_servers=mcp_servers
        )
    ) as client:
        # Invia i dettagli dell'incidente
        prompt = f"Incidente: {incident_description} (Gravità: {severity})"
        print(f"🚨 Investigando: {prompt}\n")
        await client.query(prompt)

        # Trasmetti il processo di investigazione in streaming
        investigation_log = []
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'type'):
                        if block.type == 'tool_use':
                            print(f"[{block.name}] ", end='')
                    if hasattr(block, 'text'):
                        text = block.text
                        print(text, end='', flush=True)
                        investigation_log.append(text)

            # Cattura il risultato finale
            if type(message).__name__ == "ResultMessage":
                return {
                    'analysis': ''.join(investigation_log),
                    'cost': message.total_cost_usd,
                    'duration_ms': message.duration_ms
                }

# Utilizzo
result = await investigate_incident("API di pagamento che restituisce errori 500", "high")
print(f"\n\nInvestigazione completata. Costo: ${result['cost']:.4f}")

import subprocess
import asyncio
import json
from claude_code_sdk import ClaudeSDKClient, ClaudeCodeOptions

async def audit_pr(pr_number: int):
    """Agente di audit di sicurezza per pull request con feedback in streaming"""
    # Ottieni il diff della PR
    pr_diff = subprocess.check_output(
        ["gh", "pr", "diff", str(pr_number)],
        text=True
    )

    async with ClaudeSDKClient(
        options=ClaudeCodeOptions(
            system_prompt="Sei un ingegnere della sicurezza. Rivedi questa PR per vulnerabilità, pattern insicuri e problemi di conformità.",
            max_turns=3,
            allowed_tools=["Read", "Grep", "WebSearch"]
        )
    ) as client:
        print(f"🔍 Audit della PR #{pr_number}\n")
        await client.query(pr_diff)

        findings = []
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        # Trasmetti i risultati mentre vengono scoperti
                        print(block.text, end='', flush=True)
                        findings.append(block.text)

            if type(message).__name__ == "ResultMessage":
                return {
                    'pr_number': pr_number,
                    'findings': ''.join(findings),
                    'metadata': {
                        'cost': message.total_cost_usd,
                        'duration': message.duration_ms,
                        'severity': 'high' if 'vulnerability' in ''.join(findings).lower() else 'medium'
                    }
                }

# Utilizzo
report = await audit_pr(123)
print(f"\n\nAudit completato. Gravità: {report['metadata']['severity']}")
print(json.dumps(report, indent=2))

import asyncio
from claude_code_sdk import ClaudeSDKClient, ClaudeCodeOptions

async def legal_review():
    """Revisione di documenti legali con sessione persistente e streaming"""

    async with ClaudeSDKClient(
        options=ClaudeCodeOptions(
            system_prompt="Sei un avvocato aziendale. Fornisci analisi legali dettagliate.",
            max_turns=2
        )
    ) as client:
        # Revisione multi-step nella stessa sessione
        steps = [
            "Rivedi contract.pdf per le clausole di responsabilità",
            "Controlla la conformità ai requisiti GDPR",
            "Genera un riassunto esecutivo dei rischi"
        ]

        review_results = []

        for step in steps:
            print(f"\n📋 {step}\n")
            await client.query(step)

            step_result = []
            async for message in client.receive_response():
                if hasattr(message, 'content'):
                    for block in message.content:
                        if hasattr(block, 'text'):
                            text = block.text
                            print(text, end='', flush=True)
                            step_result.append(text)

                if type(message).__name__ == "ResultMessage":
                    review_results.append({
                        'step': step,
                        'analysis': ''.join(step_result),
                        'cost': message.total_cost_usd
                    })

        # Riassunto
        total_cost = sum(r['cost'] for r in review_results)
        print(f"\n\n✅ Revisione legale completata. Costo totale: ${total_cost:.4f}")
        return review_results

# Utilizzo
results = await legal_review()

import asyncio
from claude_code_sdk import ClaudeSDKClient, ClaudeCodeOptions

# Usa sempre i context manager
async with ClaudeSDKClient() as client:
    await client.query("Analizza questo codice")
    async for msg in client.receive_response():
        # Elabora i messaggi in streaming
        pass

# Esegui più agenti contemporaneamente
async with ClaudeSDKClient() as reviewer, ClaudeSDKClient() as tester:
    await asyncio.gather(
        reviewer.query("Rivedi main.py"),
        tester.query("Scrivi test per main.py")
    )

# Gestione degli errori
from claude_code_sdk import CLINotFoundError, ProcessError

try:
    async with ClaudeSDKClient() as client:
        # Il tuo codice qui
        pass
except CLINotFoundError:
    print("Installa CLI: npm install -g @anthropic-ai/claude-code")
except ProcessError as e:
    print(f"Errore di processo: {e}")

# Raccogli la risposta completa con metadati
async def get_response(client, prompt):
    await client.query(prompt)
    text = []
    async for msg in client.receive_response():
        if hasattr(msg, 'content'):
            for block in msg.content:
                if hasattr(block, 'text'):
                    text.append(block.text)
        if type(msg).__name__ == "ResultMessage":
            return {'text': ''.join(text), 'cost': msg.total_cost_usd}

# In Jupyter, usa await direttamente nelle celle
client = ClaudeSDKClient()
await client.connect()
await client.query("Analizza data.csv")
async for msg in client.receive_response():
    print(msg)
await client.disconnect()

# Crea funzioni helper riutilizzabili
async def stream_print(client, prompt):
    await client.query(prompt)
    async for msg in client.receive_response():
        if hasattr(msg, 'content'):
            for block in msg.content:
                if hasattr(block, 'text'):
                    print(block.text, end='', flush=True)