Skip to main content

开始使用 GitHub Copilot CLI

快速了解如何使用 GitHub Copilot 命令行界面 (CLI)。

谁可以使用此功能?

GitHub Copilot 命令行界面 (CLI) 与所有 Copilot 计划兼容。 如果从组织收到 Copilot,则必须在组织的“Settings”中启用 Copilot 命令行界面(CLI) 策略。

介绍

GitHub Copilot 命令行界面 (CLI) 是一款功能强大的终端原生 AI 编码助手,可直接将智能体功能带到你的命令行。 Copilot 命令行界面(CLI) 提供深度灵活性,GitHub 工作流集成,以及能够在保持完全用户控制的同时自主处理复杂任务。

本指南将帮助你开始使用 CLI。

Installation

使用以下命令之一:

  •         **跨平台 (npm)**
    

    先决条件:Node.js 22 或更高版本。

    Bash
    npm install -g @github/copilot
    
  •         **Windows (WinGet)**
    
    Bash
    winget install GitHub.Copilot
    
  •         **macOS/Linux (Homebrew)**
    
    Bash
    brew install copilot-cli
    

首次启动 CLI

  1. 在终端中,导航到要使用 Copilot 命令行界面(CLI) 的项目目录。

  2. 启动交互式 CLI 会话:

    copilot
    
  3. 在 CLI 界面中,输入 /login,并按照屏幕上的提示向 GitHub 帐户进行身份验证。

    在第一次使用 CLI 时,你只需进行此操作。

  4. 出现提示时,请确认你相信当前目录中的文件适合用于 AI 工具。

    注意

    Copilot 不会在未获得你明确批准的情况下更改你的文件。

  5. 尝试向 Copilot 提问,例如:

    Copilot prompt
    Give me an overview of this project.
    

掌握核心快捷方式

ShortcutAction
          <kbd>Esc</kbd>                | 取消当前操作 |

| Ctrl+C | 如果需要思考、清除输入或退出,请取消操作。 | | Ctrl+L | 清除屏幕 | | @ | 提及要包含在上下文中的文件 | | / | 显示斜杠命令 | | ? | 显示选项卡式帮助 | | | 浏览命令历史记录 |

有关快捷方式和可用命令的完整列表,请输入:

/help

以非交互方式使用GitHub Copilot 命令行界面 (CLI)

你也可以输入命令,直接在终端中获得 Copilot 的响应,而无需启动交互式会话。

要做到这一点,请使用 -p 标志将提示传递给 CLI。 例如:

copilot -p "In Git, how can I apply a commit from another branch"

此标志 -p 允许你以程序化地在脚本中使用 数据变量.copilot.copilot_cli %},例如,使用 AI 自动执行任务。

你可以添加 -s 标志,告知 CLI 仅输出 Copilot 的响应,省略额外的使用信息。

copilot -sp "YOUR PROMPT HERE"

有关可通过编程方式使用的其他标志的详细信息,以及更多信息,请输入:

copilot help

or:

copilot help TOPIC

其中 TOPIC 是帮助输出中列出的主题之一。

后续步骤

了解有关 Copilot 命令行界面(CLI) 的更多信息:

  •         [AUTOTITLE](/copilot/concepts/agents/about-copilot-cli)
    
  •         [AUTOTITLE](/copilot/how-tos/use-copilot-agents/use-copilot-cli)
    
  •         [AUTOTITLE](/copilot/how-tos/copilot-cli/cli-best-practices)