从 Agent 视角系统梳理命令行工具为什么兴起、如何设计 Agent 友好的命令行工具，并结合开源 CLI 转换工具 OpenCLI、CLI-Anything 和钉钉、飞书、谷歌 Workspace、Stripe 等多家产品的官方 CLI 工具案例进行分析。

为什么 Agent 时代反而更需要 CLI

过去很多人把 CLI 看成“给工程师手工敲命令的老工具”，而在 Agent 时代，这个判断反而过时了。对于大模型驱动的 Agent 而言，CLI 并不是落后的接口，而是最天然的一类执行面：

• 它是文本输入、文本输出，和 LLM 的工作方式天然匹配
• 它通常自带 --help、--version、退出码、标准输出/错误输出，具备自描述性
• 它容易组合，适合被 shell、脚本、CI/CD、子 Agent 链式调用
• 它不要求额外协议栈，部署和运行成本低

更重要的是，Agent 不会像人一样脑补一个 CLI 的意图。人类可以忍受模糊报错、临时交互、花哨表格和超长日志；Agent 可以勉强处理，但每一次猜测都会额外消耗 token、重试浪费上下文窗口。所谓“Agent 友好 CLI”，本质上就是把这部分不必要的摩擦拿掉。

为什么 CLI 仍然是 Agent 的理想接口

1. CLI 比 GUI 自动化更稳定

GUI 自动化依赖截图、DOM、像素、焦点状态和时序，天然脆弱。CLI 只要求明确的命令、参数和输出，状态面更小，可复现性更强。

2. CLI 比直接调 API 更接近 Agent 的工作流

API 本身当然重要，但 Agent 不一定擅长从零拼装 HTTP 请求、认证方式、分页逻辑和错误恢复。设计良好的 CLI 已经把这些复杂性收敛成命令语义，Agent 可以直接发现并调用。

3. CLI 比很多 MCP 包装器更轻

MCP 适合做权限治理、工具注册、上下文注入和多工具编排，但并不是所有事情都值得单独做成 MCP Server。很多 MCP 本质上只是把已有 CLI 再包一层。如果底层 CLI 已经设计得足够好，直接调用 CLI 常常更便宜、更快，也更符合 Unix 的组合哲学。

Mario Zechner 在 MCP vs CLI 基准测试 中对比了 terminalcp 的 MCP 版本和 CLI 版本，结果很有代表性：两者都达到了 100% 成功率，差异更多来自工具设计本身，而不是协议名字本身。换句话说，协议只是管道，接口质量才是决定 Agent 成败的核心。讨论 CLI 和 MCP 时，一个常见误区是把它们当成互斥方案。更准确的理解应该是：

• CLI 是执行接口，先把底层能力做成稳定、可组合、可脚本化的 CLI
• MCP 是工具分发与治理接口
• API 是产品能力接口

这样做的好处是：

• 人类、脚本、Agent 都能复用同一套能力
• 文档、测试、错误码、输出契约只维护一份
• 如果某个平台不支持 MCP，只要有 shell 就还能工作

Agent 友好 CLI 的 7 条设计原则

下面这组原则，综合了开源社区知名的 CLI 工具通用经验，以及 OpenCLI / CLI-Anything 的实践。

1. 默认非交互

任何 Agent 可能自动化的命令，都不应依赖交互式 prompt。

推荐做法：

• 支持 --yes、--force、--quiet、--no-input
• 检测非 TTY 时自动禁用交互
• 必填项都能通过 flag、stdin、配置文件或环境变量传入

原因很直接：当一个 Agent 启动子 Agent，再由子 Agent 调起 CLI 时，中间通常没有办法把“请输入 y/n”回传到最上层用户。

2. 为机器输出结构化结果

如果命令返回的是数据，而不是纯展示信息，就应该提供稳定的机器可读格式。

推荐做法：

• 提供 --json
• 成功结果写入 stdout
• 警告、进度、错误写入 stderr
• 输出字段命名稳定，不要今天叫 id 明天改成 resource_id

这是 Agent 友好的基础，否则模型只能靠脆弱的文本解析来猜。

3. 错误要能指导下一步修复

对人类可接受的报错，对 Agent 往往不够。

坏报错：

Error: missing required arguments

好报错：

Error: --content is required.
Usage: blog-cli publish --content <file> [--status <status>]
Available statuses: draft, published, scheduled
Example: blog-cli publish --content my-post.md

Agent 需要的不只是哪里错了，更是下一次怎么改才对。

4. 可安全重试，边界清晰

Agent 会重试、恢复、回放。对有副作用的命令，CLI 设计必须考虑这一点。

推荐做法：

继续阅读

面向 Agent 的命令行工具（CLI）最佳设计实践