CLI 启动选项

启动选项适合脚本或为一次运行指定行为。与保存设置相比，多数仅作用于当前运行，但个别选项会持久化，应逐项核对。

提示与执行模式

选项	含义
-C DIRECTORY	在其他操作前改变工作目录
-i PROMPT	打开交互会话并立即执行初始提示
-p PROMPT	非交互执行，完成后退出
--attachment PATH	初始提示附件，可重复；图像还需模型和组织允许 vision
--agent NAME	选择自定义智能体
--mode MODE	interactive、plan 或 autopilot
--plan	等同 --mode plan
--autopilot	允许自主 continuation
--fleet	初始提示使用并行编排，必须有 -i、-p 或 stdin 提示
--no-ask-user	禁用澄清工具

--plan 不能与 --autopilot 合用；--plan --mode autopilot 是专门的先计划再自主实施组合，计划完成后不等人工批准。其他 --plan 与 --mode 组合被拒绝。

--max-autopilot-continues 接受非负整数，不接受负数、小数、NaN 或指数。综合参考写默认 unlimited，Autopilot 专题写默认 5 次，存在差异；需要有界运行时显式指定，不依赖默认。

会话选择

选项	行为
--continue	恢复当前目录最近会话，没有时退回全局最近会话
--resume[=VALUE]	选择或按 ID、前缀、名称恢复
--session-id ID	精确 ID；无匹配时仅有效 UUID 可创建新会话
--connect[=SESSION-ID]	连接远程会话
--name NAME / -n NAME	新会话名称
--worktree[=NAME] / -w	在 Git worktree 启动

continue 与 resume 互斥；connect 与两者互斥；worktree 与 resume、continue、connect 互斥。session-id 也不要与其他会话选择或启动方式组合。

裸 resume 需要 TTY 选择器；无法交互且有多个候选时会报错，不会自动新建，脚本应给精确 ID。名称匹配精确且忽略大小写，找不到显式名称时可回退自动摘要。

模型和上下文

--model MODEL 选择模型，auto 交给服务选模。--effort / --reasoning-effort 支持 low、medium、high、xhigh、max，具体模型是否支持仍以可用选项为准。--context 选择 default 或 long_context。

--max-ai-credits 是软限制，官方会话教程与命令参考的重置范围不同，详见额度限制。

权限、配置和扩展

--available-tools / --excluded-tools 决定模型能看到哪些工具；--allow-tool / --deny-tool 决定调用授权。--allow-url / --deny-url 控制网址，deny 优先。--add-dir 还会信任所加目录里的 Skills 和 Agents，目标必须是已存在目录。

--sandbox / --no-sandbox 是本次运行的沙箱选择，不能放宽强制企业底线。--allow-all / --yolo 同时放开工具、路径和 URL，组织可禁止。

--plugin-dir 挂载本地插件；它与 add-dir 的相对路径都按最终会话工作目录解析，不受参数排列先后影响。--no-custom-instructions 关闭仓库指令加载。

输出与界面

选项	行为
--output-format text / json	默认 text；json 实为 JSONL
--silent / -s	主要输出智能体回复，适合脚本
--stream on / off	默认 on，逐步显示回复
--share PATH	非交互完成后导出 Markdown
--share-gist	创建 secret GitHub gist
--log-dir、--log-level	日志目录与详细程度
--screen-reader	屏幕阅读器优化
--mouse on / off	显式设置会持久化鼠标偏好

完整参数以 copilot help 为准。调试导出与外发区别见诊断与日志。