跳转到主要内容
Shell 模式可在 CLI 中直接运行 shell 命令,无需离开对话。用它来执行快速、非交互式的命令;带有安全检查,输出会显示在对话中。

命令执行

命令会在你的登录 shell($SHELL)中运行,并继承 CLI 的工作目录与环境。可通过串联命令在其他目录下运行:
cd subdir && npm test

输出

超大输出会自动截断,长时间运行的进程会超时以保证性能。

限制

  • 命令在 30 秒后会超时
  • 不支持长时间运行的进程、服务器或交互式提示
  • 建议使用简短且非交互式的命令以获得最佳效果

权限

在执行之前,系统会根据你的权限和团队设置校验命令。查看 Permissions 了解详细配置。 管理员策略可能会阻止某些命令,且带有重定向的命令无法在行内加入 allowlist。

使用指南

Shell 模式适合用于状态检查、快速构建、文件操作和环境查看。 避免运行长时间驻留的服务器、交互式应用,以及需要用户输入的命令。 每条命令都是独立执行的——若要在其他目录下运行命令,请使用 cd <dir> && ...

疑难排查

  • 如果命令卡住,按 Ctrl+C 取消,并添加非交互式参数
  • 当出现权限提示时,可批准一次,或按 Tab 将其加入允许列表
  • 输出被截断时,按 Ctrl+O 展开
  • 需要在不同目录运行时,使用 cd <dir> && ...,因为目录变更不会持久化
  • Shell 模式会根据 $SHELL 变量使用 zsh 或 bash

常见问题

不会。每条命令都是独立运行的。用 cd <dir> && ... 在不同目录里执行命令。
不行。命令限定为 30 秒,且不可配置。
权限由 CLI 和团队配置一起管理。用决策横幅把命令加入允许列表。
当输入为空时按 Esc,在空输入时按 BackSpace/Delete,或按 Ctrl+C 清除并退出。
I