GitHub Copilot CLI 场景化使用指南

我想…… → 用什么

我想……	用什么	详见
一直在底部看到上下文占用 / 模型 / 额度	`/statusline`（= `/footer`）勾选 Context window 等；或 `/settings footer.showContextWindow on`	/statusline
改某个设置，但不知道有哪些可改	直接输入 `/settings` 打开设置界面，按 `/` 搜索；或 `copilot help config`	/settings、设置一览
看现在上下文用了多少	`/context`	/context
上下文快满了 / 对话太长	`/compact [重点说明]`	/compact
换模型、调推理强度、开长上下文	`/model`（列表中 Tab 切长上下文）	/model
plan 模式用另一个模型	`/model plan`	/model
先出方案再动手	`/plan 需求` 或 Shift+Tab 切到 plan 模式	/plan
让它自己一路干完	`/autopilot 目标`（= `/goal`），可加 `--max-ai-credits N`	/autopilot
把大任务拆给多个子代理并行	`/fleet 任务`	/fleet
撤销上一轮（含文件改动）	`/rewind`（= `/undo`）或空闲时 Esc Esc	/rewind
看它改了哪些代码	`/diff`	/diff
让 AI 做代码审查 / 安全审查	`/review`、`/security-review`	/review、/security-review
要一个独立的第二意见	`/rubber-duck`	/rubber-duck
创建 PR、修 CI、修冲突	`/pr create`、`/pr fix`、`/pr auto`	/pr
回到之前的会话	`/resume`；命令行 `copilot --continue` / `copilot -r 名称`	/resume
开一个全新对话	`/new`（= `/clear`）	/new
顺便问个小问题但不污染上下文	`/ask 问题`（= `/btw`）	/ask
把文件 / issue 放进上下文	`@文件路径`、`#issue号`	速查卡
不经模型直接跑 shell 命令	`!命令`	速查卡
不想每次都点批准	`/permissions allow-all`（= `/yolo`）或启动时 `--allow-tool='shell(git:*)'`	/permissions、权限章节
允许它读写工作目录外的目录	`/add-dir 路径`	/add-dir
导出 / 分享会话记录	`/share file\|html\|gist`	/share
给本次会话设花费上限	`/limits set max-ai-credits N`	/limits
看本次会话用量	`/usage`	/usage
接入 MCP 服务器	`/mcp add` 或 `copilot mcp add`	/mcp
管理 skills	`/skills`、`copilot skill list`	/skills
安装插件	`/plugin install 来源`	/plugin
生成仓库的 Copilot 指令文件	`/init`	/init
确认到底加载了哪些指令 / MCP / skills	`/env`、`/instructions`	/env、/instructions
多行输入 / 用编辑器写长提示	Shift+Enter、Ctrl+G；不生效时 `/terminal-setup`	/terminal-setup
换配色主题	`/settings theme dim`	/theme
在新 git worktree 里并行开发	`/worktree`、`/move`、`/fork worktree`	/worktree
在脚本 / CI 里非交互运行	`copilot -p "…" --allow-all-tools -s`	启动参数
CLI 行为异常想排查	`/diagnose`、`/collect-debug-logs`	/diagnose
长任务时防止电脑睡眠	`/keep-alive busy`	/keep-alive
定时 / 延时自动执行提示	`/every 1h …`、`/after 30m …`（实验性）	/every
看新版本更新了什么	`/changelog summarize`	/changelog
状态栏显示自定义内容（脚本输出）	设置项 `statusLine` + `footer.showCustom`	/statusline
全局 / 仓库级别给 AI 写规则	`~/.copilot/copilot-instructions.md`、`AGENTS.md`、`.github/copilot-instructions.md`	指令文件位置

⌨️ 快捷键与输入前缀速查卡（点击展开）

输入前缀

前缀	作用	备注
`@路径`	把文件/目录作为上下文附加到提示中，输入 `@` 会弹出文件选择器	受 `respectGitignore` 影响（默认排除 gitignore 文件）
`#123`	引用当前仓库的 issue / PR 作为上下文	需要 GitHub 远端；未核实跨仓库写法
`!命令`	不经过模型，直接在本地 shell 执行命令	单独输入 `!` 进入 shell 模式
`$`（单独一个，回车）	打开一个以会话目录为根的真正交互式 shell	设置项 `shellShortcut` 控制（默认开）
`?`（空输入时）	打开快捷帮助
`/`	斜杠命令；输入时自动补全	打字中途可按 Ctrl+X 然后 / 执行斜杠命令

全局 / 中断

按键	作用
Esc	取消当前操作 / 关闭弹窗
Esc Esc	中断正在运行的回合；空闲时打开回退（rewind）选择器
Ctrl+C	清空输入；连按两次退出
Ctrl+D	关闭（shutdown）
Ctrl+L	清屏
Shift+Tab	循环切换模式：标准 → plan → autopilot
Ctrl+T	显示 / 隐藏模型推理过程（reasoning）

输入编辑

按键	作用
Shift+Enter / Alt+Enter	换行（多行输入）；不生效时运行 /terminal-setup
Ctrl+G 或 Ctrl+X e	在外部编辑器（`$EDITOR` / `COPILOT_EDITOR`）中编辑当前提示
Ctrl+Q 或 Ctrl+Enter	代理运行中把提示排队（queue），本回合结束后发送
Ctrl+S	暂存（stash）当前输入
Ctrl+R	搜索历史提示（条数由 `commandHistoryMaxSize` 控制）
Ctrl+P / ↑ ↓	浏览历史提示
Ctrl+V	粘贴附件（文件/图片）
Alt+V	粘贴剪贴板图片
Ctrl+Space 或 Ctrl+X v	语音输入开关（见 /voice）

Ctrl+X 前缀组合

按键	作用
Ctrl+X 然后 /	打字途中执行斜杠命令（如 `/refine` 清理当前输入）
Ctrl+X 然后 b	把正在运行的任务转入后台
Ctrl+X 然后 g	展开 / 折叠 goal（autopilot 目标）面板
Ctrl+X 然后 h	隐藏侧边栏
Ctrl+X 然后 o	打开最近一个链接
Ctrl+X 然后 x	关闭当前会话
Ctrl+X 然后 e	同 Ctrl+G，打开外部编辑器

时间线 / 侧边栏

按键	作用
Ctrl+O / Ctrl+E	展开时间线中折叠的工具输出
Ctrl+F	搜索时间线
← / →（空输入时）	打开侧边栏（设置项 `sidebar` 控制）
/diff 中：c / b / w	c 添加评论，b 切换分支 diff，w 忽略空白（来源：官方文档，未核实）

① 启动与会话

如何启动 CLI、登录、管理会话与工作目录。启动参数和子命令完整表格在本章末尾。

copilot（启动）入门

用途: 在当前目录启动交互式会话；也可以带提示启动或在脚本里一次性执行。
语法 / 子命令: copilot [选项]
copilot -i "提示"　（交互模式并立即执行该提示）
copilot -p "提示" [--allow-all-tools] [-s]　（非交互，执行完退出）
典型示例: copilot
copilot -C D:\work\repo --model auto
copilot -p "总结这个仓库" --allow-all-tools -s > summary.md
copilot --continue　（接着上次会话）
相关配置 / 快捷键: 完整参数见启动参数表；默认模型由设置 model / 环境变量 COPILOT_MODEL 决定。
易混淆点: -i 进入交互界面并执行；-p 不进界面、执行完即退出，需要 --allow-all-tools（或 --yolo）才能让工具自动运行。-s 只输出回答，适合管道。

/login入门

用途: 登录 GitHub 账号以使用 Copilot。
语法 / 子命令: /login
shell：copilot login [--host HOST] [--web-flow | --device-code | --with-token]
典型示例: copilot login --device-code
相关配置 / 快捷键: 环境变量 COPILOT_GITHUB_TOKEN > GH_TOKEN > GITHUB_TOKEN 存在时优先于已保存的登录；GHE 用 GH_HOST / COPILOT_GH_HOST。
易混淆点: 没有系统钥匙串时 token 默认不落盘，可用设置 storeTokenPlaintext 允许明文存入 config.json（不推荐）。

/logout进阶

用途: 登出当前 OAuth 登录。
语法 / 子命令: /logout
易混淆点: 通过环境变量提供的 token 不受 /logout 影响，需要自行取消环境变量。

/user进阶

用途: 管理已登录的多个账号（查看 / 列出 / 切换）。
语法 / 子命令: /user [show | list | switch]
典型示例: /user switch

/new别名：/clear、/reset入门

用途: 开始一个新对话（新会话）。
语法 / 子命令: /new [首条提示]
/new worktree [提示]　（在新 git worktree 中开空会话，当前会话保持不变）
典型示例: /new 帮我看一下 README
相关配置 / 快捷键: 会话上限计数（/limits）在 /new、/clear 后重置已用量，但保留上限值。
易混淆点: 1.0.100 的 /help 把 /new（开始新对话）和 /clear（放弃当前会话重新开始）分开列出；官方文档称 /clear、/new、/reset 互为别名。旧会话仍可通过 /resume 找回（未核实是否所有情况都保留）。

/rename进阶

用途: 重命名当前会话；不带参数时根据对话自动生成名称。方便以后 copilot -r 名称 恢复。
语法 / 子命令: /rename [名称]
典型示例: /rename 登录模块重构
相关配置 / 快捷键: 启动时 copilot -n 名称 直接命名；等价于 /session rename。

/session别名：/sessions进阶

用途: 查看和管理会话：信息、检查点、改动文件、计划、清理。
语法 / 子命令: /session [info | checkpoints [n] | files | plan | rename [名称] | cleanup | prune | delete [ID] | delete-all]
典型示例: /session info　（含会话链接）
/session checkpoints
/session files
相关配置 / 快捷键: 会话数据在 ~/.copilot/session-state/、~/.copilot/session-store.db。
易混淆点: /session 管理会话数据；切换会话请用 /resume。

/fork别名：/branch进阶

用途: 把当前会话分叉成一个新会话（保留上下文）；原会话可继续在后台运行。
语法 / 子命令: /fork [名称]
/fork worktree　（分叉到基于当前分支 HEAD 的新 worktree）
典型示例: /fork 方案B尝试
相关配置 / 快捷键: worktree 位置由 worktreePathTemplate 决定。
易混淆点: /fork 复制上下文；/new 是空白会话。

/worktree进阶

用途: 新建一个 git worktree 并切换进去，未提交的改动留在原工作区。
语法 / 子命令: /worktree [分支名 | 任务描述]
（旧写法 /worktree new 已弃用，改用 /new worktree）
典型示例: /worktree feature/login
/worktree 实现导出 CSV 功能
相关配置 / 快捷键: worktreeBaseRef：head（默认，从当前检出）或 defaultBranch（从远端默认分支）；worktreePathTemplate：如 ~/src/worktrees/{repo}/{branch}。
易混淆点: /worktree 把改动留下；/move 把未提交改动带走。需要 Git 仓库。

/move进阶

用途: 把当前未提交的改动移动到一个新的 git worktree 并切换过去。
语法 / 子命令: /move [分支名 | 任务描述]
典型示例: /move fix/typo
相关配置 / 快捷键: 同 /worktree 的两个设置。
易混淆点: 与 /worktree 的区别：/move 会带走未提交改动。

/cwd别名：/cd入门

用途: 显示或切换当前工作目录。
语法 / 子命令: /cwd [路径]
典型示例: /cwd ..\other-repo
相关配置 / 快捷键: 启动时 -C 目录。
易混淆点: 切换目录不等于授权访问；访问其他目录用 /add-dir（未核实 /cwd 后是否自动授权新目录）。

/exit别名：/quit入门

用途: 关闭当前会话；若还有别的会话在运行则切到最新的那个，最后一个会话时退出 CLI。
语法 / 子命令: /exit [print]　（print：退出后打印会话记录）
典型示例: /exit print
相关配置 / 快捷键: Ctrl+C 两次 / Ctrl+D 也可退出；代理运行中可用 Ctrl+Q 把 /exit 排队。

/restart进阶

用途: 重启 CLI，并恢复本进程中的活动会话（常用于应用已下载的新版本）。
语法 / 子命令: /restart
相关配置 / 快捷键: autoUpdate 下载的新版本会在下次启动或 /restart 时生效。

/keep-alive别名：/caffeinate进阶

用途: 防止系统睡眠：会话期间一直保持、仅代理工作时保持、或保持指定时长。
语法 / 子命令: /keep-alive [on | off | busy | 时长]　（时长如 30、30m、2h、1d；纯数字=分钟）
典型示例: /keep-alive busy
/keep-alive 2h
相关配置 / 快捷键: 设置项 keepAlive（off/on/busy）为启动时的默认值。

/app进阶未核实

用途: 在 GitHub Copilot 桌面 App 中打开当前会话；未安装时显示下载地址。
语法 / 子命令: /app
shell：copilot app
易混淆点: 官方文档写“需要 1.1.3 或更高版本”，但 1.0.100 的 /help 已列出此命令；实际行为未核实。

启动参数完整表 copilot [OPTIONS]（来源：本机 copilot --help）

参数	作用	备注
`-i, --interactive <提示>`	启动交互模式并立即执行该提示
`-p, --prompt <文本>`	非交互模式执行提示，完成后退出	通常配合 `--allow-all-tools`
`-s, --silent`	只输出代理回答（无统计），适合脚本	配合 `-p`
`--fleet`	以 fleet 模式（并行子代理）运行提示	配合 `-i` / `-p` / 管道输入
`--mode <interactive\|plan\|autopilot>`	设置初始模式	优先于设置 `defaultMode`
`--plan`	以 plan 模式启动	`--plan --mode autopilot`：自动批准计划并实现
`--autopilot`	以 autopilot 模式启动
`--max-autopilot-continues <次数>`	autopilot 最多自动继续的次数	默认 5
`--max-ai-credits <数值>`	本会话 AI credit 上限	见 /limits
`--no-ask-user`	禁用 ask_user 工具，代理不再提问	设置 `askUser`
`--attachment <路径>`	给初始提示附加文件（图片/文档），仅非交互	可多次
`--output-format <text\|json>`	输出格式，json 为 JSONL
`--stream <on\|off>`	开关流式输出	设置 `stream`
`--share [路径]`、`--share-gist`	非交互完成后把会话导出为 Markdown / 私密 gist
`--usage-output-file <文件>`	把最终用量统计写成 JSON
`--enable-memory`	在 prompt（非交互）模式启用记忆（默认关）
`--model <模型>`	指定模型（`auto` 自动挑选）	环境变量 `COPILOT_MODEL`
`--reasoning-effort <级别>`	推理强度：none / minimal / low / medium / high / xhigh / max
`--context <default\|long_context>`	上下文窗口档位（覆盖已保存设置）
`--auto-tier <偏好>`	Auto 模型的路由偏好
`--agent <代理>`	使用指定自定义代理
`-r, --resume [值]`	恢复会话（ID、任务 ID、ID 前缀或名称；不带值打开选择器）
`--continue`	恢复最近一次会话
`-n, --name <名称>`	为新会话命名
`--session-id <id>`	按 ID 恢复会话 / 任务，或为新会话指定 UUID
`--connect [会话ID]`	直接连接到远程会话
`-C <目录>`	先切换到该目录再启动
`--allow-all-tools`	所有工具自动运行不询问；非交互模式必需	环境变量 `COPILOT_ALLOW_ALL`
`--allow-all-paths`	关闭路径校验，可访问任意路径
`--allow-all-urls`	所有 URL 不询问
`--allow-all`、`--yolo`	以上三者合一
`--allow-tool [工具...]`、`--deny-tool [工具...]`	按模式允许 / 拒绝工具（拒绝优先）	写法见 ⑥ 权限
`--available-tools`、`--excluded-tools`	决定模型能看到哪些工具（白名单 / 黑名单）
`--allow-url`、`--deny-url`	允许 / 拒绝 URL 或域名（拒绝优先，默认 https）
`--add-dir <目录>`	允许访问额外目录并加载其 .github skills/agents	可多次
`--disallow-temp-dir`	禁止自动访问系统临时目录
`--secret-env-vars [变量...]`	这些环境变量的值不传给 shell/MCP，且在输出中打码
`--trust-folder`	仅对这一次 prompt 模式会话信任当前目录配置
`--assisted-approval`	用 assisted 安全判官审核工具请求（需实验模式）	= `/permissions assisted`
`--additional-mcp-config <json\|@文件>`	本次会话额外加载 MCP 配置	可多次
`--disable-mcp-server <名称>`、`--enable-mcp-server <名称>`	本次禁用 / 启用指定 MCP 服务器
`--disable-builtin-mcps`	禁用全部内置 MCP（github-mcp-server、githubiq）
`--add-github-mcp-tool`、`--add-github-mcp-toolset`、`--enable-all-github-mcp-tools`	调整内置 GitHub MCP 开放的工具
`--mcp-github-auth <server=origin>`	仅向指定额外 MCP 服务器发送 GitHub 凭据
`--allow-all-mcp-server-instructions`	把所有 MCP 服务器的初始化说明放入系统提示
`--plugin-dir <目录>`	从本地目录加载插件	可多次
`--no-custom-instructions`	不加载 AGENTS.md 等自定义指令
`--dynamic-retrieval <类别=on\|off>`	开关基于向量的动态检索（目前类别：skills）并持久化
`--experimental`、`--no-experimental`	开关实验性功能
`--banner`	显示启动横幅	设置 `banner`
`--screen-reader`	屏幕阅读器优化
`--plain-diff`	关闭富文本 diff	`PLAIN_DIFF=true`
`--no-color`	关闭颜色	`NO_COLOR`
`--mouse [on\|off]`、`--no-mouse`	鼠标支持（会持久化）
`--bash-env [on\|off]`、`--no-bash-env`	BASH_ENV 支持（会持久化）
`--remote`、`--no-remote`、`--remote-export`、`--no-remote-export`	远程控制 / 远程导出	见 /remote
`--acp`	作为 Agent Client Protocol 服务器启动
`--environment-host <名称>`、`--environment-compute-id <id>`	无界面 Mission Control 环境相关	未核实具体用途
`--log-level <级别>`、`--log-dir <目录>`	日志级别 / 日志目录（默认 ~/.copilot/logs/）
`--no-auto-update`	不自动下载更新，运行可执行文件自带版本
`--disable-client-telemetry`	关闭 CLI 端遥测
`--extension-sdk-path <目录>`	替换扩展子进程使用的 copilot-sdk	开发用
`--no-eager-powershell-resolution`	Windows 上不在后台预解析 PowerShell
`-v, --version`、`-h, --help`	版本 / 帮助

子命令完整表（来源：本机各子命令 --help）

子命令	作用	示例 / 备注
`copilot app`	打开 GitHub Copilot 桌面 App
`copilot login`	登录	`--host`、`--web-flow`、`--device-code`、`--with-token`
`copilot help [主题]`	帮助	主题见 ⑨
`copilot init`	初始化仓库 Copilot 指令	= /init
`copilot config [键 [值]]`	查看 / 修改设置	`--list [--json]`、`--rm`、`--global\|--repo\|--local`；例：`copilot config footer.showQuota off`
`copilot update [stable\|prerelease]`	下载最新版本
`copilot version`	版本信息
`copilot workflow run`	运行已注册的动态工作流
`copilot sessions import`	从 JSONL 导入语义会话
`copilot memories import`	通过本地记忆服务导入记忆
`copilot plugin install\|uninstall\|update\|list\|enable\|disable\|marketplace`	管理插件	默认市场 awesome-copilot
`copilot mcp list\|get\|add\|remove\|enable\|disable`	管理 MCP 服务器	来源：用户 ~/.copilot/mcp-config.json；工作区 .mcp.json 或 .github/mcp.json；插件
`copilot skill list\|add\|remove\|enable\|disable`	管理 skills	项目 .github/skills、.agents/skills、.claude/skills；个人 ~/.copilot/skills、~/.agents/skills
`copilot instruction list`	列出发现的指令来源
`copilot lsp list`	列出已配置的语言服务器
`copilot sandbox ca`	管理沙箱凭据代理的 CA 证书
`copilot completion bash\|zsh\|fish`	生成 shell 补全脚本（也能补全设置键）	PowerShell 未在列表中

② 模型与上下文

选模型、推理强度、上下文窗口与用量控制。压缩上下文 /compact 写在 ⑤；底部常驻显示上下文占用见 /statusline。

/model别名：/models入门

用途: 选择 AI 模型、推理强度（effort）和上下文窗口档位；也可选 Auto 让 Copilot 自动挑。
语法 / 子命令: /model　（打开选择器）
/model 模型ID
/model auto [efficiency | balance | intelligence]
/model [--session | --global | --repo | --local] 模型ID
/model plan　（设置 plan 模式专用模型）
典型示例: /model claude-sonnet-5.5
/model --global gpt-5.4
/model auto balance
相关配置 / 快捷键: 选择器中 Tab 切换长上下文（long_context），Shift+Tab 切换分组。
设置：model、effortLevel、contextTier、autoTier、continueOnAutoMode；启动参数：--model、--reasoning-effort、--context、--auto-tier；环境变量 COPILOT_MODEL。仓库可用 .github/allowed_models.txt 限定可用模型。
易混淆点: 默认（或 --session）只改当前会话；--global（或 /settings model …）才改以后的默认值；--repo / --local 写入仓库设置。/model plan 写入的是 planModel / planEffortLevel（本机 settings.json 中可见，官方设置表未列出）。

/subagents别名：/agents进阶

用途: 为子代理（如 explore、task、rubber-duck 等）配置默认模型和各自的模型、推理强度、上下文档位；也可开关某个子代理。
语法 / 子命令: /subagents
相关配置 / 快捷键: 设置：subagents.agents.<名称>（model / modelPolicy / effortLevel / contextTier，可设 "inherit"）、subagents.disabledSubagents、subagents.maxConcurrency、subagents.maxDepth、subagents.agents["rubber-duck"].autoInvoke。
易混淆点: /subagents（别名 /agents）配置子代理模型；/agent（单数）是选择自定义代理，见 /agent。

/context入门

用途: 显示当前上下文窗口的 token 占用及可视化分布。
语法 / 子命令: /context
相关配置 / 快捷键: 想一直在底部看到占用：/statusline 勾选上下文项（footer.showContextWindow）。接近上限时用 /compact。
易混淆点: /context 看上下文 token；/usage 看本次会话的模型用量 / AI credits。

/usage入门

用途: 显示会话用量统计：按模型的 token 总数；按 token 计费的账号还显示各模型的 AI credits。
语法 / 子命令: /usage
相关配置 / 快捷键: 底部常驻显示：footer.showQuota、footer.showAiUsed；非交互时 --usage-output-file 文件 输出 JSON。

/limits进阶

用途: 查看或设置会话的 AI credit 软上限。
语法 / 子命令: /limits　（打开对话框）
/limits set max-ai-credits 数值
/limits unset [max-ai-credits | all]
典型示例: /limits set max-ai-credits 50
相关配置 / 快捷键: 启动参数 --max-ai-credits N；copilot help limits；autopilot 目标可单独加 --max-ai-credits（见 /autopilot）。
易混淆点: 最小值 30。是软上限：用量要在模型调用返回后才知道，单次调用可能超出。本机帮助说“作用于整个会话，/clear、/new 重置已用量”；官方文档写“每条用户消息重置”——两者不一致，以本机为准（未核实实际行为）。

③ 写代码：输入、模式与代理

日常写代码时的输入方式、三种模式（标准 / plan / autopilot）以及子代理、后台任务。输入前缀与快捷键见速查卡。

模式切换（Shift+Tab）入门

用途: 在三种模式间循环：标准（交互，每步可批准）→ plan（先出计划不改代码）→ autopilot（自主连续执行）。
语法 / 子命令: Shift+Tab
相关配置 / 快捷键: 设置 defaultMode（interactive / plan / autopilot）决定新会话初始模式；启动参数 --mode、--plan、--autopilot。
易混淆点: 模式 ≠ 权限。autopilot 只是不停下来问“下一步”，工具批准仍受 /permissions 控制。

/plan入门

用途: 让 Copilot 先给出实现计划，确认后再写代码。
语法 / 子命令: /plan [需求]
典型示例: /plan 给订单列表增加按日期筛选
相关配置 / 快捷键: /model plan 可给 plan 阶段单独配模型；计划可用 Ctrl+G 在编辑器中修改；/session plan 查看当前计划。
易混淆点: 启动参数 --plan --mode autopilot：自动批准计划并自主实现。

/autopilot别名：/goal进阶

用途: 开启 autopilot（自动驾驶）模式，可指定目标；代理会连续工作直到完成。
语法 / 子命令: /autopilot [目标] [--max-ai-credits N]
/goal on | off　（只开关模式，不设目标）
/goal --max-ai-credits N　（为暂停的目标续额度）
典型示例: /goal 重构 auth 模块 --max-ai-credits 5
相关配置 / 快捷键: Ctrl+X 然后 g 展开/折叠目标面板；设置 stayInAutopilot（完成后是否留在 autopilot）、defaultPermissionMode；启动参数 --autopilot、--max-autopilot-continues（默认 5）。
易混淆点: 达到 credit 上限会暂停并弹面板；输入新额度是“新的完整额度”，不是增量。

/fleet进阶

用途: 开启 fleet 模式：把任务拆成多部分，由多个子代理并行执行。
语法 / 子命令: /fleet [任务]
启动：copilot --fleet -p "…"
典型示例: /fleet 给所有 service 类补单元测试
相关配置 / 快捷键: 并发上限 subagents.maxConcurrency（仅按用量计费用户生效）；任务进度见 /tasks。
易混淆点: fleet 是并行子代理；/autopilot 是单代理连续执行。

/tasks进阶

用途: 查看和管理任务：子代理、后台 shell 命令。
语法 / 子命令: /tasks
相关配置 / 快捷键: Ctrl+X 然后 b：把当前运行的任务转入后台。

/agent进阶

用途: 浏览并选择自定义代理（custom agent）来处理当前会话。
语法 / 子命令: /agent [名称]
启动：copilot --agent 名称
典型示例: /agent agent-leader-coordinator
相关配置 / 快捷键: 自定义代理文件位置见 ⑧ 扩展；设置 customAgents.defaultLocalOnly。
易混淆点: 单数 /agent 选代理；复数 /agents 是 /subagents 的别名。

/ask别名：/btw入门

用途: 问一个旁支小问题，不写入对话历史、不占用主上下文。
语法 / 子命令: /ask [问题]　（不带问题时重新打开上一次的回答）
典型示例: /btw PowerShell 里怎么看环境变量？
相关配置 / 快捷键: 回答窗口中 Ctrl+E 展开、Ctrl+Y 复制全文。

/refine进阶

用途: 把随手写的、口语化的提示改写成清晰的提示供你确认（语音输入后特别有用）。
语法 / 子命令: /refine 文本
Ctrl+X 然后 /refine　（整理当前输入框内容）

/research进阶

用途: 使用 GitHub 搜索和网络来源做深度调研，生成调研报告。
语法 / 子命令: /research 主题
典型示例: /research Spring Boot 3 的虚拟线程最佳实践
相关配置 / 快捷键: 结果可用 /share research 导出。

/delegate进阶

用途: 把当前会话交给 GitHub 上的云端 Copilot 代理，由它在远端完成改动并创建 PR。
语法 / 子命令: /delegate [提示] [--base 目标分支]
典型示例: /delegate 完成剩余的单元测试 --base develop
易混淆点: /delegate 在 GitHub 云端干活；/pr 是在本地操作当前分支的 PR。

/ide进阶

用途: 连接到 IDE（如 VS Code）工作区：在 IDE 中审批 diff、共享选区与诊断信息。
语法 / 子命令: /ide
相关配置 / 快捷键: 设置 ide.autoConnect（启动时自动连接，默认 true）、ide.openDiffOnEdit（在 IDE 打开 diff 审批，默认 true）。

/lsp进阶

用途: 管理语言服务器（LSP）配置，让代理获得更准确的代码导航与诊断。
语法 / 子命令: /lsp [show | test | reload | logs | help] [服务器名]
shell：copilot lsp list
相关配置 / 快捷键: 配置文件 ~/.copilot/lsp-config.json。

/terminal-setup入门

用途: 配置终端以支持多行输入（Shift+Enter、Ctrl+Enter）。
语法 / 子命令: /terminal-setup
相关配置 / 快捷键: 多行输入快捷键见速查卡。
易混淆点: Shift+Enter 不换行时先运行它。

/vim进阶

用途: 切换输入框 Vim 模式（hjkl、w/b/e、d/c/y、u、Ctrl+R、. 重复等，Esc 回到普通模式）。
语法 / 子命令: /vim
相关配置 / 快捷键: 设置 editorMode：normal / vim。

/voice进阶

用途: 语音输入（通过 Foundry Local 本地听写转写）：开关、选择语音模型、选择麦克风。
语法 / 子命令: /voice [on | off | models | devices]
相关配置 / 快捷键: Ctrl+Space 或 Ctrl+X v 开关语音。

/computer进阶未核实

用途: 显示或开关 Computer Use（让代理操作电脑界面）。
语法 / 子命令: /computer
易混淆点: 官方命令表未收录，仅见于 1.0.100 /help；具体行为未核实。

/search别名：/find进阶实验性

用途: 在会话时间线中搜索文本。
语法 / 子命令: /search [关键词]
相关配置 / 快捷键: Ctrl+F 也可搜索时间线。

/every进阶实验性未在 /help 列出

用途: 在当前会话中定时重复执行一个提示、skill 或可调度的斜杠命令；不带参数打开调度管理器。来源：官方文档、copilot help config（beepOnSchedule）。
语法 / 子命令: /every [间隔] 提示
/after [延时] 提示　（只执行一次）
典型示例: /every 1h 运行测试
/after 30m /chronicle standup
相关配置 / 快捷键: 设置 beepOnSchedule（定时任务完成时是否提示音，需 beep 开启）。
易混淆点: 仅在实验模式可用（/settings experimental on，需重启）。

④ 审查与回退

看改动、让 AI 审查、撤销回退。

/diff入门

用途: 审查当前目录中的改动（交互式 diff 视图，可加评论反馈给代理）。
语法 / 子命令: /diff
相关配置 / 快捷键: diff 视图内：c 添加评论、b 切换分支 diff、w 忽略空白（官方文档，未核实）。启动参数 --plain-diff / 环境变量 PLAIN_DIFF=true 关闭富文本 diff。
易混淆点: 工作区干净时自动切到分支 diff（官方文档标为实验性）。

/review入门

用途: 运行代码审查代理分析改动，给出问题清单。
语法 / 子命令: /review [提示]
典型示例: /review 重点看并发和空指针
易混淆点: /review 是一般质量审查；/security-review 专注安全漏洞；/rubber-duck 是对方案/代码的独立第二意见。

/security-review进阶

用途: 对已暂存和未暂存的本地改动做安全审查，按优先级列出漏洞与修复建议。
语法 / 子命令: /security-review [提示]
易混淆点: 只看当前本地改动，不是全仓库安全审计。

/rubber-duck进阶

用途: 让“小黄鸭”代理对当前计划、代码、测试给出独立批评意见。
语法 / 子命令: /rubber-duck [提示]
典型示例: /rubber-duck 这个缓存失效方案有没有漏洞？
相关配置 / 快捷键: 设置 subagents.agents["rubber-duck"].autoInvoke：允许 Copilot 主动咨询小黄鸭（在 /subagents 中切换 Proactive invocation）。

/rewind别名：/undo入门

用途: 回退到之前的某个用户回合。可选：仅回退对话；或对话 + 文件（还原 Copilot 在这些回合中改过的文件，跳过你之后手动改过的）。
语法 / 子命令: /rewind　（打开回退选择器）
相关配置 / 快捷键: 空闲时按 Esc Esc 也会打开回退选择器。文件改动按回合追踪（包括编辑工具、shell 命令、子代理），不依赖 Git。
易混淆点: 1.0.100 /help 写“回退上一轮并还原文件改动”；官方文档为可选择的选择器。

⑤ 收尾：PR、分享、压缩、恢复

完成工作后的提交 PR、导出分享、压缩上下文、以后再接着做。

/pr入门

用途: 操作当前分支的 Pull Request：查看、创建、修复（CI 失败 / review 意见 / 冲突）、自动推到全绿、自动合并。
语法 / 子命令: /pr [view | create | fix | auto | automerge]
典型示例: /pr create
/pr fix
/pr fix conflicts
/pr auto　（推到全绿后停）
/pr automerge　（推到全绿并合并；别名 agentmerge）
相关配置 / 快捷键: 仓库有 PR 模板（.github/pull_request_template.md 等）时 create 默认遵循模板。设置 mergeStrategy（rebase / merge）决定 /pr fix conflicts 的方式；includeCoAuthoredBy 控制提交是否加 Co-authored-by。

/remote进阶

用途: 远程控制：从 GitHub 网页 / 手机端查看并操控本会话，或与另一个 CLI 共享。
语法 / 子命令: /remote [on | off]　（无参数显示状态）
相关配置 / 快捷键: 设置 remote（on / off，off=会话数据只留本地）、remoteExport；启动参数 --remote、--no-remote、--remote-export、--connect [会话ID]。

/copy入门

用途: 把上一条回复复制到剪贴板。
语法 / 子命令: /copy
相关配置 / 快捷键: 设置 copyOnSelect（鼠标选中即复制，Windows 默认关）。

/compact入门

用途: 把对话历史压缩成摘要，释放上下文窗口；可给出“重点保留什么”的指示。
语法 / 子命令: /compact [重点说明]
典型示例: /compact 重点保留 auth 模块的决定和待办
相关配置 / 快捷键: 先用 /context 或状态栏（/statusline）看占用。
易混淆点: 压缩会丢失细节；完全换话题时用 /new 更干净。

/resume别名：/continue入门

用途: 切换到另一个会话（本地或云端历史 ID、任务 ID、名称），不带参数时打开会话选择器。
语法 / 子命令: /resume [会话ID | 名称]
启动：copilot --continue　（最近一次）
　　　copilot -r [ID | ID前缀(7位+) | 名称]
　　　copilot --session-id ID
典型示例: copilot -r "登录模块重构"
相关配置 / 快捷键: 环境变量 COPILOT_ENABLE_INTERRUPTED_SESSION_RESTORE=1 可恢复被中断的会话（官方文档，未核实）。
易混淆点: /resume 切换会话；/session 管理会话数据；/fork 复制会话。

/chronicle进阶

用途: 基于会话历史的工具：站会总结、使用技巧、改进建议、重建索引，以及根据使用习惯起草仓库 skill。
语法 / 子命令: /chronicle <standup | tips | improve | reindex | skills create | skills review | skills status>
典型示例: /chronicle standup

⑥ 权限与安全

CLI 默认：读操作自动通过，写文件 / 执行命令 / 访问 URL 会询问；文件访问默认限于当前目录及子目录和系统临时目录。

/permissions入门

用途: 切换权限模式或查看当前模式；重置本会话已批准的工具与路径。
语法 / 子命令: /permissions [default | assisted | allow-all | show]
/permissions reset
典型示例: /permissions show
/permissions allow-all
相关配置 / 快捷键: 设置 defaultPermissionMode（manual / assisted / allow-all）决定新会话初始权限；permissions.disableBypassPermissionsMode 可禁止 allow-all 类参数。启动参数 --allow-all、--assisted-approval。
易混淆点: 命令里叫 default，设置里叫 manual，是同一种模式（写操作 / 命令询问，只读自动通过）。assisted 由 LLM 判断是否安全，不是安全边界。

/allow-all别名：/yolo入门

用途: 一键允许所有工具、路径和 URL（= /permissions allow-all）。
语法 / 子命令: /allow-all [off | auto | show]
典型示例: /yolo
/yolo off
相关配置 / 快捷键: 启动参数 --allow-all / --yolo（= --allow-all-tools --allow-all-paths --allow-all-urls）；环境变量 COPILOT_ALLOW_ALL。
易混淆点: --deny-tool 的拒绝规则优先于 allow-all。

/add-dir入门

用途: 允许访问一个额外目录，并把该目录的 .github/skills、.github/agents 作为可信配置加载。
语法 / 子命令: /add-dir 路径
启动：--add-dir 目录（可多次）
典型示例: /add-dir D:\shared\libs
相关配置 / 快捷键: 开启沙箱时也授予沙箱对该目录的访问。--allow-all-paths 取消路径校验；--disallow-temp-dir 禁止自动访问临时目录。

/list-dirs进阶

用途: 显示已允许访问的目录和本会话精确授权的路径。
语法 / 子命令: /list-dirs

/reset-allowed-tools进阶

用途: 重置本会话的工具批准和精确路径批准（之后会重新询问）。
语法 / 子命令: /reset-allowed-tools
易混淆点: 效果与 /permissions reset 相近。

/sandbox进阶

用途: 管理沙箱：限制 shell 命令、MCP/LSP 服务器和内置文件/网络工具的文件系统与网络访问。
语法 / 子命令: /sandbox [config | status | policy [命令] | enable | disable]
/sandbox enable session　（只对当前会话）
/sandbox ca [create | trust | rotate | remove]
shell：copilot sandbox ca …
典型示例: /sandbox status
相关配置 / 快捷键: 设置 sandbox.enabled、sandbox.allowBypass、sandbox.auth.git、sandbox.auth.gh、sandbox.credentials、sandbox.userPolicy.*（见设置一览）；copilot help sandbox。
易混淆点: 沙箱是硬限制；/permissions 只是审批流程。

权限模式写法（--allow-tool / --deny-tool 的 pattern；来源：copilot help permissions）

写法	含义	示例
`shell(命令)`	精确匹配某个 shell 命令；git/gh 按一级子命令匹配	`shell(git push)`、`shell(gh pr create)`
`shell(命令:*)`	匹配以该命令为词干的所有命令	`shell(git:*)` 匹配 git push，不匹配 gitea
`shell`	所有 shell 命令
`write` / `write(路径)`	创建 / 修改文件的工具（不含 shell 重定向）；相对路径按尾部匹配	`write(.env)` 匹配任意目录下的 .env
`MCP服务器名(工具名)`	某 MCP 服务器的某工具；省略工具名=全部	`MyMCP(my_tool)`、`MyMCP`
`url(域名或URL)`	URL 访问（shell 与 web-fetch）；默认 https	`url(https://*.github.com)`
组合示例	允许所有 git 但禁止 push	`copilot --allow-tool='shell(git:*)' --deny-tool='shell(git push)'`

⑦ 个性化：设置、状态栏、主题

先理解“设置入口之间的关系”，再查具体设置项。

设置入口之间的关系（都改的是同一批设置）

/settings（= /config）不带参数：打开可搜索的设置界面，适合“不知道有什么可改”时浏览。分 User / Repo / Repo (local) / Problems 四页。
/settings 键值：会话内一行改完；/settings 键 显示可选值；/settings show 键 看当前值；/settings unset 键 删除。
copilot config 键值：在 shell 里改（不用进 CLI）；copilot config --list 列出全部；列表型设置用 copilot config allowedUrls github.com 追加、--rm 删除。
专用命令：/model、/statusline、/theme、/memory、/vim、/keep-alive、/subagents、/sandbox 等，本质上都是写入对应设置键。
直接编辑文件：用户 ~/.copilot/settings.json；仓库共享 .github/copilot/settings.json（--repo）；仓库本地不提交 .github/copilot/settings.local.json（--local）。在设置界面按 Ctrl+E 也能打开。
~/.copilot/config.json 只存内部状态，不要在里面写设置（会被忽略）。

优先级（后者覆盖前者）：内置默认值 → 组织 MDM 策略 → 用户 ~/.copilot/settings.json → 仓库 .github/copilot/settings.json → 本地 .github/copilot/settings.local.json → 环境变量 → 命令行参数。
仓库级只能覆盖这些键：companyAnnouncements、contextTier、deniedUrls、disableAllHooks、disabledMcpServers、disabledSkills、effortLevel、enabledPlugins、extraKnownMarketplaces、hooks、includeCoAuthoredBy、mergeStrategy、model、respectGitignore（其中 deniedUrls / disabled* 为并集只增不减，respectGitignore 只能收紧）。
仓库还可用 .github/allowed_models.txt 限定模型：每行一个模型 ID 或通配（如 claude-sonnet-*），必须恰好一行 fallback: 模型ID，# 为注释。（来源：官方 config-dir 文档）

/settings别名：/config入门

用途: 打开设置界面，或在一行内查看 / 设置 / 删除某个设置。
语法 / 子命令: /settings　（打开可搜索的设置界面）
/settings 键　（打开并定位到该项，显示可选值）
/settings 键值
/settings show 键
/settings unset 键
/settings --repo | --local …　（写仓库设置）
典型示例: /settings theme dim
/settings footer.showContextWindow on
/settings show model
/settings unset effortLevel
相关配置 / 快捷键: 界面内：Tab / Shift+Tab 切换 User / Repo / Repo (local) / Problems 页；↑↓ 移动，/ 搜索，Enter 切换或编辑，Ctrl+R 恢复默认，Ctrl+E 用编辑器打开 settings.json，Esc 关闭。shell 侧等价命令：copilot config。
易混淆点: 布尔值可写 on/off 或 true/false；嵌套键用点号。列表、结构化、安全敏感的设置不能行内设置，需 Ctrl+E 编辑文件。experimental、代理（proxy）类设置需重启生效。show 会遮蔽 token 类值。

/statusline别名：/footer入门

用途: 配置输入框下方状态栏（footer）显示哪些项：模型/推理、目录、分支、上下文窗口、额度、AI 用量、代码改动等。
语法 / 子命令: /statusline　（打开勾选界面）
或逐项：/settings footer.showContextWindow on
典型示例: /settings footer.showQuota off
/settings footer.showBranch on
相关配置 / 快捷键: 可用的 footer.* 子项见下方表格。自定义内容：设置 statusLine = {type:"command", command, padding, refreshInterval}，命令从 stdin 收到会话 JSON、向 stdout 打印要显示的文字，再打开 footer.showCustom。
易混淆点: /statusline 和 /footer 是同一个命令；/context 是一次性查看详情。

/theme入门已弃用

用途: 查看或设置配色主题。
语法 / 子命令: /theme [default | github | dim | high-contrast | colorblind]
典型示例: /theme dim
相关配置 / 快捷键: 设置 theme（默认 github）；colorMode 是旧别名。
易混淆点: copilot help config 称 /theme 已弃用，推荐 /settings theme 值。

/experimental进阶已弃用

用途: 查看实验性功能列表，或开关实验模式。
语法 / 子命令: /experimental [on | off | show]
相关配置 / 快捷键: 设置 experimental；启动参数 --experimental / --no-experimental。
易混淆点: copilot help config 称 /experimental 已弃用，推荐 /settings experimental on；需要重启生效。

状态栏 footer 子项（/statusline 勾选的就是这些；/settings 键 on|off 也可）

键	显示内容
footer.showModelEffort	模型与推理强度
footer.showDirectory	当前目录
footer.showBranch	Git 分支
footer.showContextWindow	上下文窗口占用 ← 常用
footer.showQuota	额度
footer.showAgent	当前代理
footer.showAiUsed	AI 用量
footer.showCodeChanges	代码改动统计
footer.showUsername	用户名
footer.showSandbox	沙箱状态
footer.showYolo	allow-all（yolo）状态
footer.showCustom	自定义 statusLine 命令输出
footer.showCiStatus / showSchedules / showPullRequest	CI 状态 / 定时任务 / PR（出现在本机 settings.json，官方文档未列出，未核实）

📋 全部设置项一览（按主题分组）

模型与推理

键	默认值	说明	示例	来源
model	随账号而定	默认模型；`auto` 自动挑选。由 /model 管理	`/settings model claude-sonnet-5.5`	本机+文档
effortLevel	"medium"（文档）	推理强度 low / medium / high / xhigh	`/settings effortLevel high`	文档
contextTier	—	上下文档位 default / long_context	`/settings contextTier long_context`	本机+文档
autoTier	未设置	选择 Auto 模型时的路由偏好 efficiency / balance / intelligence	`/settings autoTier balance`	本机+文档
continueOnAutoMode	false	被限流时自动切换到 auto 模式并重试	`/settings continueOnAutoMode on`	本机+文档
planModel / planEffortLevel	—	plan 模式专用模型 / 推理强度，由 `/model plan` 写入	`/model plan`	本机 settings.json（文档未列，未核实）
subagents.agents.<名称>	{}	子代理的 model / modelPolicy(preferred\|required) / effortLevel / contextTier，可设 inherit	用 /subagents 配置	本机+文档
subagents.agents["rubber-duck"].autoInvoke	false	允许主动咨询小黄鸭代理	用 /subagents 切换	文档
subagents.disabledSubagents	[]	关闭的子代理名称	用 /subagents	文档
subagents.maxConcurrency	按套餐	最大并发子代理数（仅按用量计费用户生效，上限 32）		文档
subagents.maxDepth	6	子代理最大嵌套深度（仅按用量计费用户生效，上限 256）		文档

模式与权限

键	默认值	说明	示例	来源
defaultMode	"interactive"	新交互会话的初始模式 interactive / plan / autopilot	`/settings defaultMode plan`	本机
defaultPermissionMode	"manual"	新会话初始权限模式 manual / assisted / allow-all	`/settings defaultPermissionMode assisted`	本机
stayInAutopilot	true	autopilot 任务完成后是否留在 autopilot	`/settings stayInAutopilot off`	本机+文档
askUser	true	允许代理向你提问；false=完全自主	`/settings askUser off`	文档
allowedUrls	[]	无需询问即可访问的 URL / 域名（支持 *.github.com）	`copilot config allowedUrls github.com`	本机+文档
deniedUrls	[]	总是拒绝的 URL / 域名（优先于允许）	`copilot config deniedUrls example.com`	本机+文档
trustedFolders	—	已授予读取 / 执行权限的文件夹列表		本机
permissions.disableBypassPermissionsMode	—	"disable" 禁止所有 allow-all 类参数；"allow-auto-only"（详见文档）	编辑 settings.json	文档
includeCoAuthoredBy	true	提交时让代理加 Co-authored-by trailer	`/settings includeCoAuthoredBy off`	本机+文档
storeTokenPlaintext	false	无系统钥匙串时允许把 token 明文存入 config.json		文档
customAgents.defaultLocalOnly	false	只使用本地自定义代理（不用组织 / 企业代理）		本机+文档

沙箱（/sandbox）

键	默认值	说明	示例	来源
sandbox.enabled	false	把 shell、MCP/LSP、内置文件/网络工具放进沙箱	`/sandbox enable`	文档
sandbox.allowBypass	true	允许被沙箱拦截的操作弹出绕过请求		文档
sandbox.auth.git / sandbox.auth.gh	true	向沙箱注入 Git / gh 凭据（旧键 gitAuth/ghAuth 已失效）		文档
sandbox.credentials	未设置	在沙箱中遮蔽指定环境变量，由本地代理按主机注入		文档
sandbox.userPolicy.network.allowLocalNetwork	false	允许访问本地网络（如本地开发服务器）		文档
sandbox.userPolicy.network.proxy	未设置	沙箱流量走 HTTP(S) 代理		文档
sandbox.userPolicy.network.allowedHosts / blockedHosts	[]	允许 / 拒绝的主机（拒绝优先）		文档
sandbox.userPolicy.filesystem.deniedPaths	[]	禁止沙箱命令访问的路径		文档
sandbox.userPolicy.seatbelt.keychainAccess	false	仅 macOS：允许访问钥匙串		文档

状态栏与显示

键	默认值	说明	示例	来源
footer.*	见 /statusline 表	状态栏显示项开关（见下方 footer 子项表）	`/settings footer.showQuota off`	本机+文档
statusLine	—	自定义状态行命令 {type:"command", command, padding, refreshInterval}	编辑 settings.json	本机+文档
theme	"github"	配色 default / github / dim / high-contrast / colorblind	`/settings theme dim`	本机+文档
colorMode	—	theme 的旧别名（已弃用）		本机+文档
banner	"once"	启动动画横幅 always / once / never	`/settings banner never`	本机+文档
bannerStyle	"mona"	横幅图案 mona / classic		本机
showTipsOnStartup	true	启动时显示随机命令提示	`/settings showTipsOnStartup off`	本机+文档
showTimestamps	true	用户消息旁显示 HH:mm 时间		文档
pinnedPrompts	true	滚动时间线时把当前提示固定在顶部		文档
transcriptView	"default"	"concise" 把工具活动折叠成摘要	`/settings transcriptView concise`	文档
renderMarkdown	true	终端渲染 Markdown		本机+文档
renderHexColors	true	把 `#FF0000` 显示为色块		文档
inlineImages	true	用 Kitty 图形协议内联显示图片（需支持的终端）		本机+文档
inlineImageLiveWindow	50	终端中最多保留的内联图片数，0=不限		本机
scrollbar	true	显示滚动条		本机+文档
mouse	true	备用屏幕模式的鼠标支持		本机+文档
copyOnSelect	macOS true，其他 false	鼠标选中即复制	`/settings copyOnSelect on`	本机+文档
sidebar（及 sidebar.*）	true	当前会话侧边栏；子项 enabled、showResumableSessions、showHeaderButtons、showCloseButton、hoverFocus、coloredHints、accentActiveSession（子项来源：官方文档，未核实）	`/settings sidebar`	文档
tabs.enabled / tabs.hide / tabs.sort	true / [] / []	首页标签栏（Session、Agents、Issues、Pull requests、Gists）显示、隐藏、排序		本机+文档
screenReader	false	屏幕阅读器优化		本机+文档
streamerMode	false	隐藏预览模型名、额度等（直播/投屏用；/streamer-mode 仅员工可用，不在 /settings 中）		本机+文档
companyAnnouncements	[]	启动横幅中随机显示的团队公告		本机+文档
stream	true	流式输出		本机+文档

输入与 Shell

键	默认值	说明	示例	来源
editorMode	"normal"	输入框编辑模式 normal / vim（由 /vim 切换）		文档
compactPaste	true	粘贴超过 10 行时折叠成 [Paste #N - X lines]		本机+文档
commandHistoryMaxSize	50	Ctrl+R / ↑↓ 历史条数（1–1000）	`/settings commandHistoryMaxSize 200`	本机+文档
respectGitignore	true	`@` 文件选择器排除 gitignore 文件		本机+文档
shellShortcut	true	单独输入 `$` 回车打开交互 shell		文档
powershellFlags	["-NoProfile","-NoLogo"]	Windows 上启动 PowerShell 的参数；`[]` 会加载你的 profile	编辑 settings.json	本机+文档
bashEnv	false	bash 的 BASH_ENV 支持		本机+文档

通知与终端

键	默认值	说明	示例	来源
beep	false（本机）/ true（文档）	需要你处理时发出提示音。本机帮助与官方文档默认值不一致，以本机为准	`/settings beep on`	本机+文档
beepOnSchedule	true	/every、/after 定时任务完成时提示音（需 beep 开启）		本机+文档
notifications	false	需要处理 / 完成时弹出系统通知（终端有焦点时不弹）	`/settings notifications on`	本机
terminalNotifications	false	优先使用终端自身的 OSC 777 通知（Ghostty、WezTerm）		本机+文档
terminalProgress	true	工作时在终端标签显示进度（OSC 9;4）		本机+文档
updateTerminalTitle	true	在终端标题显示当前意图		本机+文档
taskbarPresence	true	Windows 任务栏显示会话状态（下次启动生效）		文档
keepAlive	"off"	启动时的防睡眠模式 off / on / busy	`/keep-alive busy`	本机+文档

扩展、记忆与 IDE

键	默认值	说明	示例	来源
memory	true	跨会话记忆（/memory）	`/memory off`	本机
hooks	—	内联 hooks 定义（与 .github/hooks/*.json 同结构）	编辑 settings.json	本机+文档
disableAllHooks	false	禁用所有 hooks		本机+文档
disabledMcpServers / enabledMcpServers	[] / []	禁用的 MCP 服务器 / 启用默认关闭的内置 MCP		文档
disabledSkills	[]	禁用的 skills	`copilot skill disable 名称`	文档
skillDirectories / ignoredSkillsLocations	[] / []	额外 skill 目录 / 排除的 skill 目录		文档
dynamicRetrieval	未设置	{ skills: false } 关闭 skills 的向量检索	`--dynamic-retrieval skills=off`	文档
enabledPlugins / extraKnownMarketplaces	{} / {}	声明式自动安装插件 / 额外插件市场		文档
connectors	true	启用 Copilot Connectors		文档
toolSearch	随模型与功能而定	工具搜索（延迟加载工具），false 关闭		文档
ide.autoConnect	true	启动时自动连接 IDE		本机+文档
ide.openDiffOnEdit	true	在 IDE 中打开 diff 审批		本机+文档
experimental	false	实验性功能（需重启）	`/settings experimental on`	本机+文档

会话、远程与 Git

键	默认值	说明	示例	来源
remote	"on"（文档）	会话同步与远程访问；off=只留本地		文档
remoteExport	true	可用时把会话导出到远端		文档
worktreeBaseRef	"head"	新 worktree 的起点 head / defaultBranch	`/settings worktreeBaseRef defaultBranch`	文档
worktreePathTemplate	未设置	worktree 路径模板，占位符 {repoPath} {repo} {branch} {branchSlug}	`~/src/worktrees/{repo}/{branch}`	文档
mergeStrategy	—	`/pr fix conflicts` 用 rebase 还是 merge	`/settings mergeStrategy rebase`	文档

网络、更新与日志

键	默认值	说明	示例	来源
proxyUrl	未设置	HTTP(S) 代理；环境变量 HTTP(S)_PROXY 优先（需重启）	`copilot config proxyUrl http://proxy:3128`	本机+文档
proxyKerberosServicePrincipal	未设置	Kerberos 代理认证的 SPN（需重启）		本机+文档
autoUpdate	true	自动下载新版（下次启动或 /restart 生效）		本机+文档
autoUpdatesChannel	"stable"	更新通道 stable / prerelease		文档
logLevel	"default"	日志级别；"all" 为调试	`/settings logLevel all`	本机+文档

⑧ 扩展：指令、Skills、MCP、插件、Agents、Hooks

让 Copilot 了解你的项目与习惯，并接入外部工具。各类文件存放位置见本章末尾表格。

/init入门

用途: 为当前仓库初始化 Copilot 自定义指令（如 .github/copilot-instructions.md）和相关代理功能。
语法 / 子命令: /init
shell：copilot init
相关配置 / 快捷键: 指令文件位置见指令文件位置。

/instructions入门

用途: 查看并开关当前加载的自定义指令文件。
语法 / 子命令: /instructions
shell：copilot instruction list
相关配置 / 快捷键: 启动参数 --no-custom-instructions 禁用全部；环境变量 COPILOT_CUSTOM_INSTRUCTIONS_DIRS 增加搜索目录。

/skills进阶

用途: 管理 skills（可复用的专项能力说明）：列出、查看、添加、移除、重新加载。
语法 / 子命令: /skills　（打开插件面板的 Skills 页）
/skills list | info 名称 | add [--project] <文件|URL|目录> | remove <名称|目录> | reload
shell：copilot skill list | add | remove | enable | disable
典型示例: /skills add --project https://example.com/skill.md
copilot skill disable grilling
相关配置 / 快捷键: 设置 disabledSkills、skillDirectories、ignoredSkillsLocations、dynamicRetrieval.skills；启动参数 --dynamic-retrieval skills=off。
易混淆点: skill 是按需加载的说明；指令文件（/instructions）每次都加载。

/mcp进阶

用途: 管理 MCP 服务器：列出、查看工具、添加、编辑、删除、启停、认证、重载、搜索。
语法 / 子命令: /mcp [config | list | show | add | edit | delete | disable | enable | auth | reload | search] [服务器名]
shell：copilot mcp list | get | add | remove | enable | disable
典型示例: /mcp show github-mcp-server
copilot mcp list
相关配置 / 快捷键: 配置：用户 ~/.copilot/mcp-config.json；工作区 .mcp.json 或 .github/mcp.json。设置 disabledMcpServers、enabledMcpServers；启动参数 --additional-mcp-config、--disable-mcp-server、--enable-mcp-server、--disable-builtin-mcps、--add-github-mcp-tool(set)、--enable-all-github-mcp-tools。
易混淆点: 内置 GitHub MCP 默认只开放一部分工具。

/plugin进阶

用途: 管理插件和插件市场（插件可打包 skills、agents、MCP、hooks 等）。
语法 / 子命令: /plugin　（插件面板：Installed / Online / Marketplace）
/plugin install 来源 | update 插件[@市场] | uninstall 插件 | list
/plugin marketplace add 来源 | remove 名称 | list | browse 名称 | update [名称]
shell：copilot plugin install | uninstall | update | list | enable | disable | marketplace
典型示例: /plugin marketplace browse awesome-copilot
相关配置 / 快捷键: 默认市场 awesome-copilot（github/awesome-copilot）。设置 enabledPlugins、extraKnownMarketplaces；启动参数 --plugin-dir。

/env入门

用途: 显示已加载的环境：指令文件、MCP 服务器、skills、agents、hooks、插件、LSP、扩展。
语法 / 子命令: /env
易混淆点: 排查“为什么没生效”时首先看这里。

/memory进阶

用途: 查看记忆（跨会话事实回忆）状态，或开关记忆功能。
语法 / 子命令: /memory [on | off]
相关配置 / 快捷键: 设置 memory（默认 true）；非交互模式需 --enable-memory；shell：copilot memories import。

Hooks（无专用斜杠命令）进阶

用途: 在会话事件（如 sessionStart）触发时运行脚本。
语法 / 子命令: settings.json 中 hooks 键，或 .github/hooks/*.json、~/.copilot/hooks/
典型示例: "hooks": { "sessionStart": [ { "type": "command", "powershell": "…", "timeoutSec": 10 } ] }
相关配置 / 快捷键: 设置 disableAllHooks 一键禁用；/env 查看已加载 hooks。
易混淆点: 上面示例结构取自本机 settings.json；具体事件名与字段请以官方 hooks 文档为准（未核实完整列表）。

/extensions别名：/extension进阶实验性仅官方文档

用途: 管理 CLI 扩展（~/.copilot/extensions/）。
语法 / 子命令: /extensions [manage | mode]
易混淆点: 1.0.100 /help 未列出；仅实验模式可用。

/workflows进阶仅官方文档

用途: 查看动态工作流的运行、阶段、代理和进度（需按 token 计费的套餐）。
语法 / 子命令: /workflows
shell：copilot workflow run
易混淆点: 1.0.100 /help 未列出；copilot workflow run 子命令本机存在。

自定义指令文件（来源：官方文档 + copilot instruction list）

位置	作用范围	备注
`~/.copilot/copilot-instructions.md`	个人，所有会话
`~/.copilot/instructions/*/.instructions.md`	个人，附加指令
`.github/copilot-instructions.md`	仓库	`/init` 生成
`.github/instructions/*/.instructions.md`	仓库，可按路径作用
`AGENTS.md`（git 根目录与当前目录）	仓库 / 目录
`CLAUDE.md`、`GEMINI.md`	仓库	兼容其他工具的指令文件
`.claude/rules/*/.md`	仓库
`COPILOT_CUSTOM_INSTRUCTIONS_DIRS` 指定目录	额外目录

Skills / Agents / MCP / 插件 / LSP 的存放位置

类别	位置	备注
Skills	项目：`.github/skills/`、`.agents/skills/`、`.claude/skills/`；个人：`~/.copilot/skills/`、`~/.agents/skills/`；插件；`copilot skill add <目录>` 添加的自定义目录	设置 `skillDirectories`、`ignoredSkillsLocations`
自定义 Agents	个人：`~/.copilot/agents/`；仓库：`.github/agents/`	`--add-dir` 会加载该目录的 .github/agents
MCP	用户：`~/.copilot/mcp-config.json`；工作区：`.mcp.json` 或 `.github/mcp.json`；插件
插件	`~/.copilot/installed-plugins/`、`~/.copilot/plugin-data/`	卸载请用 `copilot plugin uninstall`
LSP	`~/.copilot/lsp-config.json`
Hooks	`~/.copilot/hooks/`、`.github/hooks/*.json`、settings.json 的 `hooks`
扩展	`~/.copilot/extensions/`	实验性
BYOK 模型	`~/.copilot/providers.json`

~/.copilot 目录结构（来源：官方 config-dir 文档）

路径	内容	可否删除 / 备注
`settings.json`	个人设置（本指南 ⑦ 的设置都写在这里）	谨慎：删除即恢复全部默认
`config.json`	自动管理的应用状态（认证、已装插件等）；写在这里的用户设置会被忽略	谨慎：需重新登录
`copilot-instructions.md`、`instructions/`	个人指令	不建议，先备份
`agents/`、`skills/`、`hooks/`、`extensions/`	个人自定义	不建议，先备份
`mcp-config.json`、`lsp-config.json`、`providers.json`	MCP / LSP / BYOK 定义	不建议，先备份
`permissions-config.json`	按项目保存的工具与目录批准	谨慎：之后会重新询问
`session-state/`	会话历史与工作区数据	谨慎：删除后无法恢复旧会话
`session-store.db`	跨会话数据（SQLite）	谨慎：会自动重建
`command-history-state/`	命令历史	谨慎：Ctrl+R 历史丢失
`logs/`	会话日志	可以删除
`plugin-data/`	插件持久数据	可以删除
`installed-plugins/`	已安装插件	不建议，用 `copilot plugin uninstall`
`ide/`、`mcp-oauth-config/`、`mcp-secrets/`	IDE 集成状态 / MCP OAuth / MCP 密钥占位	后两者谨慎：可能需重新认证

⑨ 帮助、更新与排障

查帮助、升级、反馈问题、收集日志；以及环境变量一览。

/help入门

用途: 显示交互命令帮助。
语法 / 子命令: /help
? （空输入时，快捷帮助）
shell：copilot help [主题]
典型示例: copilot help config
相关配置 / 快捷键: 主题列表见本章末尾表格。

/version入门

用途: 显示版本并检查更新。
语法 / 子命令: /version
shell：copilot version 或 copilot --version

/update别名：/upgrade进阶

用途: 把 CLI 更新到最新版本。
语法 / 子命令: /update
shell：copilot update [stable | prerelease]
典型示例: copilot update prerelease
相关配置 / 快捷键: 设置 autoUpdate（默认 true，后台下载、下次启动或 /restart 生效）、autoUpdatesChannel；--no-auto-update、COPILOT_AUTO_UPDATE=false。
易混淆点: npm 安装的版本只提示有新版，需手动 npm install。

/changelog别名：/release-notes入门

用途: 显示 CLI 更新日志；加 summarize 由 AI 总结。
语法 / 子命令: /changelog [summarize] [版本 | last N | since 版本]
典型示例: /changelog summarize last 3

/feedback别名：/bug入门

用途: 向 GitHub 反馈 CLI 问题或建议（可附带日志）。
语法 / 子命令: /feedback

/diagnose进阶

用途: 分析当前会话日志中的错误和异常行为；可附加提示聚焦某个问题。
语法 / 子命令: /diagnose [提示]
典型示例: /diagnose 为什么 MCP 服务器没有加载

/collect-debug-logs进阶

用途: 收集调试日志：打包成本地 .tgz、征得同意后上传给 GitHub，或创建私密 gist。
语法 / 子命令: /collect-debug-logs [file | gist | share] [路径]
相关配置 / 快捷键: 日志目录 ~/.copilot/logs/；启动参数 --log-level、--log-dir；设置 logLevel（"all"=调试）；copilot help logging。

/clikit、/tuikit进阶仅官方文档

用途: 预览 CLI 业务组件（/clikit，如额度信息）与 TUIkit 设计系统组件、颜色（/tuikit）。主要面向开发者。
语法 / 子命令: /clikit [组件]
/tuikit [colors | icons | select | tabbar]
易混淆点: 1.0.100 /help 未列出。

/downgrade进阶仅官方文档

用途: 下载并重启到指定的 CLI 版本（团队账号可用）。
语法 / 子命令: /downgrade 版本
易混淆点: 1.0.100 /help 未列出。

copilot help <主题> 可用主题

主题	内容
`billing`	AI credit 计费
`commands`	交互命令列表
`config`	全部设置项说明
`environment`	环境变量
`limits`	会话上限
`logging`	日志
`monitoring`	OpenTelemetry 监控
`permissions`	权限模式写法
`providers`	自定义模型提供方（BYOK）
`sandbox`	命令沙箱

环境变量（来源：copilot help environment）

变量	作用
`COPILOT_HOME`	配置与状态目录，默认 `$HOME/.copilot`
`COPILOT_MODEL`	默认模型（被 `--model`、`/model` 覆盖）
`COPILOT_AUTO_TIER`	Auto 模型路由偏好
`COPILOT_GITHUB_TOKEN` / `GH_TOKEN` / `GITHUB_TOKEN`	认证 token（按此优先级），优先于已保存凭据
`GH_HOST` / `COPILOT_GH_HOST`	GitHub 主机名（GHE）；后者只影响 Copilot CLI
`COPILOT_ALLOW_ALL`	允许所有工具；值恰好为 "true" 时还会信任工作目录（加载其 skills/插件/MCP/hooks）
`COPILOT_AUTO_UPDATE`	"false" 关闭自动更新；CI 环境默认关闭
`COPILOT_CLI_VERSION`	覆盖用于更新比较的版本号
`COPILOT_CUSTOM_INSTRUCTIONS_DIRS`	额外的指令搜索目录（逗号分隔）
`COPILOT_EDITOR` / `VISUAL` / `EDITOR`	外部编辑器命令（Ctrl+G、编辑计划）
`COPILOT_MULTIPLEXER`	覆盖终端复用器识别：tmux / herdr / none
`COPILOT_OFFLINE`	"true" 离线模式，需要本地模型提供方
`COPILOT_PROVIDER_*`	BYOK 自带模型：BASE_URL、TYPE、API_KEY、API_KEY_COMMAND、BEARER_TOKEN、WIRE_API、TRANSPORT、AZURE_API_VERSION、MODEL_ID、WIRE_MODEL、MAX_PROMPT_TOKENS、MAX_OUTPUT_TOKENS、HEADERS（详见 `copilot help providers`）
`HTTP_PROXY` / `HTTPS_PROXY` / `NO_PROXY`	代理设置（大小写均可），优先于设置 `proxyUrl`
`NO_COLOR`	关闭颜色
`PLAIN_DIFF`	"true" 关闭富文本 diff
`USE_BUILTIN_RIPGREP`	"false" 使用 PATH 中的 ripgrep
`USE_TGREP` / `TGREP_FILE_COUNT_THRESHOLD` / `USE_TGREP_WARM_START`	tgrep 索引搜索开关、自动启用的文件数阈值（Windows 默认 10,000）、启动时等待索引
`COPILOT_OTEL_` / `OTEL_`	OpenTelemetry 监控（详见 `copilot help monitoring`）
`COPILOT_DISABLE_TERMINAL_TITLE`	禁止更新终端标题（来源：`copilot help config`）
`COPILOT_INLINE_IMAGE_LIMIT` / `COPILOT_INLINE_IMAGES_HERDR`	内联图片数量上限 / herdr 中启用内联图片（来源：`copilot help config`）
`COPILOT_PROXY_KERBEROS_SPN`	Kerberos 代理 SPN，优先于设置项（来源：`copilot help config`）
`COPILOT_ASSISTED_APPROVAL`	等同 `--assisted-approval`（来源：`copilot --help`）
`COPILOT_ENABLE_INTERRUPTED_SESSION_RESTORE`	"1" 恢复被中断的会话（来源：官方文档，未核实）

我当前的配置（已脱敏）

分享本文件前可整段删除本章节（HTML 中 <section id="mycfg"> … </section>）。

展开查看

来源：~/.copilot/settings.json、copilot skill list、copilot instruction list、copilot mcp list、copilot plugin list、copilot lsp list（2026-10-20 采集）。用户目录写作 ~；令牌、密钥、邮箱、内网地址、环境变量值一律不收录。

settings.json（摘要）

{
  "model": "gpt-6-luna",
  "planModel": "claude-fable-5",
  "planEffortLevel": "medium",
  "askUser": true,
  "autoUpdate": true,
  "footer": {
    "showModelEffort": true, "showDirectory": true, "showBranch": true,
    "showContextWindow": true, "showQuota": true, "showAiUsed": true,
    "showAgent": true, "showCodeChanges": false, "showUsername": true,
    "showSandbox": true, "showYolo": false, "showCiStatus": false,
    "showSchedules": true, "showPullRequest": true, "showCustom": true
  },
  "hooks": {
    "sessionStart": [ { "type": "command",
      "powershell": "powershell -NoProfile -ExecutionPolicy Bypass -File \"~\\.copilot\\hooks\\herdr-agent-state.ps1\"",
      "timeoutSec": 10 } ]
  }
}

观察：上下文占用已在状态栏显示（showContextWindow=true）。showCustom 为 true 但未配置 statusLine，因此不会显示自定义内容。

已安装的扩展（仅名称）

个人 skills（~/.copilot/skills）：agents-sdk、cloudflare、grill-me、grilling、hyperframes 系列、media-use、open-code-review-delegate；另有其他个人目录中的 skills（anatomy、code-review、tdd 等）。
项目 skills（C:\api）：openspec-*、impact-analysis、jira-investigate、test-case-making-excel、handoff-list、handoffdic、implement-spec、retro、wait-what、writing-for-agents。
内置 skills：customize-cloud-agent、github-pr-media。
自定义 agents：agent-leader-coordinator、agent-leader-worker。
扩展：frontend-slides。
MCP：仅内置 github-mcp-server（http）；无 ~/.copilot/mcp-config.json。
插件：未安装；内置 browser-use 已禁用。
LSP：未配置。
指令文件：C:\api\AGENTS.md（工作区）、~/.copilot/copilot-instructions.md（个人）。