> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuración

> Cómo configurar el comportamiento de Devin CLI con archivos de configuración

Devin CLI se configura mediante archivos JSON (con soporte para comentarios) a nivel de usuario y de proyecto. Estos archivos de configuración controlan el modelo del agente, los permisos, los servidores MCP y mucho más.

***

<div id="config-file-locations">
  ## Ubicaciones de los archivos de configuración
</div>

<Tabs>
  <Tab title="Configuración de usuario">
    **Ruta:** `~/.config/devin/config.json`

    Tus ajustes personales predeterminados que se aplican a todos los proyectos. Aquí puedes establecer tu modelo, tema y permisos globales preferidos.

    También puedes colocar un archivo `AGENTS.md` en este directorio (`~/.config/devin/AGENTS.md`) para definir [reglas globales](/es/cli/extensibility/rules#global-rules) que se apliquen a todos los proyectos.

    <Note>
      En Windows, esta ruta es `%APPDATA%\devin\config.json` (normalmente `C:\Users\<you>\AppData\Roaming\devin\config.json`).
    </Note>

    ```json theme={null}
    {
      "agent": { "model": "claude-sonnet-4.5" },
      "permissions": {
        "allow": ["Read(**)", "Exec(git)"]
      }
    }
    ```
  </Tab>

  <Tab title="Configuración del proyecto">
    **Ruta:** `.devin/config.json` (en la raíz de tu proyecto)

    Configuración compartida del equipo incluida en el control de versiones. Úsala para servidores MCP específicos del proyecto, políticas de permisos y ajustes de importación.

    ```json theme={null}
    {
      "permissions": {
        "allow": ["Exec(npm run)", "Read(src/**)"],
        "deny": ["Exec(sudo)"]
      },
      "mcpServers": {
        "github": {
          "command": "npx",
          "args": ["-y", "@modelcontextprotocol/server-github"]
        }
      }
    }
    ```
  </Tab>

  <Tab title="Anulaciones locales">
    **Ruta:** `.devin/config.local.json`

    Anulaciones personales para este proyecto que no se incluyen en git (git las ignora automáticamente). Úsalas para secretos, claves de API y anulaciones de preferencias personales.

    ```json theme={null}
    {
      "mcpServers": {
        "github": {
          "env": { "GITHUB_TOKEN": "ghp_your_token" }
        }
      }
    }
    ```
  </Tab>
</Tabs>

***

<div id="what-you-can-configure">
  ## Qué puedes configurar
</div>

<CardGroup cols={2}>
  <Card title="Modelo" icon="brain" href="/es/cli/models">
    Elige qué modelo de IA impulsa al agente, desde Claude Opus hasta GPT 5.2 o Gemini 3.
  </Card>

  <Card title="Permisos" icon="shield" href="/es/cli/reference/permissions">
    Aprueba de antemano las acciones seguras, bloquea las peligrosas y controla lo que el agente puede hacer sin pedir permiso.
  </Card>

  <Card title="Servidores MCP" icon="server" href="/es/cli/extensibility/mcp/configuration">
    Conecta servidores de herramientas externas para GitHub, Linear, bases de datos y cualquier API personalizada.
  </Card>

  <Card title="Importación de herramientas externas" icon="arrow-right-to-bracket" href="/es/cli/extensibility/rules">
    Importa reglas, skills y configuración desde Cursor, Windsurf y Claude Code.
  </Card>
</CardGroup>

***

<div id="quick-start">
  ## Inicio rápido
</div>

La forma más rápida de empezar es crear un archivo `.devin/config.json` en la raíz de tu proyecto:

```json theme={null}
{
  "permissions": {
    "allow": [
      "Read(**)",
      "Exec(git)",
      "Exec(npm run)"
    ]
  }
}
```

Esto aprueba de antemano la lectura de archivos y los comandos habituales para que el agente no te pida permiso para cada acción.

<Tip>
  También puedes configurar Devin CLI de forma interactiva: cuando el agente te pida permiso, elige guardar la decisión en la configuración de tu proyecto o de usuario para la próxima vez.
</Tip>

***

<div id="project-vs-user-settings">
  ## Settings del proyecto frente a Settings de usuario
</div>

No todos los Settings están disponibles en todos los niveles. Las configuraciones del proyecto (`.devin/config.json` y `.devin/config.local.json`) admiten:

* **`permissions`** — reglas de permitir, denegar y preguntar
* **`mcpServers`** — definiciones de servidores MCP
* **`read_config_from`** — importar Settings de Cursor, Windsurf y Claude
* **`hooks`** — hooks del ciclo de vida ([consulta Hooks](/es/cli/extensibility/hooks/overview))

Todos los demás Settings — incluidos `agent` (modelo), `theme_mode`, `unicode_mode`, `show_path`, `sandbox` y otras opciones de visualización y comportamiento — son **solo de configuración de usuario** y solo pueden establecerse en la configuración de usuario (`~/.config/devin/config.json`; `%APPDATA%\devin\config.json` en Windows).

***

<div id="configuration-precedence">
  ## Precedencia de la configuración
</div>

Para las Settings que admiten múltiples niveles, prevalecen las fuentes de mayor prioridad:

| Prioridad    | Fuente                                                                            | ¿Compartida?          |
| ------------ | --------------------------------------------------------------------------------- | --------------------- |
| 1 (más alta) | Settings de organización / equipo                                                 | Sí (enterprise)       |
| 2            | Autorizaciones de sesión (aprobaciones interactivas)                              | No (en memoria)       |
| 3            | Local del proyecto (`.devin/config.local.json`)                                   | No (ignorado por Git) |
| 4            | Proyecto (`.devin/config.json`)                                                   | Sí (versionado)       |
| 5 (más baja) | Usuario (`~/.config/devin/config.json`; `%APPDATA%\devin\config.json` en Windows) | No (personal)         |

Los permisos se combinan entre niveles, mientras que los servidores MCP se combinan por nombre (para servidores con el mismo nombre, prevalece la fuente de mayor prioridad).

<Note>
  Las Settings de nivel de organización (enterprise) **nunca** pueden ser sobrescritas por la configuración del proyecto o del usuario. Consulta [Precedencia de la configuración](/es/cli/reference/configuration/global-vs-local) para obtener todos los detalles sobre cómo funciona la combinación.
</Note>

***

<div id="limitations">
  ## Limitaciones
</div>

<Warning>
  Devin CLI no admite archivos `.codeiumignore`. Si usas el autocompletado de Codeium y tienes configurados patrones de exclusión, esos patrones no se aplicarán a Devin CLI.
</Warning>

***

<div id="learn-more">
  ## Más información
</div>

<CardGroup cols={2}>
  <Card title="Referencia completa de la configuración" icon="file-code" href="/es/cli/reference/configuration/config-file">
    Lista completa de las opciones de configuración y su formato.
  </Card>

  <Card title="Precedencia de la configuración" icon="layer-group" href="/es/cli/reference/configuration/global-vs-local">
    Cómo interactúan y se combinan las Settings globales, del proyecto y locales.
  </Card>
</CardGroup>