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

# JetBrains

> 在 JetBrains IDE 的 AI Chat 中将 Devin CLI 作为自定义 ACP Agent 运行，包括 JetBrains Remote Development。

JetBrains IDE 支持通过 [Agent Client Protocol (ACP)](https://agentclientprotocol.com/) 在 **AI Chat** 中将 Devin CLI 作为自定义 Agent 运行。配置完成后，你可以在 IntelliJ IDEA、PyCharm、GoLand 以及其他 JetBrains IDE 的 AI Chat 面板中使用 Devin，也可以通过 [JetBrains Remote Development](https://www.jetbrains.com/remote-development/) 使用。

<Note>
  此集成使用了 JetBrains 的 AI Assistant 中内置的 ACP 支持。更多上游参考信息，请参阅 JetBrains 文档中关于[添加自定义 Agent](https://www.jetbrains.com/help/ai-assistant/acp.html#add-custom-agent)的说明。
</Note>

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

* 已安装 **AI Assistant** 插件且可使用 AI Chat 的 JetBrains IDE。
* 已安装并完成认证的 Devin CLI。如果你还没有安装，请先按照 [Quickstart](/zh/cli/index) 进行安装，然后运行 `devin auth login`。
* `devin` 二进制文件的绝对路径。你可以通过以下命令查看：

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

  该命令通常会解析为类似 `~/.local/bin/devin` 的路径。

<Tip>
  对于 **JetBrains Remote Development**，Devin CLI 必须安装在**远程主机**上 (即运行后端的主机) ，而不是你的本地客户端上。请在远程主机的终端中运行 `which devin`，并在下方的配置中使用该路径。
</Tip>

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

<Steps>
  <Step title="打开 AI Chat">
    点击右侧工具窗口栏中的 **AI Chat** 图标。

    <Frame>
      <img src="https://mintcdn.com/cognitionai-enterprise/LFTx1kZFJVgS5rm4/images/cli/acp/jetbrains-ai-chat-icon.png?fit=max&auto=format&n=LFTx1kZFJVgS5rm4&q=85&s=a161b40def36187c50762f6e3aa4dacb" alt="JetBrains 工具窗口栏中的 AI Chat 图标" width="54" height="357" data-path="images/cli/acp/jetbrains-ai-chat-icon.png" />
    </Frame>
  </Step>

  <Step title="添加自定义 Agent">
    点击 AI Chat 面板右上角的三点菜单，然后选择
    **Add Custom Agent**。这将打开 `acp.json` 配置文件。

    <Frame>
      <img src="https://mintcdn.com/cognitionai-enterprise/LFTx1kZFJVgS5rm4/images/cli/acp/jetbrains-add-custom-agent.png?fit=max&auto=format&n=LFTx1kZFJVgS5rm4&q=85&s=1f871480961e02c8c88e61889565f838" alt="AI Chat 菜单中的 Add Custom Agent 选项" width="425" height="536" data-path="images/cli/acp/jetbrains-add-custom-agent.png" />
    </Frame>
  </Step>

  <Step title="配置 Devin Agent">
    将 Devin 添加到 `acp.json` 的 `agent_servers` 块中。将 `command` 设置为你的
    `devin` 可执行文件的绝对路径 (可通过 `which devin` 获取) ，并将 `acp` 作为
    唯一参数传入：

    ```json acp.json theme={null}
    {
      "default_mcp_settings": {},
      "agent_servers": {
        "devin": {
          "command": "/home/you/.local/bin/devin",
          "args": ["acp"]
        }
      }
    }
    ```

    保存文件后，Devin 就会作为可选 Agent 出现在 AI Chat 中。
  </Step>

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

<div id="managing-the-integration">
  ## 管理集成
</div>

AI Chat 面板中的三点菜单提供了一些适用于 Devin Agent 的实用操作：

* **重置 ACP 身份验证** — 清除已存储的 ACP 凭据并重新进行身份验证。
* **获取 ACP 日志** — 打开 ACP 日志，可用于调试连接问题，或查看 Agent 在后台执行的内容。

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

* Devin CLI 的终端/shell 输出是通过 JetBrains AI Chat 的 ACP 渲染机制显示的，因此与 Devin CLI 原生的终端 UI 不同。一些更丰富的交互仅在独立的 CLI 中可用。
* `devin acp` 子命令设计为由支持 ACP 的客户端 (如 JetBrains AI Chat) 以子进程方式启动——它通过 stdio 使用 JSON-RPC 通信，不适合以交互方式直接运行。请参阅命令参考中的 [`devin acp`](/zh/cli/reference/commands#devin-acp)。