Skip to main content
Devin 在一个持久化的环境快照中工作。每个会话都会从该快照的全新副本启动，因此你的环境配置越完整，Devin 在安装工具上浪费的时间就越少。 新的仓库设置流程被设计为快速且顺畅：
  • 无需打开 VS Code 即可配置仓库（不会锁定快照）
  • 一次性添加多个仓库
  • AI 建议和验证会异步运行

​
开始之前：授予代码仓库访问权限

确保 Devin 可以读取你需要的代码仓库。
需要权限方面的帮助？请参阅 GitHub 集成指南。

​
添加代码仓库（单个或多个）

前往 Settings > Devin’s Environment > Repositories。
  1. 点击 Add repository
  2. 选择你想要配置的 一个或多个 仓库
  3. 点击 Manage setup
就完成了——你将进入配置界面，左侧会列出你选择的仓库。 你也可以在仓库列表中选中多个仓库并点击 “Clone repositories” 操作，一次性 批量克隆（bulk clone） 多个仓库，这在同时接入大量仓库时非常有用。
添加仓库后，会在后台启动 。你无需等待其完成，就可以继续进行配置。

​
配置每个代码库（轻量）

从左侧侧边栏中选择一个代码库。每个代码库都有三个部分：
1

Clone Repository

克隆会将代码库放入环境中，供后续会话使用，路径为 ~/repos/。
  • 如果你希望 Devin 在该代码库中实际开展工作：请克隆它
  • 如果你只是提前配置命令，稍后再用：现在可以保持未克隆状态
2

Upkeep

这些命令会自动运行，以保持 Devin 与代码库同步。
  • Git pull：在会话启动时运行（默认设置通常是合适的）
  • Maintain dependencies：可选，但推荐（例如 npm ci、pip install -r requirements.txt、uv sync 等）
使用 Verify 对单个命令做快速检查，或使用 Verify All 一次性运行所有命令。
验证是异步运行的——在它完成期间，你可以切换代码库或离开此页面。
3

Knowledge

在这里，你配置 Devin 如何检查工作质量。
  • 设置 lint（快速，理想情况下 ≤ 5 分钟）
  • 设置测试（快速，理想情况下 ≤ 5 分钟）
  • 添加 Devin 应该遵循的任何代码库特定说明/注意事项（如何运行应用、特殊脚本等）
如果有可用的 AI 建议，你会看到一个带有 Accept / Reject 按钮的卡片。选择 Accept 后，会根据你的代码库预填常用命令（lint/测试等）。
如果你有类似 make lint / make test 这样的单一“入口”命令，优先使用它。这是最稳健的设置方式。

​
AI 建议

Devin 可以为你的仓库推荐特定的环境配置命令（lint、测试、依赖维护以及常见运行目标）。 这些建议是异步执行且非阻塞的——目的是帮你减少输入，而不是拖慢你的速度。 生命周期
  1. 一旦你开始配置仓库，Devin 会在后台自动启动 AI 建议流程。
  2. 建议生成时间可能会因仓库大小和复杂度而有所不同。生成期间，你可以继续配置其他字段，或者切换到其他仓库。
  3. 当这些建议准备就绪时，它们会以内联形式出现在每个相关命令字段旁边，并带有“接受 / 拒绝”按钮。接受会预填对应的命令；拒绝则会保持你当前的配置不变。
  4. 如果你的仓库发生了变化，或者这些建议遗漏了什么，在右上角打开 ⋯ 菜单并点击“Regenerate Suggestions”。

​
配置环境（按需执行）

仓库设置主要是填写文本字段并完成验证。只有在你确实需要：
  • 安装工具（编译器、包管理器、CLI）
  • 登录 Devin 需要访问的网站（Browser 选项卡）
  • 创建本地文件，比如 .envrc 或 .env
时，才需要启动机器环境。 在左侧侧边栏点击 Environment Setup，然后：
  1. （可选）调整 Upkeep Frequency（Devin 运行维护任务以保持环境最新的频率）
  2. 点击 Open VSCode + Browser
此时，Devin 会锁定环境，以确保你的更改一致且可复现。 在嵌入的 VS Code 中：
  • 在终端中运行你的引导/安装步骤
  • 确认 ~/repos/<repo> 存在，并且构建/测试可以运行
  • 如果希望 AI 帮你生成合适的安装命令，可以使用 Setup Agent 提示
完成后，点击 Save 保存更改。
你在这里安装的任何内容都会成为共享环境的一部分，可能会影响其他仓库。如果需要隔离，建议优先使用按仓库划分的虚拟环境或容器。

​
Devin 在每次会话中会做什么

配置完成后：
  • Devin 会基于你最新环境的快照启动一个新会话
  • 启动时，Devin 会运行：
    • 仓库的 Git pull 命令
    • 然后执行 Maintain dependencies（如果已配置）
  • 在提交之前，Devin 会运行：
    • 你的 lint 命令
    • 你的 test 命令
如果你想要最简单但依然好用的配置：
  1. 保持默认的 Git pull 命令
  2. 将 Maintain dependencies 配置为单条命令（例如 npm ci / uv sync / pip install -r requirements.txt）
  3. 去拿杯咖啡吧，一切就搞定了！

​
疑难解答

​
验证失败，但我本机可以跑通

大多数失败情况属于以下几类：
  • 工作目录错误 → 使用 cd ~/repos/<repo> && …
  • 工具不在 PATH 中 → 在你的 shell 配置中把它加入 PATH（或使用绝对路径）
  • 缺少依赖 → 在环境设置过程中安装它们，然后重新验证
  • 语言版本错误 → 确保在非交互式 shell（新开的终端）中已启用正确的版本

​
我的环境快照坏了

你可以在 Settings → Devin’s Environment → Version History 中恢复更早的镜像。

​
以后需要编辑？

回到 Settings → Devin’s Environment → Repositories。
  • 随时添加更多仓库
  • 选择仓库并点击 Configure 重新进行配置
  • 如需回滚，可使用 Version History

​
全部就绪

在完成仓库和环境的设置后，你就可以开始会话了。 如果遇到问题，请联系 support@cognition.ai。