> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 交接到云端 Devin

> 从 Devin CLI、Claude Code、Codex 或任何代码 Agent，将任务交接到云端 Devin 会话。

将任务交接到云端的 [Devin 会话](/zh/get-started/first-run)，同时继续在本地工作。云端会话会拥有自己的 VM、终端、浏览器以及完整的仓库访问权限，因此即使你合上笔记本电脑后，它也能继续运行。

有两种交接方式：

* **从 [Devin CLI](/zh/cli) 发起** — 使用内置的 `/handoff` 命令，无需额外设置。
* **从任何其他代码 Agent 发起** — 例如 Claude Code、Codex、Cursor 等，通过开源的 [Devin Handoff](https://github.com/club-cog/devin-handoff) 插件。

<div id="when-to-hand-off">
  ## 何时转交
</div>

当任务不适合只在你的本地机器上完成，或者你希望它在后台运行时，就可以将任务转交：

* **VM 或服务器** — 运行开发服务器、调用端点、构建 Docker 镜像
* **Browser** — 截图、OAuth 流程、端到端测试、抓取
* **CI/CD** — 调试流水线、部署、基础架构变更
* **长时间运行的工作** — 迁移、批处理作业、大规模重构
* **并行执行** — 在你继续本地编写代码的同时，将工作卸载到云端

<div id="from-the-devin-cli">
  ## 通过 Devin CLI
</div>

[Devin CLI](/zh/cli) 是一个在你的终端中运行的本地代码 Agent。它内置了 [`/handoff`](/zh/work-with-devin/devin-cli#handoff-to-cloud-devin) 命令——无需安装。

```
/handoff fix the flaky integration tests in CI
```

Devin CLI 会将对话上下文和当前的 git 分支打包，然后创建一个云端 Devin 会话，从你离开的地方继续。你可以在终端中或在 [Devin Web 应用](https://app.devin.ai) 中跟踪该会话的进度。

<Tip>
  运行不带任务描述的 `/handoff` 后，云端会话会自动从你离开的地方继续。
</Tip>

<div id="from-other-coding-agents">
  ## 来自其他代码 Agent
</div>

[Devin Handoff](https://github.com/club-cog/devin-handoff) 是一个开源插件和技能，可将同样的交接流程带到任何代码 Agent——Claude Code、Codex、Cursor 等等。安装一次后，你只需说 *“把这个交给 Devin”*，你的 Agent 就会收集当前代码仓库、分支和未提交的更改，创建一个会话，并返回给你一个 URL。

你需要一个 Devin API key——可在 [API keys 页面](https://app.devin.ai/settings/api-keys) 生成，并将其导出为 `DEVIN_API_KEY`。如需了解适用于各类 Agent 的安装和使用指示，请参阅 [仓库 README](https://github.com/club-cog/devin-handoff)；该文档会随着插件演进持续更新。

<div id="how-context-reaches-the-cloud-session">
  ### 上下文如何传递到云端会话
</div>

云端会话会在全新的 VM 中启动，因此该技能会将你的本地 Agent 已掌握的内容打包，并包含在会话提示中：

* **代码仓库 和分支** — 从 `git remote` 和 `git rev-parse` 中检测，因此 Devin 会克隆正确的 代码仓库，并检出你当前所在的分支。
* **未提交的更改** — 会包含 `git diff HEAD` 的输出 (截断至 100KB) ，这样你正在进行中的工作也能延续过去。如果你有不想发送的本地修改，请先提交或 stash。
* **额外上下文** — 调用 Agent 到目前为止了解到的内容：它检查过的文件、对 root-cause 的假设，以及部分修复。

<div id="related-resources">
  ## 相关资源
</div>

<CardGroup cols={2}>
  <Card title="Devin CLI" icon="terminal" href="/zh/cli">
    内置 `/handoff` 命令的本地代码 Agent
  </Card>

  <Card title="GitHub 上的 Devin Handoff" icon="github" href="https://github.com/club-cog/devin-handoff">
    源码、安装指南和完整脚本参考
  </Card>

  <Card title="Devin API" icon="code" href="/zh/api-reference/overview">
    为 handoff 提供支持的 Sessions API
  </Card>

  <Card title="Devin MCP" icon="plug" href="/zh/work-with-devin/devin-mcp">
    在任何 MCP 客户端中管理 sessions、playbooks 和 Knowledge
  </Card>
</CardGroup>