Il progetto: trasformare una lezione di coaching in sei momenti visivi
Claude Code è più utile per i fumetti quando il materiale sorgente è già presente in file. Un coach, il team di comunicazione di una scuola o un programma giovanile potrebbero già avere un piano di lezione, una guida per i partecipanti, un riferimento per i personaggi e regole che devono rimanere intatte a ogni revisione. Questi input richiedono più struttura di un singolo prompt per immagini.
Questa guida utilizza una lezione fittizia di basket U14:
controllare le scarpe e fare il riscaldamento prima dell'esercizio
chiamare chiaramente prima di ricevere un passaggio
aiutare un compagno dopo una caduta
ascoltare durante il riepilogo del coach
concludere con una riflessione di squadra
L'obiettivo non è sostituire un coach o una politica locale sulla sicurezza. È creare un breve supporto didattico visivo che un adulto possa rivedere prima della condivisione. La National Youth Sports Strategy degli Stati Uniti identifica lavoro di squadra, leadership, relazioni e qualità della programmazione come risultati significativi dello sport giovanile. Un fumetto può rendere queste aspettative più facili da consultare e discutere.
Abbiamo controllato la pagina live del plugin LlamaGen.AI, la guida di configurazione, la documentazione della Comic API e l'attuale contratto degli strumenti MCP il 13 ottobre 2026. L'MCP ospitato espone quattro strumenti principali:
Tool
Ruolo in questo flusso di lavoro
search_llamagen_docs
Legge la guida aggiornata su configurazione, autenticazione, limiti, webhook e gestione degli errori.
Registro delle modifiche
Accendi i sogni dei più giovani Dove milioni di storie prendono vita
Una panoramica delle ultime funzionalità rilasciate di LlamaGen, dei miglioramenti del prodotto, degli aggiornamenti di design e delle correzioni di bug più importanti.
✦
✧
✦
✧
Un nuovo mezzo per Narrazione
Crea senza limiti storie, fumetti, animazioni, giochi e altro ancora—in pochi secondi, in sintonia con il pubblico moderno
get_comic_api_usage
Controlla il piano LlamaGen.AI e i crediti Comic API rimanenti prima della generazione.
create_comic_generation
Avvia una generazione con un prompt più stile opzionale, numero di pannelli, dimensione e un URL pubblico opzionale di riferimento del personaggio.
get_comic_generation_status
Interroga lo stato della generazione e può ispezionare lo stato della generazione, della pagina o del pannello.
L'attuale strumento di scrittura crea un task di generazione. Non riscrive silenziosamente i file, non pubblica la lezione e non sostituisce un pannello all'interno di una pagina esistente. Il layout finale, i balloon, la sostituzione dei pannelli e l'approvazione avvengono ancora in LlamaGen.AI. Questo confine è utile: Claude Code orchestra e un essere umano approva comunque.
Struttura del progetto
Mantieni la fonte di verità abbastanza piccola da poter essere revisionata:
Pubblico, obiettivo didattico, sequenza approvata, affermazioni vietate e revisore adulto.
cast.md
Fatti visivi stabili per i giocatori ricorrenti e il coach.
style.md
Direzione artistica, linguaggio della camera, ordine dei pannelli, tono adeguato all'età ed esclusioni visive.
scene-plan.json
Il piano approvato pannello per pannello che la generazione deve seguire.
review-checklist.md
Controlli di continuità, leggibilità, attrezzatura sportiva, tutela e policy.
generation-log.md
ID generazione, data, chiamate agli strumenti, risultato, errori e pannelli contrassegnati per la revisione.
Non inserire il token API di LlamaGen in questa cartella. Conservalo nell'ambiente o in un archivio protetto di segreti.
Passo 1: scrivi un brief di produzione, non un paragrafo motivazionale
Usa un lesson.md compatto:
# Fumetto sulla comunicazione nel basket U14
Pubblico: giocatori di età compresa tra 13 e 16 anni
Obiettivo didattico: mostrare che chiamate chiare, supporto ai compagni e riflessione rispettosa
rendono l'allenamento più sicuro e più facile da seguire.
Momenti approvati:
1. Jordan controlla che le scarpe siano allacciate e si unisce al riscaldamento.
2. Jordan alza una mano e chiama prima del passaggio.
3. Jordan riceve il pallone da basket con controllo.
4. Jordan aiuta un compagno ad alzarsi dopo una normale perdita di equilibrio.
5. Il coach adulto guida un riepilogo tranquillo.
6. La squadra indica un'abitudine comunicativa da ripetere.
Vincoli:
- allenamento indoor supervisionato
- nessuna diagnosi o istruzione medica
- nessun riferimento reale a scuola o squadra
- niente umiliazione, punizione o contatto non sicuro
- l'output finale richiede la revisione di un adulto
Questo è abbastanza specifico per la pianificazione visiva, lasciando però le regole locali all'organizzazione reale.
Passo 2: blocca il giocatore ricorrente
Il record del personaggio dovrebbe descrivere solo i fatti che influenzano l'immagine:
# Scheda di continuità di Jordan
Età: 15
Capelli: ricci corti scuri con lati sfumati puliti
Divisa: maglia e pantaloncini da allenamento blu navy semplici, senza logo della squadra
Accessorio distintivo: polsino color corallo al polso sinistro
Scarpe: scarpe da basket alte bianche
Linguaggio del corpo: attento, collaborativo, mai aggressivo
Regole di continuità:
- preservare età, volto, capelli, colore della maglia, lato del polsino e scarpe
- usare un pallone da basket, mai un pallone da calcio
- mantenere il coach adulto visivamente distinto dai giocatori
Se hai un'immagine del personaggio approvata, caricala in una posizione HTTPS pubblica e passala come characterImageUrl. L'attuale MCP accetta un URL pubblico opzionale di riferimento del personaggio.
Passo 3: collega Claude Code a Comic MCP
Crea o ruota un token nelle impostazioni di LlamaGen.AI, quindi registra l'MCP ospitato a livello utente:
export LLAMAGEN_API_TOKEN="<YOUR_LLAMA_GEN_API_TOKEN>"
claude mcp add --scope user --transport http \
--header 'Authorization: Bearer ${LLAMAGEN_API_TOKEN}' \
llamagen https://llamagen.ai/api/mcp
Chiedi a Claude Code di elencare gli strumenti LlamaGen prima di qualsiasi generazione. Se i quattro strumenti principali non compaiono, fermati e correggi endpoint, variabile d'ambiente o header di autorizzazione. Non incollare mai il token in un file della storia, screenshot, prompt o URL pubblico.
Passo 4: fai pianificare Claude Code prima che consumi crediti
Usa questo prompt di progetto:
Read lesson.md, cast.md, style.md, and review-checklist.md.
1. Search the current LlamaGen Comic MCP documentation.
2. Check LlamaGen Comic API usage and report it separately from Claude usage.
3. Build scene-plan.json for one six-panel landscape comic.
4. For every panel include camera distance, action, emotion, background,
continuity anchors, and the teaching purpose.
5. Flag any unsafe, medical, or policy-sensitive statement.
6. Show me the plan and wait for explicit approval.
7. Do not call create_comic_generation until I approve.
Il passaggio di approvazione è importante. Permette a un coach o a un responsabile della comunicazione di correggere la lezione prima che vengano utilizzati i crediti di generazione.
Passo 5: valida scene-plan.json
Un piano utile è abbastanza concreto da poter essere verificato:
{
"audience": "ages 13-16",
"panelCount": 6,
"readingOrder": "left-to-right",
"panels": [
{
"panel": 1,
"camera": "medium-wide",
"action": "Jordan checks tied shoes, then joins the warm-up line",
"continuity": ["navy jersey", "coral left wristband", "white shoes"],
"teachingPurpose": "pre-practice preparation"
},
{
"panel": 4,
"camera": "medium",
"action": "Jordan offers a hand to a teammate after a normal loss of balance",
"continuity": ["same Jordan", "basketball visible", "coach supervising"],
"teachingPurpose": "teammate support"
}
]
}
Prima dell'approvazione, controlla tre livelli:
Storia: ogni pannello fa avanzare un momento visibile?
Sport: pallone, campo, divise e meccaniche del corpo sono plausibili?
Educazione: la lezione prevista può essere compresa senza un paragrafo di spiegazione?
Passo 6: crea e interroga la generazione
Dopo l'approvazione, Claude Code può chiamare create_comic_generation con il seguente contratto:
{
"prompt": "The approved six-panel youth basketball lesson from scene-plan.json",
"style": "bright modern educational graphic novel, clean ink, age-appropriate",
"panelCount": 6,
"size": "16:9",
"characterImageUrl": "https://your-approved-public-reference.example/jordan.webp"
}
characterImageUrl è opzionale. Non inventarne uno. La creazione restituisce un ID generazione; Claude Code dovrebbe salvare quell'ID in output/generation-log.md, interrogare get_comic_generation_status e riportare risorse completate o errori senza esporre il token.
Un log redatto può apparire così:
## Esecuzione della generazione
- Verificato: 2026-10-13
- Server MCP: llamagen
- Input: scene-plan.json approvato
- Pannelli richiesti: 6
- ID generazione: [omesso nella copia pubblica]
- Stato: completed / failed / needs review
- Crediti: copia la risposta d'uso effettiva; non stimare mai
- Revisione: il pannello 4 richiede una correzione di continuità
Passo 7: correggi un pannello senza scartare la pagina
Supponiamo che il pannello 4 cambi il colore della maglia, rimuova il polsino o sostituisca il pallone con quello sbagliato. Conserva i cinque pannelli approvati. Crea un brief di sostituzione del pannello che ripeta solo gli elementi necessari di continuità:
Create one replacement comic panel for panel 4.
Jordan is the same 15-year-old athlete from the approved reference: short dark curls,
plain navy practice jersey, coral wristband on the left wrist, white high-top shoes.
Jordan offers a hand to a teammate after a normal loss of balance.
Keep the same medium camera angle, indoor gym, basketball, pose direction,
adult supervision, bright educational graphic-novel style, and no readable text.
L'attuale MCP crea quella sostituzione come un nuovo task di generazione. Non modifica una pagina esistente sul posto. Rivedi il risultato, poi sostituisci il pannello debole nell'editor di LlamaGen.AI e mantieni invariati gli altri cinque pannelli.
Checklist di revisione per contenuti sportivi giovanili
Prima della pubblicazione, chiedi a un revisore adulto di confermare che:
i personaggi sembrino adeguati all'età e siano fittizi o usati con consenso
la lezione corrisponda alle regole e alla terminologia attuali del programma
il coach rimanga visibilmente responsabile della supervisione
nessun pannello fornisca consigli medici, riabilitativi o di ritorno al gioco
attrezzatura e dettagli del campo corrispondano allo sport
il contatto fisico e i gesti non normalizzino comportamenti non sicuri
lo stesso giocatore mantenga lo stesso volto, divisa, polsino e scarpe
l'ordine dei pannelli sia evidente su telefono e su un volantino stampato
didascalie e balloon siano leggibili e accessibili
la risorsa finale non contenga dati privati dei giocatori, segreti o marchi non autorizzati
Modalità di errore comuni
Claude Code non vede strumenti LlamaGen
Conferma che l'endpoint sia https://llamagen.ai/api/mcp, che il token sia disponibile per il processo di Claude Code e che l'header di autorizzazione sia presente. Poi elenca di nuovo gli strumenti prima di generare.
La sequenza sembra entusiasmante ma non insegna nulla
Torna a teachingPurpose in scene-plan.json. Ogni pannello dovrebbe mostrare un comportamento, una conseguenza, una decisione o una riflessione. Rimuovi l'azione decorativa che compete con la lezione.
Il giocatore cambia tra i pannelli
Riduci il record di continuità agli elementi più visibili e ripetili in ogni pannello pertinente. Usa un'immagine di riferimento pubblica approvata quando disponibile.
Un pannello è sbagliato
Non rigenerare tutti e sei per impostazione predefinita. Scrivi un brief di sostituzione per il pannello fallito, preservane camera e contesto, genera la sostituzione e scambiala nell'editor.
FAQ
Claude Code può creare un fumetto completo tramite LlamaGen.AI?
Claude Code può organizzare file, pianificare pagine, chiamare l'attuale Comic MCP e interrogare le generazioni. LlamaGen.AI esegue la generazione visiva e fornisce la superficie di editing. Per un libro più lungo, lavora pagina per pagina e mantieni un record del personaggio approvato.
L'MCP può modificare direttamente un pannello esistente?
L'attuale strumento di scrittura crea una generazione di fumetto. Per un pannello difettoso, crea una sostituzione mirata come nuovo task, ispezionala e sostituisci il pannello nell'editor di LlamaGen.AI.
L'utilizzo di Claude include i crediti di generazione LlamaGen.AI?
No. Claude gestisce la propria conversazione del modello e il lavoro sui file. I crediti Comic API di LlamaGen.AI pagano la generazione del fumetto. Controlla entrambi separatamente prima di un batch.
Un fumetto AI è sufficiente per l'istruzione sulla sicurezza nello sport?
No. Trattalo come un supporto comunicativo revisionato. Un adulto qualificato deve confermare il contenuto finale rispetto ai requisiti attuali di squadra, scuola, lega e contesto locale. Non usare fumetti generati come guida medica o per il ritorno al gioco.
Costruisci la prima lezione revisionata
Il modello utile è semplice: file sorgente, vincoli espliciti, un piano di pannelli approvato, una chiamata di generazione, un ID generazione salvato e una correzione mirata. Questo rende Claude Code un operatore di progetto invece che un improvvisatore di prompt.
