Copilot CLI 安装及命令（）

Dream25122026-05-20 9:31

安装

1) 安装 Codex CLI（官方）

复制代码 
winget install GitHub.Copilot

2) 登录（推荐交互式）

复制代码 
cd /path/to/your/repo
copilot
# 进入后输入：
/login

首次运行会提示你用 ChatGPT 登录 或用 API key 登录

使用

切换模型：

复制代码 
/model

命令大全

1) 终端命令（Command-line commands）

这些是你在 shell 里直接运行的"子命令"（不是进入 UI 后的 /xxx）。

命令 作用
copilot 启动交互式 UI（你看到的那个框架界面）。 1
copilot completion SHELL 输出一个用于启用命令补全 的脚本（bash/zsh/fish）。 1
copilot help [TOPIC] 显示帮助（可按 topic 分类）。 1
copilot init 为当前仓库初始化 Copilot 的自定义指令/agentic 功能相关文件入口（仓库级）。 1
copilot login [--host HOST] 登录（OAuth device flow）。支持指定 GitHub host（例如某些 GHEC data residency 域名）。 1
copilot mcp ... 命令行方式 管理 MCP server（不进 UI 也能改/查配置）。 1
copilot plugin ... 命令行方式 管理插件与插件市场。 1
copilot update 下载并安装最新版 CLI。 1
copilot version 显示版本并检查更新。 1

登录/Token（你关心"接口/鉴权"的关键点）

  • copilot login 默认走浏览器授权；token 优先存到系统凭据库，否则落到 ~/.copilot/（或 COPILOT_HOME 指定目录）。 1
  • 也可以用环境变量提供 token（优先级：COPILOT_GITHUB_TOKEN → GH_TOKEN → GITHUB_TOKEN）。 1
  • 支持的 token 类型包括：带 "Copilot Requests" 权限的 fine‑grained PAT（v2）、Copilot CLI app 的 OAuth token、GitHub CLI (gh) app 的 OAuth token；不支持 classic PAT（ghp_） 。 1

2) copilot mcp 子命令（命令行管理 MCP）

用于管理 ~/.copilot/mcp-config.json 等 MCP 配置。 1

命令 作用
copilot mcp list [--json] 列出所有 MCP servers（按来源分组）。 1
copilot mcp get <name> [--json] 查看某个 server 的配置与 tools。 1
copilot mcp add <name> ... 添加 server（写入 ~/.copilot/mcp-config.json）。 1
copilot mcp remove <name> 删除"用户级"server（workspace 的要去改文件）。 1

copilot mcp add 常用选项（摘要）：-- <command> [args...]（本地 stdio）、--url（远程）、--type local|stdio|http|sse、--env、--header、--tools、--timeout、--json。 1

3) copilot plugin 子命令（命令行管理插件）

插件管理完整命令如下： 2

命令 作用
copilot plugin install SPECIFICATION 安装插件（从 marketplace / GitHub repo / Git URL / 本地路径等）。 2
copilot plugin uninstall NAME 卸载插件。 2
copilot plugin list 列出已安装插件。 2
copilot plugin update NAME 更新某插件。 2
copilot plugin marketplace add SPECIFICATION 注册一个 marketplace。 2
copilot plugin marketplace list 列出 marketplace。 2
copilot plugin marketplace browse NAME 浏览 marketplace 插件列表。 2
copilot plugin marketplace remove NAME 移除 marketplace。 2

4) 交互界面 Slash 命令（/xxx）

你进入 copilot UI 后可用的"斜杠命令"。下面是官方文档列出的完整清单（带用途）。 1

4.1 权限/目录/环境类

  • /add-dir PATH：把目录加入"允许访问"的列表（文件读写权限范围）。 1
  • /allow-all [on|off|show] 或 /yolo [on|off|show]：一键开/关/查看全权限（tools/paths/URLs）。 1
  • /list-dirs：显示已允许访问的目录列表。 1
  • /env：查看当前加载的环境信息（instructions、MCP servers、skills、agents、plugins、LSP、extensions 等）。 1
  • /reset-allowed-tools：重置已允许的工具列表。 1

4.2 会话/历史/导出类

  • /clear [PROMPT]、/new [PROMPT]、/reset [PROMPT]：开始新对话。 1
  • /compact：压缩/总结历史，减少上下文窗口占用。 1
  • /context：查看上下文窗口 token 使用与可视化。 1
  • /session ... 或 /sessions ...：会话管理（info、checkpoints [n]、files、plan、rename、cleanup、prune、delete、delete-all）。 1
  • /resume [SESSION-ID] 或 /continue [SESSION-ID]：切换/继续某个 session。 1
  • /rename [NAME]：重命名当前 session（等价 /session rename）。 1
  • /share ... 或 /export ...：导出 session/research 到 Markdown / HTML / gist。 1

4.3 模型/计划/研究/审查类（你最常用的 agent 工作流）

  • /model 或 /models [MODEL]：选择模型。 1
  • /plan [PROMPT]：先产出实现计划再写代码。 1
  • /research TOPIC：用 GitHub 搜索 + web sources 做深度研究，生成报告。 1
  • /review [PROMPT]：启动 code review agent 分析改动（偏"高信噪比 review"）。 1
  • /diff：查看当前目录的改动 diff。 1
  • /undo 或 /rewind：回滚上一轮并撤销文件改动。 1

4.4 GitHub 工作流/协作类

  • /pr [view|create|fix|auto]：当前分支 PR 管理。 1
  • /delegate [PROMPT]：把任务委派到远程仓库，生成 AI PR。 1
  • /remote [on|off]：远程控制开关与状态（让别的设备 steer 你的 session）。 1
  • /ide：连接到 IDE workspace（官方文档提到 VS Code 连接）。 1

4.5 插件 / MCP / 技能 / LSP 管理类

  • /plugin [marketplace|install|uninstall|update|list] ...：在 UI 里管理插件/市场。 1
  • /mcp [show|add|edit|delete|disable|enable|auth|reload] [SERVER-NAME]：管理 MCP server。 1
  • /skills [list|info|add|remove|reload] ...：管理 skills。 1
  • /lsp [show|test|reload|help] [SERVER-NAME]：管理 language server 配置。 1
  • /agent：浏览/选择可用 agents（含自定义 agent）。 1

4.6 其它实用命令

  • /copy：复制上一条回复到剪贴板。 1
  • /cwd 或 /cd [PATH]：显示/切换工作目录。 1
  • /terminal-setup：配置多行输入支持（Shift+Enter 等）。 1
  • /theme ...：主题/对比度模式。 1
  • /usage：显示 session 用量统计。 1
  • /version、/update：版本/升级。 1
  • /login、/logout：登录/登出。 1
  • /experimental [on|off|show]：实验特性开关（有些命令仅在 experimental 模式可用）。 1
  • /ask QUESTION：快速侧问（不进入历史），仅 experimental。 1
  • /search 或 /find：搜索会话时间线，仅 experimental。 1
  • /keep-alive / /caffeinate：防休眠（按 session active / busy / 持续时间）。 1
  • /restart：重启 CLI 但保留当前 session。 1
  • /feedback / /bug：反馈/报错入口。 1
  • /changelog / /release-notes：查看变更日志（可让 AI summarize）。 1
  • /downgrade <VERSION>：降级到特定版本（文档注明 team accounts 才可用）。 1
  • /clikit [COMPONENT]：预览 CLI business components（例如 quota info）。 1
  • /tasks：查看/管理 tasks（subagents + shell commands）。 1
  • /fleet [PROMPT]：并行子代理执行（把任务拆分并行跑）。 1

5) 全局参数（Command-line options，含 programmatic/权限/模型）

这些参数既可用于交互式启动，也可用于脚本化（比如 copilot -p ...）。以下为官方文档列出的选项清单： 1

5.1 最常用（脚本化/CI）

  • -p/--prompt PROMPT：非交互模式执行 prompt，完成后退出。 1
  • -s/--silent：只输出模型回复（无统计/装饰），适合管道。 1
  • --output-format text|json：输出 text 或 JSONL（每行一个 JSON）。 1
  • --share=PATH / --share-gist：在 programmatic 结束后导出 session 到 md 或 secret gist。 1

5.2 权限与安全（决定"能不能改代码/跑命令/上网"）

  • --allow-all（或 --yolo）：全开（= --allow-all-tools --allow-all-paths --allow-all-urls）。 1
  • --allow-all-tools / --allow-all-paths / --allow-all-urls：分别全开。 1
  • --allow-tool=... / --deny-tool=...：允许/禁止某些工具且不再弹确认（支持 pattern）。 1
  • --available-tools=... / --excluded-tools=...：白名单/黑名单式限制"模型能看到的工具集合"。 1
  • --allow-url=... / --deny-url=... / --allow-all-urls：URL 访问控制。 1
  • --add-dir=PATH / --allow-all-paths：文件访问范围控制。 1
  • --disallow-temp-dir：禁止自动访问系统临时目录。 1
  • --secret-env-vars=VAR ...：把某些环境变量从 shell/MCP 环境与输出里打码（GITHUB_TOKEN/COPILOT_GITHUB_TOKEN 默认已打码）。 1

5.3 模型与推理强度

  • --model=MODEL：指定模型；auto 让 Copilot 自动选。 1
  • --effort=low|medium|high（或 --reasoning-effort=...）：推理努力程度。 1
  • --enable-reasoning-summaries：对支持的 OpenAI 模型请求 reasoning summaries。 1

5.4 会话与运行模式

  • -i/--interactive=PROMPT：进入交互界面并自动先执行一条 prompt。 1
  • --mode=interactive|plan|autopilot：设置初始模式。 1
  • --plan：直接 plan mode（--mode plan 的简写）。 1
  • --autopilot：在 prompt mode 开启 autopilot continuation。 1
  • --max-autopilot-continues=COUNT：限制 autopilot 连续次数。 1
  • --resume[=...] / --continue：恢复历史 session。 1

5.5 远程控制（Remote sessions）

  • --remote / --no-remote：允许/禁止从 GitHub.com / Mobile 远程 steer 这个 session。 1
  • --connect[=SESSION-ID]：直接连接远程 session（与 --resume/--continue 冲突）。 1

文档注明：--remote/--connect 等需要你的账号具备 remote sessions 功能。 1

5.6 MCP / 插件 / 其它

  • --additional-mcp-config=JSON：仅当前 session 追加 MCP server 配置（JSON 字符串或 @file）。 1
  • --disable-builtin-mcps / --disable-mcp-server=...：禁用内置 MCP 或某个 MCP。 1
  • --plugin-dir=DIRECTORY：从本地目录加载插件（可重复）。 1
  • --log-dir / --log-level：日志目录与等级。 1
  • --banner/--no-banner、--no-color、--screen-reader、--mouse/--no-mouse：UI/可访问性相关。 1

6) 交互界面"全局快捷输入"（不是 /xxx，但很像命令）

这些在任何输入框里都能用： 1

输入/快捷键 作用
@ 文件名 把文件内容加入上下文。 1
# 编号 把 GitHub issue/PR 加入上下文。 1
! COMMAND 直接在本地 shell 执行命令（绕过 Copilot）。 1
Ctrl+G 用外部编辑器编辑 prompt（$EDITOR）。 1
Ctrl+C / Esc / Ctrl+L 等 取消/清屏/退出等基础控制。 1
相关推荐
夜雪闻竹21 小时前
Codex CLI / Trae / Copilot 数据源接入
gpt·copilot·ai-native
AI周红伟1 天前
Token工厂：无锡部署昇腾384超节点算力集群，制造Token
大数据·人工智能·windows·百度·copilot·制造
夜雪闻竹1 天前
Claude Code 对话自动导入完全指南
数据库·数据挖掘·copilot
筠筠喵呜喵1 天前
保姆教程：基于Copilot构建AI Agent
人工智能·copilot
MicrosoftReactor1 天前
技术速递｜Web 和移动端远程控制 CLI 会话功能现已开启公开预览
ai·copilot·cli
constCpp2 天前
Cursor、Claude Code、Copilot——剥开壳子，是同一台机器
人工智能·copilot
程序员柒叔2 天前
OpenCode 一周动态-2026-W20
人工智能·github·copilot·agent·opencode
AI周红伟2 天前
All in Token，百度李彦宏指出：Token经济，阿里，百度，腾讯，字节，移动，电信，联通，华为，开启新的Token战争
大数据·人工智能·windows·百度·copilot·openclaw
AI周红伟2 天前
Token工厂落地：移动，电信，华为，阿里，从流量到Token，All in Token
大数据·人工智能·百度·华为·copilot·openclaw
热门推荐
01GitHub 镜像站点02Codex 接入 DeepSeek API 完整配置文档03CC-Switch & Claude 基于 Linux 服务器安装使用指南04Gemini大升级、AI眼镜首发、Android XR亮相，13天后见分晓05【AI】2026 年具身智能模型和世界模型总结06裂开！ChatGPT 居然开始要手机号验证，附详细解决方法07用了半年 OpenRouter，我换到了 Ofox.ai — 两个 AI API 聚合平台的真实对比08Codex 手机端连接教程：三分钟搞定，附完整步骤09【踩坑记录 | 第一篇】微软商店无法使用时，如何手动安装 OpenAI Codex？附`.msix`文件系统错误解决方法10codex app每次打开重连5次Reconnecting问题解决