---
title: "命令系统简介"
description: "把终端子命令、启动标志、斜杠命令三类入口分清：各自在哪用、管什么、谁覆盖谁，再按场景挑对入口。"
updated: 2026-11-13
canonical: https://docai.cc/learn/command-system-overview/
markdown_mirror: https://docai.cc/learn/command-system-overview.md
---
## 三个入口，别混着记

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

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

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

## 终端子命令：决定怎么启动

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

```bash
claude
```

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

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

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

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

接着上次的会话继续：

```bash
claude -c
```

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

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

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

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

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

## 斜杠命令：对话里的操作台

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

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

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

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

## 配置优先级：谁覆盖谁

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

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

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

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

## 场景对照

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

危险开关要单独提醒：跳过全部确认的标志只适合一次性容器或隔离的流水线，日常机器上不要用。确认机制是最后一道闸，闸门常开，迟早出事，相关原则见[人在回路](/concepts/human-in-the-loop/)。

分清三类入口只是第一步。下一节按用途把命令重新归类，让你从「想干什么」直接找到对应命令：[命令分类](/learn/cli-command-categories/)。