跳到正文
docai.cc

DOCAI · 课程 · L3 · 18 分钟 · 命令参考

命令系统简介

把终端子命令、启动标志、斜杠命令三类入口分清:各自在哪用、管什么、谁覆盖谁,再按场景挑对入口。

Claude Code 程序员 · 命令系统概述

你将学会

  • 能分清三类命令各自的适用场景
  • 能判断配置冲突时哪一层生效
  • 能为日常开发、脚本和持续集成选对命令组合

三个入口,别混着记

刚上手时最容易犯的错,是把三种东西当成一类:在终端里敲了一个斜杠命令,或者在对话里输入一段启动参数。它们的位置和职责完全不同。

形式 在哪用 管什么
子命令 终端,跟在主命令后面 启动方式与维护操作
启动标志 终端,- 或 -- 开头的参数 只影响当前这一轮
斜杠命令 对话界面内,以斜杠开头 会话过程中的控制

先记住这张表,后面遇到任何一条命令,先判断它属于哪一行。分类不是目的,少一次试错才是。概念上的定位见这个工具是什么。

终端子命令:决定怎么启动

在项目目录里直接运行主命令,进入交互界面:

claude

带一句话进入,适合一上来就有明确任务:

claude "看看这个目录的结构"

跑完即退出,不进入对话界面,适合放进脚本:

claude -p "把这个目录过一遍,指出明显问题"

接着上次的会话继续:

claude -c

此外还有恢复指定会话的启动参数,以及更新版本、管理外部工具连接等子命令。它们解决的都是「怎么开始」和「怎么维护」,进入对话之后就用不上了。

启动标志:这一次运行怎么跑

标志是附加在启动命令后面的开关,对本次运行有效:

  • 模型标志:指定这一次用哪个模型;
  • 输出格式标志:让结果输出为纯文本、结构化数据或流式数据;
  • 系统提示标志:替换或追加一段长期指令;
  • 工具放行标志:让列出的操作不再逐次确认,要限制可用范围得另配禁止清单;
  • 详细日志标志:排查问题时打开。

写脚本时,输出格式和轮次上限最有用:前者让程序能解析结果,后者防止它反复尝试耗掉额度。所有标志都只影响本次启动,下次不写就恢复默认。

斜杠命令:对话里的操作台

进入交互界面后,斜杠命令负责过程控制:

/help
/model
/clear
/compact
/cost
/status
/init

日常最常用的是前四个。/clear 清空上下文,适合换一个完全无关的任务;/compact 把历史压缩成要点再继续,适合话题相关但对话太长的情况。选错会丢信息,或者白带着一堆无关内容。

/cost 用来核对开销,/status 用来确认会话现状,/init 在项目里生成规范文件的初稿。拿不准有哪些可用命令时,敲 /help 查询,或按 Tab 让界面补全。

配置优先级:谁覆盖谁

同一项设置可能在几个地方出现。个人和项目层面,生效顺序从高到低是:

  1. 启动时写的标志;
  2. 项目里的配置文件(本机私有设置优先于团队共享的那份);
  3. 用户目录下的全局配置;
  4. 工具自带的默认值。

如果公司统一下发了托管配置,它会压在最上面,启动标志也盖不过它。

举个例子:全局配置默认用快速模型,某个项目改用推理模型,你启动时又用标志指定了第三个,最终采用标志里的那个。配置放在哪一层,决定它对谁生效;改值之前先弄清范围。排查「为什么行为和预期不一样」时,按这个顺序往上找,通常很快能定位。

场景对照

你想做的事 选哪个入口
进入项目边聊边改 直接启动,进对话
一句话任务,做完就走 非交互模式加输出格式
换模型、清上下文、看花费 对话内斜杠命令
写进脚本或持续集成 启动标志组合
排查环境和版本问题 诊断类子命令

危险开关要单独提醒:跳过全部确认的标志只适合一次性容器或隔离的流水线,日常机器上不要用。确认机制是最后一道闸,闸门常开,迟早出事,相关原则见人在回路。

分清三类入口只是第一步。下一节按用途把命令重新归类,让你从「想干什么」直接找到对应命令:命令分类。

自测

先自己回答,再展开对照;答不上来就回到对应小节。
  1. 01启动标志和斜杠命令都能换模型,区别在哪?看答案

    启动标志只在启动那一刻生效,换一次要退出重开;斜杠命令在对话里随时可用,改的是当前会话后续的行为。

  2. 02为什么危险权限开关只能在隔离环境用?看答案

    它跳过全部确认,任何命令都可能直接执行,包括不可逆的删除操作。日常机器上误触发一次,代价无法预估。

查看 Markdown

涉及的概念

在知识树上