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

# 配置

> 如何通过配置文件设置 Devin CLI 的行为

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

***

<div id="config-file-locations">
  ## 配置文件位置
</div>

<Tabs>
  <Tab title="用户配置">
    **路径：** `~/.config/devin/config.json`

    适用于所有项目的个人默认配置。你可以在这里设置偏好的模型、主题和全局权限。

    你也可以在此目录中放置一个 `AGENTS.md` 文件 (`~/.config/devin/AGENTS.md`) ，用于定义适用于每个项目的[全局规则](/zh/cli/extensibility/rules#global-rules)。

    <Note>
      在 Windows 上，此路径为 `%APPDATA%\devin\config.json` (通常是 `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="项目配置">
    **路径：** `.devin/config.json` (位于项目根目录)

    提交到版本控制的团队共享配置。可用于项目专用的 MCP 服务器、权限策略和导入设置。

    ```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="本地覆盖">
    **路径：** `.devin/config.local.json`

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

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

***

<div id="what-you-can-configure">
  ## 你可以配置的内容
</div>

<CardGroup cols={2}>
  <Card title="模型" icon="brain" href="/zh/cli/models">
    选择由哪个 AI 模型为 Agent 提供支持——从 Claude Opus 到 GPT 5.2，再到 Gemini 3。
  </Card>

  <Card title="权限" icon="shield" href="/zh/cli/reference/permissions">
    预先批准安全操作，拦截危险操作，并控制 Agent 在无需询问的情况下可以执行哪些操作。
  </Card>

  <Card title="MCP 服务器" icon="server" href="/zh/cli/extensibility/mcp/configuration">
    连接适用于 GitHub、Linear、数据库及各种自定义 API 的外部工具服务器。
  </Card>

  <Card title="外部工具导入" icon="arrow-right-to-bracket" href="/zh/cli/extensibility/rules">
    从 Cursor、Windsurf 和 Claude Code 导入规则、技能和配置。
  </Card>
</CardGroup>

***

<div id="quick-start">
  ## 快速开始
</div>

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

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

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

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

***

<div id="project-vs-user-settings">
  ## 项目设置与用户设置
</div>

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

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

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

***

<div id="configuration-precedence">
  ## 配置优先级
</div>

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

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

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

<Note>
  组织级 (企业版) 设置**绝不会**被项目或用户配置覆盖。有关合并方式的完整说明，请参阅[配置优先级](/zh/cli/reference/configuration/global-vs-local)。
</Note>

***

<div id="limitations">
  ## 限制
</div>

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

***

<div id="learn-more">
  ## 了解更多
</div>

<CardGroup cols={2}>
  <Card title="完整配置参考" icon="file-code" href="/zh/cli/reference/configuration/config-file">
    所有配置选项及其格式的完整参考列表。
  </Card>

  <Card title="配置优先级" icon="layer-group" href="/zh/cli/reference/configuration/global-vs-local">
    全局、项目和本地设置如何相互作用并进行合并。
  </Card>
</CardGroup>