配置文件

Devin CLI 使用 JSON 文件 (支持注释) 进行配置。本页介绍所有可用选项。

文件位置

文件	目的
`~/.config/devin/config.json`	用户级设置
`.devin/config.json`	项目设置 (已提交)
`.devin/config.local.json`	项目本地覆盖设置 (已加入 gitignore)
`~/.config/devin/mcp_config.json`	用户级 MCP 服务器
`.devin/mcp_config.json`	项目 MCP 服务器 (已提交)
`.devin/mcp_config.local.json`	项目本地 MCP 服务器 (已加入 gitignore)
系统策略文件	全系统、由管理员管理的设置 (`system.json`)

在 Windows 上，用户配置文件路径为 %APPDATA%\devin\config.json 和 %APPDATA%\devin\mcp_config.json (例如 C:\Users\<you>\AppData\Roaming\devin\config.json) ，而不是 ~\.config\devin\。

MCP 服务器在 v3000.3 (Local 3.6 版本) 中已移至专用的 mcp_config.json 文件。旧版本会将其存储在主配置文件的 mcpServers 密钥中；新版本会在启动时自动迁移其中找到的所有 mcpServers 条目。请参阅 mcpServers。

完整配置参考

用户配置
项目配置

// ~/.config/devin/config.json
{
  // Agent 行为
  "agent": {
    "model": "swe-1-6-fast",           // 默认模型
    "show_history_on_continue": true  // 恢复时显示消息记录
  },

  // 主题
  "theme_mode": null,            // "light"、"dark"、"terminal-dark"、"terminal-light"、"nocolor" 或 null（自动）

  // 权限
  "permissions": {
    "allow": [],
    "deny": [],
    "ask": []
  },

  // 显示
  "show_path": false,             // 在输入框边框中显示 CWD
  "unicode_mode": "auto",         // "auto"、"unicode" 或 "ascii"
  "show_hints": true,             // 在各轮对话之间显示提示

  // 文件补全
  "include_gitignored_files": false, // 在 @ 补全中包含已加入 gitignore 的文件

  // 文件访问
  "respect_gitignore": false,        // 阻止工具访问已加入 gitignore 的路径

  // 提交与 PR 署名
  "attribution": true,            // 向提交和 PR 添加“Generated with Devin”/ Co-Authored-By

  // 子 Agent
  "subagents_enabled": true,      // 允许 Agent 启动子 Agent

  // 快捷键覆盖，先按上下文再按操作
  "keymap": {
    "global": { "clear_screen": "ctrl-shift-k" }
  },

  // 更新
  "auto_update": true,            // 在后台安装新版本

  // 快捷键覆盖（上下文 -> 操作 -> 按键规范）
  "keymap": {},

  // 通知
  "notify": "smart",              // "never" | "smart" | "always" — 终端通知

  // CLI HTTP 流量的代理设置
  "proxy": {
    "mode": "system",           // "system" | "manual" | "off"
    "url": null,                // 代理 URL（手动模式下必填）
    "no_proxy": null            // 以逗号分隔的不走代理列表
  },

  // 沙盒网络过滤
  "sandbox": {
    "allowed_domains": [],       // 域名允许列表（空 = 不过滤）
    "denied_domains": [],        // 域名拒绝列表（优先）
    "network_mode": "full"       // "full" 或 "limited"（仅限 GET/HEAD/OPTIONS）
  },

  // 从其他工具导入设置
  "read_config_from": {
    "cursor": true,
    "windsurf": true,
    "claude": true
  }
}

// .devin/config.json
{
  // 权限
  "permissions": {
    "allow": [],
    "deny": [],
    "ask": []
  },

  // 从其他工具导入设置
  "read_config_from": {
    "cursor": true,
    "windsurf": true,
    "claude": true
  }
}

选项参考

标记为 仅限用户 的选项只能在用户配置中设置 (~/.config/devin/config.json；Windows 上为 %APPDATA%\devin\config.json) 。项目配置中只有 permissions、read_config_from 和 hooks 可用。mcpServers 也可在两个级别设置，但位于专用的 mcp_config.json 文件中 (请参阅 mcpServers) 。

Agent (仅限用户)

选项	类型	默认值	描述
`model`	string	`"swe-1-6-fast"`	默认 AI 模型
`show_history_on_continue`	boolean	`true`	恢复会话时显示之前的消息记录

theme_mode (仅限用户)

值	行为
`null`	自动检测 (首次运行时会询问)
`"light"`	浅色主题
`"dark"`	深色主题
`"terminal-dark"`	采用 16 色 ANSI 颜色量化的深色主题 (遵循终端配色方案)
`"terminal-light"`	采用 16 色 ANSI 颜色量化的浅色主题 (遵循终端配色方案)
`"nocolor"`	无颜色输出 (单色，适用于 VT100 终端)

权限

完整文档请参阅权限。

{
  "permissions": {
    "allow": ["Read(**)", "Exec(git)"],
    "deny": ["Exec(sudo)"],
    "ask": ["Write(**/.env*)"]
  }
}

mcpServers

服务器名称到服务器配置的映射。支持本地命令 (stdio) 和远程 HTTP 服务器。请参阅 MCP Configuration。自 v3000.3 (Local 3.6 版本) 起，MCP 服务器配置存储在专用文件中：~/.config/devin/mcp_config.json (Windows 上为 %APPDATA%\devin\mcp_config.json) 、.devin/mcp_config.json 和 .devin/mcp_config.local.json。在较早版本中，mcpServers 密钥直接位于主配置文件中；较新版本会在启动时自动将其迁移到专用文件中。

// mcp_config.json
{
  "mcpServers": {
    "server-name": {
      "command": "executable",
      "args": ["arg1", "arg2"],
      "env": { "KEY": "value" }
    },
    "remote-server": {
      "url": "https://mcp.example.com/mcp",
      "transport": "http"
    }
  }
}

show_path (仅限用户)

在输入框边框中显示当前工作目录路径。启用后，输入框上边框会显示美化后的 CWD (例如 ~/projects/my-app) 。

值	行为
`false`	隐藏 (默认)
`true`	在输入框边框中显示 CWD 路径

unicode_mode (仅限用户)

控制终端 UI 使用 Unicode 符号，还是使用兼容 ASCII 的替代字符。如果你的终端或字体无法正确渲染 Unicode 字形 (例如 ⏺ 符号显示为方框) ，请将其设为 "ascii"。

值	行为
`"auto"`	从环境中检测是否支持 Unicode (默认)
`"unicode"`	始终使用 Unicode 符号
`"ascii"`	始终使用兼容 ASCII 的字符

show_hints (仅限用户)

在对话轮次之间偶尔显示提示 (例如“你知道吗：使用 /model 可在可用模型之间切换”) 。有助于你了解 CLI 功能；熟悉后可将其设为 false 以关闭这些提示。

值	行为
`true`	偶尔显示提示 (默认)
`false`	从不显示提示

include_gitignored_files (仅限用户)

在 @ 选项卡补全结果中包含被 Git 忽略的文件。启用后，匹配 .gitignore 规则的文件会出现在 @ 提及补全中。如果你将文档或其他文件存放在被 Git 忽略的目录中，并希望引用它们，此选项会很有用。

值	行为
`false`	从补全中排除被 Git 忽略的文件 (默认)
`true`	在 `@` 补全中包含被 Git 忽略的文件

respect_gitignore (仅限用户)

控制 Agent 在通过工具读取或写入文件时是否遵守 .gitignore。启用后，访问被 .gitignore 忽略路径的工具调用会被阻止。这与 include_gitignored_files 不同，后者仅影响 @ 选项卡补全。

值	行为
`false`	无论 `.gitignore` 如何，Agent 都可以访问所有文件 (默认)
`true`	阻止工具访问被 `.gitignore` 忽略的路径

attribution (仅限用户)

控制 Agent 是否在其创建的提交和拉取请求中添加 Devin 署名。启用后，提交信息和 PR 正文会包含一行 Generated with [Devin] 以及一个 Co-Authored-By: Devin 尾注。将其设为 false 可省略这两项，即不添加任何 Devin 署名。

值	行为
`true`	在提交和 PR 中添加 `Generated with [Devin]` 行以及 `Co-Authored-By` 尾注 (默认)
`false`	不在提交和 PR 中添加任何 Devin 署名

subagents_enabled (仅限用户)

控制 Agent 是否可以将工作交给子 Agent。禁用后，run_subagent 和 read_subagent 工具将被移除，因此 Agent 会自行完成所有工作。更改此设置会立即生效，正在运行的会话无需重启即可采用新设置。

值	行为
`true`	Agent 可以启动子 Agent (默认)
`false`	此用户的子 Agent 已禁用

Organization policy 优先：如果 Admin 已通过 默认子 Agent 模型 设置为你的 org 禁用子 Agent，则无论此设置如何，子 Agent 都会保持禁用状态。

keymap (仅限用户)

覆盖 CLI 的内置键盘快捷键。此部分是一个上下文表 (global、editor、input、list、…) ，每个上下文将操作名称映射到触发相应操作的按键。未列出的操作将保留其内置默认设置。

{
  "keymap": {
    "global": {
      "clear_screen": "ctrl-shift-k",
      "history_search": ["ctrl-r", "f3"]
    },
    "editor": {
      "beginning_of_line": "home"
    }
  }
}

值	含义
`"ctrl-shift-k"`	绑定到该操作的单个按键规范
`["ctrl-r", "f3"]`	多个按键规范，任一按键均可触发该操作
`[]`	解除该操作的绑定

按键规范由通过 - 分隔的修饰键 (ctrl、alt、shift) 和一个按键名称组成 (按键名称可以是单个字符，也可以是 enter、esc、tab、home、page-up、f5 等命名按键) 。修饰键的顺序不限，匹配不区分大小写；但单个大写字符表示绑定带 Shift 的按键 ("K" 等同于 "shift-k") 。

运行 /shortcuts 可查看每个操作及其 context.action 标识符 (即此处使用的标识符) ，并以交互方式重新绑定。你在那里设置的绑定会保存回本节。

global.cancel (Ctrl+C) 无法解除绑定，因此你始终可以中断正在运行的 Agent。无效条目、未知的上下文或操作，以及会与同一上下文中其他快捷键冲突的覆盖项，都会在启动时报告，并回退到内置默认值。

auto_update (仅限用户)

控制 macOS 和 Linux 上的后台自动更新。启用后，Devin CLI 运行期间会在后台下载并启用新版本，因此下次调用 devin 时会自动使用最新版本。当前正在运行的会话不受影响——current 符号链接的切换只会在下次启动时生效。此更新机制可安全应对中断：文件系统的每个步骤都会先暂存到临时路径，再通过原子重命名切换到正式位置；同时，并发更新会通过文件锁按顺序执行。更新过程中即使退出，也不会导致安装损坏——下次启动时仍只会继续使用旧版本。仅适用于自行管理的安装 (macOS/Linux 上通过 curl | bash 安装) 。与其他产品捆绑的安装 (例如 Windsurf) 会忽略此设置，并通过其宿主应用进行更新。

值	行为
`true`	在后台下载并安装新版本 (默认)
`false`	仅检查新版本；通过 `/update` 手动安装

keymap (仅限用户)

覆盖键盘快捷键。覆盖项按 context 和 action 标识；该标识符为 /shortcuts 中每个快捷键显示的 context.action (例如 editor.insert_newline) ：

{
  "keymap": {
    "global": {
      "clear_screen": "ctrl-shift-k",
      "history_search": ["ctrl-r", "f5"],
      "feedback_up": []
    },
    "editor": {
      "insert_newline": ["shift-enter", "alt-enter", "ctrl-j"]
    }
  }
}

值	行为
`"<spec>"`	将 action 绑定到一个按键
`["<spec>", ...]`	将 action 绑定到多个按键 (均可触发)
`[]`	解除 action 的绑定

覆盖会完全替换该 action 的内置默认设置；未列出的 action 将保留默认设置。Ctrl+C (取消) 无法解除绑定。无效条目 (未知名称、无效的按键规范、类型不正确的值，或与同一上下文中其他绑定冲突的覆盖) 会在启动时以警告形式报告并跳过——其余配置仍会生效。按键规范由零个或多个以 - 分隔的修饰键以及一个按键名称组成 (例如 ctrl-shift-p、alt-enter、f5、K) 。修饰键：ctrl/control/c、alt/meta/option/opt/m、shift/s。命名按键：enter、esc、tab、backspace、delete、insert、up、down、left、right、home、end、page-up、page-down、space、f1–f24。其他任何单个字符都会绑定对应的字符键 (区分大小写：K 会绑定 Shift+K) ；减号键请使用 - (ctrl--) 。你也可以交互式地重新绑定：在 /shortcuts 中，选中某个快捷键行后按 Enter，再按下新按键——更改会保存到此 keymap 部分。参见自定义按键绑定。

notify

控制 Agent 完成任务或需要 user 输入时的终端通知。CLI 会写入一个 BEL 字符 (触发终端铃声/可视铃声) 、一个 OSC 9 转义序列 (在 iTerm2 和兼容终端中触发系统通知) ，以及一个 OSC 777 序列 (在 rxvt-unicode 和其他终端中触发桌面通知) 。无法识别这些序列的终端会安全地忽略它们。

Value	Behavior
`"never"`	不通知
`"smart"`	仅在终端窗口未获得焦点时通知 (使用 OSC 焦点报告) (default)
`"always"`	无论是否获得焦点，只要发生符合条件的事件就通知

read_config_from

控制是否从其他 AI 工具的配置中导入：

选项	类型	默认值	说明
`cursor`	boolean/null	`true`	从 `.cursor/rules/` 导入
`windsurf`	boolean/null	`true`	从 `.windsurf/rules/` 导入
`claude`	boolean/null	`true`	从 `.claude/` 导入

设为 false 可禁用某项导入。null 会被视为 true。

proxy (仅限用户)

配置 CLI 如何为自身发出的 HTTP/HTTPS 流量 (API 调用、更新、MCP 服务器等) 选择代理路由。这不会影响沙盒子进程的联网方式 (见下方的 sandbox) 。 mode 字段用于选择代理策略：

Mode	Behavior
`"system"` (default)	遵循环境变量 (`HTTP_PROXY`、`HTTPS_PROXY`、`ALL_PROXY`) ，以及 macOS 和 Windows 上平台原生的 PAC (代理自动配置)
`"manual"`	通过明确指定的 `url` 转发所有 CLI 流量
`"off"`	直接连接——不使用代理

Option	Type	Default	Description
`mode`	string	`"system"`	代理策略：`"system"`、`"manual"` 或 `"off"`
`url`	string/null	`null`	代理 URL。当 `mode` 为 `"manual"` 时为必填。支持 `http://`、`https://` 和 `socks5://` 协议
`no_proxy`	string/null	`null`	不走代理的主机/域名逗号分隔列表。使用与 `NO_PROXY` 环境变量相同的语法 (例如 `"localhost,127.0.0.1,.corp.example.com"`) 。适用于任何模式

示例——企业代理：

{
  "proxy": {
    "mode": "manual",
    "url": "http://proxy.corp.example.com:8080",
    "no_proxy": "localhost,127.0.0.1,.internal.corp"
  }
}

示例——禁用代理：

{
  "proxy": {
    "mode": "off"
  }
}

管理员也可以在适用于整台机器的系统配置文件中设置相同的 proxy 块。Enterprise 设置优先；如果两个文件中都配置了代理，将导致错误——如果你的组织负责管理此设置，请从你的用户配置中移除 proxy 部分。

沙盒 (仅限用户)

沙盒网络过滤目前还不稳定。如果你需要此功能，请联系你的账户代表，了解其稳定性时间表。

为沙盒配置域级网络过滤。启用 --sandbox 且已配置域过滤时，系统会在回环地址上启动一个受管网络代理，沙盒会强制所有子进程的网络流量都经由该代理转发。

如需全面了解沙盒的工作方式——包括企业级强制执行机制，以及企业设置与用户设置如何交互——请参阅沙盒文档。

--sandbox 标志会在操作系统层面强制执行可写路径和 deny 规则。可写根目录根据已授予的 Write(...) 作用域以及工作区目录派生而来；除此之外的所有路径均可读，但被 Read(...) 拒绝规则隐藏的路径除外。在会话中途授予的 Write(...) 作用域会动态扩展沙盒，使其对后续命令生效。

如果传入了 --sandbox，但沙盒初始化失败 (例如当前平台上没有可用的沙箱工具) ，CLI 会拒绝启动，而不是在无沙盒的情况下运行。这种“故障默认关闭”的行为可确保 --sandbox 的安全意图绝不会被悄然绕过。

选项	类型	默认值	描述
`allowed_domains`	string[]	`[]`	允许通过代理的域名模式。非空时，仅允许匹配的域名通过 (允许列表模式)
`denied_domains`	string[]	`[]`	始终阻止的域名模式。拒绝规则优先于允许规则
`network_mode`	string	`"full"`	`"full"` 允许所有 HTTP 方法；`"limited"` 仅允许 GET/HEAD/OPTIONS

域名模式语法：

模式	匹配项
`example.com`	仅精确匹配
`*.example.com`	任意子域名 (不包括根域名)
`**.example.com`	根域名及其任意子域名

示例：

{
  "sandbox": {
    "allowed_domains": [
      "github.com",
      "**.npmjs.org",
      "**.crates.io",
      "**.pypi.org"
    ],
    "denied_domains": ["evil.example.com"],
    "network_mode": "full"
  }
}

仅在沙盒启用时 (--sandbox) ，域过滤才会生效。不使用 --sandbox 时，会忽略沙盒相关部分。

对于企业团队，管理员可以通过团队设置覆盖域名列表。企业允许列表以其配置为准 (会替换你本地的 allowed_domains) ，而企业拒绝列表则为叠加模式 (会与你本地的 denied_domains 合并) 。

带注释的 JSON

配置文件支持 JavaScript 风格的注释：

{
  // 行注释
  "agent": {
    "model": "sonnet"  // 内联注释
  },
  /* 块注释
     */
  "permissions": {}
}

入门指南

编辑器集成

扩展性

企业版

参考文档

变更日志

文件位置

完整配置参考

选项参考

Agent (仅限用户)

theme_mode (仅限用户)

权限

mcpServers

show_path (仅限用户)

unicode_mode (仅限用户)

show_hints (仅限用户)

include_gitignored_files (仅限用户)

respect_gitignore (仅限用户)

attribution (仅限用户)

subagents_enabled (仅限用户)

keymap (仅限用户)

auto_update (仅限用户)

keymap (仅限用户)

notify

read_config_from

proxy (仅限用户)

沙盒 (仅限用户)

带注释的 JSON

​文件位置

​完整配置参考

​选项参考

​Agent (仅限用户)

​theme_mode (仅限用户)

​权限

​mcpServers

​show_path (仅限用户)

​unicode_mode (仅限用户)

​show_hints (仅限用户)

​include_gitignored_files (仅限用户)

​respect_gitignore (仅限用户)

​attribution (仅限用户)

​subagents_enabled (仅限用户)

​keymap (仅限用户)

​auto_update (仅限用户)

​keymap (仅限用户)

​notify

​read_config_from

​proxy (仅限用户)

​沙盒 (仅限用户)

​带注释的 JSON

文件位置

完整配置参考

选项参考

Agent (仅限用户)

theme_mode (仅限用户)

权限

mcpServers

show_path (仅限用户)

unicode_mode (仅限用户)

show_hints (仅限用户)

include_gitignored_files (仅限用户)

respect_gitignore (仅限用户)

attribution (仅限用户)

subagents_enabled (仅限用户)

keymap (仅限用户)

auto_update (仅限用户)

keymap (仅限用户)

notify

read_config_from

proxy (仅限用户)

沙盒 (仅限用户)

带注释的 JSON