配置 - 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 服务器

外部工具导入

快速开始

项目设置与用户设置

配置优先级

限制

了解更多

完整配置参考

配置优先级

Documentation Index

​配置文件位置

​你可以配置的内容

模型

权限

MCP 服务器

外部工具导入

​快速开始

​项目设置与用户设置

​配置优先级

​限制

​了解更多

完整配置参考

配置优先级

配置文件位置

你可以配置的内容

快速开始

项目设置与用户设置

配置优先级

限制

了解更多