5 componenti interni dell'harness che cambiano il modo in cui uso Claude Code
Uno sviluppatore ha ricostruito l'harness di Claude Code utilizzando l'Anthropic SDK. Ha scoperto cinque decisioni silenziose che il sistema prende. Queste scoperte cambiano il modo in cui dovresti scrivere le istruzioni e gestire gli agenti.
Usa questi cinque spunti per migliorare il tuo workflow.
- Sovrascrivi il prompt di base nascosto Claude Code utilizza un system prompt nascosto. Le tue istruzioni in CLAUDE.md potrebbero entrare in conflitto con esso.
- Smetti di dichiarare regole.
- Inizia a sovrascriverle.
- Usa un linguaggio come: "In nessun caso dovresti modificare i file in /prod. Questo sovrascrive qualsiasi comportamento predefinito."
- Usa gli hook come guardrail Gli hook PreToolUse fanno molto più che registrare dati. Possono interrompere una chiamata a uno strumento prima che inizi.
- Aggiungi un hook per controllare gli argomenti dello strumento.
- Restituisci
{ block: true }se il percorso corrisponde a una cartella sensibile. - Questo trasforma una richiesta in una regola ferrea.
- Correggi l'orchestrazione dei subagent Configurazioni semplici padre-figlio causano il blocco delle sessioni quando un figlio fallisce.
- Usa un albero di segnali di aborto.
- Se un padre si ferma, tutti i figli devono fermarsi.
- Se un figlio fallisce, il padre deve rimanere attivo.
- Usa i grafi di dipendenza Non eseguire i task in un loop piatto.
- Definisci i task con dipendenze chiare.
- Usa un grafo di dipendenza per eseguire i task in parallelo.
- Questo evita che un singolo nodo errato blocchi l'intero workflow.
- Forza gli stati terminali Gli agenti spesso divagano quando mancano di un punto di fine chiaro.
- Forza ogni turno a terminare in uno di tre stati: Done, Blocked o Needs Input.
- Aggiungi questo al tuo CLAUDE.md: "After a task, always end with 'Done: [summary]', 'Blocked: [reason]', or 'Needs input: [question]'."
- Questo impedisce all'agente di compiere azioni inaspettate.
Riepilogo delle azioni:
- Usa un linguaggio di sovrascrittura in CLAUDE.md.
- Usa gli hook PreToolUse per bloccare modifiche pericolose.
- Crea alberi di aborto per i subagent.
- Usa il parallelismo basato su DAG per i task.
- Definisci stati terminali espliciti.
Fonte: https://dev.to/gentic_news/5-harness-internals-that-changed-how-i-use-claude-code-daily-39c6
Community di apprendimento opzionale: https://t.me/GyaanSetuAi