Skip to main content

GitHub Copilot CLI 命令参考

查找有助于你有效使用 Copilot 命令行界面(CLI) 的命令和键盘快捷键。

命令行命令

Command目的
copilot启动交互模式。
copilot help [topic]显示帮助信息。 帮助主题包括:config、、commands``environmentloggingpermissions
copilot init初始化此存储库的Copilot自定义说明
copilot update下载并安装最新版本。
copilot version显示版本信息并检查更新。
copilot plugin管理插件和插件市场。

交互模式下的全局快捷方式

Shortcut目的
@ FILENAME将文件内容包含在上下文中。
          <kbd>Ctrl</kbd>+然后 <kbd>X</kbd>`/`  | 开始键入提示后,这样就可以运行斜杠命令,例如,如果要更改模型,而无需重新键入提示。 |

| Esc | 取消当前操作。 | | ! COMMAND | 在本地 shell 中执行命令,绕过 Copilot。 | | Ctrl+C | 取消操作/清除输入。 按两次退出。 | | Ctrl+D | 关闭。 | | Ctrl+L | 清除屏幕。 |

交互模式下的时间线快捷方式

Shortcut目的
ctrl+o没有输入时,这将扩展 Copilot 中的最近项目的响应时间轴,以显示更多详细信息。
ctrl+e没有输入时,这会展开 Copilot 响应时间线中的所有项目。
Shortcut目的
Ctrl+A移动到行首(输入时)。
          <kbd>Ctrl</kbd>+<kbd>E</kbd>        | 移动到行的末尾(键入时)。       |

| Ctrl+H | 删除上一个字符。 | | Ctrl+W | 删除上一个单词。 | | Ctrl+U | 从光标删除到行首。 | | Ctrl+K | 从光标删除到行尾。 | | +/ | 按单词移动光标。 | | / | 浏览命令历史。 |

交互模式下的斜杠命令

Command目的
/add-dir PATH将目录添加到允许的文件访问列表。
/agent浏览并选择可用代理(如果有)。
          `/allow-all`、`/yolo`                               | 启用所有权限(工具、路径和 URL)。 |

| /clear/new | 清除对话历史记录。 | | /compact | 汇总对话历史记录以减少上下文窗口使用情况。 | | /context | 显示上下文窗口令牌使用情况和可视化效果。 | | /cwd/cd [PATH] | 更改工作目录或显示当前目录。 | | /delegate [PROMPT] | 使用 AI 生成的拉取请求提交更改到远程存储库。 | | /diff | 查看当前目录中所做的更改。 | | /exit/quit | 退出 CLI。 | | /experimental [on\|off] | 切换或打开/关闭实验功能。 | | /share [file\|gist] [PATH] | 将会话共享到 Markdown 文件或 GitHub Gist。 | | /feedback | 提供有关 CLI 的反馈。 | | /help | 显示交互式命令的帮助。 | | /ide | 连接到 IDE 工作区。 | | /init | 为此存储库初始化 Copilot 自定义指令和智能体功能。 | | /list-dirs | 显示允许访问文件的所有目录。 | | /login | 登录 Copilot。 | | /logout | 退出 Copilot。 | | /lsp [show\|test\|reload\|help] [SERVER-NAME] | 管理语言服务器配置。 | | /mcp [show\|add\|edit\|delete\|disable\|enable] [SERVER-NAME] | 管理 MCP 服务器配置。 | | /model/models [MODEL] | 选择要使用的 AI 模型。 | | /plan [PROMPT] | 在编码之前创建实现计划。 | | /plugin [marketplace\|install\|uninstall\|update\|list] [ARGS...] | 管理插件和插件市场。 | | /rename NAME | 重命名当前会话(/session rename 的别名)。 | | /reset-allowed-tools | 重置允许的工具列表。 | | /resume [SESSION-ID] | 切换到其他会话(可选)指定会话 ID。 | | /review [PROMPT] | 运行代码评审代理以分析更改。 | | /session [checkpoints [n]\|files\|plan\|rename NAME] | 显示会话信息和工作区摘要。 请使用子命令查看详细信息。 | | /skills [list\|info\|add\|remove\|reload] [ARGS...] | 管理技能以提升能力。 | | /terminal-setup | 为多行输入支持配置终端(Shift+EnterCtrl+Enter)。 | | /theme [show\|set\|list] [auto\|THEME-ID] | 查看或配置终端主题。 | | /usage | 显示会话使用情况指标和统计信息。 | | /user [show\|list\|switch] | 管理当前 GitHub 用户。 |

可用斜杠命令的完整列表可以通过在交互模式下输入 /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作为 JSON 字符串或文件路径(前缀为 @)的附加 MCP 服务器配置(可多次使用)。 将~/.copilot/mcp-config.json的配置扩充到此会话中。
--agent AGENT指定要使用的自定义代理。
--allow-all启用所有权限(等效于 --allow-all-tools --allow-all-paths --allow-all-urls)。
--allow-all-paths禁用文件路径验证并允许访问任何路径。
--allow-all-tools允许所有工具在不确认的情况下自动运行。 在非交互模式下(env: COPILOT_ALLOW_ALL)是必需的。
--allow-all-urls允许在没有确认的情况下访问所有 URL。
--allow-tool [TOOLS...]CLI 有权使用的工具。 不会提示输入权限。
--allow-url [URLS...]允许访问特定的网址或域。
--available-tools [TOOLS...]只有这些工具可供模型使用。
--banner显示启动横幅。
--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`选项被覆盖。 |

| --excluded-tools [TOOLS...] | 这些工具将不适用于模型。 | | --experimental | 启用实验性功能(使用 --no-experimental 进行禁用)。 | | -h--help | 显示帮助。 | | -i PROMPT--interactive PROMPT | 启动交互式模式并自动执行此提示。 | | --log-dir DIRECTORY | 设置日志文件目录(默认值: ~/.copilot/logs/)。 | | --log-level LEVEL | 设置日志级别(选项:none、、error``warninginfodebugall``default)。 | | --model MODEL | 设置要使用的 AI 模型。 | | --no-ask-user | ask_user禁用该工具(代理在不提出问题的情况下自主工作)。 | | --no-auto-update | 禁用自动下载 CLI 更新。 | | --no-color | 禁用所有颜色输出。 | | --no-custom-instructions | 禁止从 AGENTS.md 相关文件中加载自定义指令。 | | -p PROMPT--prompt PROMPT | 在非交互模式下执行提示(完成后退出)。 | | --plain-diff | 禁用富差异渲染(通过你的 git 配置指定的差异工具进行语法高亮显示)。 | | --resume [SESSION-ID] | 从上一个会话恢复((可选)指定会话 ID)。 | | -s--silent | 仅输出代理响应(不使用使用情况统计信息),对于使用 -p脚本编写非常有用。 | | --screen-reader | 启用屏幕阅读器优化。 | | --share [PATH] | 在非交互模式下,完成会话后将其保存为 Markdown 文件(默认路径:./copilot-session-<ID>.md)。 | | --share-gist | 在非交互式模式下完成后,将会话共享到机密 GitHub Gist。 | | --stream MODE | 启用或禁用流模式(模式选项: onoff)。 | | -v--version | 显示版本信息。 | | --yolo | 启用所有权限(等效于 --allow-all-tools --allow-all-paths --allow-all-urls)。 |

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