跳转到主要内容
Xcode 26.6 的 代码智能 支持通过 Agent Client Protocol (ACP)编码助手 中将 Devin 作为 Agent 运行。Devin 不在 Xcode 的 Intelligence 设置中列出的 Agent 之中,因此你需要手动将它添加为 自定义 ACP Agent,并通过你本地安装的 Devin CLI 运行。
此集成使用了 Xcode 编码助手内置的 ACP 支持。更多上游参考信息,请参阅 Apple 关于 设置代码智能 的文档。

前提条件

  • 已安装 Xcode 26.6 或更高版本,且编码助手可用。
  • 已安装 Devin CLI 并完成身份验证。如果你尚未安装,请先按照快速入门操作,然后运行 devin auth login
  • devin 二进制程序的绝对路径。你可以使用以下命令查找:
    which devin
    
    这通常会显示类似 /Users/you/.local/bin/devin 的路径。
Xcode 要求 Agent 命令使用绝对路径——它不会展开 ~,也不会使用你的 shell 的 PATH。如果 which devin 输出的是以 ~ 开头的路径, 请先将其展开 (例如,运行 echo "$(cd ~ && pwd)/.local/bin/devin") ,然后 使用完整的 /Users/... 路径。

设置

在 Intelligence 设置中将 Devin 添加为自定义 Agent。
1

打开 Intelligence 设置

选择 Xcode > Settings,然后在侧边栏中选择 Intelligence
2

添加 Agent

Agents 下,点击 Add an Agent。Xcode 内置的 ACP 支持让 你可以注册任何支持 Agent Client Protocol 的 Agent。
3

配置 Devin Agent

在弹出的面板中,输入 Agent 的详细信息:
  • NameDevin (或你喜欢的任意标签) 。
  • Command — 你的 devin 二进制程序的绝对路径 (可通过 which devin 获取) ,例如 /Users/you/.local/bin/devin。相对路径 或以 ~ 开头的路径都无法使用。
  • Argumentsacp (Devin 唯一需要的参数) 。
点击 Add。此时,Devin 会显示在 Agents 下,可供选择。
4

开始与 Devin 聊天

在编码助手中选择 Devin,然后发送一条消息以开始 session。首次连接时,系统可能会提示你进行身份验证; Devin 会使用 devin auth login 中的凭据 (如果已设置,则使用 WINDSURF_API_KEY) 。

让 Devin CLI 访问你的 Xcode 项目 (MCP)

除了在 Xcode 运行 Devin 之外,你还可以将独立的 Devin CLI 指向你的 Xcode 项目,这样它就能构建、运行测试、读取和编辑文件、渲染 SwiftUI 预览,以及搜索 Apple 文档。Xcode 自带一个 MCP 服务器 xcrun mcpbridge,它会向任何外部 Agent 提供这些 Xcode 工具 (这也是 Cursor 使用的同一机制) 。像添加其他 MCP 服务器一样把它添加到 Devin 中即可。
Xcode MCP bridge 要求 Xcode 26.3 或更高版本。请使用 xcrun --find mcpbridge 确认该二进制程序可用 (如果不可用,请参阅 故障排查) 。 另请参阅 Apple 关于 允许外部 Agent 访问 Xcode 的文档。
1

在 Xcode 中允许外部 Agent

选择 Xcode > Settings,选中 Intelligence,然后在 Model Context Protocol 下启用 Allow external agents to use Xcode tools
2

将 Xcode MCP 服务器添加到 Devin

xcrun mcpbridge 注册为 stdio MCP 服务器:
devin mcp add xcode -- xcrun mcpbridge
使用 devin mcp list 确认已添加成功。有关作用域和配置选项,请参阅 devin mcp
3

打开你的项目并向 Devin 提示

在 Xcode 中打开你的项目或工作区 (该 bridge 需要在 Xcode 运行中且已打开项目的 session 内使用) ,然后通过 CLI 向 Devin 输入提示。外部 Agent 连接时以及处于活动状态时,Xcode 都会提醒你。

故障排查

  • xcrun: error: unable to find utility "mcpbridge" — 你的系统当前指向的是 Command Line Tools,而不是完整安装的 Xcode。可通过以下命令修复:
    sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
    sudo xcodebuild -runFirstLaunch
    
    然后运行 xcrun --find mcpbridge 确认,正常情况下应会输出一个路径。
  • Devin 无法访问 Xcode 工具 — 请确保 Xcode 正在运行,且已打开一个项目 (而不是空白窗口) ,并在 Intelligence 设置中启用 Allow external agents to use Xcode tools

注意事项和限制

  • 无法在 Xcode 中选择模型——Devin 始终使用你团队的默认模型。
  • 当你在 Xcode 的编码助手中选择一个 Agent 时,它会自动获得 Xcode 的相关能力,例如构建和测试你的应用。你可以在 Intelligence 设置中的 Agents > Permissions 下查看并限制 Agent 可使用的命令和工具——请参阅 Apple 关于 扩展和自定义 Agent 的文档。
  • Devin CLI 的终端/Shell 输出会通过 Xcode 的 ACP 渲染显示,这与 Devin CLI 原生终端 UI 不同。一些更丰富的交互仅在独立 CLI 中可用。
  • devin acp 子命令设计为由支持 ACP 的客户端 (例如 Xcode 的编码助手) 作为子进程启动——它通过 stdio 使用 JSON-RPC 进行通信,不适合交互式运行。请参阅命令参考中的 devin acp