Skip to main content
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: Si la misma configuración se define en varios niveles, prevalece la fuente de mayor prioridad.
Los servidores MCP siguen la misma precedencia, pero se encuentran en archivos específicos en cada nivel: ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json en Windows), .devin/mcp_config.json y .devin/mcp_config.local.json. En las versiones de la CLI anteriores a v3000.3 (la versión Local 3.6), los servidores MCP se almacenan en la clave mcpServers de los archivos config.json; las versiones más recientes los migran automáticamente a los archivos específicos al iniciarse.

​
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
Path: .devin/config.jsonÚsalo para estándares del equipo registrados en el repositorio. Solo permissions, read_config_from y hooks están disponibles en .devin/config.json; los servidores MCP se configuran en el archivo .devin/mcp_config.json:
  • Servidores MCP compartidos (con configuración no secreta, en .devin/mcp_config.json)
  • Políticas de permisos del equipo
  • Configuración de importación
  • Hooks del ciclo de vida
Path: .devin/config.local.jsonÚsalo para anulaciones personales que no deberían versionarse:
  • Claves de API y secretos (los servidores MCP se configuran en .devin/mcp_config.local.json)
  • Preferencias personales de herramientas para este proyecto
  • Anulaciones de permisos
Los archivos de configuración local se excluyen automáticamente de git mediante .git/info/exclude.
La gestiona el admin de tu empresa a través del panel de configuración del equipo. Estos ajustes no pueden ser objeto de anulación 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 (mcpServers se encuentra en los archivos dedicados mcp_config.json de cada nivel, no en config.json): 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

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\).