> ## 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.

# Configuração

> Como configurar o comportamento do Devin CLI com arquivos de configuração

O Devin CLI é configurado por meio de arquivos JSON (com suporte a comentários) em nível de usuário e de projeto. Esses arquivos de configuração controlam o modelo do agente, as permissões, os servidores MCP e muito mais.

***

<div id="config-file-locations">
  ## Localização dos arquivos de configuração
</div>

<Tabs>
  <Tab title="Configuração do usuário">
    **Caminho:** `~/.config/devin/config.json`

    Suas configurações padrão pessoais, aplicadas a todos os projetos. É aqui que você define seu modelo, tema e permissões globais preferidos.

    Você também pode colocar um arquivo `AGENTS.md` neste diretório (`~/.config/devin/AGENTS.md`) para definir [regras globais](/pt-BR/cli/extensibility/rules#global-rules) que se aplicam a todos os projetos.

    <Note>
      No Windows, este caminho é `%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="Configuração do projeto">
    **Caminho:** `.devin/config.json` (na raiz do seu projeto)

    Configuração compartilhada pela equipe e versionada no controle de versão. Use isso para servidores MCP específicos do projeto, políticas de permissão e configurações de importação.

    ```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="Overrides locais">
    **Caminho:** `.devin/config.local.json`

    Overrides pessoais para este projeto que não são comitados no git (ignorados automaticamente pelo git). Use isso para segredos, chaves de API e overrides de preferências pessoais.

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

***

<div id="what-you-can-configure">
  ## O que você pode configurar
</div>

<CardGroup cols={2}>
  <Card title="Modelo" icon="brain" href="/pt-BR/cli/models">
    Escolha qual modelo de IA será usado pelo agente — de Claude Opus a GPT 5.2 e Gemini 3.
  </Card>

  <Card title="Permissões" icon="shield" href="/pt-BR/cli/reference/permissions">
    Aprove previamente ações seguras, bloqueie as perigosas e controle o que o agente pode fazer sem pedir confirmação.
  </Card>

  <Card title="Servidores MCP" icon="server" href="/pt-BR/cli/extensibility/mcp/configuration">
    Conecte servidores de ferramentas externos para GitHub, Linear, bancos de dados e APIs personalizadas.
  </Card>

  <Card title="Importações de ferramentas externas" icon="arrow-right-to-bracket" href="/pt-BR/cli/extensibility/rules">
    Importe regras, skills e configurações do Cursor, Windsurf e Claude Code.
  </Card>
</CardGroup>

***

<div id="quick-start">
  ## Primeiros passos
</div>

A forma mais rápida de começar é criar um `.devin/config.json` na raiz do seu projeto:

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

Isso aprova previamente leituras de arquivos e comandos comuns para que o agente não solicite sua aprovação a cada ação.

<Tip>
  Você também pode configurar o Devin CLI de forma interativa: quando o agente pedir permissão, escolha salvar a decisão nas configurações do projeto ou do usuário para a próxima vez.
</Tip>

***

<div id="project-vs-user-settings">
  ## Configurações de projeto vs. do usuário
</div>

Nem todas as configurações estão disponíveis em todos os níveis. As configurações do projeto (`.devin/config.json` e `.devin/config.local.json`) oferecem suporte a:

* **`permissions`** — regras de permitir, negar e pedir confirmação
* **`mcpServers`** — definições de servidor MCP
* **`read_config_from`** — importar configurações do Cursor, Windsurf e Claude
* **`hooks`** — hooks de ciclo de vida ([veja Hooks](/pt-BR/cli/extensibility/hooks/overview))

Todas as outras configurações — incluindo `agent` (modelo), `theme_mode`, `unicode_mode`, `show_path`, `sandbox` e outras opções de exibição e comportamento — são **exclusivas da configuração do usuário** e só podem ser definidas na configuração do usuário (`~/.config/devin/config.json`; `%APPDATA%\devin\config.json` no Windows).

***

<div id="configuration-precedence">
  ## Precedência de configuração
</div>

Para configurações compatíveis com vários níveis, as origens de maior prioridade prevalecem:

| Prioridade     | Origem                                                                            | Compartilhado?          |
| -------------- | --------------------------------------------------------------------------------- | ----------------------- |
| 1 (mais alta)  | Configurações da organização / equipe                                             | Sim (enterprise)        |
| 2              | Autorizações de sessão (aprovações interativas)                                   | Não (em memória)        |
| 3              | Projeto local (`.devin/config.local.json`)                                        | Não (ignorado pelo Git) |
| 4              | Projeto (`.devin/config.json`)                                                    | Sim (comitado)          |
| 5 (mais baixa) | Usuário (`~/.config/devin/config.json`; `%APPDATA%\devin\config.json` no Windows) | Não (pessoal)           |

As permissões são mescladas entre os níveis, enquanto os servidores MCP são mesclados por nome (a origem de maior prioridade prevalece para servidores com o mesmo nome).

<Note>
  As configurações no nível da organização (enterprise) **nunca** podem ser substituídas pela configuração do projeto ou do usuário. Consulte [Precedência de configuração](/pt-BR/cli/reference/configuration/global-vs-local) para ver todos os detalhes sobre como a mesclagem funciona.
</Note>

***

<div id="limitations">
  ## Limitações
</div>

<Warning>
  Devin CLI não oferece suporte a arquivos `.codeiumignore`. Se você usa o preenchimento automático do Codeium e configurou padrões de exclusão, esses padrões não se aplicarão ao Devin CLI.
</Warning>

***

<div id="learn-more">
  ## Saiba mais
</div>

<CardGroup cols={2}>
  <Card title="Referência completa da configuração" icon="file-code" href="/pt-BR/cli/reference/configuration/config-file">
    Lista completa de todas as opções de configuração e seus formatos.
  </Card>

  <Card title="Precedência de configuração" icon="layer-group" href="/pt-BR/cli/reference/configuration/global-vs-local">
    Como as configurações globais, do projeto e locais interagem e fazem merge.
  </Card>
</CardGroup>