Impostazioni avanzate

La maggior parte delle impostazioni si trova nella pagina Impostazioni dell'app. Questa pagina copre quelle che non ci sono: le chiavi che scrivi a mano in un file di configurazione e le variabili d'ambiente che l'harness legge. Le chiavi che hanno una pagina propria — provider, memoria, sincronizzazione, plugin — sono elencate qui in breve, con un link a quella pagina.

Dove stanno le impostazioni

FileAmbito
~/.oharness/config.jsonTu, su questo computer. Tutte le chiavi qui sotto possono stare qui.
oharness.config.json (o .oharness.json) in un progettoChiunque apra quel progetto.

Il file del progetto viene unito sopra il tuo, quindi un progetto può restringere o regolare ciò che hai impostato. Alcune chiavi sono escluse di proposito dal file di progetto, perché un repository che cloni non dovrebbe poterle decidere al posto tuo:

  • team: quali crediti vengono spesi
  • sync.url, sync.token, sync.team: dove finiscono le tue trascrizioni
  • runtimePlugins: codice che gira sul tuo computer
  • l'attivazione dell'estrazione o dell'unione automatica della memoria, che consuma il tuo credito del modello. Un progetto può invece disattivarle.

OHARNESS_HOME sposta l'intera directory ~/.oharness. Vedi File di configurazione per gli altri file che contiene.

{
  "model": "sonnet",
  "smallModel": "haiku",
  "permissionMode": "auto",
  "permissions": { "deny": ["Bash(git push --force*)"] },
  "writableRoots": ["~/scratch"],
  "maxTurns": 100,
  "sessionRetention": { "maxAgeDays": 90 }
}

Modelli

ChiaveCosa fa
modelIl modello con cui partono le nuove conversazioni, per id o alias.
smallModelIl modello per i lavori che non richiedono quello principale: i riepiloghi della compattazione del contesto, l'estrazione della memoria, le attività in background come i titoli e il revisore della modalità auto. Se non è impostato, questi usano il modello della conversazione stessa, che può costare molto più del necessario.
thinkingRagionamento predefinito: { "enabled": true, "effort": "high" }. effort viene adattato a ciò che il modello supporta. budgetTokens vale per i modelli che accettano un budget di token. display è "summarized" o "omitted".
cacheCaching dei prompt dove il provider lo supporta. Attivo per impostazione predefinita.
models, providers, catalog, openAiCompatible, oauthProvidersAggiungono o sostituiscono modelli e provider. Vedi Provider e modelli.

Imposta smallModel. La modalità auto lo chiama prima di ogni azione che esamina, e la compattazione lo chiama nelle conversazioni lunghe. Un modello veloce ed economico rende entrambe più rapide e ne tiene basso il costo. Se l'id non può essere risolto, l'harness registra un avviso e ripiega sul modello della conversazione.

Permessi

ChiaveCosa fa
permissionModeLa modalità con cui partono le nuove conversazioni: default, acceptEdits, plan, auto o bypassPermissions.
permissionsRegole allow, ask e deny. Una regola deny batte ogni modalità, Bypass compresa.
workspaceModeDove possono finire le scritture: read-only, workspace-write (predefinito: il progetto più writableRoots) o full-access. Controlla gli argomenti degli strumenti; non è una sandbox del sistema operativo.
writableRootsAltre directory in cui l'agente può scrivere.
readableRootsAltre directory che l'agente può leggere ma non scrivere.
auditConserva un registro di ogni decisione sui permessi insieme alla sua sessione. Attivo a meno che non sia impostato a false.
auditLogAggiunge anche ogni decisione a questo file, per un'esecuzione non presidiata il cui registro va raccolto.

Permessi spiega le modalità, la sintassi delle regole e come decide il revisore della modalità auto.

Turni e istruzioni

ChiaveCosa fa
maxTurnsQuante chiamate al modello può richiedere un prompt prima che l'agente si fermi e riferisca. Predefinito 60.
systemPromptSostituisce il prompt di sistema integrato. Raramente è ciò che vuoi.
appendSystemPromptTesto aggiunto dopo il prompt di sistema integrato.
instructionsFileUn file di istruzioni del progetto diverso da quello predefinito, relativo alla radice del progetto.

Strumenti ed estensioni

ChiaveCosa fa
tools{ "allow": [...], "deny": [...] } per nome dello strumento. Funzionano i glob come mcp__github__*. deny si applica dopo allow. Uno strumento escluso qui non viene mai offerto al modello, a differenza di una regola di permesso, che rifiuta la chiamata quando viene fatta.
browser{ "mode": "auto" } (predefinito) lascia scegliere all'agente tra il tuo browser, tramite l'estensione, e uno integrato. builtin, extension o off lo fissano.
claudeAgentOffre il tuo Claude Code come sub-agente e come @claude, pagato dal tuo piano Claude. Disattivato a meno che non sia impostato a true.
importsLegge le skill, gli agenti e i server MCP di Claude Code e di Codex da dove si trovano. Entrambi attivi a meno che non sia impostato a false.
skillDirs, agentDirsAltre directory in cui cercare skill e definizioni di sub-agenti.
disabledSkillsSkill disattivate per nome.
mcpServers, hooks, subagents, plugins, runtimePluginsVedi Plugin.
schedulesPrompt eseguiti secondo una pianificazione cron.

Sessioni e worktree

ChiaveCosa fa
sessionDirDove vengono conservate sessioni e trascrizioni. Il predefinito è storage/ in ~/.oharness. Indicare un'altra directory parte da zero: nulla di ciò che è registrato nella posizione predefinita viene importato.
sessionRetention{ "maxAgeDays": 90, "keep": 500 } elimina le sessioni più vecchie all'avvio. Non viene eliminato nulla se non lo imposti.
worktreePreparare un nuovo worktree git. copy elenca percorsi o glob copiati dal progetto quando il worktree ne è privo (predefinito .env*). setup è un comando shell eseguito nel nuovo worktree, come npm ci.
memory, syncVedi Memoria e sincronizzazione.

Fatturazione e log

ChiaveCosa fa
teamAddebita l'utilizzo del piano ufficiale ai crediti di un team invece che ai tuoi. Il servizio verifica che tu faccia parte del team. Ammesso nella tua configurazione o in OHARNESS_TEAM, mai in un file di progetto.
logLeveldebug, info, warn, error o silent.

Variabili d'ambiente

Una variabile d'ambiente sostituisce la chiave di configurazione corrispondente, dove esiste.

VariabileCosa fa
OHARNESS_HOMEUsa un'altra directory al posto di ~/.oharness.
OHARNESS_TEAMCome team.
OHARNESS_SYNC0, false, off o no disattiva la sincronizzazione qualunque cosa dica la configurazione.
OHARNESS_SYNC_TOKENCredenziale di sincronizzazione, quando non è nella configurazione.
OHARNESS_SITE_URLUn indirizzo Cloud self-hosted o di sviluppo.
OHARNESS_CATALOGUsa questo file come catalogo dei modelli.
OHARNESS_NO_BUILTIN_MODELS1 esclude il catalogo dei modelli incluso, così restano solo le tue voci.
OHARNESS_NO_CLAUDE_AGENT1 non offre mai Claude Code come sub-agente.
OHARNESS_BROWSER_PATHIl binario di Chrome o Chromium che il browser integrato avvia.
OHARNESS_BROWSER_HEADLESS0 dà al browser integrato una finestra visibile.
OHARNESS_CLAUDE_HOME, OHARNESS_CODEX_HOMEDove leggere i file di Claude Code e di Codex, quando non sono nella posizione abituale.