Ajustes avanzados

La mayoría de los ajustes están en la página de ajustes de la aplicación. Esta página trata los que no están ahí: las claves que escribes a mano en un archivo de configuración y las variables de entorno que lee el harness. Las claves que tienen su propia página —proveedores, memoria, sincronización, plugins— se mencionan aquí brevemente, con un enlace a esa página.

Dónde se guardan los ajustes

ArchivoAlcance
~/.oharness/config.jsonTú, en este equipo. Todas las claves de abajo pueden ir aquí.
oharness.config.json (o .oharness.json) en un proyectoTodos los que abren ese proyecto.

El archivo del proyecto se combina por encima del tuyo, así que un proyecto puede endurecer o ajustar lo que tú defines. Algunas claves se excluyen a propósito del archivo de proyecto, porque un repositorio que clonas no debería poder decidirlas por ti:

  • team: qué créditos se gastan
  • sync.url, sync.token, sync.team: adónde van tus transcripciones
  • runtimePlugins: código que se ejecuta en tu equipo
  • activar la extracción o la fusión automática de memoria, que gasta tu crédito de modelo. Un proyecto sí puede desactivarlas.

OHARNESS_HOME traslada todo el directorio ~/.oharness. Consulta Archivos de configuración para los demás archivos que contiene.

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

Modelos

ClaveQué hace
modelEl modelo con el que empiezan las conversaciones nuevas, por id o alias.
smallModelEl modelo para las tareas que no necesitan el principal: resúmenes de compactación del contexto, extracción de memoria, tareas en segundo plano como los títulos y el revisor del modo auto. Si no se define, usan el modelo de la propia conversación, que puede ser mucho más caro de lo necesario.
thinkingRazonamiento predeterminado: { "enabled": true, "effort": "high" }. effort se ajusta a lo que admite el modelo. budgetTokens se aplica a los modelos que aceptan un presupuesto de tokens. display es "summarized" u "omitted".
cacheCaché de prompts cuando el proveedor la admite. Activada por defecto.
models, providers, catalog, openAiCompatible, oauthProvidersAñaden o sustituyen modelos y proveedores. Consulta Proveedores y modelos.

Define smallModel. El modo auto lo llama antes de cada acción que revisa, y la compactación lo llama en las conversaciones largas. Un modelo rápido y barato hace ambas cosas más ágiles y mantiene bajo su coste. Si el id no se puede resolver, el harness registra una advertencia y vuelve al modelo de la conversación.

Permisos

ClaveQué hace
permissionModeEl modo en que empiezan las conversaciones nuevas: default, acceptEdits, plan, auto o bypassPermissions.
permissionsReglas allow, ask y deny. Una regla deny gana a todos los modos, incluido Bypass.
workspaceModeDónde pueden caer las escrituras: read-only, workspace-write (predeterminado: el proyecto más writableRoots) o full-access. Comprueba los argumentos de las herramientas; no es un sandbox del sistema operativo.
writableRootsMás directorios en los que el agente puede escribir.
readableRootsMás directorios que el agente puede leer pero no escribir.
auditGuarda un registro de cada decisión de permisos junto con su sesión. Activado salvo que se defina como false.
auditLogAdemás, añade cada decisión a este archivo, para una ejecución desatendida cuyo registro haya que recopilar.

Permisos explica los modos, la sintaxis de las reglas y cómo decide el revisor del modo auto.

Turnos e instrucciones

ClaveQué hace
maxTurnsCuántas llamadas al modelo puede consumir un prompt antes de que el agente se detenga e informe. Por defecto, 60.
systemPromptSustituye el prompt de sistema integrado. Rara vez es lo que quieres.
appendSystemPromptTexto que se añade después del prompt de sistema integrado.
instructionsFileUn archivo de instrucciones del proyecto distinto del predeterminado, relativo a la raíz del proyecto.

Herramientas y extensiones

ClaveQué hace
tools{ "allow": [...], "deny": [...] } por nombre de herramienta. Funcionan patrones como mcp__github__*. deny se aplica después de allow. Una herramienta que se excluye aquí nunca se ofrece al modelo, a diferencia de una regla de permisos, que rechaza la llamada cuando se hace.
browser{ "mode": "auto" } (predeterminado) deja que el agente elija entre tu navegador, a través de la extensión, y uno integrado. builtin, extension u off lo fijan.
claudeAgentOfrece tu propio Claude Code como subagente y como @claude, pagado con tu plan de Claude. Desactivado salvo que se defina como true.
importsLee las skills, los agentes y los servidores MCP de Claude Code y de Codex desde donde están. Ambos activados salvo que se defina como false.
skillDirs, agentDirsMás directorios en los que buscar skills y definiciones de subagentes.
disabledSkillsSkills desactivadas por nombre.
mcpServers, hooks, subagents, plugins, runtimePluginsConsulta Plugins.
schedulesPrompts que se ejecutan según una programación cron.

Sesiones y worktrees

ClaveQué hace
sessionDirDónde se guardan las sesiones y las transcripciones. Por defecto, storage/ en ~/.oharness. Indicar otro directorio empieza de cero: no se importa nada de lo registrado en la ubicación predeterminada.
sessionRetention{ "maxAgeDays": 90, "keep": 500 } elimina las sesiones más antiguas al arrancar. No se elimina nada a menos que lo definas.
worktreePreparar un worktree de git nuevo. copy enumera rutas o patrones que se copian del proyecto cuando el worktree no los tiene (por defecto .env*). setup es un comando de shell que se ejecuta en el worktree nuevo, como npm ci.
memory, syncConsulta Memoria y sincronización.

Facturación y registros

ClaveQué hace
teamCarga el uso del plan oficial a los créditos de un equipo en lugar de a los tuyos. El servicio comprueba que perteneces al equipo. Se admite en tu propia configuración o en OHARNESS_TEAM, nunca en un archivo de proyecto.
logLeveldebug, info, warn, error o silent.

Variables de entorno

Una variable de entorno sustituye a la clave de configuración correspondiente, cuando la hay.

VariableQué hace
OHARNESS_HOMEUsa otro directorio en lugar de ~/.oharness.
OHARNESS_TEAMIgual que team.
OHARNESS_SYNC0, false, off o no desactiva la sincronización diga lo que diga la configuración.
OHARNESS_SYNC_TOKENCredencial de sincronización, cuando no está en la configuración.
OHARNESS_SITE_URLUna dirección de Cloud autoalojada o de desarrollo.
OHARNESS_CATALOGUsa este archivo como tu catálogo de modelos.
OHARNESS_NO_BUILTIN_MODELS1 excluye el catálogo de modelos incluido, de modo que solo quedan tus propias entradas.
OHARNESS_NO_CLAUDE_AGENT1 nunca ofrece Claude Code como subagente.
OHARNESS_BROWSER_PATHEl binario de Chrome o Chromium que inicia el navegador integrado.
OHARNESS_BROWSER_HEADLESS0 da al navegador integrado una ventana visible.
OHARNESS_CLAUDE_HOME, OHARNESS_CODEX_HOMEDónde leer los archivos de Claude Code y de Codex, cuando no están en el lugar habitual.