Copilot CLI：终端里的 AI 编程助手

项目简介

GitHub Copilot CLI 把 GitHub Copilot 的编程智能体能力直接搬进终端。它由与 GitHub Copilot coding agent 相同的 agentic harness 驱动，可以在命令行里通过自然语言对话完成构建、调试和理解代码的工作，并与 GitHub 工作流深度结合。

主要功能

• 终端原生开发：无需切换上下文，直接在命令行与 Copilot 编程智能体协作。
• 开箱即用的 GitHub 集成：用自然语言访问仓库、issue 和 pull request，沿用已有 GitHub 账号完成认证。
• 智能体能力：与能规划和执行复杂任务的 AI 协作者一起编写、修改、调试和重构代码。
• MCP 扩展：coding agent 默认自带 GitHub 的 MCP server，同时支持自定义 MCP server 扩展能力。
• 完全可控：每个动作在执行前都会预览，没有你的明确批准就不会发生。
• 模型可选：默认使用 Claude Sonnet 4.5，可通过 /model 命令选择其他可用模型，包括 Claude Sonnet 4 和 GPT-5。
• LSP 支持：可接入 Language Server Protocol 获得跳转定义、悬停信息和诊断等代码智能能力。

安装与使用

支持 Linux、macOS 和 Windows。Windows 上需要 PowerShell v6 或更高版本，并且需要一个有效的 Copilot 订阅。

macOS / Linux 安装脚本：

curl -fsSL https://gh.io/copilot-install | bash

Homebrew：

brew install copilot-cli

WinGet（Windows）：

winget install GitHub.Copilot

npm（macOS / Linux / Windows）：

npm install -g @github/copilot

安装后在代码目录中启动：

copilot

首次启动会显示动画 banner，可用 --banner 再次查看。若尚未登录 GitHub，会提示使用 /login 斜杠命令并按屏幕指引完成认证。也可以使用启用了 "Copilot Requests" 权限的 fine-grained PAT，把令牌放入环境变量 GH_TOKEN 或 GITHUB_TOKEN（按此优先级读取）。

使用 /model 切换模型；启动 copilot --experimental 或使用 /experimental 可开启实验模式，激活后会写入配置，之后无需再加参数。实验特性包括 Autopilot 模式（按 Shift+Tab 循环切换模式），它会鼓励智能体持续工作直到任务完成。

配置 LSP Server

CLI 不内置 LSP server，需要自行安装，例如：

npm install -g typescript-language-server

用户级配置写在 ~/.copilot/lsp-config.json，仓库级配置写在仓库根目录的 .github/lsp.json，示例：

{
  "lspServers": {
    "typescript": {
      "command": "typescript-language-server",
      "args": ["--stdio"],
      "fileExtensions": {
        ".ts": "typescript",
        ".tsx": "typescript"
      }
    }
  }
}

在交互会话中用 /lsp 命令查看已配置的 LSP server 状态。

容器镜像

CLI 也提供容器镜像 ghcr.io/github/copilot-cli（linux/amd64 与 linux/arm64），用于以 headless server 形式供 Copilot SDK 客户端连接，而不是交互式终端使用。运行前需在环境中设置 COPILOT_GITHUB_TOKEN，并设置连接令牌：

export COPILOT_CONNECTION_TOKEN="$(openssl rand -hex 32)"
docker run --rm -p 127.0.0.1:4321:4321 -e COPILOT_CONNECTION_TOKEN -e COPILOT_GITHUB_TOKEN ghcr.io/github/copilot-cli:latest

注意事项

• 需要有效的 Copilot 订阅；若通过组织或企业获得 Copilot 访问权限，当组织所有者或企业管理员在设置中禁用后，将无法使用本 CLI。
• 每次提交 prompt 都会消耗一次月度 premium requests 配额。
• 安装脚本可用 | sudo bash 以 root 身份安装到 /usr/local/bin；通过 PREFIX 指定安装目录（root 默认 /usr/local，非 root 默认 $HOME/.local），通过 VERSION 指定版本。
• 项目仍在快速迭代，建议保持客户端更新以获取最新功能和修复。可在仓库提 issue、参与 Discussions，或在 CLI 中运行 /feedback 提交反馈。

---

本作品整理自 GitHub 开源项目 github/copilot-cli，原作者 @github。中文介绍由 AI 根据项目 README 整理，以原仓库为准。