---
title: "03 · Copilot 的入口地图"
description: "梳理 GitHub Copilot 在 GitHub.com、VS Code、IDE Chat、Windows Terminal、CLI、Mobile 和 Cloud Agent 中的分工。"
verifiedAt: "2026-05-06"
---

第一次学 Copilot 最容易乱，是因为入口太多。你以为自己在学一个插件，实际会碰到 GitHub 网站、VS Code、JetBrains、Windows Terminal、GitHub CLI、Mobile、Cloud Agent、企业后台和 SDK。先画入口地图，后面每个功能才有位置。

> [!NOTE]
> **本章目标**：你会按任务发生的位置选择 Copilot 入口，并知道每个入口能看到什么上下文、能做什么动作、结果应该回到哪里验收。

## 1. 入口决定上下文

```mermaid
flowchart TD
  Task["开发任务"] --> Where{"任务发生在哪里"}
  Where -->|仓库 / PR / Issue| GitHub["GitHub.com"]
  Where -->|本地代码编辑| IDE["VS Code / IDE Chat"]
  Where -->|命令行问题| Terminal["Windows Terminal / Copilot CLI"]
  Where -->|异步分支任务| Cloud["Cloud Agent"]
  Where -->|移动端跟进| Mobile["GitHub Mobile"]
  GitHub --> GHContext["PR / Issue / Files / Alerts"]
  IDE --> IDEContext["Workspace / Selection / Diff / Terminal"]
  Terminal --> ShellContext["Shell command / Git / Local repo"]
  Cloud --> PRContext["Branch / Commits / Checks / PR"]
  Mobile --> LightContext["Chat / Notifications / Lightweight review"]
```

入口不是 UI 偏好，而是上下文边界。GitHub.com 看得到 GitHub 对象；IDE 看得到本地文件和编辑状态；Terminal 看得到命令；Cloud Agent 看得到远端仓库和分支。

## 2. GitHub.com：围绕协作对象提问

GitHub.com 入口适合围绕这些对象工作：

- repository。
- file。
- issue。
- pull request。
- discussion。
- commit。
- security alert。
- organization dashboard。

适合问题：

- “这个 PR 改了什么？”
- “这个 issue 的核心需求是什么？”
- “这个 security alert 影响哪些文件？”
- “这段仓库代码的入口在哪里？”

验收方式：

- 回到 PR diff。
- 看 checks。
- 看 review comments。
- 看 issue 里的讨论和 acceptance criteria。
- 看 security alert 状态。

不适合：询问本地未提交 diff、只存在你电脑里的日志、未上传的截图、终端当前状态。

## 3. VS Code / IDE：围绕本地代码改动

VS Code 官方文档当前把 Copilot 描述成能完成“规划 → 实现 → 验证”（plan / implement / verify）的跨文件改动闭环。IDE 入口适合本地真实编码闭环。

适合任务：

- 解释当前文件。
- 生成或修改函数。
- 用 inline suggestions 做局部补全。
- 用 inline chat 做小范围编辑。
- 用 Agent mode 处理跨文件低到中风险任务。
- review code edits。
- 结合 terminal 跑验证。

IDE 入口的优势是本地上下文丰富：当前文件、选区、workspace、diff、terminal、MCP、custom instructions 都能参与。

风险边界：

- Agent mode 可能改多个文件。
- terminal command 需要人工批准。
- MCP 可能接触外部系统。
- 生成结果必须回到 diff 和测试验收。

## 4. Windows Terminal：解释命令，不替你冒险

Windows Terminal Canary 中的 Copilot 适合解释和建议命令。

适合：

- “这个命令是什么意思？”
- “如何列出占用某端口的进程？”
- “这个 Git 报错怎么处理？”
- “这段 shell 输出表示什么？”

不适合：

- 生产环境直接执行不懂的命令。
- 删除、部署、迁移、上传、密钥处理。
- 把 Copilot 建议当成无需审查的 shell 自动化。

终端入口的验收是 command output 和 exit code。执行前先判断副作用。

## 5. Copilot CLI：终端里的 Agent 任务

Copilot CLI 是更 agentic（代理式）的终端入口。官方功能页说明它可以在终端里委派任务——给项目加功能、修 bug，然后帮你创建 pull request；任务也可以从终端开始，再在 GitHub.com 或 GitHub Mobile 上接着同一个会话（session）往下做。

适合：

- 在本地 repo 里修一个明确 bug。
- 给小功能开分支和 PR。
- 在 terminal 中继续一个任务。
- 结合 hooks 和权限做受控执行。

上线边界：

- 运行前看 Git status。
- 明确允许改哪些路径。
- 高风险命令必须人工确认。
- 创建 PR 后仍走 review 和 CI。

## 6. Cloud Agent：异步分支和 PR 工作流

官方功能页把 Copilot cloud agent 描述为：研究仓库 → 制定实现计划 → 在分支里改代码。你可以 review diff、迭代修改，最后再创建 pull request。

适合：

- 明确 issue 的异步实现。
- 中等规模 refactor。
- 补测试或文档。
- 在分支里交付可 review 结果。

不适合：

- 本机未提交现场。
- 依赖本地登录态。
- 生产后台或私有桌面应用。
- 不能写清验收标准的模糊任务。

Cloud Agent 的验收不是自然语言总结，而是 branch、commits、diff、checks、PR review 和必要的产出物（artifacts，例如构建包 / 测试报告）。

## 7. GitHub Mobile：延续上下文，不做复杂合并

Mobile 适合轻量查看和延续对话：

- 跟进 issue。
- 看通知。
- 问简单上下文。
- 继续 Cloud Agent session。
- 粗看 PR 状态。

不适合：

- 审大 diff。
- 处理复杂 merge conflict。
- 批准高风险代码变更。
- 检查完整测试输出。

移动端是协作补充，不是主要 code review 工具。

## 8. 入口选择表

| 任务 | 推荐入口 | 验收证据 |
| --- | --- | --- |
| 解释 PR 改动 | GitHub.com | PR diff、checks、comments |
| 修本地组件 bug | VS Code Agent mode | local diff、test、browser |
| 补局部代码 | IDE inline suggestions | diff、compile、test |
| 解释命令 | Windows Terminal | 命令说明、人工判断 |
| CLI 修 bug 并开 PR | Copilot CLI | branch、PR、CI |
| issue 异步实现 | Cloud Agent | plan、branch、commits、checks、PR |
| 移动端跟进 | GitHub Mobile | notification、session 状态 |

## 9. 团队上线时怎么写规则

团队 SOP 不应该只写“使用 Copilot”。应该写：

1. 哪些入口允许使用。
2. 哪些入口只能只读。
3. 哪些入口可以改代码。
4. 哪些入口可以运行命令。
5. 哪些入口可以调用 MCP。
6. 哪些任务必须回到 PR review。
7. 哪些高风险路径禁用 Agent 或 Cloud Agent。

这样开发者才知道什么时候用哪个入口，而不是把所有问题都丢进同一个 Chat 面板。

## 官方来源

- [What is GitHub Copilot?](https://docs.github.com/en/copilot/get-started/what-is-github-copilot)：官方列出 IDE、Mobile、Windows Terminal、GitHub CLI 和 GitHub website 等入口。
- [GitHub Copilot features](https://docs.github.com/en/copilot/get-started/features)：官方说明 Copilot CLI、Cloud Agent、IDE Agent mode、Chat 和管理员功能。
- [GitHub Copilot Chat](https://docs.github.com/en/copilot/how-tos/chat-with-copilot)：官方 Chat 跨环境入口。
- [GitHub Copilot in VS Code](https://code.visualstudio.com/docs/copilot/overview)：VS Code 官方 agent、edit、review 和 project verification 入口。

## 接下来去哪

<Cards>
  <Card title="上一篇" description="先把 Copilot 和 Claude Code、Codex、Cursor 的工作面差异分清。" href="/docs/github-copilot/understanding/02-copilot-vs-claude-code-codex-cursor" />
  <Card title="下一篇" description="继续理解 Copilot 如何从补全发展到 Agent mode。" href="/docs/github-copilot/understanding/04-from-autocomplete-to-agent" />
  <Card title="官方入口地图" description="回到官方重组页查看 GitHub.com、VS Code、IDE Chat、Terminal 等入口。" href="/docs/github-copilot/official/01-surfaces" />
</Cards>
