Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

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:
PrioridadFuenteNotas
1 (máxima)Settings de la organización / del equipoNo se puede sobrescribir
2Sesión (aprobaciones interactivas)Solo en memoria
3Proyecto local (.devin/config.local.json)Personal, ignorado por Git
4Proyecto (.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)"]
  }
}
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"]
    }
  }
}
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.
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

No todos los Settings se pueden definir a nivel de proyecto. Las configuraciones del proyecto (.devin/config.json y .devin/config.local.json) admiten lo siguiente:
SettingConfiguración de usuarioConfiguración de proyecto
permissions✓✓
mcpServers✓✓
read_config_from✓✓
hooks✓✓
agent (modelo)✓✗
theme_mode✓✗
unicode_mode✓✗
show_path✓✗
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

ArchivoEncontrado por¿Compartido?
~/.config/devin/config.jsonRuta XDGNo
.devin/config.jsonBuscando hacia arriba desde cwdSí (versionado)
.devin/config.local.jsonBuscando hacia arriba desde cwdNo (ignorado por Git)
.devin/skills/*/SKILL.mdRaíz del proyectoSí (versionado)
~/.config/devin/skills/*/SKILL.mdRuta XDGNo
AGENTS.mdRaíz del proyectoSí (versionado)
~/.config/devin/AGENTS.mdRuta XDGNo
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\).