Archivo de configuración

Devin CLI usa archivos JSON (con compatibilidad con comentarios) para la configuración. Esta página documenta todas las opciones disponibles.

Ubicaciones de archivos

Archivo	Propósito
`~/.config/devin/config.json`	Configuración global del usuario
`.devin/config.json`	Configuración del proyecto (versionada)
`.devin/config.local.json`	Anulaciones locales del proyecto (ignoradas por Git)
`~/.config/devin/mcp_config.json`	Servidores MCP globales del usuario
`.devin/mcp_config.json`	Servidores MCP del proyecto (versionados)
`.devin/mcp_config.local.json`	Servidores MCP locales del proyecto (ignorados por Git)
Archivo de políticas del sistema	Configuración para toda la máquina, gestionada por administradores (`system.json`)

En Windows, las rutas de configuración del usuario son %APPDATA%\devin\config.json y %APPDATA%\devin\mcp_config.json (p. ej., C:\Users\<you>\AppData\Roaming\devin\config.json), no ~\.config\devin\.

Los servidores MCP se trasladaron a los archivos dedicados mcp_config.json en v3000.3 (la versión Local 3.6). Las versiones anteriores los almacenan en la clave mcpServers de los archivos de configuración principales; las versiones más recientes migran automáticamente al inicio cualquier entrada de mcpServers que encuentren allí. Consulte mcpServers.

Referencia completa de la configuración

Configuración de usuario
Configuración del proyecto

// ~/.config/devin/config.json
{
  // Comportamiento del agente
  "agent": {
    "model": "swe-1-6-fast",           // Modelo predeterminado
    "show_history_on_continue": true  // Mostrar mensajes al reanudar
  },

  // Tema
  "theme_mode": null,            // "light", "dark", "terminal-dark", "terminal-light", "nocolor" o null (automático)

  // Permisos
  "permissions": {
    "allow": [],
    "deny": [],
    "ask": []
  },

  // Visualización
  "show_path": false,             // Mostrar el CWD en el borde del campo de entrada
  "unicode_mode": "auto",         // "auto", "unicode" o "ascii"
  "show_hints": true,             // Mostrar sugerencias entre turnos

  // Autocompletado de archivos
  "include_gitignored_files": false, // Incluir archivos ignorados por git en los autocompletados con @

  // Acceso a archivos
  "respect_gitignore": false,        // Bloquear el acceso de las herramientas a rutas ignoradas por git

  // Atribución de commits y PR
  "attribution": true,            // Agregar "Generated with Devin" / Co-Authored-By a los commits y PR

  // Subagentes
  "subagents_enabled": true,      // Permitir que el agente cree subagentes

  // Anulaciones de combinaciones de teclas, agrupadas por contexto y luego por acción
  "keymap": {
    "global": { "clear_screen": "ctrl-shift-k" }
  },

  // Actualizaciones
  "auto_update": true,            // Instalar nuevas versiones en segundo plano

  // Anulaciones de combinaciones de teclas (contexto -> acción -> especificación(es) de tecla)
  "keymap": {},

  // Notificaciones
  "notify": "smart",              // "never" | "smart" | "always" — notificaciones de la terminal

  // Configuración del proxy para el tráfico HTTP de la CLI
  "proxy": {
    "mode": "system",           // "system" | "manual" | "off"
    "url": null,                // URL del proxy (obligatoria para el modo manual)
    "no_proxy": null            // Lista de exclusión separada por comas
  },

  // Filtrado de red del sandbox
  "sandbox": {
    "allowed_domains": [],       // Lista de permitidos (vacío = sin filtrado)
    "denied_domains": [],        // Lista de denegación (tiene prioridad)
    "network_mode": "full"       // "full" o "limited" (solo GET/HEAD/OPTIONS)
  },

  // Importar configuración de otras herramientas
  "read_config_from": {
    "cursor": true,
    "windsurf": true,
    "claude": true
  }
}

// .devin/config.json
{
  // Permisos
  "permissions": {
    "allow": [],
    "deny": [],
    "ask": []
  },

  // Importar configuración de otras herramientas
  "read_config_from": {
    "cursor": true,
    "windsurf": true,
    "claude": true
  }
}

Referencia de opciones

Las opciones marcadas con solo para el usuario solo pueden configurarse en el archivo de configuración del usuario (~/.config/devin/config.json; %APPDATA%\devin\config.json en Windows). Solo permissions, read_config_from y hooks están disponibles en las configuraciones de proyecto. mcpServers también puede configurarse en ambos niveles, pero se encuentra en los archivos dedicados mcp_config.json (consulta mcpServers).

agent (solo para el usuario)

Opción	Tipo	Predeterminado	Descripción
`model`	string	`"swe-1-6-fast"`	Modelo de IA predeterminado
`show_history_on_continue`	boolean	`true`	Muestra los mensajes anteriores al reanudar una sesión

theme_mode (solo para el usuario)

Valor	Comportamiento
`null`	Detección automática (pregunta en la primera ejecución)
`"light"`	Tema claro
`"dark"`	Tema oscuro
`"terminal-dark"`	Tema oscuro cuantizado a 16 colores ANSI (respeta el esquema de colores del terminal)
`"terminal-light"`	Tema claro cuantizado a 16 colores ANSI (respeta el esquema de colores del terminal)
`"nocolor"`	Salida sin color (monocroma, útil para terminales VT100)

permisos

Consulta Permisos para obtener la documentación completa.

{
  "permissions": {
    "allow": ["Read(**)", "Exec(git)"],
    "deny": ["Exec(sudo)"],
    "ask": ["Write(**/.env*)"]
  }
}

mcpServers

Mapa que relaciona el nombre del servidor con su configuración. Admite tanto comandos locales (stdio) como servidores HTTP remotos. Consulta MCP Configuration. Desde la v3000.3 (la versión Local 3.6), los servidores MCP se encuentran en archivos dedicados: ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json en Windows), .devin/mcp_config.json y .devin/mcp_config.local.json. En versiones anteriores, la clave mcpServers se encuentra directamente en los archivos de configuración principales; las versiones más recientes la migran automáticamente a los archivos dedicados al iniciarse.

// mcp_config.json
{
  "mcpServers": {
    "server-name": {
      "command": "executable",
      "args": ["arg1", "arg2"],
      "env": { "KEY": "value" }
    },
    "remote-server": {
      "url": "https://mcp.example.com/mcp",
      "transport": "http"
    }
  }
}

show_path (solo para el usuario)

Muestra la ruta del directorio de trabajo actual en el borde del campo de entrada. Cuando está habilitado, el borde superior del cuadro de entrada muestra tu CWD en un formato legible (p. ej., ~/projects/my-app).

Valor	Comportamiento
`false`	Oculto (predeterminado)
`true`	Muestra la ruta del CWD en el borde del campo de entrada

unicode_mode (solo para el usuario)

Controla si la UI del terminal utiliza símbolos Unicode o alternativas compatibles con ASCII. Establécelo en "ascii" si tu terminal o la fuente no muestran correctamente los glifos Unicode (p. ej., si el símbolo ⏺ aparece como un recuadro).

Valor	Comportamiento
`"auto"`	Detecta la compatibilidad con Unicode según el Environment (predeterminado)
`"unicode"`	Usa siempre símbolos Unicode
`"ascii"`	Usa siempre caracteres compatibles con ASCII

show_hints (solo para el usuario)

Muestra consejos ocasionales entre turnos (p. ej., “¿Sabías que…? Usa /model para cambiar entre los modelos disponibles”). Es útil para descubrir funciones de la CLI; establécelo en false para ocultarlos cuando ya te hayas familiarizado.

Valor	Comportamiento
`true`	Muestra consejos ocasionalmente (predeterminado)
`false`	No muestra nunca consejos

include_gitignored_files (solo para el usuario)

Incluye archivos ignorados por Git en los resultados de autocompletado de la pestaña @. Cuando está habilitado, los archivos que coincidan con los patrones de .gitignore aparecerán en las sugerencias de mención con @. Esto resulta útil si almacenas documentación u otros archivos en directorios ignorados por Git que quieres consultar.

Valor	Comportamiento
`false`	Excluye los archivos ignorados por Git de las sugerencias de autocompletado (predeterminado)
`true`	Incluye los archivos ignorados por Git en las sugerencias de `@`

respect_gitignore (solo para el usuario)

Controla si el agente respeta .gitignore al leer o escribir archivos mediante herramientas. Cuando está habilitado, se bloquean las llamadas a herramientas que acceden a rutas ignoradas por Git. Esto es independiente de include_gitignored_files, que solo afecta al autocompletado de la pestaña @.

Valor	Comportamiento
`false`	El agente puede acceder a todos los archivos independientemente de `.gitignore` (predeterminado)
`true`	Bloquea el acceso de las herramientas a rutas ignoradas por Git

attribution (solo para el usuario)

Controla si el agente agrega la atribución de Devin a los commits y las pull requests que crea. Cuando está habilitado, los cuerpos de los commits y las PR incluyen una línea Generated with [Devin] y un pie Co-Authored-By: Devin. Establécelo en false para omitir ambas, de modo que no se agregue ninguna atribución de Devin.

Valor	Comportamiento
`true`	Agrega la línea `Generated with [Devin]` y el pie `Co-Authored-By` a los commits y las PR (predeterminado)
`false`	Omite toda atribución de Devin de los commits y las PR

subagents_enabled (solo para el usuario)

Controla si el agente puede delegar trabajo en subagentes. Cuando esta opción está deshabilitada, se eliminan las herramientas run_subagent y read_subagent, por lo que el agente realiza todo el trabajo por sí mismo. Los cambios en esta configuración se aplican en tiempo real: una sesión en ejecución los adopta sin necesidad de reiniciarse.

Valor	Comportamiento
`true`	El agente puede crear subagentes (predeterminado)
`false`	Los subagentes están deshabilitados para este usuario

La política de la organización tiene prioridad: si un Admin ha deshabilitado los subagentes para tu organización (mediante la configuración Default subagent model), los subagentes permanecerán deshabilitados independientemente de esta configuración.

keymap (solo para el usuario)

Anule los atajos de teclado integrados de la CLI. Esta sección es una tabla de contextos (global, editor, input, list, …), donde cada contexto asigna nombres de acciones a las teclas que las activan. Las acciones que no incluya conservarán sus valores predeterminados integrados.

{
  "keymap": {
    "global": {
      "clear_screen": "ctrl-shift-k",
      "history_search": ["ctrl-r", "f3"]
    },
    "editor": {
      "beginning_of_line": "home"
    }
  }
}

Valor	Significado
`"ctrl-shift-k"`	Una sola especificación de tecla asignada a la acción
`["ctrl-r", "f3"]`	Varias especificaciones de tecla; cualquiera de ellas activa la acción
`[]`	Desasigna la acción

Una especificación de tecla es una lista de modificadores (ctrl, alt, shift) separados por -, seguida de un nombre de tecla (un carácter o una tecla con nombre, como enter, esc, tab, home, page-up, f5). El orden de los modificadores no importa y la coincidencia no distingue entre mayúsculas y minúsculas, excepto que un único carácter en mayúscula asigna la tecla con Shift ("K" equivale a "shift-k").

Ejecuta /shortcuts para ver todas las acciones con su identificador context.action —los mismos identificadores que se usan aquí— y reasignarlas de forma interactiva. Las asignaciones que configures allí se guardan en esta sección.

global.cancel (Ctrl+C) no se puede desasignar, por lo que siempre puedes interrumpir un agente en ejecución. Al iniciar, se informan las entradas no válidas, los contextos o acciones desconocidos y las anulaciones que entren en conflicto con otro atajo en el mismo contexto; en esos casos, se usa el valor predeterminado integrado.

auto_update (solo para el usuario)

Controla la actualización automática en segundo plano en macOS y Linux. Cuando está habilitada, las nuevas versiones se descargan y activan mientras Devin CLI está en ejecución, de modo que la siguiente vez que se invoque devin se use automáticamente la versión más reciente. La sesión actualmente en ejecución no se ve afectada: cambiar el enlace simbólico current solo surte efecto en el siguiente inicio. La actualización está diseñada para ser segura ante interrupciones: cada paso en el sistema de archivos se prepara en una ruta temporal y se aplica mediante un cambio de nombre atómico, y las actualizaciones concurrentes se serializan con un bloqueo de archivo. Si sales a mitad de la actualización, la instalación no quedará en un estado dañado; simplemente volverá a iniciarse con la versión anterior. Solo se aplica a instalaciones autogestionadas (curl | bash en macOS/Linux). Las instalaciones incluidas con otro producto (p. ej., Windsurf) ignoran esta configuración y se actualizan a través de la aplicación principal.

Valor	Comportamiento
`true`	Descarga e instala nuevas versiones en segundo plano (predeterminado)
`false`	Solo comprueba si hay nuevas versiones; instálalas manualmente con `/update`

keymap (solo para el usuario)

Anula los atajos de teclado. Las anulaciones se agrupan primero por contexto y luego por acción: el identificador context.action que se muestra para cada atajo en /shortcuts (p. ej., editor.insert_newline):

{
  "keymap": {
    "global": {
      "clear_screen": "ctrl-shift-k",
      "history_search": ["ctrl-r", "f5"],
      "feedback_up": []
    },
    "editor": {
      "insert_newline": ["shift-enter", "alt-enter", "ctrl-j"]
    }
  }
}

Valor	Comportamiento
`"<spec>"`	Asocia la acción a una sola tecla
`["<spec>", ...]`	Asocia la acción a varias teclas (todas la activan)
`[]`	Desasocia la acción

Las anulaciones sustituyen por completo las opciones predeterminadas integradas de esa acción; las acciones no incluidas conservan sus valores predeterminados. No se puede desasociar Ctrl+C (cancelar). Las entradas no válidas (nombres desconocidos, especificaciones de teclas incorrectas, valores de tipo incorrecto o anulaciones que entran en conflicto con otra asociación en el mismo contexto) se notifican como advertencias al iniciar y se omiten; el resto de la configuración se sigue aplicando. Una especificación de tecla consta de cero o más modificadores separados por -, seguidos de un nombre de tecla (p. ej., ctrl-shift-p, alt-enter, f5, K). Modificadores: ctrl/control/c, alt/meta/option/opt/m, shift/s. Teclas con nombre: enter, esc, tab, backspace, delete, insert, up, down, left, right, home, end, page-up, page-down, space, f1–f24. Cualquier otro carácter individual asocia esa tecla (distingue entre mayúsculas y minúsculas: K asocia Mayús+K); use - para la tecla de signo menos (ctrl--). También puede reasignar teclas de forma interactiva: en /shortcuts, pulse Enter en una fila de atajo y luego pulse la nueva tecla; el cambio se guarda en esta sección keymap. Consulte Personalización de asignaciones de teclas.

notify

Controla las notificaciones del terminal cuando el agente termina o necesita intervención del usuario. La CLI escribe un carácter BEL (activa la campana del terminal o una alerta visual), una secuencia de escape OSC 9 (activa una notificación del sistema en iTerm2 y terminales compatibles) y una secuencia OSC 777 (notificación de escritorio en rxvt-unicode y otros terminales). Los terminales que no reconocen estas secuencias simplemente las ignoran.

Valor	Comportamiento
`"never"`	Sin notificaciones
`"smart"`	Notifica solo cuando la ventana del terminal no está enfocada (usa informes de foco de OSC) (predeterminado)
`"always"`	Notifica en cada evento aplicable, independientemente del foco

read_config_from

Controla la importación de configuraciones de otras herramientas de IA:

Opción	Tipo	Predeterminado	Descripción
`cursor`	boolean/null	`true`	Importar desde `.cursor/rules/`
`windsurf`	boolean/null	`true`	Importar desde `.windsurf/rules/`
`claude`	boolean/null	`true`	Importar desde `.claude/`

Establece el valor en false para deshabilitar una importación específica. null se interpreta como true.

proxy (solo para el usuario)

Configura cómo la CLI enruta su propio tráfico saliente HTTP/HTTPS (llamadas a la API, actualizaciones, servidores MCP, etc.). Esto no afecta a la conectividad de red de los procesos hijo del sandbox (consulta sandbox más abajo). El campo mode selecciona la estrategia de proxy:

Modo	Comportamiento
`"system"` (predeterminado)	Tiene en cuenta las variables de entorno (`HTTP_PROXY`, `HTTPS_PROXY`, `ALL_PROXY`) y la PAC (configuración automática de proxy) nativa de la plataforma en macOS y Windows
`"manual"`	Enruta todo el tráfico de la CLI a través de la `url` especificada
`"off"`	Se conecta directamente — sin proxy

Opción	Tipo	Predeterminado	Descripción
`mode`	string	`"system"`	Estrategia de proxy: `"system"`, `"manual"` o `"off"`
`url`	string/null	`null`	URL del proxy. Obligatoria cuando `mode` es `"manual"`. Admite los esquemas `http://`, `https://` y `socks5://`
`no_proxy`	string/null	`null`	Lista de hosts/dominios separados por comas que evitan el proxy. Usa la misma sintaxis que la variable de entorno `NO_PROXY` (p. ej., `"localhost,127.0.0.1,.corp.example.com"`). Se aplica en cualquier modo

Ejemplo — proxy corporativo:

{
  "proxy": {
    "mode": "manual",
    "url": "http://proxy.corp.example.com:8080",
    "no_proxy": "localhost,127.0.0.1,.internal.corp"
  }
}

Ejemplo — desactivar el proxy:

{
  "proxy": {
    "mode": "off"
  }
}

Los administradores pueden establecer el mismo bloque proxy en el archivo de configuración del sistema de toda la máquina. La configuración Enterprise tiene precedencia, y configurar un proxy en ambos archivos es un error; elimina la sección proxy de tu configuración de usuario si tu organización la gestiona.

sandbox (solo para el usuario)

El filtrado de red del sandbox es actualmente inestable. Si necesitas esta función, ponte en contacto con el representante de tu cuenta para conocer los plazos de estabilidad.

Configura el filtrado de red a nivel de dominio para el sandbox. Cuando --sandbox está activo y el filtrado de dominios está configurado, se inicia un proxy de red gestionado en loopback, y el sandbox obliga a que todo el tráfico de los procesos hijos se enrute a través de él.

Para obtener una visión completa de cómo funciona el sandbox, incluida la aplicación en Enterprise y cómo interactúan las configuraciones de Enterprise y del usuario, consulta la documentación de Sandbox.

La marca --sandbox aplica las rutas con permiso de escritura y las reglas deny a nivel del sistema operativo. Las raíces con permiso de escritura se derivan de los ámbitos Write(...) concedidos más los directorios del espacio de trabajo; todo lo demás es legible, excepto las rutas ocultas por las reglas de denegación Read(...). Los ámbitos Write(...) concedidos durante la sesión expanden dinámicamente el sandbox para los comandos posteriores.

Si se pasa --sandbox pero falla la resolución del sandbox (p. ej., las herramientas de aislamiento no están disponibles en la plataforma actual), la CLI se negará a iniciarse en lugar de ejecutarse sin sandbox. Este comportamiento de cierre ante fallos garantiza que la intención de seguridad de --sandbox nunca se omita silenciosamente.

Opción	Tipo	Predeterminado	Descripción
`allowed_domains`	string[]	`[]`	Patrones de dominio permitidos a través del proxy. Cuando no está vacío, solo se permiten los dominios coincidentes (modo de lista de permitidos)
`denied_domains`	string[]	`[]`	Patrones de dominio siempre bloqueados. Las reglas de denegación tienen prioridad sobre las reglas de permiso
`network_mode`	string	`"full"`	`"full"` permite todos los métodos HTTP; `"limited"` permite solo GET/HEAD/OPTIONS

Sintaxis de patrones de dominio:

Patrón	Coincide con
`example.com`	Solo coincidencia exacta
`*.example.com`	Cualquier subdominio (no el dominio raíz)
`**.example.com`	El dominio raíz y cualquier subdominio

Ejemplo:

{
  "sandbox": {
    "allowed_domains": [
      "github.com",
      "**.npmjs.org",
      "**.crates.io",
      "**.pypi.org"
    ],
    "denied_domains": ["evil.example.com"],
    "network_mode": "full"
  }
}

El filtrado de dominios se aplica cuando el sandbox está activo (--sandbox). Sin --sandbox, se ignora la sección de sandbox.

En los equipos Enterprise, los Admin pueden anular las listas de dominios mediante Team Settings. Las listas de permitidos de Enterprise prevalecen (reemplazan tu allowed_domains local), mientras que las listas de denegación de Enterprise son aditivas (se combinan con tu denied_domains local).

JSON con comentarios

Los archivos de configuración admiten comentarios al estilo de JavaScript:

{
  // Comentarios de línea
  "agent": {
    "model": "sonnet"  // Comentarios en línea
  },
  /* Comentarios
     en bloque */
  "permissions": {}
}

Primeros pasos

Integraciones del Editor

Extensibilidad

Enterprise

Referencia

Registro de cambios

Archivo de configuración

Ubicaciones de archivos

Referencia completa de la configuración

Referencia de opciones

agent (solo para el usuario)

theme_mode (solo para el usuario)

permisos

mcpServers

show_path (solo para el usuario)

unicode_mode (solo para el usuario)

show_hints (solo para el usuario)

include_gitignored_files (solo para el usuario)

respect_gitignore (solo para el usuario)

attribution (solo para el usuario)

subagents_enabled (solo para el usuario)

keymap (solo para el usuario)

auto_update (solo para el usuario)

keymap (solo para el usuario)

notify

read_config_from

proxy (solo para el usuario)

sandbox (solo para el usuario)

JSON con comentarios

​Ubicaciones de archivos

​Referencia completa de la configuración

​Referencia de opciones

​agent (solo para el usuario)

​theme_mode (solo para el usuario)

​permisos

​mcpServers

​show_path (solo para el usuario)

​unicode_mode (solo para el usuario)

​show_hints (solo para el usuario)

​include_gitignored_files (solo para el usuario)

​respect_gitignore (solo para el usuario)

​attribution (solo para el usuario)

​subagents_enabled (solo para el usuario)

​keymap (solo para el usuario)

​auto_update (solo para el usuario)

​keymap (solo para el usuario)

​notify

​read_config_from

​proxy (solo para el usuario)

​sandbox (solo para el usuario)

​JSON con comentarios

Ubicaciones de archivos

Referencia completa de la configuración

Referencia de opciones

agent (solo para el usuario)

theme_mode (solo para el usuario)

permisos

mcpServers

show_path (solo para el usuario)

unicode_mode (solo para el usuario)

show_hints (solo para el usuario)

include_gitignored_files (solo para el usuario)

respect_gitignore (solo para el usuario)

attribution (solo para el usuario)

subagents_enabled (solo para el usuario)

keymap (solo para el usuario)

auto_update (solo para el usuario)

keymap (solo para el usuario)

notify

read_config_from

proxy (solo para el usuario)

sandbox (solo para el usuario)

JSON con comentarios