斜杠命令与工具
把 CLI 的功能菜单完整看一遍，再认识它手里的四件套
命令是确定的功能，工具是灵活的能力——分清两者，效率翻倍你已经掌握了五种输入模式。现在展开 CLI 的完整功能菜单，分清『命令』和『工具』这两个最容易被混淆的概念。
命令记不住
二十多个斜杠命令，密密麻麻，不知从何下手
不知道有哪些
知道输入 / 能看命令，但那么多命令，不知道哪些常用、哪些很少用。
命令和工具分不清
听说有 Read、Write、Bash 这些"工具"，又听说有 /clear 这些"命令"，两者啥关系？
启动参数一脸懵
文档里 -w、-c、--yolo 一堆参数，不知道什么时候用。
命令 vs 工具
这是理解 Qoder CLI 的一个关键区分
斜杠命令（确定性功能）
你输入 /status，CLI 程序直接执行一个固定动作——查状态、显示结果。没有 AI 介入，结果确定。
像点菜单：点"查看状态"就上"查看状态"。
/clear 清空会话
/usage 看 Credits
/quit 退出内置工具（AI 调用的能力）
Read、Write、Bash 这些是AI 在干活时调用的能力。你说"读一下 app.ts"，AI 决定调用 Read 工具。
像厨房的炊具：AI 是厨师，工具是它手里的刀和锅。
Read 读文件
Write 写文件
Grep 搜内容
Bash 跑命令会话管理
控制对话历史的四个命令，每天都用
| 命令 | 作用 | 什么时候用 |
|---|---|---|
/clear |
清空当前会话历史 | 切换到完全不同的任务，不想旧上下文干扰 |
/compact |
总结压缩历史 | 对话太长要爆上下文，但还想保留要点 |
/resume |
查看并恢复历史会话 | 回到昨天没干完的那个任务继续 |
/tasks |
查看后台运行的任务 | 有耗时任务在跑，想看进度 |
/clear 清空——避免上一个任务的上下文"污染"下一个任务的判断。这是保持 AI 专注的简单技巧。
账号与状态
查自己、查 CLI 的四个命令
/status — CLI 体检
显示版本、当前模型、账号、API 连通性、工具状态。出问题时第一个该敲的命令，帮你定位是网络、账号还是配置的问题。
/usage — 用量查看
显示当前 Credits 消耗情况。任务跑得久或多时，定期看看有没有超额风险。
/config — 系统配置
查看 CLI 当前的系统配置，包括权限模式、自动升级等设置项。
/login / /logout
登录与登出账号。已在第 02 章详细讲过。
项目相关
让 CLI 深度参与项目的四个命令，进阶核心
| 命令 | 作用 | 对应章节 |
|---|---|---|
/init | 初始化/更新 AGENTS.md 记忆文件 | 第 05 章 |
/memory | 管理各级记忆（用户级、项目级、本地） | 第 05 章 |
/review | 对本地代码改动进行评审 | 本章 + 第 14 章 |
/quest | 执行基于 Spec 的自主委派任务 | 第 12 章 |
快速体验 /review——这是最直观感受 AI 价值的一个命令：
（在项目里改几个文件后）
> /review
（CLI 读取你的改动，从代码质量、安全、可维护性等角度给出评审）配置与模型
调整 AI 工作方式的几个命令
/effort — 思考深度
调整当前模型的思考深度（类似"想多久"）。简单任务用低档省 Credits，复杂重构用高档要质量。第 13 章详解。
/agents — 子代理管理
查看、创建、管理子代理。第 07 章详解。
/tools — 工具清单
查看当前会话可用的所有工具（内置 + MCP）。这是确认 AI 手里有什么能力的命令。
/skills — 技能管理
查看、重载已配置的技能。第 06 章详解。
四件套工具
AI 干活时最常用的四个内置工具
Qoder CLI 内置了 Grep、Read、Write、Bash 等工具，无需任何配置即可使用。它们是 AI 操作文件和执行命令的基础。
Grep — 搜索内容
在项目里搜索代码、文本、配置。AI 用它定位相关文件。
你说"找到所有调用 login 的地方"，AI 就调 Grep。
Read — 读取文件
读取源代码、文档、配置。大文件只读相关片段，省 token。
AI 看代码靠它，理解项目靠它。
Write — 写文件
创建新文件或修改已有文件。每次写入会经过权限检查。
AI 改代码靠它，但需你批准（默认模式）。
Bash — 执行命令
运行构建、测试、Git 等任何 shell 命令。风险最高，权限最严。
AI 跑测试、跑构建靠它。
控制工具
你可以限制 AI 能用哪些工具——这是安全的关键
工具"可见"和"允许执行"是两件事。启动时用参数控制：
| 参数 | 作用 |
|---|---|
--tools | 限制本次会话可见的工具（白名单） |
--allowed-tools | 预先允许指定工具，免确认 |
--disallowed-tools | 禁止指定工具 |
# 只读探索：AI 只能看，不能改
qodercli --tools Read Grep Glob --allowed-tools 'Read,Grep,Glob'
# 允许安全的状态检查命令免确认
qodercli --allowed-tools 'Read,Grep,Bash(git status)'
# 非交互式审查时禁止任何文件编辑
qodercli -p "review this repo" --disallowed-tools 'Write,Edit'--tools Read Grep Glob 让 AI 只能用看和搜的工具，物理上无法修改文件。排查问题、做代码审查时特别有用。权限系统的完整内容见第 11 章。
启动参数
启动 CLI 时常用的几个一次性参数
| 参数 | 说明 | 示例 |
|---|---|---|
-w | 指定工作区目录 | qodercli -w /Users/demo/projects/nacos |
-c | 继续上次会话 | qodercli -c |
-r | 恢复指定会话 | qodercli -r xxx-c09a-40a9-... |
--max-turns | 最大对话轮数 | qodercli --max-turns=10 |
--yolo | 跳过权限检查（危险） | qodercli --yolo |
--yolo 的警告：它等同于跳过所有权限确认，AI 改文件、跑命令都不问你。只在完全可信的沙盒环境用，比如一次性实验。生产项目千万别用——这是"事故制造机"。--yolo 等价于 --permission-mode bypass_permissions，详见第 11 章。
排错指南
命令和工具使用中的高频问题
斜杠命令报 not found
原因：命令名拼错，或版本太旧不支持。修复：输入 / 看补全列表；用 /status 查版本，必要时 qodercli update。
AI 说"我没有这个工具"
原因：启动时用 --tools 限制了可见工具，或该工具需要 MCP 配置（如浏览器工具）。修复：用 /tools 看可用清单；确认启动参数没有限制。
改文件时总弹确认，很烦
原因：默认权限模式对写入要确认。修复：用 accept_edits 模式（第 11 章），或 --allowed-tools 'Edit' 预先允许。
会话越聊越慢/越乱
原因：上下文堆积太多。修复：用 /compact 压缩，或 /clear 清空重来。
动手练习
把本章学的命令和工具都摸一遍
练习 1：体检与用量
- 运行
/status，记录版本、模型、连通状态 - 运行
/usage，看看 Credits 消耗
练习 2：体验 review
- 在项目里改两个文件（加注释、改函数名都行）
- 运行
/review，看 AI 怎么评审你的改动
练习 3：只读会话
- 用
qodercli --tools Read Grep Glob启动 - 让 AI 试着改文件，观察它如何回应（应表示无法修改）
- 体会"限制可见工具"的安全意义
本章回顾
带走的三个核心认知
命令 vs 工具
命令是你对 CLI 下的指令（确定性），工具是 AI 干活用的能力（灵活调用）。
命令分四组
会话管理、账号状态、项目相关、配置模型。常用的就那十来个。
工具可控
--tools/--allowed-tools/--disallowed-tools 是安全调度的关键。
下一章，深入"项目相关"命令中最关键的两个：/init 和 /memory，让 AI 长期记住你的项目。
延伸阅读
继续本课程
- 下一章：记忆 AGENTS.md — 让 AI 长期记住项目规则
- 权限系统 — 深入工具与权限控制
- 高级特性 — /effort、Worktree 等