跳转至

常用指令的简单介绍

本节我们列举各种常用的指令。掌握基础的指令就可以进行最基础的 Agent 操作。

1. Hello World!

首先在你想要浏览的文件夹里面启动 Agent CLI 。如果不确定,也可以开一个空的文件夹,然后在里面打开 Agent CLI。 如果使用的模型能力较强(即 GPT, Claude, DeepSeek, GLM, Kimi 等强开源闭源模型),我非常推荐所有读者,在启动的时候,就直接给 Agent 完全权限。

会不会把我电脑上的东西删完?

只要你不要让他在危险的文件夹里启动,或者让他去操作那些危险的文件、文件夹就行。比如,不要让他去操作你的系统文件夹,删除之前向你二次确认,等等。

选取你想要启动的 Agent 并启动:

claude --dangerously-skip-permissions

进入交互式命令行后,输入 Hello World,Agent 就会回应你。

恭喜你,你已经初步掌握了如何使用 Agent!和 Agent 交流与和网页端的 AI 交流逻辑差不多,新手可以先把它当成许愿机或者先知来使用。

Codex 有两种等效的办法:

codex --dangerously-bypass-approvals-and-sandbox
codex --yolo

进入交互式命令行后,输入 Hello World,Agent 就会回应你。

恭喜你,你已经初步掌握了如何使用 Agent!和 Agent 交流与和网页端的 AI 交流逻辑差不多,新手可以先把它当成许愿机或者先知来使用。

OpenCode 需要修改文件,输入

opencode

进入交互式命令行,然后粘贴下面这句给他,

在 ~/.config/opencode/opencode.json 中,将 permission 设为 "allow" ,以配置全局 bypass 权限

等他干完,你再按 Ctrl + C 退出,然后重新输入 opencode 进入就是设置好权限的 CLI 了。

进入交互式命令行后,输入 Hello World,Agent 就会回应你。

恭喜你,你已经初步掌握了如何使用 Agent!和 Agent 交流与和网页端的 AI 交流逻辑差不多,新手可以先把它当成许愿机或者先知来使用。

接下来的大部分教程,结构都会是:

  1. 问 Agent 问题:
    • ”你会做什么?”
    • ”这个怎么做?“
    • ”我的方案能行吗?”
    • ”能按照我的方案做吗?“
    • “为什么不按照我的方案做?”
    • ……
  2. Agent 给我们一个简明的教程/解释/方案/等等
  3. 等到学会了更简单和实用的办法,就不用重复问了

让我们开始吧!

2. 如何让 Agent 听话: AGENTS.md / CLAUDE.md

相信读者大多数很反感 AI 味很重的句子 ,比如 “不是……而是”、大而无当的比喻、刻板的用词、互联网行业黑化、奇怪的直译,等等。

我们可以从这个视频里面提炼出下面的 AI 味特征和处理规则:

1. 保持直接、自然的表达,减少空泛的比喻和套话。
2. 优先使用正向陈述,清楚说明当前主题。
3. 内容较多时使用列表,让结构一目了然。
4. 专注当前任务,避免引入距离较远的上下文。
5. 完成工作后直接汇报结果和需要关注的问题。

在工作目录中新建 AGENTS.md / CLAUDE.md 并把上述内容粘贴进去。后续你的所有指令都会把这段内容自动注入开头。

读者不能完全让 Agent 自己写 AGENTS.md。Agent (驱动 Agent 的 LLM)的视角一般比较高,它的阅历和工程经验大多数时候比读者丰富;而且受限于它的训练过程,它习惯于把任务变换成具体的代码任务来做,在一些场合反而过于复杂、而且违背任务的本意。

不同的 LLM 的“脾气”也不同,使用不同的 LLM 的时候需要注意的地方也不同。关于不同 LLM 的脾气,会在下一节做简要阐述。

3. 基础指令

指令一般以 / 开头,直接输入 / 就能看到待选列表,按方向键上下并回车即可选中。

常见且一般在不同的 CLI 中通用的指令如下:

指令 指令功能
/model 列举并选择接下来使用的模型(和推理强度)
/compact 压缩过长的对话内容
/plan 切换到计划模式
/goal 切换到目标模式
/btw 在 Agent 工作期间,不打断工作状态,临时问一个问题
/clear 清除当前的所有对话历史并新开对话
/usage 查看当前的累计用量
/agent 查看当前对话中能够使用的 Agent

其中 /plan,/goal 和 /btw 是这里面最常用的指令。接下来先简单讲解这三个指令的使用方法,后面的章节中会有进阶教程。

3.1. /plan:开启计划模式,确定工作计划

输入

/plan [你的计划内容,可简可繁]

Agent 随即进入计划模式:

  1. 进行调研,与你交流,直到得出可行的执行计划;
  2. 让 Agent 按照计划的内容开始工作。
  3. 注意,这个过程里面 Agent 不能执行本地代码。如果你需要让他执行本地代码、获得结果来深入理解计划的话,反而不能打开计划模式,更应该直接和他讨论。

3.2. /goal:让 Agent 不达某目的不罢休

输入

/goal [任务目标 + 验证任务完成的办法 + 可选的任务内容]

按照括号内容详细描述任务,即可让 Agent 尽最大的努力、向着该任务目标不懈工作,直到验证通过。

3.3. /btw:不打断工作的临时询问

如果出现问题需要让 Agent 暂停并更改错误,可以直接在 CLI 按 Esc 键;但是如果只是想临时问个问题且不影响 Agent 工作,则可以按照下面的方法提问,如:

/btw 关于你刚才那个步骤,为什么需要这么做呢

这样会从当前最新的任务步骤里面分支出来,创建一个临时的问答。

问答结束后按 Esc 即退出这个临时问答(同时丢失这个 /btw 的历史)。

3.4. /compact:压缩上下文,腾出空间

Agent 是由 LLM 驱动的,LLM 的上下文长度,不管是 32k 还是 1M,总归是有限的。 当你觉得当前的任务步骤已经完成,同时后续的任务和当前任务关系不是非常大、但是仍然要接续当前的任务结果进行工作时,可以直接输入

/compact [可选的压缩指导]

Agent 就会自己想办法压缩目前所有的对话内容,腾出更多的上下文,为后续做准备。 很多成熟的 Agent 框架会自己运行这个指令,无需用户额外设置。

当然如果你要指导 Agent 进行上下文压缩,你也可以在 /compact 里面输入指导他如何保留和丢弃历史上下文中的内容。