命令与开关 - Devin Docs

用法

devin [OPTIONS] [prompt]

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

全局开关

开关	简写	环境变量	描述
`--model <MODEL>`		`DEVIN_MODEL`	设置此会话使用的 AI 模型
`--permission-mode <MODE>`		`DEVIN_PERMISSION_MODE`	权限模式：`normal` (别名 `auto`，默认值) 、`accept-edits`、`smart`、`dangerous` (别名 `yolo`、`bypass`) 或 `autonomous` (需要 `--sandbox`) 。请参阅权限。
`--sandbox`		`DEVIN_SANDBOX`	[研究预览] 在沙盒中执行工具进程 (macOS seatbelt / Linux bwrap+seccomp) 。请参阅沙盒。
`--cloud`			驱动 Devin Cloud 会话，而非本地 agent。需要 Devin 账户。
`--continue`	`-c`		恢复当前目录中最近的会话
`--resume <SESSION_ID>`	`-r`		按 ID 恢复指定会话。搭配 `--cloud` 时，可接受云端会话 ID 或 URL。
`--print [PROMPT]`	`-p`		输出响应后退出 (非交互模式) 。可选接受内联提示。
`--prompt-file <FILE>`			从文件加载初始提示
`--config <PATH>`			配置文件路径
`--export [PATH]`			每轮对话后将会话导出到文件 (ATIF 格式) 。未提供路径时使用默认路径。
`--respect-workspace-trust [true\|false]`			是否遵循工作区信任设置。默认为 `true`。

非交互式 --print 模式无法显示工作区信任提示，因此在不受信任的目录中会失败。在脚本和 CI 中传入 --respect-workspace-trust false 可跳过此检查。

示例：

devin -- add a login page
devin --model opus -- refactor the auth module
devin --permission-mode accept-edits -- fix the failing tests
devin --sandbox -- run the migration script
devin -c                                           # 恢复最近一次会话
devin -r abc12345                                  # 恢复指定会话
devin --cloud                                      # 启动 Devin Cloud 会话
devin --cloud -r https://app.devin.ai/sessions/…   # 恢复云端会话
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，遇到 404、405 等非身份验证类 4xx 错误时回退到旧版 SSE (根据 MCP 规范) 。对于带有 WWW-Authenticate 质询的 401 响应和作用域不足的 403 响应，系统会直接报告，以便你完成身份验证。你也可以显式设置 "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/v1/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 models

列出你的账户中可用的模型。

命令	描述
`devin models list`	按模型系列列出可用模型
`devin models list --format json`	以 JSON 格式输出模型列表 (供脚本使用)

详见 Models。

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 plugins

管理插件——将技能、规则、钩子、MCP 服务器和子 Agent 打包在一起的 bundle。

命令	说明
`devin plugins install <source>`	安装插件及其必需插件
`devin plugins list`	列出已安装插件及其版本和阻止状态
`devin plugins info <name>`	显示插件的技能、钩子、规则及其必需/可选/禁止列表
`devin plugins update [name]`	从最新 HEAD 重新获取并安装插件。省略名称可更新所有插件。
`devin plugins remove <name>`	移除已安装的插件
`devin plugins prune`	移除磁盘上已不存在的代码仓库的依赖项，然后清理未被引用的插件内容

source 可以是 GitHub owner/repo、git URL 或本地路径。如果插件位于代码仓库根目录下的子路径中，请追加 #path/to/plugin。 选项：

-y, --yes (install) — 跳过交互式信任提示
--force (remove) — 即使其他插件或治理配置仍要求该插件，也将其移除

devin plugins install acme/review-tools
devin plugins install acme/vendor-plugins#plugins/stripe
devin plugins info review-tools

详见 Plugins。

devin migrate

将其他工具中的配置迁移到 Devin 的格式。

命令	描述
`devin migrate hooks`	将 Windsurf 钩子 (`.windsurf/hooks.json`) 迁移为 Devin 钩子 (`.devin/hooks.v1.json`)
`devin migrate workflows`	将工作流程文件迁移为技能，并删除原文件

devin migrate workflows 的选项：

--scope <all\|workspace\|global> — 要迁移的工作流程 (默认值：all)

迁移为一次性复制。对于 Devin CLI 可直接读取的配置——包括来自 Cursor、Windsurf、Claude Code、Copilot 等的规则、技能和 MCP 服务器——无需迁移；请参阅配置导入。

devin list

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

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

devin cloud

通过终端管理 Devin Cloud 资源。命令会使用由 devin auth login 存储的凭据，无需额外配置环境。

devin cloud drs

管理声明式仓库设置：环境蓝图、用于测试仓库设置的沙盒会话和快照构建。

命令	说明
`devin cloud drs whoami`	输出当前配置 (组织、API 端点、身份验证状态)
`devin cloud drs sandbox-create --repo <owner/repo>`	创建关联到代码仓库的沙盒 Devin 会话，用于测试仓库设置
`devin cloud drs run --devin-id <id> --command <cmd>`	在沙盒会话中运行 Shell 命令，并等待其完成
`devin cloud drs blueprint-list`	列出组织的所有环境蓝图
`devin cloud drs blueprint-create`	创建蓝图，可选地限定至某个代码仓库
`devin cloud drs blueprint-write --blueprint-id <id> --from-file <FILE>`	用 YAML 文件替换蓝图内容
`devin cloud drs build`	触发环境构建并等待其完成
`devin cloud drs build-start`	触发构建并立即返回构建作业 ID
`devin cloud drs build-wait --build-job-id <id>`	等待此前启动的构建完成
`devin cloud drs build-logs --build-job-id <id>`	以 NDJSON 格式流式输出构建作业日志，可用于诊断 `partial` 或 `failed` 构建
`devin cloud drs secret-create --key <KEY> --value <VALUE>`	创建组织级密钥

devin cloud drs sandbox-create 的选项：

--repo <owner/repo> — 要关联的沙盒代码仓库 (必填)
--prompt <PROMPT> — 沙盒会话的初始提示
--secret <KEY=VALUE> — 会话级密钥 (可重复指定)

devin cloud drs run 的选项：

--devin-id <ID> — Devin 会话 ID (例如 devin-abc123…) (必填)
--command <CMD> — 要执行的 Shell 命令 (必填)
--timeout <SECONDS> — 服务器端超时时间 (默认值：600)

devin cloud drs blueprint-create 的选项：

--repo <owner/repo> — 蓝图适用的代码仓库；省略则创建组织级蓝图
--from-file <FILE> — 包含初始蓝图内容的 YAML 文件

devin cloud drs whoami
devin cloud drs blueprint-create --repo acme/api --from-file environment.yaml
devin cloud drs sandbox-create --repo acme/api --secret NPM_TOKEN=abc123
devin cloud drs run --devin-id devin-abc123 --command "npm test"
devin cloud drs build

有关这些命令读取和写入的 environment.yaml 格式，请参阅蓝图参考。

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 请求接收凭据。 选项：

开关	环境变量	描述
`--agent-type <TYPE>`		要运行的 Agent 类型。省略则运行默认 Agent。
`--model <MODEL>`	`DEVIN_MODEL`	每个新 ACP session 的默认模型，会覆盖 Enterprise 配置的默认值。接受与 `/model` 相同的模糊名称 (系列 slug、别名或部分名称) ，例如 `--model opus`。

devin acp --model opus

ACP 主机中的斜杠命令

ACP 服务器会通过协议发布完整的斜杠命令集，因此这些命令会显示在主机自身的命令面板中，并提供说明、参数提示和分类：

类别	命令
账户	`/login [api-key]`、`/logout`、`/status` (ACP 对 CLI `/login-status` 的称呼)
会话	`/ask [question]`、`/plan [prompt]`、`/compact`、`/context`、`/fast`、`/loop <prompt>`、`/btw <prompt>`、`/session-stats` (别名：`/stats`) 、`/help`
系统	`/workspace` (别名：`/workspaces`) 、`/add-dir <path>`、`/remove-dir <path>`、`/mcp`、`/bug <description>`

部分命令是否可用取决于主机和你的账户：

如果主机自行管理身份验证，/login 和 /logout 会被隐藏。
仅当主机要求 Agent 管理工作区根目录时，才会显示工作区目录命令 (/workspace、/add-dir、/remove-dir) 。自行管理根目录的主机不会看到这些命令。

devin update

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

devin update

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

devin update --force

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 doctor

诊断本地 Devin 配置。该命令会列出已加载的自定义子 Agent Profile，标出 frontmatter 无法解析的 AGENT.md 定义 (此类定义在运行时会被跳过) ，并对 Devin 会忽略的 frontmatter 键发出警告。若有任一检查未通过，该命令将以非零状态码退出。

devin doctor
devin doctor --json   # 输出机器可读的格式

devin airgap doctor

诊断气隙 (air-gapped) 环境的配置及模型端点的连通性。除了 devin doctor 中的自定义子 Agent 检查外，该命令还会检查许可证、本地配置路径和模型文件，并逐一探测所有已配置的模型端点。

devin airgap doctor
devin airgap doctor --json   # 输出机器可读格式

devin airgap doctor 仅在 CLI 的气隙 (air-gapped) 构建版本中可用。

devin ssh

通过 SSH 连接到云端会话的虚拟机。该命令封装了系统的 ssh，连接至 Devin SSH gateway，并使用你已登录的凭据批准该连接，无需在浏览器中来回操作。参见 SSH。

devin ssh <session> [--gateway <host[:port]>] [ssh options...]

参数	说明
`<session>`	会话 ID 或会话 URL
`--gateway <host[:port]>`	SSH gateway 主机 (默认为你的 Devin API 对应的 `ssh.` 主机，例如 `ssh.devin.ai`)
`[ssh options...]`	透传给 `ssh` 的额外选项，例如 `-L 8080:localhost:8080`

devin forward

将云端会话 VM 上的端口转发到 localhost，这样即可通过 http://localhost:<port> 访问在该机器上运行的开发服务器。命令会持续运行，直到按下 Ctrl-C。

devin forward <session> <port>... [--gateway <host[:port]>]

每个端口的格式为 <port> 或 <local>:<port>：

devin forward devin-abc123 3000          # http://localhost:3000
devin forward devin-abc123 8080:3000     # 本地 8080 → 虚拟机 3000

devin worker

以 Outposts 工作器的身份运行 CLI。该命令不会显示在 devin --help 中，相关说明请参阅单独的 Outposts 参考。

devin uninstall

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

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

斜杠命令

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

模式与模型

命令	说明
`/mode [normal\|accept-edits\|smart\|plan\|bypass]`	显示或切换当前模式 (`autonomous` 可用于沙盒会话)
`/normal`	切换到 Normal 模式 (默认)
`/accept-edits`	切换到 Accept Edits 模式 (自动批准对工作区中文件的编辑)
`/smart`	切换到 Smart 模式 (自动批准由快速模型判定为安全的操作)。正在逐步推出，可能尚未在你的账户中提供。
`/plan`	切换到 Plan 模式 (只读规划)
`/ask <question>`	在不进行代码修改的情况下提问 (单次)
`/bypass`	切换到 Bypass 模式 (自动批准所有操作)
`/autonomous`	切换到 Autonomous 模式 (由沙盒强制执行；需要 `--sandbox`)
`/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`
`/title <new title>`	重命名当前会话
`/rename-session <new title>`	重命名当前会话
`/rm-session <session-id>`	永久删除某个会话及其所有数据，此操作不可撤销
`/export`	显示导出信息。使用 `--export` CLI 标志启用对话导出。
`/exit`	退出应用程序 (别名：`/quit`) 。你也可以直接输入 `exit` 或 `quit`，无需加 `/` 前缀。

工作区

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

自动化

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

扩展性

命令	描述
`/hooks`	列出所有已加载的钩子，包括其 ID、事件类型和源路径
`/mcp`	列出已配置的 MCP 服务器及其状态

实用命令

命令	描述
`/help`	显示可用的斜杠命令
`/shortcuts`	在按类别分组的交互式可搜索列表中浏览键盘快捷键。在某一行按 `Enter` 可重新绑定该快捷键，并查看每个操作的 `context.action` 标识符
`/config`	打开交互式配置编辑器
`/bug [description]`	向 Devin CLI 开发者报告 bug
`/update [--force]`	检查并安装更新。传入 `--force` 后，即使当前已是最新版本，也会重新安装。
`/upgrade`	升级你的订阅套餐
`/login`	使用你的账户进行身份验证
`/logout`	清除已存储的凭据并退出
`/login-status`	显示登录和身份验证状态 (向 ACP 主机公布为 `/status`)
`/org`	选择你的 Devin 组织
`/copy`	将最后一条回复复制到剪贴板
`/feedback <up\|down>`	为最后一条回复评分
`/mouse`	切换鼠标事件捕获 (菜单中的点击/悬停/滚动)
`/context`	显示上下文窗口用量
`/usage`	显示该会话预估的积分/ACU 用量，包括恢复会话此前打开时产生的用量
`/session-stats`	显示会话统计 (别名：`/stats`)
`/compact`	强制压缩会话

会话统计

/session-stats (别名 /stats) 可查看会话的完整消耗情况，而 /usage 仅提供简要的积分/ACU 摘要。它按照服务器自身的标签和分组，呈现服务器报告的所有用量维度——积分、ACU、Agent 消息、轮次延续和令牌用量——因此新增维度无需更新 CLI 即可显示。Model 行会标明实际处理计费轮次的模型，该模型可能与你所选的模型不同。恢复会话后，总计不会重置，因此会报告累计用量。

云端会话

有关从终端运行 Devin Cloud 会话的指南，请参阅 Cloud CLI。

命令	说明
`/cloud`	将全新的本地会话切换到 Devin Cloud 中运行 (需在发送第一条消息之前；否则请先执行 `/clear`)
`/handoff [task]`	本地会话：在云端会话中继续该任务。云端会话：检出该会话的 pull request 分支，在本地继续。参见移交给 cloud Devins。
`/repo`	为此云端会话选择仓库
`/platform`	为此云端会话选择平台 (操作系统)
`/open [web\|desktop]`	在 web app (默认) 或 Devin Desktop 中打开此云端会话
`/ssh`	通过 SSH 连接到此云端会话的虚拟机。参见 SSH。
`/pickup`	检出此云端会话的 pull request 分支并在本地继续 (与云端会话中的 `/handoff` 相同)
`/rename <new title>`	重命名此云端会话
`/archive`	归档此云端会话

模式

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

Normal（默认）
Plan 模式
Smart
Bypass
Autonomous

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

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

除文件写入外，所有操作都会自动批准，并由 OS 沙盒而非提示来强制执行边界。

Permission mode: Autonomous (需要 --sandbox)
Profile: Normal
Use for: 在沙盒化 session 中进行长时间无人值守运行

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

Profiles

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

Profile	描述	工具访问权限
`normal`	完整的编码助手 (用于 Normal、Accept Edits、Smart、Bypass 和 Autonomous 模式)	所有工具
`plan`	结构化规划工作流程 (用于 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 models

​devin rules

​devin skills

​devin plugins

​devin migrate

​devin list

​devin cloud

​devin cloud drs

​devin version

​devin acp

​ACP 主机中的斜杠命令

​devin update

​devin sandbox

​devin sandbox setup

​devin setup

​devin doctor

​devin airgap doctor

​devin ssh

​devin forward

​devin worker

​devin uninstall

​斜杠命令

​模式与模型

​会话管理

​工作区

​自动化

​扩展性

​实用命令

​会话统计

​云端会话

​模式

​Profiles

用法

全局开关

子命令

devin auth

devin mcp

devin models

devin rules

devin skills

devin plugins

devin migrate

devin list

devin cloud

devin cloud drs

devin version

devin acp

ACP 主机中的斜杠命令

devin update

devin sandbox

devin sandbox setup

devin setup

devin doctor

devin airgap doctor

devin ssh

devin forward

devin worker

devin uninstall

斜杠命令

模式与模型

会话管理

工作区

自动化

扩展性

实用命令

会话统计

云端会话

模式

Profiles