# GitHub Copilot CLI

用于理解、规划、编辑和调试项目的终端 AI 编码助手，支持 GitHub 集成、自定义代理和 MCP 工具。

> 这是 OpenNavo 上 GitHub Copilot CLI 页面的 Markdown 版本，内容与网页相同： <https://opennavo.com/zh/apps/copilot-cli>

- **最新版本**: `1.0.114`
- **开发者**: GitHub, Inc.
- **主页**: <https://docs.github.com/en/copilot/concepts/agents/about-copilot-cli>
- **分类**: [开发工具](https://opennavo.com/zh/categories/developer-tools)
- **安装**: `brew install --cask copilot-cli`
- **近 30 天安装**: 20,919
- **Homebrew**: 可以安装，应用会自行更新
- **下载地址**: <https://github.com/github/copilot-cli/releases/download/v1.0.114/copilot-darwin-arm64.tar.gz>
- **SHA-256**: `35e8165a6ca811fb907b5afb7892e53d1bb85426bb77fe3f83b7f0b4e955249a`
- **附带命令**: copilot

SHA-256 只用来核对下载的文件是否完整，不代表安全认证。

## 安装与卸载内容

```json
[
  {
    "declaration": {
      "binary": [
        "copilot"
      ],
      "target": "$HOMEBREW_PREFIX/bin/copilot"
    },
    "phase": "install",
    "sources": [
      "copilot"
    ],
    "target": "$HOMEBREW_PREFIX/bin/copilot",
    "type": "binary"
  },
  {
    "declaration": {
      "generate_completions_from_executable": [
        "copilot",
        "completion",
        {
          "base_name": null,
          "shell_parameter_format": null,
          "shells": [
            "bash",
            "zsh",
            "fish"
          ]
        }
      ]
    },
    "phase": "install",
    "sources": [
      "copilot",
      "completion"
    ],
    "type": "generate_completions_from_executable"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/.copilot",
            "~/Library/Caches/copilot"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 介绍

GitHub Copilot CLI 是一款来自 GitHub 的基于终端的 AI 编码助手。它通过自然语言对话帮助开发者理解代码仓库、规划变更、编辑和调试代码，并执行开发任务。它将本地项目上下文与 GitHub 仓库、议题和拉取请求集成起来。

### 主要功能
- 在终端中询问代码相关问题、制定计划，并请求实现、调试或重构。
- 使用交互式会话或提示驱动的工作流；检查工具调用并在允许操作前批准权限。
- 通过内置的 GitHub MCP 集成使用 GitHub 上下文，并为其他工具添加自定义 MCP 服务器。
- 为特定项目工作流配置自定义代理、技能、钩子以及受支持的语言服务器。
- 选择受支持的模型并管理会话上下文；可用模型取决于你的账户或已配置的提供程序。
- 使用命令沙箱和权限设置来控制执行、网络访问和文件访问。

### 安装和首次使用
安装 `brew install --cask copilot-cli`。这会安装 `copilot` 可执行文件和受支持的 shell 补全，而不是图形化 Mac 应用。在项目文件夹中，运行 `copilot`，如果需要 GitHub 身份验证，请按照 `/login` 操作。从代码问题或 `/plan` 开始，查看建议的操作，并仅授予适合该任务的权限。

### 要求、依赖项和冲突
当前的 Homebrew Mac cask 需要 macOS 13 或更高版本，并提供单独的 Apple Silicon 和 Intel 原生下载。它声明没有额外的 formula 依赖项，并与 `copilot-cli@prerelease` 冲突，后者提供替代可执行文件。无需单独安装 Node.js 即可安装原生归档；而 npm 安装方式则需要 Node.js 22 或更高版本。Windows 使用需要 PowerShell 6 或更高版本。官方发行版也涵盖 Linux 和 Windows；Mac 归档不是它们的安装程序。

GitHub CLI (`gh`) 对于身份验证回退和 GitHub 命令工作流是可选的。当任务需要时，Git、语言运行时、构建工具和 MCP 服务器必须可用。语言服务器未捆绑，必须单独安装和配置。组织管理员可以禁用 CLI 访问或限制工具和域。避免通过多个包管理器管理同一个可执行文件。

### 账户、费用和许可证
对于 GitHub 托管的 Copilot 使用，请使用符合条件的 GitHub 账户和 Copilot 权益进行身份验证；组织提供的访问还需要启用其 CLI 策略。使用额度和付费消耗取决于你的计划和所选模型，因此请查阅当前计划，而不要假设请求不受限制。安装 CLI 本身并不授予服务访问权限。

当前文档还支持在不使用 GitHub 身份验证进行模型请求的情况下，使用你自己的模型提供商 API 密钥（BYOK）。提供商费用和可用性则另行适用。GitHub 托管的功能，例如云委派、GitHub MCP 服务器和 GitHub 代码搜索，仍然需要 GitHub 身份验证。离线模式避免联系 GitHub，但仅当配置的模型提供商也是本地或隔离时，才提供隔离环境。

CLI 使用自定义的 GitHub Copilot CLI License，而不是开源许可证。其公共仓库提供发布、文档和问题跟踪；软件许可证和任何连接服务的条款分别适用。

参考资料：[官方仓库](https://github.com/github/copilot-cli)、[安装](https://docs.github.com/en/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli)、[身份验证和 BYOK](https://docs.github.com/en/copilot/how-tos/copilot-cli/set-up-copilot-cli/authenticate-copilot-cli)、[计划](https://github.com/features/copilot/plans) 和 [CLI 许可证](https://github.com/github/copilot-cli/blob/main/LICENSE.md)。

## 系统要求

- macOS 13 起 · 应用版本: 1.0.114 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/copilot-cli.rb> · 核查于 2026-11-22
  - <https://github.com/github/copilot-cli/releases/download/v1.0.114/copilot-darwin-x64.tar.gz>
  - SHA-256: `9ac9f8785ad036c8d6a976a386fd05d721b510b57f083f1aac0cac9e378051bb`
- macOS 13 起 · 应用版本: 1.0.114 · Apple 芯片 · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/copilot-cli.rb> · 核查于 2026-11-22
  - <https://github.com/github/copilot-cli/releases/download/v1.0.114/copilot-darwin-arm64.tar.gz>
  - SHA-256: `35e8165a6ca811fb907b5afb7892e53d1bb85426bb77fe3f83b7f0b4e955249a`

## 卸载

- `brew uninstall --cask copilot-cli`

普通卸载会删除应用本身，设置和缓存会保留。

### 深度清理（可选）

- `brew uninstall --zap --cask copilot-cli`

`--zap` 还会删除 Homebrew 定义里列出的设置、缓存等文件，其中可能有其他应用共用的数据，删除后无法恢复；它也不保证没有任何残留。请先备份需要保留的数据；如要保留设置和缓存，请不要加 `--zap`。

普通卸载会删除应用本身，设置和缓存会保留。

- 文件和文件夹: `~/.copilot` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/copilot-cli.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Caches/copilot` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/copilot-cli.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

## 最新版本说明

### 1.0.115-6-prerelease (2026-11-21)

**Fixed**
- Organization-required plugins can install on the next attempt when a temporary policy change interrupts setup, without waiting for the usual retry delay.
- /delegate now explains that a login is needed instead of doing nothing when you are not signed in.
- On Unix, canceling a shell command now stops orphaned child processes that remain in the shell's process group.
- The Sessions sidebar shows Copilot Fusion sessions as working while they choose a model in the background.

## 资料与来源

- <https://opennavo.com/zh/apps/copilot-cli>
- <https://opennavo.com/zh/apps/copilot-cli/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/copilot-cli.rb> · 核查于 2026-11-22
- <https://formulae.brew.sh/cask/copilot-cli>
