CLACOROO
EN IT
Scarica

Editor CLAUDE.md

CLAUDE.md è un file Markdown in chiaro che Claude Code carica nel contesto della conversazione per insegnare all’assistente le tue preferenze, convenzioni e vincoli. Puoi avere un file globale (~/.claude/CLAUDE.md) che si applica a ogni sessione, e uno per-progetto (<progetto>/CLAUDE.md) che si applica solo dentro una cartella.

CLACOROO ti permette di modificare entrambi i tipi inline dalla pagina Impostazioni, senza uscire dall’app.

Panoramica

Le righe CLAUDE.md in Impostazioni mostrano:

  • CLAUDE.md globale — ~/.claude/CLAUDE.md, si applica a ogni sessione Claude Code
  • CLAUDE.md di progetto — una riga per ogni cartella progetto che hai aggiunto a CLACOROO; ogni riga mostra il nome del progetto e il path del file

Ogni riga ha un bottone Modifica che apre un modal di editor inline. Il modal ha una textarea pre-popolata col contenuto attuale del file, bottoni Salva e Annulla, e il path completo del file in cima per chiarezza.

Cosa mostra

Path consentiti

Per sicurezza, l’editor apre solo file che matchano una whitelist nota di path:

  • ~/.claude/CLAUDE.md (globale)
  • <radice-progetto>/CLAUDE.md per i progetti che CLACOROO conosce

Tentare di aprire qualsiasi altro path viene rifiutato con un errore chiaro. Questo previene un misclick accidentale dall’aprire file arbitrari.

Comportamento dell’editor

  • Read all’apertura: CLACOROO legge il file da disco ogni volta che clicchi Modifica, così editi sempre la versione corrente
  • Write atomico al Salva: file temporaneo + rename, così il file non resta mai a metà se l’app crasha durante la scrittura
  • Annulla scarta le tue edit in memoria e chiude il modal senza toccare il disco
  • Il modal non blocca nulla: se il file cambia su disco mentre stai editando, il prossimo salva sovrascriverà. Aggiorna prima se sospetti un conflitto.

Markdown in chiaro, niente anteprima

L’editor è una textarea semplice — niente anteprima live, niente syntax highlighting (il file è Markdown, ma leggerlo è meglio nel tuo editor reale). L’intento è fare modifiche piccole e mirate (aggiungi una regola, sistema un typo, ritocca una riga). Per modifiche profonde, usa Apri in VS Code dalla stessa riga.

Operazioni comuni

Come modificare il CLAUDE.md globale

  1. Apri Impostazioni in CLACOROO
  2. Trova la riga CLAUDE.md globale
  3. Clicca Modifica
  4. Fai modifiche nella textarea
  5. Clicca Salva — CLACOROO scrive il file in modo atomico
  6. Apri una sessione Claude Code: il nuovo contenuto ha effetto dal prossimo messaggio

Come modificare il CLAUDE.md di un progetto

  1. Aggiungi il progetto a CLACOROO con + Progetto nella topbar
  2. Vai a Impostazioni → sezione CLAUDE.md
  3. Trova la riga di quel progetto
  4. Clicca Modifica e fai le modifiche
  5. Salva — Claude Code caricherà il nuovo contenuto la prossima volta che apre una sessione in quella cartella

Come scartare le modifiche

Mentre sei nel modal editor, clicca Annulla (o premi Esc). Le tue edit in memoria sono scartate e il file su disco resta intoccato.

Come modificare un CLAUDE.md non in whitelist

Se vuoi modificare un file in una cartella che CLACOROO non conosce ancora:

  1. Aggiungi la cartella come Progetto (+ Progetto nella topbar)
  2. Il suo CLAUDE.md (se esiste) appare ora nella lista Impostazioni
  3. Usa l’editor inline come sopra

Oppure semplicemente apri il file nell’editor di tua scelta — CLACOROO non traccia quel file, ma Claude Code lo legge comunque.

Suggerimenti e scorciatoie

  • La textarea supporta indentazione standard con Tab e shortcut della clipboard — niente di fancy, ma basta per ritocchi veloci
  • Il path mostrato in cima al modal è copiabile — utile quando devi incollarlo altrove
  • La descrizione della riga di Impostazioni ti dice se ogni CLAUDE.md esiste o è vuoto/assente — cliccare Modifica su uno mancante lo crea al Salva
  • Mantieni CLAUDE.md corto e focalizzato. Liste di regole lunghe finiscono nel contesto del prompt e costano token.

Casi limite ed errori

  • Errore “Path not allowed”. Stai cercando di modificare un file fuori dalla whitelist (es. un CLAUDE.md in una cartella che CLACOROO non conosce). Aggiungi prima la cartella come Progetto.
  • Salva fallito: permission denied. Il tuo utente non può scrivere il file. Controlla owner/permessi del file in shell.
  • L’editor si apre con contenuto stantio. Clicca Annulla e riapri Modifica — CLACOROO rilegge il file ad ogni apertura.
  • Le mie modifiche non hanno effetto in Claude Code. Claude Code legge CLAUDE.md all’inizio di una sessione e su eventi chiave. Inizia una nuova sessione (o manda un messaggio fresco in una di lungo corso) per esserne sicuro.
  • Conflitto: il file è cambiato su disco mentre editavo. CLACOROO non lo rileva; il prossimo Salva sovrascrive. Se sospetti un’edit parallela, copia le tue modifiche altrove, clicca Annulla, riapri Modifica e fai merge a mano.

Correlati