{"meta":{"title":"开始使用 GitHub Copilot CLI","intro":"快速了解如何使用 GitHub Copilot CLI。","product":"GitHub Copilot","breadcrumbs":[{"href":"/zh/copilot","title":"GitHub Copilot"},{"href":"/zh/copilot/get-started","title":"开始"},{"href":"/zh/copilot/get-started/cli-quickstart","title":"Copilot CLI 快速入门"}],"documentType":"article"},"body":"# 开始使用 GitHub Copilot CLI\n\n快速了解如何使用 GitHub Copilot CLI。\n\n## Introduction\n\nGitHub Copilot CLI 是一个功能强大的终端原生 AI 编码助手，它直接将代理功能引入命令行。 它提供了 Copilot CLI 深度的灵活性、 GitHub 工作流集成以及能够在保持完全用户控制的同时自主处理复杂任务的能力。\n\n本指南将帮助你开始使用 CLI。\n\n## 安装\n\n使用以下命令之一：\n\n* **跨平台 （npm）**\n\n  先决条件： Node.js 22 or later.\n\n  ```bash copy\n  npm install -g @github/copilot\n  ```\n\n* **Windows （WinGet）**\n\n  ```bash copy\n  winget install GitHub.Copilot\n  ```\n\n* **macOS/Linux （Homebrew）**\n\n  ```bash copy\n  brew install --cask copilot-cli\n  ```\n\n## 首次启动 CLI\n\n1. 在终端中，导航到要使用的 Copilot CLI项目目录。\n\n2. 启动交互式 CLI 会话：\n\n   ```bash\n   copilot\n   ```\n\n3. 在 CLI 界面中，输入 `/login` 并按照屏幕上的提示使用帐户进行身份验证 GitHub 。\n\n   首次使用 CLI 时，只需执行此操作。\n\n4. 出现提示时，请确认你相信当前目录中的文件适合用于 AI 工具。\n\n   > \\[!NOTE]\n   > Copilot 不会在没有得到你的明确批准的情况下对文件进行更改。\n\n5. 尝试提问 Copilot ，例如：\n\n   ```copilot copy\n   Give me an overview of this project.\n   ```\n\n   如果你愿意，也可以直接说出你的提示内容，而不用手动输入。 请参阅“[通过 Copilot CLI 使用语音输入](/zh/copilot/how-tos/copilot-cli/use-copilot-cli/voice-input)”。\n\n## 掌握核心快捷方式\n\n| Shortcut                     | Action                |\n| ---------------------------- | --------------------- |\n| <kbd>Esc</kbd>               | 取消当前操作                |\n| <kbd>Ctrl</kbd>+<kbd>C</kbd> | 如果需要思考、清除输入或退出，请取消操作。 |\n| <kbd>Ctrl</kbd>+<kbd>L</kbd> | 清除屏幕                  |\n| `@`                          | 提及要包含在上下文中的文件         |\n| `/`                          | 显示斜杠命令                |\n| `?`                          | 显示选项卡式帮助              |\n| <kbd>↑</kbd> 和 <kbd>↓</kbd>  | 浏览命令历史记录              |\n\n有关快捷方式和可用命令的完整列表，请输入：\n\n```bash\n/help\n```\n\n## 以非交互方式使用GitHub Copilot CLI\n\n还可以输入命令并从终端直接获取响应 Copilot ，而无需启动交互式会话。\n\n要做到这一点，请使用 `-p` 标志将提示传递给 CLI。 例如：\n\n```bash\ncopilot -p \"In Git, how can I apply a commit from another branch\"\n```\n\n标志 `-p` 允许你在脚本中以编程方式使用 GitHub Copilot CLI ，例如，使用 AI 自动执行任务。\n\n您可以添加`-s`标志，指导CLI仅输出Copilot的响应，省略额外的使用信息。\n\n```bash\ncopilot -sp \"YOUR PROMPT HERE\"\n```\n\n有关可通过编程方式使用的其他标志的详细信息，以及更多信息，请输入：\n\n```bash\ncopilot help\n```\n\nor:\n\n```bash\ncopilot help TOPIC\n```\n\n其中 TOPIC 是帮助输出中列出的主题之一。\n\n## 后续步骤\n\n详细了解 Copilot CLI：\n\n* [关于 GitHub Copilot CLI](/zh/copilot/concepts/agents/copilot-cli/about-copilot-cli)\n* [使用 GitHub Copilot CLI](/zh/copilot/how-tos/copilot-cli/use-copilot-cli/overview)\n* [GitHub Copilot CLI 的最佳做法](/zh/copilot/how-tos/copilot-cli/cli-best-practices)\n* [入门 GitHub Copilot CLI：免费动手课程](https://developer.microsoft.com/blog/get-started-with-github-copilot-cli-a-free-hands-on-course)"}