Sfondi con Codex: la ricetta gratis, senza chiave API

codex exec con lo strumento immagini integrato, la foto e due sfondi approvati come riferimento;
la trappola di -i che si mangia l'argomento successivo. In CLAUDE.md: la prossima volta si lancia
da qui senza chiedere la chiave.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UdeKd62opy9PKgpQXtVctF

CLAUDE.md

@@ -20,3 +20,5 @@ i suoi ricordi: non inventare persone, luoghi o fatti del paese al posto suoi; p
 - Pubblicare (tag/bump/push) solo quando Andrea lo chiede.
 - Persone vere nel gioco solo con consenso; niente nomi, personaggi o musiche di giochi esistenti.
 - Prompt delle immagini in `prompts/` e fogli grezzi in `assets/raw/`: esclusi da git.
+- Sfondi nuovi: li genera **Codex** con il suo strumento immagini integrato, gratis e senza chiave API
+  (`codex exec`, ricetta in `docs/GENERAZIONE_SFONDI.md`, «Generare con Codex»). Si lancia da qui, senza chiedere la chiave ad Andrea.

docs/GENERAZIONE_SFONDI.md

@@ -24,6 +24,32 @@ Foto, prompt e risultati intermedi sono esclusi da Git, secondo le convenzioni
 del progetto. Per trasferire il lavoro su un altro computer servono anche queste
 cartelle locali: il solo repository non include le foto e i prompt specifici.
 
+## Generare con Codex (la strada normale: gratis)
+
+Dal 23 ottobre 2026 gli sfondi si fanno con lo **strumento immagini integrato di Codex**, che non usa
+l'API e non costa niente. Serve solo il prompt in `prompts/backgrounds/<nome-foto>.txt`, scritto come gli
+altri. `tools/genera.py` e `OPENAI_API_KEY` restano per quando Codex non basta (sotto, «Installazione»).
+La prima volta così: l'ingresso della scuola (`assets/generated/scuola-ingresso.png`).
+
+```zsh
+cd ~/Workspaces/misc/LeggendaDelRegolo
+codex exec -C . -s workspace-write -o /tmp/codex-sfondo.txt \
+  "Genera UNO sfondo con il tuo strumento di generazione immagini integrato (non l'API, non tools/genera.py).
+Prompt: unisci, in quest'ordine, prompts/backgrounds/base.txt e prompts/backgrounds/NOME.txt.
+Immagini allegate: la prima è la foto da trasformare; le altre sono sfondi già approvati del gioco, solo come
+riferimento di stile, tavolozza e luce. Formato 16:9 orizzontale, 1536x864 (ridimensiona con
+magick -filter point se esce diverso). Salva come assets/generated/NOME.png (se esiste già, NOME-prova-2.png).
+Non modificare nessun altro file. Alla fine scrivi in italiano il percorso e la dimensione in pixel." \
+  -i assets/raw/foto/NOME.jpg -i assets/scenes/villa-adami.png -i assets/scenes/salita-villa-adami.png \
+  </dev/null
+```
+
+- **Trappola**: `-i` accetta più file e si mangia anche l'argomento che segue. Il prompt va **prima** dei `-i`,
+  e stdin chiuso (`</dev/null`). Con un `-` dopo le immagini Codex risponde «could not read the local image at `-`».
+- Lanciarlo in background: ci mette qualche minuto. Il risultato finisce anche in
+  `~/.codex/generated_images/<sessione>/`.
+- Poi, come sempre: confronto con la foto, `make background SRC=assets/generated/NOME.png` e la scena in `story.js`.
+
 ## Installazione
 
 Python 3.10 o successivo: