GitHub Copilot CLI 编程参考

除了交互式运行 Copilot CLI 外，您还可以在单个命令中直接向 CLI 传递提示，而无需进入交互会话。这使您能够在脚本、CI/CD 管道和自动化工作流中以编程方式使用 Copilot。欲了解更多信息，请参阅运行 GitHub Copilot CLI 的编程方式。

本文阐述了在编程运行 Copilot CLI 时特别相关的命令行选项和环境变量。

要查看所有可用选项的完整列表，请参阅GitHub Copilot CLI 命令参考，或在终端中输入以下命令。

copilot help

copilot help

命令行选项

在编程运行 Copilot CLI 时，有许多命令行选项特别有用。

用于 --allow-tool 选项的工具

您可以使用 --allow-tool 选项指定多种类型的工具。

工具过滤器

shell、write、url 与 MCP 服务器工具类型允许在括号中指定过滤器，以控制具体允许哪些工具。

环境变量

您可以使用环境变量来配置在编程运行时 CLI 的各种行为。此方式在 CI/CD 工作流或其他自动化环境中尤为有用，因为您可能不想在命令行中直接写入某些选项。

要获取有关 Copilot CLI 环境变量的完整信息，请在终端中运行 copilot help environment。

选择模型

当您以非交互模式向 Copilot CLI 发送提示时，CLI 使用的模型会在响应输出中显示（前提是未使用 -s 或 --silent 选项）。

您可以使用 --model 选项指定 CLI 应使用的 AI 模型。这让您可以根据提示的需求，在速度、成本与能力之间进行权衡选择最合适的模型。

例如，对于解释代码或生成摘要等简易任务，您可以选择速度快、成本低的模型，例如 Claude Haiku 系列。

copilot -p "What does this project do?" -s --model claude-haiku-4.5

copilot -p "What does this project do?" -s --model claude-haiku-4.5

对于需要更深层次推理的复杂任务——如调试或重构代码——则可以选择更强大的模型，例如 GPT Codex 系列。

copilot -p "Fix the race condition in the worker pool" \
  --model gpt-5.3-codex \
  --allow-tool='write, shell'

copilot -p "Fix the race condition in the worker pool" \
  --model gpt-5.3-codex \
  --allow-tool='write, shell'

另外，您也可以通过设置 COPILOT_MODEL 环境变量来为当前 shell 会话指定模型。

若希望在多个 shell 会话间保持模型选择，可在 CLI 配置文件中设置 model 键。该文件位于 ~/.copilot/config.json（若已设置 COPILOT_HOME 环境变量，则位于 $COPILOT_HOME/.copilot/config.json）。某些模型还允许您设置推理力度等级，以控制模型在响应前的思考时间。

{
  "model": "gpt-5.3-codex",
  "reasoning_effort": "low"
}

{
  "model": "gpt-5.3-codex",
  "reasoning_effort": "low"
}

模型优先级

在确定针对给定提示使用哪个模型时，CLI 按如下顺序（从高到低）检查模型的指定来源：

• 若使用了自定义代理：以自定义代理定义中（若有）指定的模型为准。
• 命令行中的 --model 选项。
• COPILOT_MODEL 环境变量。
• 配置文件中的 model 键（~/.copilot/config.json 或 $COPILOT_HOME/.copilot/config.json）。
• CLI 的默认模型。

使用自定义代理

您可以通过 --agent 选项将工作委派给专门的代理。更多信息请参阅为 GitHub Copilot CLI 创建与使用自定义代理。

在本例中使用了 code-review 代理。这要求已经创建了名为 code-review 的自定义代理。

copilot -p "Review the latest commit" \
  --allow-tool='shell' \
  --agent code-review

延伸阅读

• GitHub Copilot CLI
• GitHub Copilot CLI 命令参考
• GitHub Copilot CLI 插件参考