什么是GitHub Copilot CLI?
GitHub Copilot CLI是GitHub发布的命令行AI编程代理,官方产品页面对其有说明。它在你的终端中运行,而不是在编辑器中,可以读取你的代码仓库、提出修改建议、执行你批准的Shell命令,并通过类似聊天的界面回答关于你代码库的问题。默认情况下,这些请求都由托管在GitHub基础设施上的模型处理,通过网络使用你的GitHub凭据访问——CLI本身不交付或运行任何模型权重。
- 核心功能:一个驻留在终端中的代理式编程助手——读取项目文件,提出并应用修改,可在你确认后执行命令
- 默认推理:基于云端,通过GitHub自己托管的模型进行,需要GitHub Copilot订阅档位
- 可选本地路径:BYOK配置(四个环境变量)可将模型调用重定向到你自己机器或网络上的自托管服务器——Ollama、vLLM、Foundry Local,或任何兼容端点
- 开发者:GitHub(微软子公司)
- 分发方式:npm包
@github/copilot,也可通过Homebrew和WinGet获取
Copilot CLI的背景
GitHub Copilot CLI将GitHub现有的Copilot产品线扩展到了终端,沿用了与其编辑器和聊天集成相同的账户与订阅模式。
- 1Copilot CLI作为终端编程代理推出
Why it matters: GitHub将Copilot从编辑器扩展为一个独立的命令行代理,可通过npm、Homebrew或WinGet安装,并使用现有GitHub凭据进行身份验证。 - 2新增BYOK与自定义模型提供方支持
Why it matters: GitHub发布了文档,说明如何通过环境变量将Copilot CLI连接到自托管的模型服务器——Ollama、vLLM和Foundry Local——为CLI提供了一条独立于其默认云模型的可选本地推理路径,参见GitHub的[BYOK文档](https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/use-byok-models)。 - 3AI Credits统一了各Copilot功能间的用量核算
Why it matters: GitHub整合了用量核算方式,使Copilot Chat、代理模式、代码审查和Copilot CLI在付费个人计划中都从同一个每月AI Credits额度中扣除,而不是分别计量CLI的用量。
GitHub Copilot CLI能做什么?
- 代理式终端聊天——终端中的对话式界面,可以读取文件、提出多文件修改建议并解释代码,通过
copilot命令启动 - 带确认的命令执行——Copilot CLI可以建议并执行Shell命令,但在执行任何会更改你的系统或代码仓库的操作前会请求确认
- 代码仓库感知——读取项目的文件和结构,使其回答和修改基于你实际的代码库,而不是通用建议
- 默认云模型——开箱即用时,请求由GitHub自己托管的模型处理,通过你的GitHub账户和订阅档位进行身份验证
- BYOK/自定义模型提供方——四个环境变量(
COPILOT_PROVIDER_BASE_URL、COPILOT_MODEL、COPILOT_PROVIDER_TYPE、COPILOT_PROVIDER_API_KEY)让你可以将Copilot CLI重定向到其他模型后端,包括自托管的本地服务器 - 支持的本地提供方——GitHub的BYOK文档明确列出了Ollama、vLLM和Foundry Local,此外还有"任何兼容OpenAI Chat Completions API的端点"
- BYOK的模型要求——你为Copilot CLI指定的模型必须支持工具调用和流式传输;为实现可靠的代理行为,GitHub建议使用128k token的上下文窗口
使用示例:使用Copilot CLI的三种方式
以下是基于GitHub官方文档的具体工作流程,而非假设性的用例。
使用Copilot CLI的默认云模型
使用 npm install -g @github/copilot 安装,运行 copilot,并用你现有的GitHub账户进行身份验证。从此以后,每个请求都会通过网络发送到GitHub托管的模型——这是默认行为,不需要额外配置,只需要一个包含CLI访问权限的GitHub Copilot订阅档位。
通过BYOK将Copilot CLI连接到本地Ollama模型
启动Ollama并加载一个支持工具调用和流式传输的模型(建议使用128k上下文的模型)。将 COPILOT_PROVIDER_BASE_URL 设置为你的本地Ollama端点,将 COPILOT_MODEL 设置为模型名称;本地Ollama实例不需要设置 COPILOT_PROVIDER_API_KEY。启动 copilot——此后请求会发送到你的本地Ollama服务器,而不是GitHub的云模型。
将Copilot CLI连接到自托管的vLLM或Foundry Local服务器
在你自己的硬件或网络上运行vLLM或Foundry Local,暴露一个兼容OpenAI的端点。将 COPILOT_PROVIDER_BASE_URL 设置为该端点,将 COPILOT_MODEL 设置为所提供的模型名称;仅当端点默认不兼容OpenAI时才需要设置 COPILOT_PROVIDER_TYPE。这样可以让推理保留在你自己的基础设施内,而不是GitHub的基础设施内。
安装Copilot CLI并快速上手
Copilot CLI以命令行包的形式安装,而不是可下载的应用程序。根据GitHub的文档,使用npm、Homebrew或WinGet安装,然后用你现有的GitHub账户进行身份验证。
方式 | 命令/说明 |
|---|---|
| npm(所有平台) | npm install -g @github/copilot |
| Homebrew(macOS/Linux) | 可通过Homebrew获取——具体公式请参阅GitHub的安装文档 |
| WinGet(Windows) | 可通过WinGet获取——具体包ID请参阅GitHub的安装文档 |
| 启动 | copilot(使用你现有的GitHub凭据进行身份验证) |
无论哪种方式都需要一个GitHub账户。使用默认云模型还需要一个包含CLI访问权限的GitHub Copilot订阅档位(Free档位即可,但使用量受限)。设置本地/BYOK路径还需要你自行运行Ollama、vLLM或Foundry Local——Copilot CLI本身不会为你安装或管理本地模型服务器。
GitHub Copilot CLI的价格
访问Copilot CLI需要GitHub Copilot订阅,不单独出售。以下档位反映了GitHub公开的个人版和企业版计划;由于档位和额度会发生变化,请在决定前到github.com/features/copilot/plans核实当前价格。
Free
- 价格:
- 0美元
- AI Credits/包含内容:
- 每月2,000次代码补全和50次聊天请求;包含Copilot CLI访问权限,受这些额度限制
Pro
- 价格:
- 每月10美元
- AI Credits/包含内容:
- 每月15美元的AI Credits,在Copilot Chat、代理模式、代码审查和Copilot CLI之间共享
Pro+
- 价格:
- 每月39美元
- AI Credits/包含内容:
- 每月70美元的AI Credits,在相同功能集之间共享
Max
- 价格:
- 每月100美元
- AI Credits/包含内容:
- 每月200美元的AI Credits,在相同功能集之间共享
Business
- 价格:
- 每用户每月19美元
- AI Credits/包含内容:
- 团队级计划;当前AI Credits额度请查阅GitHub的价格页面
Enterprise
- 价格:
- 每用户每月39美元
- AI Credits/包含内容:
- 组织级计划;当前AI Credits额度请查阅GitHub的价格页面
AI Credits是每个付费个人计划共享的单一额度池——大量使用Copilot CLI会消耗与Copilot Chat、代理模式和代码审查相同的额度,而不是单独的CLI预算。BYOK/本地模型路径完全不消耗GitHub的AI Credits,因为GitHub并未运行该模型——但你需要自行承担运行Ollama、vLLM或Foundry Local所需的任何托管成本。这些数字在评测时是准确的;GitHub此前已调整过Copilot的价格,未来也可能再次调整——请查阅上方链接,而不是将此表视为永久不变。
GitHub Copilot CLI vs. Aider
GitHub Copilot CLI和Aider都是基于终端的AI编程代理,但两者在推理发生的位置以及付费方式上的默认设定几乎截然相反。
默认推理
- GitHub Copilot CLI:
- 云端,通过GitHub托管的模型
- Aider:
- 云端,通过你配置的API密钥——或通过Ollama等服务器完全本地运行
本地模型路径
- GitHub Copilot CLI:
- 可选的BYOK配置(四个环境变量),指向Ollama、vLLM或Foundry Local
- Aider:
- 通过Ollama及其他兼容OpenAI的服务器原生支持本地模型,无需单独的BYOK模式
许可证
- GitHub Copilot CLI:
- 专有、闭源
- Aider:
- 开源(Apache-2.0);参见PromptQuorum的Aider评测
访问/价格
- GitHub Copilot CLI:
- 需要GitHub Copilot订阅,从Free到每月100美元不等
- Aider:
- 工具本身免费;你只需为所使用的API或本地算力付费
GitHub集成
- GitHub Copilot CLI:
- 与GitHub账户和代码仓库的原生一体化集成
- Aider:
- 适用于任何Git仓库;无需GitHub专属集成
如果完全本地、可离线运行的工作流程是首要考虑因素,Aider将其视为一流的默认选项,而不是可选的配置步骤——具体的本地模型配置方式,请参见PromptQuorum的Aider评测。
谁适合使用GitHub Copilot CLI?
Copilot CLI是否适合你,取决于你是否能接受默认的云端推理,以及如果你想使用本地模型,愿意在BYOK路径上投入多少精力。
以下情况适合使用GitHub Copilot CLI
- 你的代码和工作流程已经在GitHub上,你想要一个直接绑定到该账户的终端代理
- 你能接受默认的云端托管推理,并希望在不额外配置的情况下使用GitHub自己的模型
- 出于合规或离线原因,你特别需要BYOK路径来连接本地的Ollama、vLLM或Foundry Local服务器,并且愿意自行设置环境变量
- 你已经在为GitHub Copilot订阅付费,或符合Free档位资格,并希望CLI访问权限包含在同一计划中
以下情况应等待或考虑其他方案
- 你想要一款将本地、离线推理作为默认设置而非可选配置步骤的工具——参见上方与Aider的比较
- 你希望底层代理的源代码开放以供检查——Copilot CLI是闭源的
- 你需要让使用云模型的CLI用量完全脱离GitHub的AI Credits核算——Copilot CLI没有与共享额度池分离的云端专属档位
- 你不愿意自行运行和维护Ollama、vLLM或Foundry Local服务器——Copilot CLI不会替你管理本地模型运行环境
竞品与替代方案
GitHub Copilot CLI与其他几款终端AI编程代理处于同一细分领域。本评测是本地大语言模型软件目录中GitHub Copilot CLI条目的深度补充——完整目录请查阅该页面。
- Aider——一款开源终端编程代理,将本地模型作为一流选项而非可选功能;参见Aider评测以及上方的直接比较。
- OpenCode——另一款终端编程代理;参见PromptQuorum的OpenCode评测。
- Shell-GPT——一款更轻量的命令行AI助手;参见Shell-GPT评测。
- Tabby——一款设计为完全在你自己基础设施上运行的自托管AI编程助手;参见Tabby评测。
评估GitHub Copilot CLI时的常见误区
关于Copilot CLI的大多数困惑,源于将其界面运行的位置与其AI模型运行的位置混为一谈,或误解其共享AI Credits及BYOK要求的运作方式。
误区一:认为"在本地终端中运行"意味着"运行本地推理"
Copilot CLI的界面运行在你的机器上,但默认情况下,模型本身运行在GitHub的服务器上,通过网络访问。只有当你配置BYOK路径(四个环境变量),将Copilot CLI指向你自己运行的服务器(如Ollama)时,才会发生本地推理。在你如此配置之前,不要将默认设置描述为在本地运行AI模型——它并非如此。
误区二:期望BYOK能兼容任何模型
你通过BYOK连接到Copilot CLI的模型必须支持工具调用和流式传输;GitHub建议使用128k token的上下文窗口。即使端点本身成功连接,不支持工具调用的模型也无法与Copilot CLI的代理功能正确配合工作。
误区三:认为付费计划下的Copilot CLI使用不受限制
付费个人档位会将Copilot CLI用量计入与Copilot Chat、代理模式和代码审查相同的每月AI Credits池。如果你在同一计费周期内也使用其他Copilot功能,大量使用CLI可能比预期更快耗尽这一共享额度。
误区四:认为Copilot CLI必须付费订阅
GitHub Copilot的Free档位包含Copilot CLI访问权限,以及每月2,000次代码补全和50次聊天请求——尝试CLI并非严格要求付费计划,付费只是为了提高这些使用上限。
常见问题
什么是GitHub Copilot CLI?
GitHub Copilot CLI(github.com/features/copilot/cli)是GitHub推出的命令行AI编程代理。它在你的终端中运行,读取你的代码仓库,并可以通过类似聊天的界面提出修改建议、执行你批准的命令。
GitHub Copilot CLI默认会在本地运行AI模型吗?
不会。默认情况下,它会通过网络将请求发送给GitHub自己托管的模型。它在本地终端中运行,但这与运行本地推理并不相同。
GitHub Copilot CLI能使用Ollama这样的本地模型吗?
可以,通过用四个环境变量设置的BYOK(自带密钥)配置实现:COPILOT_PROVIDER_BASE_URL 和 COPILOT_MODEL(必需),以及 COPILOT_PROVIDER_TYPE 和 COPILOT_PROVIDER_API_KEY(可选)。GitHub明确将Ollama、vLLM和Foundry Local列为支持的本地提供方。
GitHub Copilot CLI是免费的吗?
GitHub Copilot的Free档位(0美元)包含Copilot CLI访问权限,限制为每月2,000次代码补全和50次聊天请求。付费档位从个人版Pro(每月10美元)到Max(每月100美元),团队版从Business(每用户每月19美元)到Enterprise(每用户每月39美元)——当前价格请查阅github.com/features/copilot/plans。
GitHub Copilot CLI使用什么许可证?
专有且闭源。没有公开的源代码仓库,因此该工具不适用GitHub星标数。
如何安装GitHub Copilot CLI?
运行 npm install -g @github/copilot,或通过Homebrew或WinGet安装,然后用 copilot 命令启动,并用你现有的GitHub账户进行身份验证。
GitHub Copilot CLI支持哪些本地模型提供方?
GitHub的BYOK文档明确列出了Ollama、vLLM和Foundry Local,此外还有任何兼容OpenAI Chat Completions API的端点。
什么是AI Credits,它们如何适用于Copilot CLI?
AI Credits是付费个人计划中的每月使用额度,在Copilot Chat、代理模式、代码审查和Copilot CLI之间共享。Pro、Pro+和Max分别包含每月15美元、70美元和200美元。
本地BYOK模型有哪些要求?
模型必须支持工具调用和流式传输;为实现可靠的代理行为,GitHub建议使用128k token的上下文窗口。
GitHub Copilot CLI与Aider相比如何?
Aider将本地模型视为原生的一流选项,且是开源的;Copilot CLI默认使用云模型,本地使用需要单独的BYOK配置,且为闭源。参见上方的完整比较。
