术语表
什么是 CLI，智能体为什么喜欢它？
CLI 是命令行界面（Command Line Interface）。你通过输入命令来控制程序，不用点击按钮。你可能已经在用好几个：git、npm、docker。
GUI 与 CLI 对比
| GUI（图形界面） | CLI（命令行） | |
|---|---|---|
| 使用方式 | 点击按钮，拖动内容 | 输入命令 |
| 示例 | GitHub Desktop | git push |
| 对人来说 | 通常更容易上手 | 熟悉命令后更快 |
| 对智能体来说 | 难用，需要截图和点击 | 顺手，智能体本来就在输入命令 |
智能体为什么喜欢 CLI
AI 编程智能体整天都在终端里输入命令。它们用命令运行代码、安装包、操作 git 和执行测试。CLI 能直接融入它们已有的工作方式。不需要特殊集成。
这就是 Pane 把 runpane 做成 CLI，而不是要求智能体使用自定义协议的原因。Claude Code、Codex、Aider，甚至 bash 脚本，都没区别。只要能输入 runpane panes create，就能控制 Pane。
怎样的 CLI 对智能体友好
不是所有 CLI 都同样适合智能体。下面这些最重要：
JSON 输出。智能体无法稳定解析给人看的表格。--json 参数会返回它们真正能处理的结构化数据。
命令发现。智能体不该先读文档，才能知道有哪些命令。像 runpane agent-context 这样的命令一次就能告诉它全部内容。
默认输出要短。智能体的上下文窗口有限。如果命令默认吐出 500 行内容，就是在浪费 token。好的智能体 CLI 会保持输出简短，并让你用 --limit 200 这类参数按需查看更多。
非交互模式。智能体无法回答“确定吗？(y/n)”这类提示。--yes 参数让它们在自动化流程中跳过确认。
安装前可查看。智能体应该能在安装前检查 CLI 能做什么。Pane 在公开 URL 上发布了完整命令列表，让智能体先看清楚再决定。
runpane 如何实践这些原则
# Discovery: what commands exist?
runpane agent-context --json
# Short output: just what's on screen right now
runpane panels screen --panel <id> --limit 80 --json
# Non-interactive: skip the "are you sure?" prompt
runpane panes create --repo active --name "my-task" --yes --json
# Readable before install:
curl -fsSL https://runpane.com/runpane-cli-contract.json相关内容
- runpane CLI 文档，完整参考
- runpane CLI 介绍页，Pane 为什么构建 CLI
- 什么是 MCP？，与 CLI 互补的协议
- “不限定智能体”是什么意思？，CLI 为什么能做到这一点
最后更新于 2026年6月24日