企业版管理¶

如果把 GitHub Copilot 想象成公司统一采购的办公软件套件，那么企业版管理就是 IT 部门负责的**软件分发与权限管控**——决定谁可以用、能用哪些功能、在哪些部门开放。Copilot CLI 作为套件中的一个"客户端"，同样服从这套管控体系。本文面向企业所有者（Enterprise Owner）和组织管理员，讲解如何对 Copilot CLI 进行集中管控。

本文你会学到：

• 掌握在企业或组织级别启用/禁用 Copilot CLI 的方法
• 了解哪些 AI 控制策略对 CLI 生效、哪些不生效
• 了解组织级自定义 Agent 的管理方式
• 能够排查开发者无法访问 Copilot CLI 的常见原因

启用或禁用 Copilot CLI¶

企业所有者可以在 GitHub.com 上通过配置策略来控制 Copilot CLI 的使用，支持**企业级**和**组织级**两个层级的管理。可以把这理解为"总公司统一规定"与"分公司自行决定"的关系——企业级策略的优先级更高。

配置路径如下：

1. 导航到你的 Enterprise 页面（例如从 GitHub.com 的 Enterprises 页面进入）
2. 点击页面顶部的 AI controls
3. 在侧边栏中点击 Copilot
4. 在 Copilot Clients 区域中，为 Copilot CLI 选择策略

graph TD
    A[Enterprise 页面] --> B[AI controls]
    B --> C[Copilot]
    C --> D[Copilot Clients]
    D --> E{选择策略}
    E --> F[Enabled everywhere]
    E --> G[Disabled everywhere]
    E --> H[Let organizations decide]

策略控制项¶

并非所有企业级 AI 控制策略都会影响 Copilot CLI。这类似于公司统一采购了 Office 套件，但不同组件（Word、Excel、Teams）各自有独立的管控维度。下面分别列出适用和不适用的控制项。

适用的控制¶

不适用的控制¶

以下企业级策略**不会**影响 Copilot CLI：

• MCP 服务器策略：控制 MCP 服务器是否可用或允许哪些 MCP Registry 的策略，对 CLI 不生效
• IDE 特定策略：为特定 IDE 或编辑器扩展配置的策略
• 内容排除（Content Exclusions）：基于文件路径的内容排除规则
• BYOK（用户级模型提供商配置）：用户可通过环境变量自行配置模型提供商

BYOK 配置示例：

1
2
3
4
5
6
7
8
9

# 用户在本地 shell 配置文件（如 .bashrc / .zshrc）中设置自有模型提供商
export COPILOT_PROVIDER_TYPE=anthropic
export COPILOT_PROVIDER_API_KEY=sk-ant-xxxxxxxxxxxx
export COPILOT_PROVIDER_BASE_URL=https://api.anthropic.com

# 或使用 OpenAI 兼容的提供商
export COPILOT_PROVIDER_TYPE=openai
export COPILOT_PROVIDER_API_KEY=sk-xxxxxxxxxxxx
export COPILOT_PROVIDER_BASE_URL=https://your-custom-endpoint.com/v1

上述配置完全在用户本地完成，企业策略无法感知或阻止。

组织级 Agent¶

企业可以为组织配置自定义 Agent，这些 Agent 存放在组织的 .github-private/agents/ 目录下，仅对组织内成员可见。

1
2
3
4

your-organization/.github-private/agents/
├── code-reviewer.md      # 代码审查 Agent
├── deployment-helper.md  # 部署助手 Agent
└── security-scanner.md   # 安全扫描 Agent

不同组织可以维护各自的 Agent 集合，开发者在 Copilot CLI 中能够调用所属组织的专属 Agent，实现组织级别的自动化能力共享。

排障指南¶

如果开发者报告无法访问 Copilot CLI，可以按照以下决策流程逐一排查：

graph TD
    A[开发者无法使用 Copilot CLI] --> B{有 Copilot 座位?}
    B -- 否 --> C[联系管理员分配座位]
    B -- 是 --> D{企业级策略是什么?}
    D -- Enabled everywhere --> E[应可正常使用, 检查其他问题]
    D -- Disabled everywhere --> F[企业级被禁用, 需申请更改]
    D -- Let organizations decide --> G{授权组织是否启用?}
    G -- 至少一个已启用 --> E
    G -- 均未启用 --> H[联系组织管理员启用]

确认座位分配

确保该用户已从企业内的某个组织获得有效的 GitHub Copilot 座位分配。没有座位，所有 Copilot 功能均不可用。

检查企业级策略

如果企业策略设置为 Enabled everywhere 或 Disabled everywhere，该设置会**覆盖**所有组织级的配置。请确认企业级策略没有意外地被设为全局禁用。

检查组织级策略

如果企业策略设置为 Let organizations decide，则需要进一步确认：用户获得 Copilot 许可的**所有组织中，至少有一个**已启用 Copilot CLI。即使只有一个授权组织启用了 CLI，用户也能正常使用。