命令与选项 - Devin Docs

用法

devin [OPTIONS] [prompt]

传入可选的提示，即可用一条初始消息开启会话；也可以不带任何参数，以交互方式启动。你也可以在终端中通过 man devin 查看这些说明。

全局参数

Flag	Short	Description
`--model <MODEL>`		为当前会话设置 AI 模型
`--permission-mode <MODE>`		权限模式 (`normal`、`dangerous`、`bypass`)
`--continue`	`-c`	在当前目录中恢复最近一次会话
`--resume <SESSION_ID>`	`-r`	按 ID 恢复指定会话
`--print [PROMPT]`	`-p`	输出响应并退出 (非交互模式) 。可选接收内联提示。
`--prompt-file <FILE>`		从文件中加载初始提示
`--config <PATH>`		配置文件路径
`--export [PATH]`		每轮交互后将对话导出到文件 (ATIF 格式) 。如果未提供路径，则使用默认路径。
`--respect-workspace-trust`		是否遵循工作区信任设置

示例：

devin -- add a login page
devin --model opus -- refactor the auth module
devin -c                              # 恢复上一个会话
devin -r abc12345                     # 恢复指定会话
devin -p "list all TODO comments"    # 打印响应并退出
devin -p -- list all TODO comments    # 同上，使用 -- 分隔符（同样有效）
devin --export -- fix the tests       # 将对话导出至默认路径
devin --export out.json -- fix tests   # 导出至指定文件

子命令

devin auth

与身份验证相关的命令。

命令	描述
`devin auth login`	登录你的账户
`devin auth logout`	登出并删除已存储的凭据
`devin auth status`	查看身份验证状态

devin auth login 的选项：

--force-manual-token-flow — 跳过基于浏览器的身份验证，手动粘贴令牌 (对远程/SSH 会话很有用)

devin mcp

连接到 Model Context Protocol 服务器并登录。

命令	说明
`devin mcp add <name>`	添加新的 MCP 服务器
`devin mcp list`	列出所有已配置的 MCP 服务器
`devin mcp get <name>`	显示特定 MCP 服务器的详细信息
`devin mcp remove <name>`	移除已配置的 MCP 服务器
`devin mcp login <name>`	通过 OAuth 对 MCP 服务器进行身份验证
`devin mcp logout <name>`	删除为 MCP 服务器存储的 OAuth 凭据
`devin mcp enable <name>`	启用已禁用的 MCP 服务器
`devin mcp disable <name>`	禁用 MCP 服务器而不将其移除

devin mcp add 的选项：

-t, --transport <stdio|http> — 传输类型 (可选；根据 URL 推断为 http，根据后续参数推断为 stdio)
-s, --scope <local|project|user> — 配置作用域 (默认：local)
--url <URL> — HTTP 传输使用的 URL (也可作为名称后的位置参数传入)
--command <CMD> — stdio 传输使用的命令 (提供后续参数时可省略)
-e, --env <KEY=VALUE> — 环境变量 (可重复)
-H, --header <HEADER: VALUE> — HTTP 标头 (可重复)
--scopes <SCOPE,SCOPE> — 要请求的 OAuth 作用域 (逗号分隔)
--oauth-resource <RESOURCE> — 覆盖 OAuth 请求中发送的 RFC 8707 resource 参数 (默认：MCP 服务器 URL；对于拒绝该参数的提供商，可传入空字符串以省略该参数)
<URL> — HTTP 的位置 URL 参数 (可替代 --url)
-- <COMMAND> [ARGS...] — stdio 的命令及参数 (省略 --command 时，第一个参数为命令)

HTTP 服务器会先尝试 Streamable HTTP，在出现 4xx 错误时回退到旧版 SSE (根据 MCP 规范) 。你也可以显式设置 "transport": "sse"。请参阅 MCP 配置 → 故障排查。

示例：

# stdio 服务器
devin mcp add my-server -- npx @company/mcp-server --port 3000

# HTTP 服务器（位置参数 URL）
devin mcp add notion https://mcp.notion.com/mcp
devin mcp add --transport http datadog-mcp https://mcp.datadoghq.com/api/unstable/mcp-server/mcp

# HTTP 服务器（--url 标志，同样适用）
devin mcp add notion --url https://mcp.notion.com/mcp

# 使用环境变量和作用域
devin mcp add -e GITHUB_TOKEN=ghp_xxx github -- npx -y @modelcontextprotocol/server-github
devin mcp add -s project sentry https://mcp.sentry.dev/mcp

devin mcp remove 的选项：

-s, --scope <local|project|user> — 配置作用域 (默认值：local)

devin mcp login 的选项：

--scopes <SCOPE,SCOPE> — 要请求的 OAuth 作用域 (以逗号分隔)
--oauth-resource <RESOURCE> — 覆盖在 OAuth 请求中发送的 RFC 8707 resource 参数 (默认值：MCP 服务器 URL；对于会拒绝该参数的提供商，可传入空字符串以省略该参数)

devin mcp enable 的选项：

-s, --scope <local|project|user> — 配置作用域 (默认值：local)

devin mcp disable 的选项：

-s, --scope <local|project|user> — 配置作用域 (默认值：local)

详见 MCP 配置。

devin rules

管理 Agent 规则 (始终生效的上下文块) 。

命令	说明
`devin rules list`	列出所有可用规则
`devin rules show <name>`	显示特定规则的详细信息
`devin rules paths`	显示规则目录的位置

devin rules list 的选项：

--provider <cursor\|windsurf> — 按规则提供方筛选

详见规则。

devin skills

管理 Agent 技能 (斜杠命令和由 Agent 触发的上下文数据块) 。

命令	说明
`devin skills list`	列出所有可用的技能
`devin skills show <name>`	显示指定技能的详细信息
`devin skills paths`	显示技能目录的位置

devin skills list 的选项：

--trigger <user\|model> — 按触发类型筛选

详见 Skills。

devin list

列出当前目录中的会话。别名：devin ls

命令	描述
`devin list`	交互式会话选择器 (默认)
`devin list --format json`	以 JSON 格式输出会话
`devin list --format csv`	以 CSV 格式输出会话

devin version

输出当前版本并退出。

devin version

这相当于 devin --version。

devin acp

通过 stdio 将 Devin 作为 Agent Client Protocol (ACP) server 运行。此子命令供支持 ACP 的编辑器或 IDE (如 Windsurf 或 Zed) 以子进程方式调用——它通过 stdin/stdout 使用 JSON-RPC 通信，不适合交互式运行。

devin acp

ACP 服务器会在已设置 WINDSURF_API_KEY 时从中读取凭据，否则会从 devin auth login 存储的凭据中读取。它也可以在运行时通过 ACP 的 authenticate 请求接收凭据。

devin update

检查更新，并可选择安装更新。

devin update

即使已经是最新版本，也可使用 --force 重新安装：

devin update --force

devin shell

[功能预览] Shell 集成命令。完整信息请参阅 Shell 集成。

命令	描述
`devin shell setup`	将 Shell 集成安装到你的 shell 配置文件中
`devin shell setup <shell>`	为指定的 shell 安装 (`bash`、`zsh` 或 `fish`)

devin sandbox

[研究预览版] 管理 exec 工具的操作系统级进程沙盒隔离。传入全局 --sandbox 开关，即可在强制启用沙盒的情况下运行会话。

devin sandbox setup

显示当前平台的沙盒前置要求。使用 --sandbox 运行时的要求：

Linux：需要 bubblewrap (bwrap) 和 socat。如果缺少任一项，沙盒会话将无法启动，并显示安装指示——即使是在全新的 WSL 发行版中也是如此。
macOS：通过 Seatbelt 开箱即用；无需额外软件包。
Windows：原生 Windows 无法运行沙盒。请安装 WSL 2，并在 WSL 发行版中运行 Devin。

devin sandbox setup

devin setup

用于身份验证和配置 MCP 的交互式设置向导。

devin setup
devin setup --force-manual-token-flow  # 适用于远程/SSH 会话

devin uninstall

卸载 Devin CLI，并可选择删除所有数据。

选项	说明
`--clean`	删除所有数据，包括配置、历史记录和自定义数据
`--force`	跳过确认提示

斜杠命令

这些命令可在交互式会话中使用。请在提示符处输入。

模式与模型

命令	说明
`/mode [normal\|accept-edits\|plan\|bypass]`	显示或切换当前模式 (`autonomous` 可用于沙盒会话)
`/normal`	切换到 Normal 模式 (默认)
`/accept-edits`	切换到 Accept Edits 模式 (自动批准对工作区中文件的编辑)
`/plan`	切换到 Plan mode (只读规划)
`/ask <question>`	在不进行代码修改的情况下提问 (单次)
`/bypass`	切换到 Bypass 模式 (自动批准所有操作)
`/model [name]`	显示或更改当前模型
`/fast`	切换到 SWE-1.6 Fast
`/theme [dark\|light\|terminal-dark\|terminal-light\|no-color]`	在各主题间切换 (深色、浅色、终端深色、终端浅色、无颜色)

/bypass 的别名有 /yolo 和 /dangerous，三者作用相同。

会话管理

命令	说明
`/clear`	清空对话历史并开始新会话。别名：`/new`
`/continue [session-id]`	继续之前的会话
`/fork [step]`	从当前会话派生一个新会话。也可选择从特定步骤派生 (见 `/steps`) 。
`/steps`	列出对话步骤 (与 `/fork` 和 `/revert` 搭配使用)
`/revert <step>`	回退从特定步骤开始的文件更改，并将对话退回到该步骤之前
`/resume [session-id]`	打开交互式会话选择器，或按 ID 恢复指定会话
`/ls [--all]`	列出最近的会话 (默认仅显示当前目录) 。别名：`/list-sessions`
`/rename-session <new title>`	重命名当前会话
`/rm-session <session-id>`	永久删除某个会话及其所有数据，此操作不可撤销
`/export`	显示导出信息。使用 `--export` CLI 标志启用对话导出。
`/exit`	退出应用程序 (别名：`/quit`) 。你也可以直接输入 `exit` 或 `quit`，无需加 `/` 前缀。

工作区

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

自动化

命令	说明
`/loop <prompt>`	运行提示，然后循环自动审查 diff
`/btw <prompt>`	提一个简短的题外问题。它会利用当前对话上下文运行一个 sidechain，并将答案显示在框中，同时不会把该问题加入主对话。

扩展性

命令	描述
`/hooks`	列出所有已加载的 hook，包括其 ID、事件类型和源路径

实用命令

命令	描述
`/help`	显示可用的斜杠命令
`/shortcuts`	在按类别分组的交互式可搜索列表中浏览键盘快捷键
`/bug [description]`	向 Devin CLI 开发者报告 bug
`/update [--force]`	检查并安装更新。传入 `--force` 后，即使当前已是最新版本，也会重新安装。
`/upgrade`	升级你的订阅套餐
`/login`	使用你的账户登录
`/logout`	清除已存储的凭据并退出
`/context`	显示上下文窗口用量
`/usage`	显示该会话预估的 credit/ACU 用量，包括恢复会话此前打开时产生的用量
`/compact`	强制压缩会话

云端会话 (仅限 insiders)

Command	Description
`/cloud-sessions [--all]`	打开一个交互式选择器，列出你最近的云端 Devin 会话。使用方向键移动，输入以筛选，按 Enter 可附加，按 Esc 取消。传入 `--all` 可查看整个组织范围内的会话。
`/cloud-attach <session-id>`	附加到一个云端 Devin 会话，并提供完整的 TUI 渲染和双向输入。

模式

模式通过将权限模式与 Agent Profile 组合起来，控制 Agent 的自主程度。

Normal（默认）
套餐
Bypass

为复杂编码任务提供完全自主能力。Agent 可以在常规权限检查下读取、写入并执行命令。

Permission mode: Normal
Profile: Normal
Use for: 多文件重构、功能实现、bug 修复

使用 /mode 在不同模式间切换，或者直接使用 /normal、/accept-edits、/plan 或 /bypass 切换。使用 /ask <question> 作为一次性命令提问，而无需切换模式。

Profiles

Profile 决定 Agent 可使用的工具及其行为。切换模式时，Profile 会自动设置。

Profile	描述	工具访问权限
`normal`	完整的编码助手 (用于 Normal、Accept Edits 和 Bypass 模式)	所有工具
`plan`	结构化规划工作流程 (用于套餐模式)	只读工具 (grep、glob、read、todo、ask_user_question、exit_plan_mode)
`ask`	问答 (用于 `/ask` 命令)	只读工具 (grep、glob、read、todo、ask_user_question)

​用法

​全局参数

​子命令

​devin auth

​devin mcp

​devin rules

​devin skills

​devin list

​devin version

​devin acp

​devin update

​devin shell

​devin sandbox

​devin sandbox setup

​devin setup

​devin uninstall

​斜杠命令

​模式与模型

​会话管理

​工作区

​自动化

​扩展性

​实用命令

​云端会话 (仅限 insiders)

​模式

​Profiles

用法

全局参数

子命令

devin auth

devin mcp

devin rules

devin skills

devin list

devin version

devin acp

devin update

devin shell

devin sandbox

devin sandbox setup

devin setup

devin uninstall

斜杠命令

模式与模型

会话管理

工作区

自动化

扩展性

实用命令

云端会话 (仅限 insiders)

模式

Profiles