DOCAI · 课程 · L3 · 18 分钟 · 命令参考
命令系统简介
把终端子命令、启动标志、斜杠命令三类入口分清:各自在哪用、管什么、谁覆盖谁,再按场景挑对入口。
你将学会
- 能分清三类命令各自的适用场景
- 能判断配置冲突时哪一层生效
- 能为日常开发、脚本和持续集成选对命令组合
三个入口,别混着记
刚上手时最容易犯的错,是把三种东西当成一类:在终端里敲了一个斜杠命令,或者在对话里输入一段启动参数。它们的位置和职责完全不同。
| 形式 | 在哪用 | 管什么 |
|---|---|---|
| 子命令 | 终端,跟在主命令后面 | 启动方式与维护操作 |
| 启动标志 | 终端,- 或 -- 开头的参数 |
只影响当前这一轮 |
| 斜杠命令 | 对话界面内,以斜杠开头 | 会话过程中的控制 |
先记住这张表,后面遇到任何一条命令,先判断它属于哪一行。分类不是目的,少一次试错才是。概念上的定位见这个工具是什么。
终端子命令:决定怎么启动
在项目目录里直接运行主命令,进入交互界面:
claude
带一句话进入,适合一上来就有明确任务:
claude "看看这个目录的结构"
跑完即退出,不进入对话界面,适合放进脚本:
claude -p "把这个目录过一遍,指出明显问题"
接着上次的会话继续:
claude -c
此外还有恢复指定会话的启动参数,以及更新版本、管理外部工具连接等子命令。它们解决的都是「怎么开始」和「怎么维护」,进入对话之后就用不上了。
启动标志:这一次运行怎么跑
标志是附加在启动命令后面的开关,对本次运行有效:
- 模型标志:指定这一次用哪个模型;
- 输出格式标志:让结果输出为纯文本、结构化数据或流式数据;
- 系统提示标志:替换或追加一段长期指令;
- 工具放行标志:让列出的操作不再逐次确认,要限制可用范围得另配禁止清单;
- 详细日志标志:排查问题时打开。
写脚本时,输出格式和轮次上限最有用:前者让程序能解析结果,后者防止它反复尝试耗掉额度。所有标志都只影响本次启动,下次不写就恢复默认。
斜杠命令:对话里的操作台
进入交互界面后,斜杠命令负责过程控制:
/help
/model
/clear
/compact
/cost
/status
/init
日常最常用的是前四个。/clear 清空上下文,适合换一个完全无关的任务;/compact 把历史压缩成要点再继续,适合话题相关但对话太长的情况。选错会丢信息,或者白带着一堆无关内容。
/cost 用来核对开销,/status 用来确认会话现状,/init 在项目里生成规范文件的初稿。拿不准有哪些可用命令时,敲 /help 查询,或按 Tab 让界面补全。
配置优先级:谁覆盖谁
同一项设置可能在几个地方出现。个人和项目层面,生效顺序从高到低是:
- 启动时写的标志;
- 项目里的配置文件(本机私有设置优先于团队共享的那份);
- 用户目录下的全局配置;
- 工具自带的默认值。
如果公司统一下发了托管配置,它会压在最上面,启动标志也盖不过它。
举个例子:全局配置默认用快速模型,某个项目改用推理模型,你启动时又用标志指定了第三个,最终采用标志里的那个。配置放在哪一层,决定它对谁生效;改值之前先弄清范围。排查「为什么行为和预期不一样」时,按这个顺序往上找,通常很快能定位。
场景对照
| 你想做的事 | 选哪个入口 |
|---|---|
| 进入项目边聊边改 | 直接启动,进对话 |
| 一句话任务,做完就走 | 非交互模式加输出格式 |
| 换模型、清上下文、看花费 | 对话内斜杠命令 |
| 写进脚本或持续集成 | 启动标志组合 |
| 排查环境和版本问题 | 诊断类子命令 |
危险开关要单独提醒:跳过全部确认的标志只适合一次性容器或隔离的流水线,日常机器上不要用。确认机制是最后一道闸,闸门常开,迟早出事,相关原则见人在回路。
分清三类入口只是第一步。下一节按用途把命令重新归类,让你从「想干什么」直接找到对应命令:命令分类。
自测
先自己回答,再展开对照;答不上来就回到对应小节。01启动标志和斜杠命令都能换模型,区别在哪?看答案
启动标志只在启动那一刻生效,换一次要退出重开;斜杠命令在对话里随时可用,改的是当前会话后续的行为。
02为什么危险权限开关只能在隔离环境用?看答案
它跳过全部确认,任何命令都可能直接执行,包括不可逆的删除操作。日常机器上误触发一次,代价无法预估。