GitHub Copilot CLI 命令参考

命令行命令

Command	目的
`copilot`	启动交互式用户界面。
`copilot help [topic]`	显示帮助信息。帮助主题包括：`config`、、commands``environment、`logging`和`permissions`。
`copilot init`	初始化此存储库的Copilot自定义说明
`copilot update`	下载并安装最新版本。
`copilot version`	显示版本信息并检查更新。
`copilot login`	通过 OAuth 设备流使用 Copilot 进行身份验证。接受 `--host HOST` 指定 GitHub 主机 URL （默认值： `https://github.com`）。
`copilot logout`	注销 GitHub 并删除存储的凭据。
`copilot plugin`	管理插件和插件市场。

交互式界面中的全局快捷方式

Shortcut	目的
`@ FILENAME`	将文件内容包含在上下文中。

          <kbd>Ctrl</kbd>+然后 <kbd>X</kbd>`/`  | 开始键入提示后，这样就可以运行斜杠命令，例如，如果要更改模型，而无需重新键入提示。 |

交互式界面中的时间线快捷方式

Shortcut	目的
ctrl+o	虽然提示输入中没有任何内容，但此操作会展开 Copilot 的响应时间线中的最近项目，以显示更多详细信息。
ctrl+e	虽然提示输入中没有任何内容，但此操作会展开 Copilot 的响应时间线中的所有项目。
ctrl+t	展开/折叠响应中推理的显示。

Shortcut	目的

          <kbd>Ctrl</kbd>+<kbd>A</kbd>        | 移动到行首（输入时）。 |

交互式接口中的斜杠命令

Command	目的
`/add-dir PATH`	将目录添加到允许的文件访问列表。
`/agent`	浏览并选择可用代理（如果有）。

          `/allow-all`、`/yolo`                               | 启用所有权限（工具、路径和 URL）。 |

要获取所有可用的斜杠命令的完整列表，请在 CLI 的交互式界面中输入 /help。

命令行选项

选项	目的
`--acp`	启动代理客户端协议服务器。
`--add-dir PATH`	将目录添加到允许的文件访问列表（可多次使用）。
`--add-github-mcp-tool TOOL`	添加一个工具，以便为 GitHub MCP 服务器启用，而不是默认 CLI 子集（可多次使用）。将 `*` 用于所有工具。
`--add-github-mcp-toolset TOOLSET`	添加工具集以启用 GitHub MCP 服务器，而不是默认 CLI 子集（可多次使用）。对所有工具集使用 `all`。
`--additional-mcp-config JSON`	仅为此会话添加 MCP 服务器。服务器配置可以作为 JSON 字符串或文件路径（前缀） `@`提供。从 `~/.copilot/mcp-config.json` 扩充配置。覆盖任何已安装的同名 MCP 服务器配置。
`--agent AGENT`	指定要使用的自定义智能体。
`--allow-all`	启用所有权限（等效于 `--allow-all-tools --allow-all-paths --allow-all-urls`）。
`--allow-all-paths`	禁用文件路径验证并允许访问任何路径。
`--allow-all-tools`	允许所有工具在不确认的情况下自动运行。以编程方式使用 CLI 时是必需的（env： `COPILOT_ALLOW_ALL`）。
`--allow-all-urls`	允许在没有确认的情况下访问所有 URL。
`--allow-tool [TOOLS...]`	CLI 有权使用的工具。不会提示输入权限。
`--allow-url [URLS...]`	允许访问特定的网址或域。
`--alt-screen [VALUE]`	使用终端备用屏幕缓冲区（`on` 或 `off`）。
`--autopilot`	在提示模式下启用 Autopilot 延续。请参阅“允许 GitHub Copilot CLI 自主工作”。
`--available-tools [TOOLS...]`	只有这些工具可供模型使用。
`--banner`	显示启动横幅。
`--bash-env [VALUE]`	启用 `BASH_ENV` 对 bash shell（`on` 或 `off`）的支持。
`--config-dir PATH`	设置配置目录（默认值： `~/.copilot`）。
`--continue`	恢复最新的会话。
`--deny-tool [TOOLS...]`	CLI 没有使用权限的工具。不会提示输入权限。
`--deny-url [URLS...]`	拒绝访问特定 URL 或域，优先于 `--allow-url`。
`--disable-builtin-mcps`	禁用所有内置 MCP 服务器（当前： `github-mcp-server`）。
`--disable-mcp-server SERVER-NAME`	禁用特定的 MCP 服务器（可以多次使用）。
`--disable-parallel-tools-execution`	禁用工具的并行执行（LLM 仍可以进行并行工具调用，但它们将按顺序执行）。
`--disallow-temp-dir`	防止自动访问系统临时目录。
`--enable-all-github-mcp-tools`	启用所有 GitHub MCP 服务器工具，而不是默认 CLI 子集。

          `--add-github-mcp-toolset`和`--add-github-mcp-tool`选项被覆盖。 |

有关命令和选项的完整列表，请运行 copilot help。

工具权限模式

          `--allow-tool`和`--deny-tool`选项接受格式为`Kind(argument)`的权限模式。 该参数是可选的， 省略它与该类型的所有工具匹配。

种类	Description	示例模式
`shell`	Shell 命令执行

          `shell(git push)`、`shell(git:*)`、`shell` |

| write | 文件创建或修改 | write、write(src/*.ts) | | read | 文件或目录读取 | read、read(.env) | | SERVER-NAME | MCP 服务器工具调用 | MyMCP(create_issue)、MyMCP | | url | 通过 web 抓取或 shell 访问 URL | url(github.com)、url(https://*.api.com) | | memory | 将事实存储到代理内存 | memory |

对于 shell 规则，:* 后缀会与命令主干匹配，然后跟一个空格，以避免部分匹配。例如， shell(git:*) 匹配 git push 和 git pull 不匹配 gitea。

即使设置了拒绝规则， --allow-all 拒绝规则始终优先于允许规则。

# Allow all git commands except git push
copilot --allow-tool 'shell(git:*)' --deny-tool 'shell(git push)'

# Allow a specific MCP server tool
copilot --allow-tool 'MyMCP(create_issue)'

# Allow all tools from a server
copilot --allow-tool 'MyMCP'

环境变量

Variable	Description
`COPILOT_MODEL`	设置 AI 模型。
`COPILOT_ALLOW_ALL`	将其设置为 `true` 以自动允许所有权限（相当于 `--allow-all`）。
`COPILOT_AUTO_UPDATE`	设置为 `false` 禁用自动更新。
`COPILOT_CUSTOM_INSTRUCTIONS_DIRS`	自定义说明中额外目录的逗号分隔列表。
`COPILOT_SKILLS_DIRS`	技能附加目录的逗号分隔列表。
`COPILOT_EDITOR`	用于交互式编辑的编辑器命令（在`$VISUAL`和`$EDITOR`检查后）。如果未设置，则默认为`vi`。
`COPILOT_GITHUB_TOKEN`	身份验证令牌。优先于 `GH_TOKEN` 和 `GITHUB_TOKEN`。
`GH_TOKEN`	身份验证令牌。优先于 `GITHUB_TOKEN`.
`GITHUB_TOKEN`	身份验证令牌。
`XDG_CONFIG_HOME`	重写配置目录。默认值：`$HOME/.copilot`。
`XDG_STATE_HOME`	覆盖状态目录默认值：`$HOME/.copilot`。
`USE_BUILTIN_RIPGREP`	将 `false` 设置为使用系统的 ripgrep，而不是使用捆绑的版本。
`PLAIN_DIFF`	设置为 `true` 禁用丰富的差异呈现。
`COLORFGBG`	检测深色/浅色终端背景的回退机制
`COPILOT_CLI_ENABLED_FEATURE_FLAGS`	要启用的功能标志的逗号分隔列表（例如）。 `"SOME_FEATURE,SOME_OTHER_FEATURE"`

配置文件设置

用户设置存储在 ~/.copilot/config.json. 项目级设置可以放置在 .copilot/settings.json （提交到存储库）或 .copilot/settings.local.json （个人替代，添加到 .gitignore）中。设置在用户、项目和本地之间层级传递，越具体的范围会优先于越一般的范围。命令行标志和环境变量始终优先。

密钥	类型	违约	Description
`allowed_urls`	`string[]`	`[]`	允许的 URL 或域，无需提示。
`alt_screen`	`boolean`	`false`	使用终端备用屏幕缓冲区。
`auto_update`	`boolean`	`true`	自动下载 CLI 更新。
`banner`

          `"always"`
          \|
          `"once"`
          \|
          `"never"`
         | `"once"` | 动画横幅显示频率。 |

挂钩参考

钩子是在会话的特定生命周期节点执行的外部命令，用于实现自定义自动化、安全控制和集成。挂钩配置文件会自动从 .github/hooks/*.json 存储库中加载。

钩子配置格式

钩子配置文件使用带有版本的 JSON 格式1:

{
  "version": 1,
  "hooks": {
    "preToolUse": [
      {
        "type": "command",
        "bash": "your-bash-command",
        "powershell": "your-powershell-command",
        "cwd": "optional/working/directory",
        "env": { "VAR": "value" },
        "timeoutSec": 30
      }
    ]
  }
}

字段	类型	必选	Description
`type`	`"command"`	是的	必须是 `"command"`。
`bash`	字符串	其中一个 `bash`/`powershell`	Unix 的 Shell 命令。
`powershell`	字符串	其中一个 `bash`/`powershell`	适用于 Windows 的 Shell 命令。
`cwd`	字符串	否	命令的工作目录（相对于存储库根目录或绝对目录）。
`env`	对象	否	要设置的环境变量（支持变量扩展）。
`timeoutSec`	数字	否	超时时间（以秒为单位）默认值：`30`。

挂钩事件

事件	触发时间	已处理的输出
`sessionStart`	新的或已恢复的会话开始。	否
`sessionEnd`	会话终止。	否
`userPromptSubmitted`	用户提交提示。	否
`preToolUse`	在每个工具执行之前。	是 — 可以允许、拒绝或修改。
`postToolUse`	每个工具完成操作后。	否
`agentStop`	主代理完成回合。	是 — 可以阻止和强制继续。
`subagentStop`	子代理完成。	是 — 可以阻止和强制延续。
`errorOccurred`	执行期间发生错误。	否

          `preToolUse` 决策控制

挂钩 preToolUse 可以通过将 JSON 对象写入 stdout 来控制工具执行。

字段	价值观	Description
`permissionDecision`

          `"allow"`、`"deny"`、`"ask"` | 工具是否已执行? 空输出使用默认行为。 |

          `agentStop`
           / 
          `subagentStop` 决策控制

字段	价值观	Description
`decision`

          `"block"`、`"allow"` | 
          `"block"` 强制另一个代理将 `reason` 作为提示。 |

| reason | 字符串 | 当decision是"block"时，提示下一轮。 |

挂钩匹配工具名称

工具名称	Description
`bash`	执行 shell 命令（Unix）。
`powershell`	执行 shell 命令（Windows）。
`view`	读取文件内容。
`edit`	修改文件内容。
`create`	创建新文件。
`glob`	按模式查找文件。
`grep`	搜索文件内容。
`web_fetch`	抓取网页。
`task`	运行子代理任务。

如果配置了同一类型的多个挂钩，则它们按顺序执行。对于 preToolUse，如果任何挂钩返回 "deny"，则阻止该工具。挂钩故障（非零退出代码或超时）会记录并跳过，它们永远不会阻止代理执行。

MCP 服务器配置

MCP 服务器向 CLI 代理提供其他工具。在~/.copilot/mcp-config.json中配置持久性服务器。使用 --additional-mcp-config 来为单个会话添加服务器。

传输类型

类型	Description	必填字段
`local` / `stdio`	本地进程通过 stdin/stdout 进行通信。

          `command`、`args` |

| http | 使用可流式 HTTP 传输的远程服务器。 | url | | sse | 使用服务器发送事件 (Server-Sent Events) 传输的远程服务器。 | url |

本地服务器配置字段

字段	必选	Description
`command`	是的	用于启动服务器的命令。
`args`	是的	命令参数（数组）。
`tools`	是的	要启用的工具：`["*"]`，可以是所有工具或特定工具名称的列表。
`env`	否	环境变量。支持`$VAR`和${VAR}``${VAR:-default}扩展。
`cwd`	否	服务器的工作目录。
`timeout`	否	工具调用超时（以毫秒为单位）。
`type`	否

          `"local"` 或 `"stdio"`。 默认值：`"local"`。 |

远程服务器配置字段

字段	必选	Description
`type`	是的

          `"http"` 或 `"sse"`。 |

筛选器映射

控制如何使用服务器配置中的filterMapping字段来处理 MCP 工具输出。

模式	Description
`none`	无筛选。
`markdown`	将输出格式化为 Markdown。
`hidden_characters`	删除隐藏或控制字符。违约。

内置 MCP 服务器

CLI 包括内置 MCP 服务器，这些服务器在没有其他设置的情况下可用。

Server	Description
`github-mcp-server`	GitHubAPI 集成：问题、拉取请求、提交、代码搜索和 GitHub Actions。
`playwright`	浏览器自动化：导航、单击、键入、屏幕截图和表单处理。
`fetch`	通过该工具发送的 HTTP 请求。
`time`	时间实用工具： `get_current_time` 和 `convert_time`。

用于 --disable-builtin-mcps 禁用所有内置服务器，或 --disable-mcp-server SERVER-NAME 禁用特定服务器。

技能指南

功能是 Markdown 文件，用来扩展 CLI 的能力。每个技能都位于其自己的目录中，其中包含一个 SKILL.md 文件。调用（通过 /SKILL-NAME 或自动由代理调用）时，技能的内容将注入到会话中。

技能前置元数据字段

字段	类型	必选	Description
`name`	字符串	是的	技能的唯一标识符。仅字母、数字和连字符。最多 64 个字符。
`description`	字符串	是的	技能的作用以及何时使用它。最多 1024 个字符。
`allowed-tools`	String 或 String[]	否	技能处于活动状态时自动允许的工具的逗号分隔列表或 YAML 数组。将 `"*"` 用于所有工具。
`user-invocable`	布尔	否	用户是否可以调用技能 `/SKILL-NAME`。默认值：`true`。
`disable-model-invocation`	布尔	否	阻止代理自动调用此技能。默认值：`false`。

技能位置

技能将按照优先顺序从这些位置加载（在重复名称中，首次找到的优先）。

位置	Scope	Description
`.github/skills/`	项目	特定于项目的技能。
`.agents/skills/`	项目	替代项目位置。
`.claude/skills/`	项目	与 Claude 兼容的位置。
父母 `.github/skills/`	继承	Monorepo 父目录支持。
`~/.copilot/skills/`	个人	适用于所有项目的个人技能。
`~/.claude/skills/`	个人	与 Claude 兼容的个人定位设置。
插件目录	插件	已安装插件中的技能。
`COPILOT_SKILLS_DIRS`	Custom	其他目录（逗号分隔）。

代理人	默认模型	Description
`explore`	claude-haiku-4.5	快速代码库浏览。搜索文件、读取代码和回答问题。提供不超过300字的简明答案。可以安全地并行运行。
`task`	claude-haiku-4.5	命令执行（测试、构建、代码检查）。成功时返回简要摘要，失败时返回全部输出。
`code-review`	claude-sonnet-4.5	高信噪比代码审查。分析代码差异中的缺陷、安全问题和逻辑错误。
`general-purpose`	claude-sonnet-4.5	支持复杂多步骤任务的全功能代理。在单独的上下文窗口中运行。

自定义代理程序前端字段

字段	类型	必选	Description
`name`	字符串	否	显示名称。默认为文件名。
`description`	字符串	是的	说明显示在代理列表和`task` 工具中。
`model`	字符串	否	此代理的 AI 模型。未设置时，继承外部代理的模型。
`tools`	字符串[]	否	代理可用的工具。默认值： `["*"]` （所有工具）。
`mcp-servers`	对象	否	要连接的 MCP 服务器。使用与`~/.copilot/mcp-config.json`相同的模式。
`infer`	布尔	否	允许主代理自动委派。默认值：`true`。

自定义代理位置

Scope	位置
项目

          `.github/agents/` 或 `.claude/agents/` |

| 用户 | ~/.copilot/agents/ 或 ~/.claude/agents/ | | 插件 | <plugin>/agents/ |

项目级代理优先于用户级代理。插件代理的优先级最低。

权限审批结果

当 CLI 提示执行作的权限时，可以使用以下键进行响应。

密钥	影响
`y`	允许此特定请求一次。
`n`	拒绝此特定请求一次。
`!`	允许会话其余部分的所有类似请求。
`#`	拒绝会话其余部分的所有类似请求。
`?`	显示有关请求的详细信息。

运行 /clear 或启动新会话时，会话审批会重置。

Flag	层	Description
`AUTOPILOT_MODE`	`experimental`	自动运行模式。
`BACKGROUND_AGENTS`	`staff`	在后台运行代理。
`QUEUED_COMMANDS`	`staff`	代理运行时的队列命令。
`LSP_TOOLS`	`on`	语言服务器协议工具。
`PLAN_COMMAND`	`on`	交互式规划模式。
`AGENTIC_MEMORY`	`on`	跨会话的持久内存。
`CUSTOM_AGENTS`	`on`	自定义代理定义。

本文内容