Precedencia de la configuración

Devin CLI carga la configuración de múltiples fuentes y las combina. Comprender el orden de precedencia te ayuda a definir la configuración adecuada para tu equipo y tus preferencias personales.

Capas de configuración

De mayor a menor prioridad:

Prioridad	Fuente	Notas
1 (máxima)	Settings de la organización / del equipo	No se puede sobrescribir
2	Sesión (aprobaciones interactivas)	Solo en memoria
3	Proyecto local (`.devin/config.local.json`)	Personal, ignorado por Git
4	Proyecto (`.devin/config.json`)	Compartido con el equipo
5 (mínima)	Usuario (`~/.config/devin/config.json`; `%APPDATA%\devin\config.json` en Windows)	Tus valores predeterminados

Si la misma configuración se define en varios niveles, prevalece la fuente de mayor prioridad.

Cuándo usar cada nivel

Configuración de usuario

Path: ~/.config/devin/config.json (%APPDATA%\devin\config.json en Windows)Úsalo para preferencias personales que se aplican en todas partes:

Preferencia de modelo predeterminada
Preferencia de tema
Servidores MCP personales (p. ej., tus propias claves de API)
Permisos globales

{
  "agent": { "model": "opus" },
  "permissions": {
    "allow": ["Read(**)", "Exec(git)"]
  }
}

Configuración del proyecto

Path: .devin/config.jsonÚsalo para estándares del equipo registrados en el repositorio. Solo permissions, mcpServers, read_config_from y hooks están disponibles en este nivel:

Servidores MCP compartidos (con configuración no secreta)
Políticas de permisos del equipo
Configuración de importación
Hooks del ciclo de vida

{
  "permissions": {
    "allow": ["Exec(npm run)", "Read(src/**)"],
    "deny": ["Exec(sudo)"]
  },
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    }
  }
}

Configuración local del proyecto

Path: .devin/config.local.jsonÚsalo para anulaciones personales que no deberían versionarse:

Claves de API y secretos
Preferencias personales de herramientas para este proyecto
Anulaciones de permisos

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_my_personal_token"
      }
    }
  }
}

Los archivos de configuración local se excluyen automáticamente de git mediante .git/info/exclude.

Configuración de la organización

La gestiona el admin de tu empresa a través del panel de configuración del equipo. Estos ajustes no pueden ser anulados por usuarios individuales y aplican políticas para toda la organización, como restricciones de modelos y allowlists de servidores MCP.

Qué está disponible en cada nivel

Las configuraciones del proyecto (.devin/config.json y .devin/config.local.json) solo admiten un subconjunto de los Settings. La tabla siguiente muestra qué Settings están disponibles en cada nivel:

Setting	Configuración de usuario	Configuración de proyecto
`permissions`	✓	✓
`mcpServers`	✓	✓
`read_config_from`	✓	✓
`hooks`	✓	✓
`agent` (modelo)	✓	✗
`theme_mode`	✓	✗
`unicode_mode`	✓	✗
`show_path`	✓	✗
`show_hints`	✓	✗
`include_gitignored_files`	✓	✗
`sandbox`	✓	✗

Los Settings marcados como exclusivos de la configuración de usuario solo se pueden definir en la configuración de usuario (~/.config/devin/config.json; %APPDATA%\devin\config.json en Windows) y no forman parte de la jerarquía de precedencia anterior.

Cómo funciona la fusión

La tabla de precedencia anterior solo se aplica a los Settings que admiten múltiples niveles (permissions, mcpServers, read_config_from, hooks).

Permisos

Las listas de permisos se fusionan (se combinan) entre niveles. Una denegación en un nivel superior no puede ser anulada por un permiso concedido en un nivel inferior. Por ejemplo, si tu organización deniega Exec(sudo), agregar Exec(sudo) a la lista de permisos permitidos de tu usuario no tiene ningún efecto: la denegación de la organización siempre prevalece. Sin embargo, otros permisos, como Read(**) en el nivel de proyecto, se aplican con normalidad.

Servidores MCP

Las configuraciones de los servidores MCP se combinan por nombre. Un servidor definido en un nivel superior anula al servidor con el mismo nombre definido en un nivel inferior. Por ejemplo, si tanto tu configuración de usuario como la configuración del proyecto definen un servidor “GitHub”, prevalece la versión de la configuración del proyecto porque tiene mayor prioridad que la configuración de usuario.

Hooks

Los hooks se recopilan de todas las fuentes y se ejecutan todos. Un hook definido en la configuración del usuario se ejecuta junto con los definidos en la configuración del proyecto; no se sustituyen entre sí.

Detección de la raíz del proyecto

Devin CLI encuentra el directorio raíz de tu proyecto buscando un directorio .git o .jj y subiendo desde tu directorio de trabajo actual. La configuración del proyecto (.devin/) se carga desde el directorio raíz del proyecto.

Si tienes directorios .devin/ anidados (p. ej., en un monorepo), las configuraciones de los subdirectorios tienen prioridad sobre las de los directorios superiores.

Resumen de detección de archivos

Archivo	Encontrado por	¿Compartido?
`~/.config/devin/config.json`	Ruta XDG	No
`.devin/config.json`	Buscando hacia arriba desde `cwd`	Sí (versionado)
`.devin/config.local.json`	Buscando hacia arriba desde `cwd`	No (ignorado por Git)
`.devin/skills/*/SKILL.md`	Raíz del proyecto	Sí (versionado)
`~/.config/devin/skills/*/SKILL.md`	Ruta XDG	No
`AGENTS.md`	Raíz del proyecto	Sí (versionado)
`~/.config/devin/AGENTS.md`	Ruta XDG	No

Windows: Las rutas que se muestran como ~/.config/devin/ usan la convención XDG para Linux/macOS. En Windows, se resuelven como %APPDATA%\devin\ (normalmente C:\Users\<YourUser>\AppData\Roaming\devin\).

​Capas de configuración

​Cuándo usar cada nivel

​Qué está disponible en cada nivel

​Cómo funciona la fusión

​Permisos

​Servidores MCP

​Hooks

​Detección de la raíz del proyecto

​Resumen de detección de archivos

Capas de configuración

Cuándo usar cada nivel

Qué está disponible en cada nivel

Cómo funciona la fusión

Permisos

Servidores MCP

Hooks

Detección de la raíz del proyecto

Resumen de detección de archivos