|
| 1 | +--- |
| 2 | +title: Administering Copilot CLI for your enterprise |
| 3 | +shortTitle: Administer for enterprise |
| 4 | +intro: 'Control the use of {% data variables.copilot.copilot_cli_short %} within your enterprise.' |
| 5 | +versions: |
| 6 | + feature: copilot |
| 7 | +topics: |
| 8 | + - Copilot |
| 9 | + - Enterprise |
| 10 | +contentType: how-tos |
| 11 | +allowTitleToDifferFromFilename: true |
| 12 | +category: |
| 13 | + - Manage Copilot for a team # Copilot discovery page |
| 14 | + - Administer Copilot CLI # Copilot CLI bespoke landing page |
| 15 | +--- |
| 16 | + |
| 17 | +## Enabling or disabling {% data variables.copilot.copilot_cli_short %} |
| 18 | + |
| 19 | +**Enterprise owners** can control the use of {% data variables.copilot.copilot_cli_short %} by configuring a policy. |
| 20 | + |
| 21 | +{% data reusables.enterprise-accounts.access-enterprise %} |
| 22 | +{% data reusables.enterprise-accounts.ai-controls-tab %} |
| 23 | +1. To manage policies for **{% data variables.product.prodname_copilot_short %}**, in the sidebar, click {% octicon "copilot" aria-hidden="true" aria-label="copilot" %} **{% data variables.product.prodname_copilot_short %}**. |
| 24 | +1. In the "{% data variables.product.prodname_copilot_short %} Clients" section, for {% data variables.copilot.copilot_cli_short %}, select your preferred policy. |
| 25 | + |
| 26 | +## How do other AI controls affect {% data variables.copilot.copilot_cli_short %}? |
| 27 | + |
| 28 | +Not all enterprise-level AI controls and policies apply to {% data variables.copilot.copilot_cli_short %}. These are the controls that **do apply**: |
| 29 | + |
| 30 | +### {% data variables.copilot.copilot_cli_short %} enablement |
| 31 | + |
| 32 | +You can enable or disable {% data variables.copilot.copilot_cli_short %} at the enterprise or organization level. |
| 33 | + |
| 34 | +### Model selection |
| 35 | + |
| 36 | +Users can only access AI models that are enabled at the enterprise level. When you enable or disable models in your enterprise settings, those changes are reflected in {% data variables.copilot.copilot_cli_short %}. Users can view which models are available to them using the `/model` command. |
| 37 | + |
| 38 | +### Custom agents |
| 39 | + |
| 40 | +Enterprise-configured custom agents are available to use with {% data variables.copilot.copilot_cli_short %}. |
| 41 | + |
| 42 | +### {% data variables.copilot.copilot_coding_agent %} enablement |
| 43 | + |
| 44 | +Both the {% data variables.copilot.copilot_cli_short %} policy and the {% data variables.copilot.copilot_coding_agent %} policy must be enabled for users to be able to use the `/delegate` command in {% data variables.copilot.copilot_cli_short %}. |
| 45 | + |
| 46 | +### Audit logging |
| 47 | + |
| 48 | +{% data variables.copilot.copilot_cli_short %} usage events appear in enterprise audit logs. |
| 49 | + |
| 50 | +### Seat assignment |
| 51 | + |
| 52 | +Users must have an assigned {% data variables.product.prodname_copilot %} seat to access {% data variables.copilot.copilot_cli_short %}. |
| 53 | + |
| 54 | +### Controls that do not apply |
| 55 | + |
| 56 | +All other controls do **not** affect {% data variables.copilot.copilot_cli_short %}, notably: |
| 57 | + |
| 58 | +* **Model Context Protocol (MCP) server policies**: Enterprise policies that control whether MCP servers can be used, or which MCP registry servers are allowed |
| 59 | +* **IDE-specific policies**: Policies configured for specific IDEs or editor extensions |
| 60 | +* **Content exclusions**: File path-based content exclusions |
| 61 | + |
| 62 | +## Why can't my developers access {% data variables.copilot.copilot_cli_short %}? |
| 63 | + |
| 64 | +If you expect a user to have access to {% data variables.copilot.copilot_cli_short %} and they don't: |
| 65 | + |
| 66 | +1. Ensure the user has a valid {% data variables.product.prodname_copilot %} seat assignment from an organization in your enterprise. |
| 67 | +1. Verify the **enterprise-level policy.** If you set the policy to "Enabled everywhere" or "Disabled everywhere," this overrides all organization-level settings. |
| 68 | +1. If the enterprise policy is set to "Let organizations decide," check the organizations where the user receives their {% data variables.product.prodname_copilot %} license. {% data variables.copilot.copilot_cli_short %} must be enabled in **at least one** of the organization granting them a {% data variables.product.prodname_copilot %} license. |
| 69 | + |
| 70 | +One way to ensure consistent access across all organizations is to set the policy to **Enabled everywhere** at the enterprise level. |
| 71 | + |
| 72 | +## Further reading |
| 73 | + |
| 74 | +* [AUTOTITLE](/copilot/how-tos/copilot-cli/cli-best-practices) |
0 commit comments