---
title: "Enterprise controls"
description: "Gemini CLI enterprise controls：企业控制项、管理员策略、团队使用边界和落地前检查清单。"
verifiedAt: "2026-05-09"
---

Enterprise controls 面向管理员和团队治理。它要解决的是：谁能用、用什么身份、能接哪些工具、能访问哪些数据、日志怎么留。

> [!IMPORTANT]
> 强制策略优先放 Admin Controls。System settings 能提供默认值和覆盖值，但不能替代组织级不可绕过策略。

官方 Admin Controls 和 system settings 的定位不同：system settings 是本机配置覆盖，具备本机权限的用户可能绕过；Admin Controls 是管理台下发的组织策略，用户本地不能覆盖，应优先用于强制策略。

## 检查清单

- 用户身份是否统一。
- Cloud Project 是否固定。
- 许可和配额是否足够。
- MCP server 是否受控。
- policy 是否限制高风险工具。
- telemetry 是否符合组织要求。
- 敏感数据是否有排除规则。

## 关键控制项

当前官方文档列出的企业控制包括：

- Strict Mode：默认启用，阻止用户进入 yolo mode。
- Extensions：默认禁用，控制是否允许使用或安装 extensions。
- MCP：默认禁用，控制是否允许使用 MCP server。
- MCP Servers allowlist：预览能力，只允许连接组织信任的 MCP server。
- Required MCP Servers：预览能力，强制注入组织要求的 MCP server。
- Unmanaged Capabilities：默认禁用；当前会禁用 Agent Skills 这类未托管能力。

MCP allowlist 的安全点在于：如果 allowlist 非空，本地未列入的 MCP server 会被忽略。对 allowlist 中的 server，`url`、`type`、`trust` 等字段使用管理员配置，本地 `command`、`args`、`env`、`cwd`、`httpUrl`、`tcp` 等执行字段会被清掉，避免用户把同名 server 指到别的实现。

Required MCP Servers 则不同：它会在 allowlist 过滤后注入，适合合规、审计、内部 registry 这类必须存在的远端服务。Required server 只支持远端 transports，例如 `sse` 和 `http`，不支持本地执行字段。

这条限制很关键：required server 不应变成“强制在员工机器上执行本地命令”。企业控制适合注入远端受控服务，本地执行能力仍要通过 policy、sandbox 和系统配置单独治理。

## 反模式

- 每个开发者自己随便配。
- API key 到处复制。
- MCP server 没有权限审计。
- CI 里使用个人凭据。
- 把 `trust: true` 给到外部 MCP server。
- 只配置 allowlist，不验证本地是否仍能启动未授权 server。

## 落地顺序

先定身份和许可，再定 MCP 策略，再定工具权限和 telemetry。不要先开放 extensions、skills、remote MCP，再事后补审计；企业控制应该从最小能力开始按需求放开。

| 能力 | 默认建议 | 验证方式 |
| --- | --- | --- |
| Yolo / auto approve | 禁止 | 普通用户不能开启 |
| Extensions | 默认禁用或 allowlist | 未授权 extension 安装失败 |
| MCP | 默认禁用或 allowlist | 未授权 server 不被加载 |
| Required MCP | 仅远端受控服务 | 登录后自动出现 |
| Unmanaged capabilities | 默认禁用 | Agent Skills 等能力按策略受控 |

## 验收方式

用普通开发者账号验证三类负例：不能进入 yolo，不能安装未授权 extension，不能连接 allowlist 外 MCP server。再验证正例：required MCP server 自动出现，allowlisted MCP server 只能使用管理员允许的工具。

验收时不要用管理员账号。管理员账号天然拥有更多能力，无法证明普通开发者边界是否生效。至少准备一个普通用户、一个试点用户、一个无 license 用户做对照。

## 接下来去哪

<Cards>
  <Card title="Telemetry" description="企业 controls 落地后，继续看日志、metrics、traces 和 prompt 记录边界。" href="/docs/gemini-cli/official/06-security-enterprise/64-telemetry" />
  <Card title="Enterprise config" description="回看 system settings、Admin Controls 和 GEMINI_CLI_HOME 隔离。" href="/docs/gemini-cli/official/06-security-enterprise/62-enterprise-config" />
  <Card title="Extensions" description="Extensions 默认受控，安装前要审查 manifest 和新增能力。" href="/docs/gemini-cli/official/03-tools-mcp/38-extensions" />
</Cards>

## 官方来源

- [Gemini CLI Enterprise Admin Controls](https://github.com/google-gemini/gemini-cli/blob/main/docs/admin/enterprise-controls.md)
