配置 - Devin Docs

Devin CLI 通过用户级和项目级的 JSON 文件 (支持注释) 进行配置。这些配置文件用于控制 Agent 的模型、权限、MCP 服务器等设置。

配置文件位置

用户配置
项目配置
本地覆盖

路径： ~/.config/devin/config.json适用于所有项目的个人默认配置。你可以在这里设置偏好的模型、主题和全局权限。你也可以在此目录中放置一个 AGENTS.md 文件 (~/.config/devin/AGENTS.md) ，用于定义适用于每个项目的全局规则。

在 Windows 上，此路径为 %APPDATA%\devin\config.json (通常是 C:\Users\<you>\AppData\Roaming\devin\config.json) 。

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

路径： .devin/config.json (位于项目根目录)提交到版本控制的团队共享配置。可用于项目专用的 MCP 服务器、权限策略和导入设置。

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

路径： .devin/config.local.json当前项目的个人覆盖配置，不会提交到 git (会自动被 gitignore 忽略) 。可用于存放 secrets、API keys 和个人偏好覆盖。

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

你可以配置的内容

模型

选择由哪个 AI 模型为 Agent 提供支持——从 Claude Opus 到 GPT 5.2，再到 Gemini 3。

权限

预先批准安全操作，拦截危险操作，并控制 Agent 在无需询问的情况下可以执行哪些操作。

MCP 服务器

连接适用于 GitHub、Linear、数据库及各种自定义 API 的外部工具服务器。

外部工具导入

从 Cursor、Windsurf 和 Claude Code 导入规则、技能和配置。

快速开始

最快的上手方法是在你的项目根目录中创建一个 .devin/config.json：

{
  "permissions": {
    "allow": [
      "Read(**)",
      "Exec(git)",
      "Exec(npm run)"
    ]
  }
}

这会预先批准文件读取和常用命令，这样 Agent 就不用每执行一个操作都向你请求确认。

你也可以通过交互方式配置 Devin CLI：当 Agent 请求权限时，可以选择将该决定保存到项目配置或用户配置中，供下次使用。

项目设置与用户设置

并非所有设置都可在每个层级使用。项目配置 (.devin/config.json 和 .devin/config.local.json) 支持：

permissions — allow、deny 和 ask 规则
mcpServers — MCP 服务器定义
read_config_from — 从 Cursor、Windsurf 和 Claude 导入设置
hooks — 生命周期钩子 (参见 Hooks)

其他所有设置——包括 agent (模型) 、theme_mode、unicode_mode、show_path、sandbox 以及其他显示和行为选项——都仅支持用户配置，只能在用户配置 (~/.config/devin/config.json；Windows 上为 %APPDATA%\devin\config.json) 中设置。

配置优先级

对于支持多层级的设置，以优先级更高的来源为准：

优先级	来源	共享？
1 (最高)	组织 / 团队设置	是 (企业版)
2	会话授予 (交互式批准)	否 (内存中)
3	项目本地 (`.devin/config.local.json`)	否 (被 git 忽略)
4	项目 (`.devin/config.json`)	是 (已提交)
5 (最低)	用户 (`~/.config/devin/config.json`；Windows 上为 `%APPDATA%\devin\config.json`)	否 (个人)

权限会跨层级合并，而 MCP 服务器则按名称合并 (同名服务器以更高优先级的来源为准) 。

组织级 (企业版) 设置绝不会被项目或用户配置覆盖。有关合并方式的完整说明，请参阅配置优先级。

限制

Devin CLI 不支持 .codeiumignore 文件。如果你使用 Codeium 的自动补全功能，并且已配置忽略规则，这些规则将不会对 Devin CLI 生效。

配置

配置文件位置

你可以配置的内容

模型

权限

MCP 服务器

外部工具导入

快速开始

项目设置与用户设置

配置优先级

限制

了解更多

完整配置参考

配置优先级

​配置文件位置

​你可以配置的内容

模型

权限

MCP 服务器

外部工具导入

​快速开始

​项目设置与用户设置

​配置优先级

​限制

​了解更多

完整配置参考

配置优先级

配置文件位置

你可以配置的内容

快速开始

项目设置与用户设置

配置优先级

限制

了解更多