自定义全局权限配置参考

在 global.json 文件中，你可以配置全局权限策略，包括文件目录授权、网络目标授权、命令调用规则和 MCP 调用规则。通过这些配置，你可以统一管理智能体对本地文件、网络目标、Shell 命令和 MCP 工具的访问与执行范围。

资源授权

resourceAuthorization 对象用于配置资源级授权规则。你可以为指定文件目录设置读写或只读权限，也可以为指定网络目标设置允许或拒绝访问的策略。当智能体访问的资源命中这里的规则时，TraeWork 会优先使用资源级规则；未命中时，再回退到自定义权限模式中的默认策略或系统内置的默认资源访问权限。

"resourceAuthorization": {
  "filesystem": {
    "readWrite": [],
    "readOnly": []
  },
  "network": {
    "allow": [],
    "deny": []
  }
}

文件目录授权

resourceAuthorization.filesystem 用于精细控制智能体对本地文件系统的访问权限。它通过路径列表为智能体设置指定目录的读写或只读权限。

支持的路径格式：

• 绝对路径：例如 /usr/local/bin 或 C:\Program Files；
• Home 目录：使用 ~ 表示用户主目录，如 ~/Documents；
• 环境变量：使用 $VAR 引用环境变量，如 $HOME/.config；
• 工作区变量：使用 $WORKSPACE_FOLDER 引用当前工作区目录。

不同操作系统的注意事项：

• Windows：系统会自动忽略 Unix 风格的绝对路径（如 /usr/lib），并将 Git Bash 风格的路径（如 /c/Users）转换为标准 Windows 路径（如 C:\Users）。
• macOS / Linux：系统会自动忽略 Windows 风格的盘符路径（如 C:\Users）。

路径匹配规则：

• 路径越长、越精确，优先级越高。
• 如果一个路径被同时添加至 readWrite 和 readOnly 列表，readOnly 的优先级高于 readWrite。
• 对于同一个文件目录，resourceAuthorization.filesystem 中的权限配置优先于自定义权限模式中的以及系统内置的文件系统访问权限配置。

网络目标授权

resourceAuthorization.network 用于管理智能体对特定网络目标的访问策略。该配置可用于允许或阻止特定域名、IP、子网或端口。

可配置的字段如下：

网络目标的匹配规则如下：

• 网络地址越长、越精确，优先级越高。
• 如果一个网络地址同时被添加至 allow 和 deny 列表，deny 的优先级高于 allow。
• 对于同一个网络目标，resourceAuthorization.network 中的权限配置优先于自定义权限模式中的以及系统内置的网络访问权限配置。

支持的网络地址写法如下：

示例 1： 仅允许访问 GitHub

此配置将默认拒绝所有网络请求，并仅放行对 GitHub HTTPS 服务的访问，降低敏感信息被发送到非预期网络目标的风险。

{
  "customProfiles": {
    "defaultCustomProfile": {
      ...
      "network": {
        "default": "deny"
      ...    
      }
    }
  },
  "resourceAuthorization": {
    "network": {
      "allow": ["*.github.com:443"],
      "deny": []
    }
  }
}

示例 2：禁止访问内部网络

此配置将放行所有网络请求，但明确禁止访问常见的内网地址段，防止智能体访问或攻击内网服务。

{
  "customProfiles": {
    "defaultCustomProfile": {
      ...
      "network": {
        "default": "allow"
      ...
      }
    }
  },
  "resourceAuthorization": {
    "network": {
      "allow": [],
      "deny": [
        "[10.0.0.0/8]",
        "[172.16.0.0/12]",
        "[192.168.0.0/16]"
      ]
    }
  }
}

命令调用规则

customProfiles.defaultCustomProfile.approval.commandRules 用于按命令内容配置审批与执行策略。它适合对特定 Shell 命令设置更精细的控制，例如直接放行常用命令、拒绝高风险命令，或要求用户在执行前确认。

该字段以键值对形式配置，key 为命令匹配模式，value 为对应的审批与执行策略。

命令匹配模式：

审批与执行策略：

示例：

{
  "commandRules": {
    "git *": { "approval": "allow", "execEnv": "host" },
    "npm *": { "approval": "allow", "execEnv": "host" },
    "r/rm\\s+-rf/": { "approval": "deny" },
    "kill *": { "approval": "ask" }
  }
}

MCP 调用规则

customProfiles.defaultCustomProfile.approval.mcpRules 字段用于按 MCP Server 或 MCP 工具配置审批与执行策略。它适合对来自不同 MCP Server 的工具调用进行精细化管理，例如放行可信工具、拦截高风险工具，或要求用户在调用前确认。

该字段以键值对形式配置，key 为 MCP 工具匹配模式，value 为对应的审批与执行策略。

MCP 工具匹配模式：

审批与执行策略：

示例：

{
  "mcpRules": {
    "playwright__playwright_delete": { "approval": "allow" },
    "github__*": { "approval": "ask" },
    "internal-admin": { "approval": "deny" }
  }
}