必备命令 - Devin Docs

启动 Devin CLI

默认情况下，会话会在 REPL 中进行。REPL 是一种图形化终端界面，你可以在其中来回对话并观察 Devin 的操作。

devin                            # 启动交互式 REPL（无提示）
devin -- your prompt here        # 启动带初始提示的 REPL
devin -p "prompt"                # 单轮模式，无 REPL：将响应输出到标准输出并退出
devin -p -- prompt words here    # 同上，使用 -- 分隔符（同样有效）

在提示前加上 --，这样它会被识别为提示，而不是子命令。

单轮模式 (-p) 非常适合脚本和自动化。

在提示输入框中键入 @，即可打开本地文件/目录的自动补全。选择一项后，会将其作为上下文添加到你的消息中。

你可以用 Ctrl+V 从剪贴板粘贴图片。附加的图片会显示在输入区域中，可使用 左/右方向键 切换，并用 Backspace 删除。

运行 shell 命令

Devin 在工作过程中可能会运行 shell 命令。如果某个命令在默认等待时间过后仍未结束，Devin 会将其转入后台，并显示已等待的时长以及后台 shell ID。这样，Devin 就可以继续工作，并在稍后检查该命令的输出。

模式

Devin CLI 有 4 种内置权限模式：Normal、Accept Edits、Bypass 和 Autonomous，以及 3 种 Agent 模式：Normal、Plan 和 Ask。如需使用 Plan 和 Ask，请使用 /plan 和 /ask。

Normal

会自动批准当前目录内的只读工具，并在执行写入/执行操作时请求权限。

/normal
# 或
/mode normal

这是默认模式。

Accept Edits

会自动批准 工作区 内的文件编辑，但仍会对 shell 命令和其他操作进行提示。我们预计用户大多数时间都会使用这个模式。

/accept-edits
# 或
/mode accept-edits

Bypass

会自动批准所有工具调用，包括写入和 shell 命令。

/bypass
# 或
/mode bypass

你也可以以 bypass 模式启动：

devin --permission-mode bypass

别名：/yolo、/dangerous

Bypass 模式绝不会覆盖你的 Admin 通过团队设置配置的组织级权限。由 Admin 强制执行的 deny 和 ask 规则始终优先。

Autonomous

大致相当于在当前 工作区 中使用 Accept Edits，并额外支持在 OS-level 沙盒内运行任意 shell 命令 (以限制这些命令实际能够访问的内容) 。

devin --sandbox --permission-mode autonomous

使用 --sandbox 运行时，Autonomous 是唯一可用的权限模式，并会自动选中——Normal、Accept Edits 和 Bypass 会在沙盒 session 中隐藏。在 Autonomous 模式下…

系统会针对能力而非命令向你发出提示。
- 命令会通过文件系统沙盒遵循 Write 和 Read 作用域。
- 当命令尝试连接网络资源时，系统会提示你。
当前目录内的只读操作会自动批准。

Autonomous 依赖沙盒来保障安全。未启用 --sandbox 时，此模式不可用——如果你希望在没有 OS 级隔离的情况下进行无人值守执行，请使用 Bypass。有关直接对比，请参阅下方的 Bypass vs Autonomous。

Bypass 与 Autonomous 的区别

Bypass 和 Autonomous 都能减少审批提示，但它们采用的安全机制不同：

	Bypass	Autonomous
需要 `--sandbox`	否	是 (仅在沙盒会话中可用)
Shell 命令	自动批准，不受限制	自动批准，但受沙盒约束
通过 `edit`/`write` 工具写入文件	在任何位置都会自动批准	仍会提示 (授予某个作用域会扩展沙盒)
网络访问	不受限制	受沙盒的域名允许/拒绝列表过滤
遵循 Admin 团队设置	是	是

当你信任 Agent 操作整台机器时，选择 Bypass。若你希望无人值守执行，同时由操作系统强制限制 Agent 可访问的文件和域名，请选择 --sandbox (这会启用 Autonomous) 。如果你喜欢 bypass 的使用体验，但又希望 Agent 拥有自己独立的电脑，不妨试试 cloud Devin！

会话历史

你的对话历史会被保存，以便你稍后继续之前的会话。

devin -c              # 继续当前目录中最近的会话
devin --continue

devin -r              # 从最近的会话中选择
devin --resume
devin -r brisk-otter  # 通过 ID 恢复指定会话

斜杠命令

你可以在当前会话中使用这些命令。

命令	描述
`/help`	查看所有可用命令
`/exit` or `/quit`	退出应用
`/clear` or `/new`	清除对话历史 (重新开始)

你也可以直接输入 exit 或 quit 作为普通文本 (不带 / 前缀) 来退出。

模式切换

命令	说明
`/mode`	显示当前模式
`/mode <name>`	切换模式 (`normal`、`accept-edits`、`plan`、`bypass`；在沙盒会话中还可使用 `autonomous`)
`/normal`	切换到 Normal 模式 (默认)
`/plan`	切换到 Plan 模式
`/ask <question>`	仅提问而不进行代码修改 (oneshot)
`/bypass`	切换到 Bypass 模式 (别名：`/yolo`、`/dangerous`)

模型切换

命令	说明
`/model`	显示模型选择器

会话管理

命令	描述
`/resume`	打开交互式会话选择器
`/resume <id>`	按 ID 恢复会话
`/ls`	列出当前目录中最近的会话 (别名：`/list-sessions`)
`/ls --all`	列出所有目录中的会话
`/continue`	恢复最近一次会话
`/continue <id>`	按 ID 恢复会话
`/rm-session <id>`	按 ID 永久删除会话

工作区

命令	描述
`/workspace`	列出工作区目录 (别名：`/workspaces`)
`/add-dir <path>`	添加额外的工作区目录
`/undo-add-dir <path>`	移除工作区目录

自动化

命令	说明
`/loop <prompt>`	运行提示，并循环自动审查 diff (开始前要求 git 处于干净状态)

可扩展性

命令	说明
`/hooks`	列出所有已加载的 hook，以及它们的 ID、事件类型和源路径

账户与系统

命令	说明
`/login`	登录 Devin
`/logout`	清除已存储的凭据并退出
`/update`	检查并安装更新
`/upgrade`	升级你的订阅套餐
`/bug`	向 Devin CLI 开发者报告 bug
`/compact`	强制压缩会话

如果你通过 Homebrew 安装了终端版 Devin，/update 会提示你改用 brew upgrade devin，而不是执行自更新。

键盘快捷键

以下是最重要的键盘快捷键。更多快捷键请参见键盘快捷键。

快捷键	描述
`Shift+Tab`	在各模式间循环切换 (Normal、Accept Edits、Plan、Bypass、Autonomous)
`Ctrl+C`	清除输入文本，或取消正在运行的 Agent
`Esc`	取消正在运行的 Agent
`Shift+Enter`	插入换行 (多行输入)
`Ctrl+V` 或 `Shift+Insert`	从剪贴板粘贴
`Ctrl+G`	打开外部编辑器
`Ctrl+O`	打开全屏思考轨迹查看器
`@`	提及文件，将其添加到上下文中

​启动 Devin CLI

​运行 shell 命令

​模式

​Bypass 与 Autonomous 的区别

​会话历史

​斜杠命令

​导航与控制

​模式切换

​模型切换

​会话管理

​工作区

​自动化

​可扩展性

​账户与系统

​键盘快捷键

启动 Devin CLI

运行 shell 命令

模式

Bypass 与 Autonomous 的区别

会话历史

斜杠命令

导航与控制

模式切换

模型切换

会话管理

工作区

自动化

可扩展性

账户与系统

键盘快捷键