> ## 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.

# Xcode

> 通过 Agent Client Protocol (ACP) 在 Xcode 的编码助手中运行 Devin，或通过 Xcode 的 MCP bridge 让 Devin CLI 访问你的 Xcode 项目。

Xcode 26.6 的 [代码智能](https://developer.apple.com/documentation/xcode/setting-up-coding-intelligence)
支持通过 [Agent Client Protocol (ACP)](https://agentclientprotocol.com/)
在 **编码助手** 中将 Devin 作为 Agent 运行。Devin 不在 Xcode 的
Intelligence 设置中列出的 Agent 之中，因此你需要手动将它添加为
自定义 ACP Agent，并通过你本地安装的 Devin CLI 运行。

<Note>
  此集成使用了 Xcode 编码助手内置的 ACP 支持。更多上游参考信息，请参阅
  Apple 关于
  [设置代码智能](https://developer.apple.com/documentation/xcode/setting-up-coding-intelligence)
  的文档。
</Note>

<div id="prerequisites">
  ## 前提条件
</div>

* 已安装 **Xcode 26.6 或更高版本**，且编码助手可用。
* 已安装 Devin CLI 并完成身份验证。如果你尚未安装，请先按照[快速入门](/zh/cli/index)操作，然后运行 `devin auth login`。
* `devin` 二进制程序的**绝对**路径。你可以使用以下命令查找：

  ```bash theme={null}
  which devin
  ```

  这通常会显示类似 `/Users/you/.local/bin/devin` 的路径。

<Warning>
  Xcode 要求 Agent 命令使用**绝对**路径——它不会展开
  `~`，也不会使用你的 shell 的 `PATH`。如果 `which devin` 输出的是以 `~` 开头的路径，
  请先将其展开 (例如，运行 `echo "$(cd ~ && pwd)/.local/bin/devin"`) ，然后
  使用完整的 `/Users/...` 路径。
</Warning>

<div id="setup">
  ## 设置
</div>

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

<Steps>
  <Step title="打开 Intelligence 设置">
    选择 **Xcode > Settings**，然后在侧边栏中选择 **Intelligence**。
  </Step>

  <Step title="添加 Agent">
    在 **Agents** 下，点击 **Add an Agent**。Xcode 内置的 ACP 支持让
    你可以注册任何支持 Agent Client Protocol 的 Agent。
  </Step>

  <Step title="配置 Devin Agent">
    在弹出的面板中，输入 Agent 的详细信息：

    * **Name** — `Devin` (或你喜欢的任意标签) 。
    * **Command** — 你的 `devin` 二进制程序的**绝对**路径 (可通过
      `which devin` 获取) ，例如 `/Users/you/.local/bin/devin`。相对路径
      或以 `~` 开头的路径都无法使用。
    * **Arguments** — `acp` (Devin 唯一需要的参数) 。

    点击 **Add**。此时，Devin 会显示在 **Agents** 下，可供选择。
  </Step>

  <Step title="开始与 Devin 聊天">
    在编码助手中选择 **Devin**，然后发送一条消息以开始
    session。首次连接时，系统可能会提示你进行身份验证；
    Devin 会使用 `devin auth login` 中的凭据 (如果已设置，则使用 `WINDSURF_API_KEY`) 。
  </Step>
</Steps>

<div id="give-devin-cli-access-to-your-xcode-project-mcp">
  ## 让 Devin CLI 访问你的 Xcode 项目 (MCP)
</div>

除了在 Xcode *内*运行 Devin 之外，你还可以将独立的 Devin
CLI 指向你的 Xcode 项目，这样它就能构建、运行测试、读取和编辑文件、渲染
SwiftUI 预览，以及搜索 Apple 文档。Xcode 自带一个
[MCP](/zh/cli/extensibility/mcp/overview) 服务器 `xcrun mcpbridge`，它会向任何外部
Agent 提供这些 Xcode 工具 (这也是
[Cursor 使用的](https://cursor.com/docs/integrations/xcode)同一机制) 。像添加其他
MCP 服务器一样把它添加到 Devin 中即可。

<Note>
  Xcode MCP bridge 要求 **Xcode 26.3 或更高版本**。请使用
  `xcrun --find mcpbridge` 确认该二进制程序可用 (如果不可用，请参阅 [故障排查](#troubleshooting)) 。
  另请参阅 Apple 关于
  [允许外部 Agent 访问 Xcode](https://developer.apple.com/documentation/xcode/giving-external-agents-access-to-xcode) 的文档。
</Note>

<Steps>
  <Step title="在 Xcode 中允许外部 Agent">
    选择 **Xcode > Settings**，选中 **Intelligence**，然后在 **Model
    Context Protocol** 下启用 **Allow external agents to use Xcode tools**。
  </Step>

  <Step title="将 Xcode MCP 服务器添加到 Devin">
    将 `xcrun mcpbridge` 注册为 stdio MCP 服务器：

    ```bash theme={null}
    devin mcp add xcode -- xcrun mcpbridge
    ```

    使用 `devin mcp list` 确认已添加成功。有关作用域和配置选项，请参阅
    [`devin mcp`](/zh/cli/reference/commands#devin-mcp)。
  </Step>

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

<div id="troubleshooting">
  ## 故障排查
</div>

* **`xcrun: error: unable to find utility "mcpbridge"`** — 你的系统当前指向的是 Command Line Tools，而不是完整安装的 Xcode。可通过以下命令修复：

  ```bash theme={null}
  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**。

<div id="notes-and-limitations">
  ## 注意事项和限制
</div>

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