本页介绍的是本地沙箱。有关云端行为及其限制，请参阅对比本地沙箱与云沙箱。

本指南介绍在沙箱环境中对 GitHub Copilot 进行身份验证、配置和使用的方法。

官方文档：GitHub Copilot CLI

快速开始

创建沙箱，并为项目目录运行 Copilot：

$ sbx run copilot ~/my-project

工作区参数是可选的，默认值为当前目录：

$ cd ~/my-project
$ sbx run copilot

身份验证

Copilot 需要一个拥有 Copilot 访问权限的 GitHub 令牌。用 存储的密钥保存你的令牌：

$ sbx secret set github --command 'gh auth token'

配置

沙箱不会读取宿主机的用户级配置。沙箱内只有工作目录中的项目级配置可用。变通方法 请参阅 沙箱为什么不用我的用户级智能体配置？。

Copilot 默认被配置为信任工作区目录，因此操作工作区文件时无需反复确认。

默认启动命令

不带额外参数时，沙箱运行：

copilot --yolo

当 -- 后的第一个参数本身是标志（以 - 开头）时，其余参数会追加到默认标志之后， 因此 --yolo 会被保留：

$ sbx run copilot -- -p "review this PR"   # 运行 copilot --yolo -p "review this PR"

有关提示词和子命令，请参阅 向智能体传递参数。

基础镜像

模板：docker/sandbox-templates:copilot

已预先配置为信任工作区目录。

有关预装工具或自定义此环境，请参阅自定义。