支持的 AI Agent

ServerCC 通过 SSH 在你自己的服务器上运行七个编程 agent — 全部从 iPhone 或 iPad 操作。1.8.0 在 Claude Code 与 Codex 之外加入了 Grok BuildOpenCodeKimi Code;1.8.1 再添 PiOMP(oh-my-pi)。每个 agent 都享有同一套核心工作流:安装检测、一键启动、带精确恢复的会话历史、权限模式,以及 tmux 持久会话。

Agent CLI 权限模式 说明
Claude Code claude Default · AcceptEdits · Auto · Bypass 完整支持,含 Agent View、bg 会话、Skills、CLAUDE.md 编辑
Codex codex 沙盒与审批模式 Skills 与 MCP 浏览器、实验性功能开关
Grok Build grok Default · AcceptEdits · Auto · DontAsk · Bypass · Plan xAI 官方 CLI;登录卡片;官方版校验
OpenCode opencode 自动批准开关 开源、多模型服务商;历史识别 worktree
Kimi Code kimi Default · YOLO · Auto · Plan Moonshot AI 的 CLI;登录卡片;其 TUI 不支持初始 prompt
Pi pi —(无权限确认,直接执行) Mario Zechner 的极简 agent;通过 npm 安装(Node ≥ 22.19)
OMP omp YOLO 开关 oh-my-pi — Pi 的扩展 fork,单个预编译二进制;可复用 Claude Code/Cursor 凭据

启用 Agent

偏好设置 → Agents 中勾选你要用的 agent。默认为 Claude Code + Codex,老用户无感知;且始终至少保留一个启用的 agent。服务器页和工作区页只渲染已启用 agent 的区块,健康检查也只探测已启用的 agent — 不用的 agent 零开销。

停用某个 agent 只是隐藏其区块和历史,不会删除任何数据 — 重新启用后缓存的会话立即恢复可见。有持久会话或并行会话在跑的 agent 即使被停用,其区块也会保持可见,确保你随时能回到正在运行的工作。

安装与健康检查

服务器详情页为每个已启用的 agent 显示安装区块:检测到的版本、使用各家官方安装脚本的一键安装/升级,以及可选的自定义二进制路径。Pi 是安装方式上的唯一例外:它的官方安装脚本是交互式的,所以 ServerCC 改用 npm 安装(需要 Node ≥ 22.19)。检测还会查找常见安装位置(~/.local/bin~/.grok/bin~/.opencode/bin~/.kimi-code/bin~/.npm-global/bin~/.bun/bin)— 即使 PATH 只写在交互式 shell 的 rc 文件里,新装的 CLI 也能被找到。

Grok Build:仅限官方 CLI

社区的 "superagent" grok-cli 也会安装名为 grok 的二进制。ServerCC 会校验 xAI 官方 CLI 的版本输出,并把社区版视为未安装。

会话:历史、恢复、重连

工作区首页为每个已启用的 agent 显示一个历史标签页。点击任意一行即可恢复那条确切的对话 — ServerCC 解析每个 agent 自己的会话存储(Grok Build 的磁盘会话文件、OpenCode 的 CLI 会话列表、Kimi Code 的会话索引、Pi 和 OMP 的按项目会话文件),按会话 ID 精确恢复,而不是"最近一条"。断线后,非持久会话会续接工作区最近的对话;基于 tmux 的持久会话则按精确会话重连,同样支持全部七个 agent。

OpenCode 的历史以项目为范围,包含在 worktree 中启动的会话。一个限制:Grok Build、Kimi Code、Pi 和 OMP 的会话历史从各自默认的 home 目录读取 — 仅在 shell rc 文件中 export 的自定义 GROK_HOME/KIMI_CODE_HOME/PI_CONFIG_DIR/OMP_PROFILE 不会被识别。

权限模式

每个工作区会按 agent 记住启动时的权限模式,在工作区设置中配置。Grok Build 支持 DefaultAcceptEditsAutoDontAskBypassPlan;Kimi Code 支持 DefaultYOLO(常规工具自动批准,敏感文件仍会询问)、Auto(完全无人值守)和 Plan;OpenCode 提供自动批准开关,OMP 提供 YOLO 开关。Pi 没有权限体系:工具一律直接执行,也没有可配置的东西;高风险工作建议放进 worktree。无人值守类模式在开启前会弹出风险确认。

在手机上登录

当 agent 在终端打印登录 URL 时 — Grok Build 的 device-auth 流程(x.ai)、OpenCode 的 OpenAI 登录、或 Kimi Code 的 device-code 流程 — ServerCC 会识别并显示登录卡片:点击在浏览器中打开、完成登录、回到会话即可。自 1.8.1 起 Grok Build 的 TUI 也支持了 — 它只显示配对码,ServerCC 会据此反构出 device-auth URL。Pi 和 OMP 在各自 TUI 内通过 /login 登录(交互式选择流程、不打印 URL,因此没有卡片);OMP 还能复用服务器上已有的 Claude Code 或 Cursor 凭据。注意 OpenCode 已于 1.3.0 移除 Anthropic OAuth — 在 OpenCode 中请使用 API key 或其他服务商。

MCP 与 Skills

MCP 服务器浏览器支持七个 agent 中的五个 — Claude Code、Codex、Grok Build、OpenCode 和 Kimi Code。ServerCC 读写每个 agent 自己的配置格式(Grok Build 的 config.toml、OpenCode 的 opencode.json、Kimi Code 的 mcp.json),并保留不认识的字段。Pi 没有原生 MCP,OMP 的 MCP 配置尚未接入。Skills 浏览器目前支持 Claude Code 和 Codex。

仍为 Claude Code 独有的功能

  • Agent View 与 bg 会话 — supervisor 托管的并行面板在其他 CLI 中没有对应功能
  • 从工作区页编辑 CLAUDE.md
  • 会话启动时解锁 macOS 钥匙串

FAQ

可以在 iPhone 上运行 OpenCode 吗?

可以。OpenCode 运行在你自己的服务器上;ServerCC 从 iPhone 或 iPad 通过 SSH 连接,提供完整终端、带精确恢复的会话历史、自动批准开关,以及 OpenCode 的 tmux 持久会话。

ServerCC 支持社区版 grok-cli 吗?

ServerCC 支持的是 xAI 官方 Grok CLI(Grok Build)。社区的 "superagent" grok-cli 会安装同名二进制 — ServerCC 会校验版本输出,把社区版视为未安装。

OpenCode 能用我的 Claude(Anthropic)订阅登录吗?

不能。OpenCode 在 1.3.0 版本应 Anthropic 要求移除了 Anthropic OAuth 登录。在 OpenCode 中请使用 API key 或其他服务商账号 — 或者直接使用 ServerCC 完整支持的 Claude Code。

为什么启动 Kimi Code 时初始 prompt 被忽略了?

Kimi Code 的交互式 TUI 没有初始 prompt 参数,因此 ServerCC 启动会话时不会预填 prompt — TUI 启动后输入或粘贴即可。历史、精确恢复和权限模式均正常工作。

Pi 和 OMP 有什么区别?

Pi 是 Mario Zechner 写的极简编程 agent:没有权限确认,通过 npm 安装。OMP(oh-my-pi)是它的社区 fork,以单个预编译二进制分发,加了计划、后台任务、六十来个 slash 命令、YOLO 自动批准开关,还能复用服务器上已有的 Claude Code 或 Cursor 凭据。ServerCC 从 1.8.1 起两个都支持。

为什么 Pi 没有权限模式设置?

Pi 没有权限体系——工具一律直接执行,所以没有可配置项。高风险改动建议放在 worktree 里跑。它的 fork OMP 有 YOLO 自动批准开关。

另见:快速开始添加第一台服务器,会话了解历史与恢复的细节,终端了解快捷命令与多行输入。