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.

Localização dos arquivos de configuração

Configuração do usuário
Configuração do projeto
Overrides locais

Caminho: ~/.config/devin/config.jsonSuas 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 que se aplicam a todos os projetos.

No Windows, este caminho é %APPDATA%\devin\config.json (normalmente C:\Users\<you>\AppData\Roaming\devin\config.json).

{
  "agent": { "model": "claude-sonnet-4.5" },
  "permissions": {
    "allow": ["Read(**)", "Exec(git)"]
  }
}

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.

{
  "permissions": {
    "allow": ["Exec(npm run)", "Read(src/**)"],
    "deny": ["Exec(sudo)"]
  },
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    }
  }
}

Caminho: .devin/config.local.jsonOverrides 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.

{
  "mcpServers": {
    "github": {
      "env": { "GITHUB_TOKEN": "ghp_your_token" }
    }
  }
}

O que você pode configurar

Modelo

Escolha qual modelo de IA será usado pelo agente — de Claude Opus a GPT 5.2 e Gemini 3.

Permissões

Aprove previamente ações seguras, bloqueie as perigosas e controle o que o agente pode fazer sem pedir confirmação.

Servidores MCP

Conecte servidores de ferramentas externos para GitHub, Linear, bancos de dados e APIs personalizadas.

Importações de ferramentas externas

Importe regras, skills e configurações do Cursor, Windsurf e Claude Code.

Primeiros passos

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

{
  "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.

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.

Configurações de projeto vs. do usuário

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)

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

Precedência de configuração

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

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 para ver todos os detalhes sobre como a mesclagem funciona.

Limitações

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.

Localização dos arquivos de configuração

O que você pode configurar

Modelo

Permissões

Servidores MCP

Importações de ferramentas externas

Primeiros passos

Configurações de projeto vs. do usuário

Precedência de configuração

Limitações

Saiba mais

Referência completa da configuração

Precedência de configuração

​Localização dos arquivos de configuração

​O que você pode configurar

Modelo

Permissões

Servidores MCP

Importações de ferramentas externas

​Primeiros passos

​Configurações de projeto vs. do usuário

​Precedência de configuração

​Limitações

​Saiba mais

Referência completa da configuração

Precedência de configuração

Localização dos arquivos de configuração

O que você pode configurar

Primeiros passos

Configurações de projeto vs. do usuário

Precedência de configuração

Limitações

Saiba mais