03. 首次运行与 CLI 基础
Hermes 的 CLI 是最重要的主入口。很多高级能力最终都要回到 CLI 里调试和观察，所以这一章建议认真读。
本章目标
- 学会启动 Hermes CLI 并完成一次基本对话
- 掌握常用 slash commands
- 学会恢复会话、切换模型、观察工具行为
- 理解 CLI 与消息平台交互面的差异
适用读者
- 刚完成安装的新用户
- 希望把 Hermes 当作主工作台的重度用户
前置条件
- 已完成安装
- 至少有一个可用模型
核心概念
CLI 是最完整的交互面
CLI 默认拥有最完整的观察能力和调试体验，包括：
- slash command 自动补全
- 工具执行进度显示
- 会话恢复
- 中断与重定向
- 本地图片粘贴
- 背景会话
有两类命令需要区分
- shell 命令：例如
hermes status - 会话内 slash commands：例如
/model、/usage、/compress
你可以把前者理解为“启动或管理 Hermes”，把后者理解为“正在和 Hermes 对话时控制当前会话”。
操作步骤
启动 CLI
最简单的方式就是：
hermes
进入后先尝试几条基础命令：
/help
/model
/usage
/toolsets
发出第一条有效请求
不要一开始就发“你好”，更推荐给 Hermes 一个能触发真实能力的任务，例如：
阅读当前目录结构并总结这个仓库的核心组成。
这样你能更快看到它是否会搜索文件、是否会调用工具、输出风格是否符合预期。
学会多行输入与中断
CLI 支持多行输入，适合粘贴代码、traceback 和长提示。任务跑偏时可以按 Ctrl+C 中断，再直接发新消息重定向。
掌握最常用的 slash commands
下面这些是高频中的高频：
-
/help：查看帮助 -
/model [model]：查看或切换模型 -
/new//reset：新会话 -
/title [name]：给当前会话命名 -
/resume [name]：恢复之前命名过的会话 -
/usage：看 token、成本、上下文使用情况 -
/compress：手动压缩上下文 -
/verbose：切换工具输出显示级别 -
/background <prompt>：在后台启动独立任务 -
/tools [list|enable|disable]：查看或修改当前会话工具 -
/skills：搜索、查看、安装技能
学会会话恢复
CLI 外部可以用：
hermes -c
hermes -r "会话标题"
CLI 内部可以用：
/resume 会话标题
如果你经常做连续任务，会话命名是非常值得养成的习惯。
观察工具行为
执行复杂任务时，建议切换 /verbose，观察 Hermes 是否：
- 真正调用了你期望的工具
- 在错误的地方浪费步骤
- 因为权限、配置或工具缺失而被卡住
这比盲目重试更有效。
常见场景
场景 1：恢复昨天没做完的任务
hermes -r "auth-refactor"
或者进入 CLI 后：
/resume auth-refactor
场景 2：切换到更合适的模型
/model
/model openrouter:anthropic/claude-sonnet-4
/model zai:glm-5
复杂推理任务和简单格式化任务，往往不该强行用同一个模型。
场景 3：让长任务后台运行
/background 读取当前仓库，整理一份贡献指南并给出改进建议。
这样当前会话仍然可用，后台任务完成后会返回结果。
常见问题与排错
为什么我在 CLI 里看不到工具细节
先执行 /verbose，Hermes 会在不同显示级别之间切换。
为什么一个任务越聊越慢
通常是上下文变长了。先看 /usage，必要时执行 /compress。
为什么同样的命令在消息平台里没有
因为有些 slash commands 是 CLI-only，例如 /tools、/toolsets、/browser、/config、/skills 等。CLI 和 Gateway 共享一部分命令，但并不完全一致。
本章总结
CLI 是你理解 Hermes 行为、观察工具调用、调整模型与会话状态的最佳入口。只要你把 CLI 用顺，后面使用 Gateway、MCP、Cron 和开发扩展时都会轻松很多。
下一步建议
继续看 配置体系与模型管理，理解 Hermes 的配置到底怎么组织。
Top comments (0)