程序员努力
AI导航AI编程实战PromptMCP市场Skills市场

程序员努力

AI 编程资源库 - 聚合 AI 编程教程、提示词、MCP 与 Skills 资源

内容栏目

  • AI导航
  • AI编程实战
  • Prompt
  • MCP市场
  • Skills市场
  • 全站搜索

教程分类

  • 进阶技巧
  • 入门指南
  • 最佳实践
  • Claude Code
  • Cline教程
  • GitHub Copilot
  • Cursor教程
  • 提示词工程

关于

  • 关于我们
  • GitHub

© 2026 程序员努力. All rights reserved.

冀ICP备15004808号-7

首页教程PromptMCPSkills
advanced

Copilot CLI 进阶教程:终端里的 AI 编程工作流

面向开发者的 Copilot CLI 进阶教程,涵盖安装、LSP 配置、实验模式与实战工作流。

程序员努力2026年8月18日10 分钟阅读2513 字

GitHub Copilot CLI 是 GitHub 官方推出的终端版 AI 编程助手,把 Copilot 的代码理解、生成和调试能力直接塞进命令行。适合习惯用终端、不想在编辑器与浏览器之间来回切换的开发者,用来完成代码编写、仓库操作、问题排查等任务。

是什么 / 为什么用它

Copilot CLI 基于 GitHub Copilot 的 agentic harness,能在终端里和你同步协作,理解你的代码和 GitHub 上下文。它不是一个简单的补全工具,而是一个能规划并执行复杂任务的 AI 协作伙伴。

几个核心特点:

  • 终端原生:直接在命令行里工作,不需要切换窗口。

  • GitHub 集成:用自然语言访问你的仓库、issue、pull request,使用现有 GitHub 账号认证。

  • Agent 能力:可以构建、编辑、调试、重构代码,AI 会规划步骤并执行。

  • MCP 扩展:内置 GitHub 的 MCP server,也支持自定义 MCP server 扩展功能。

  • 完全控制:每一步操作都会先预览,只有你明确批准才会执行。

适合谁?如果你每天都在终端里跑 git、构建、测试,又想让 AI 帮你处理重复劳动,这个工具值得一试。它特别适合处理跨文件的重构、根据 issue 实现功能、排查复杂 bug 这类任务。

安装与环境准备

支持平台

Linux、macOS、Windows 都支持。Windows 上需要 PowerShell v6 或更高版本。

前提条件

  • 有效的 Copilot 订阅。如果你是通过组织或企业获得 Copilot 访问权限,需要确认组织管理员没有在策略中禁用 Copilot CLI。

安装方式

macOS 和 Linux 用脚本安装:

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

或者用 wget:

wget -qO- https://gh.io/copilot-install | bash

默认安装到 /usr/local/bin(root 用户)或 $HOME/.local/bin(非 root 用户)。想改目录,用 PREFIX 环境变量。想装指定版本,用 VERSION。例如安装 v0.0.369 到自定义目录:

curl -fsSL https://gh.io/copilot-install | VERSION="v0.0.369" PREFIX="$HOME/custom" bash

Homebrew 安装(macOS 和 Linux):

brew install copilot-cli

想尝鲜预发布版:

brew install copilot-cli@prerelease

Windows 用 WinGet:

winget install GitHub.Copilot

预发布版:

winget install GitHub.Copilot.Prerelease

npm 安装(全平台):

npm install -g @github/copilot

预发布版:

npm install -g @github/copilot@prerelease

首次启动与登录

在项目目录下运行:

copilot

第一次启动会看到动画 banner。如果没登录 GitHub,CLI 会提示你使用 /login 斜杠命令。输入后按屏幕提示完成认证。

也可以用个人访问令牌(PAT)认证。需要创建 fine-grained PAT,并开启 "Copilot Requests" 权限。步骤:

  1. 访问 https://github.com/settings/personal-access-tokens/new

  2. 在 Permissions 下添加 "Copilot Requests" 权限

  3. 生成 token

  4. 把 token 设置到环境变量 GH_TOKEN 或 GITHUB_TOKEN(前者优先级更高)

第一个能跑通的例子

进入一个你熟悉的项目目录,运行 copilot。等提示符出现后,输入一句自然语言指令,比如:

这个项目的测试命令是什么?

Copilot CLI 会分析项目文件,找到测试配置,然后告诉你应该运行什么命令。如果它需要执行命令,会先展示命令内容,等你确认后再运行。

再试一个:

解释一下 src/main.py 里 main 函数的作用

它会读取文件,给出解释。整个过程都在终端里完成,不需要打开编辑器。

默认情况下,Copilot CLI 使用 Claude Sonnet 4.5 模型。想换模型,输入 /model 斜杠命令,可以选 Claude Sonnet 4、GPT-5 等。

常用操作

斜杠命令

  • /login:登录 GitHub 账号

  • /model:切换模型

  • /lsp:查看 LSP 服务器状态

  • /experimental:激活实验模式

  • /feedback:提交反馈

模式切换

按 Shift+Tab 可以循环切换模式。实验模式下有一个 Autopilot 模式,这个模式下 agent 会持续工作,直到任务完成。适合那种“帮我实现这个功能,做完告诉我”的长时间任务。

预览与批准

Copilot CLI 的每个动作都会先预览。比如它要修改文件、运行命令,都会先展示具体内容,等你确认。这样你不会被 AI 带偏,所有变更都在掌控之中。

进阶技巧与工作流

配置 LSP 服务器

LSP(Language Server Protocol)是语言服务器协议,能提供跳转定义、悬停信息、诊断等智能代码功能。Copilot CLI 不自带 LSP 服务器,需要你自己安装。

以 TypeScript 为例,先安装语言服务器:

npm install -g typescript-language-server

然后配置。LSP 配置支持两个级别:

用户级配置(对所有项目生效):编辑 ~/.copilot/lsp-config.json

仓库级配置(只对当前项目生效):在仓库根目录创建 .github/lsp.json

示例配置:

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

配置好后,在交互会话里用 /lsp 命令查看状态。如果没生效,检查文件路径和 JSON 格式。

激活实验模式

实验模式可以提前使用还在开发中的功能。两种方式:

copilot --experimental

或者在 CLI 里输入 /experimental。激活后设置会持久化,之后启动不用再加 --experimental 参数。

利用 GitHub 集成

Copilot CLI 能直接访问你的仓库、issue 和 PR。比如你可以说:

看看 issue #42 描述了什么,然后帮我写一个实现方案

它会读取 issue 内容,结合当前代码库给出方案。这种工作流特别适合开源维护者:从 issue 到实现,全程不离开终端。

自定义 MCP 服务器

Copilot CLI 的 agent 默认自带 GitHub 的 MCP server,也支持自定义 MCP 服务器。这意味着你可以接入自己的内部工具、数据库、API 服务,让 agent 具备更多能力。具体配置方法以官方文档为准。

结合 Autopilot 模式做长任务

把 Autopilot 模式和 GitHub 集成结合起来,可以实现“自动实现功能”的工作流。比如:

在 feature-xyz 分支上实现 issue #42 描述的功能,写测试,然后创建 PR

切换到 Autopilot 模式后,agent 会自己规划步骤、修改代码、运行测试,直到任务完成。你只需要在关键节点批准操作。

实战案例

案例 1:用 LSP 排查 TypeScript 类型错误

假设你有一个 TypeScript 项目,编译时报了一堆类型错误。配置好 LSP 后,启动 Copilot CLI:

/lsp

确认 TypeScript 服务器已连接。然后输入:

帮我修复 src/types.ts 里的类型错误

agent 会读取 LSP 诊断信息,定位错误位置,提出修改方案。你确认后它会直接改文件。

案例 2:根据 issue 实现新功能

你在维护一个开源项目,收到一个 feature request。在本地仓库运行 Copilot CLI:

看一下 issue #88 的需求,在 main 分支上新建一个分支实现它,完成后告诉我改动范围

agent 会读取 issue,创建分支,编写代码,然后给你一个改动摘要。整个过程你只需要在它执行 git 操作时确认。

案例 3:跨文件重构

把一个模块的 API 从回调风格改成 Promise 风格,涉及多个文件。用自然语言描述目标:

把 src/api 下的所有回调函数改成 async/await,更新所有调用方,然后运行测试

agent 会分析依赖关系,逐个文件修改,最后跑测试验证。如果测试失败,它会根据错误信息继续调整。

常见问题与排错

启动时提示需要登录

现象:运行 copilot 后,界面提示使用 /login 命令。

解决:输入 /login,按屏幕提示完成浏览器认证。如果你用的是 PAT,设置好 GH_TOKEN 环境变量后重新启动。

组织策略导致无法使用

现象:你有 Copilot 订阅,但启动 CLI 时提示没有权限。

原因:组织或企业管理员在策略中禁用了 Copilot CLI。

解决:联系管理员调整策略,或者用个人账号的 Copilot 订阅。

LSP 配置不生效

现象:/lsp 命令看不到预期的语言服务器,或者代码诊断信息为空。

排查步骤:

  1. 确认语言服务器已安装,比如 typescript-language-server 是否在 PATH 中。

  2. 检查配置文件路径。用户级是 ~/.copilot/lsp-config.json,仓库级是 .github/lsp.json。

  3. 检查 JSON 格式,注意 fileExtensions 的键名要带点,比如 .ts。

  4. 修改配置后重启 Copilot CLI。

每次提问都消耗配额

现象:使用一段时间后,提示 premium requests 配额不足。

说明:每次向 Copilot CLI 提交 prompt,都会消耗一次月度 premium request 配额。具体配额数量和使用情况,参考 GitHub 官方文档。

版本更新频繁

现象:官方迭代很快,功能经常变化。

解决:定期用原来的安装方式更新。比如 npm 全局包执行 npm update -g @github/copilot,Homebrew 执行 brew upgrade copilot-cli。脚本安装的可以重新跑一次安装脚本。

总结与下一步

Copilot CLI 把 GitHub Copilot 的 agent 能力带到了终端,让你在熟悉的环境里完成代码编写、调试、重构和 GitHub 操作。LSP 配置和实验模式进一步扩展了它的实用性。

下一步建议:找一个你手头的中小型项目,配置好 LSP,然后试着用 Copilot CLI 处理一个真实的 issue 或重构任务。先从简单的“解释代码”开始,再逐步尝试 Autopilot 模式。

评论 (0)

评论需审核后才会显示

暂无评论,来发表第一条评论吧

目录

是什么 / 为什么用它安装与环境准备支持平台前提条件安装方式首次启动与登录第一个能跑通的例子常用操作斜杠命令模式切换预览与批准进阶技巧与工作流配置 LSP 服务器激活实验模式利用 GitHub 集成自定义 MCP 服务器结合 Autopilot 模式做长任务实战案例案例 1:用 LSP 排查 TypeScript 类型错误案例 2:根据 issue 实现新功能案例 3:跨文件重构常见问题与排错启动时提示需要登录组织策略导致无法使用LSP 配置不生效每次提问都消耗配额版本更新频繁总结与下一步

相关推荐

查看更多

Cline 进阶技巧与工作流:从 CLI 到多智能体自动化

13分钟同分类

Codex CLI 进阶技巧与工作流教程

11分钟同分类

进阶:构建 AI Agent 应用

5分钟同分类