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

# JetBrains

> Execute o Devin em IDEs JetBrains a partir do AI Chat usando o Agent Client Protocol (ACP), incluindo o JetBrains Remote Development.

É possível executar o Devin em IDEs JetBrains como um agente dentro do **AI Chat** usando o
[Agent Client Protocol (ACP)](https://agentclientprotocol.com/). A forma mais rápida de
adicionar o Devin é instalá-lo a partir do **ACP Registry**; você também pode configurá-lo
manualmente como um agente personalizado. De qualquer forma, você pode controlar o Devin pelo painel do AI Chat no
IntelliJ IDEA, PyCharm, GoLand e outras IDEs JetBrains — inclusive por meio do
[JetBrains Remote Development](https://www.jetbrains.com/remote-development/).

<Note>
  Esta integração usa o suporte nativo ao ACP do JetBrains no AI Assistant. Para a
  referência oficial, consulte a documentação do JetBrains sobre
  [como adicionar um agente personalizado](https://www.jetbrains.com/help/ai-assistant/acp.html#add-custom-agent).
</Note>

## Pré-requisitos

* Uma IDE JetBrains com o plugin **AI Assistant** e o AI Chat disponível.

<div id="setup">
  ## Configuração
</div>

Instale o Devin diretamente pelo **ACP Registry** — sem precisar instalar a CLI nem fazer
configuração manual.

<Steps>
  <Step title="Abra o AI Chat">
    Clique no ícone do **AI Chat** na barra lateral direita da janela de ferramentas.

    <Frame>
      <img src="https://mintcdn.com/cognitionai/9EKnqBIslwD5kWvk/images/cli/acp/jetbrains-ai-chat-icon.png?fit=max&auto=format&n=9EKnqBIslwD5kWvk&q=85&s=1de025a909c3869041a8bd5d1aad10e2" alt="Ícone do AI Chat na barra da janela de ferramentas do JetBrains" width="54" height="357" data-path="images/cli/acp/jetbrains-ai-chat-icon.png" />
    </Frame>
  </Step>

  <Step title="Abra o seletor de agentes">
    Clique no seletor de agentes no rodapé do AI Chat para ver a lista de agentes
    disponíveis.
  </Step>

  <Step title="Instale o Devin pelo ACP Registry">
    Escolha **Install From ACP Registry...**, procure por **Devin** e clique em
    **Install**. O Devin será adicionado à lista de agentes disponíveis.

    <Frame>
      <img src="https://mintcdn.com/cognitionai/-ptQDbeV2RztJi0W/images/cli/acp/jetbrains-acp-registry-menu.png?fit=max&auto=format&n=-ptQDbeV2RztJi0W&q=85&s=c18348688a8775e6aabb0dc6a85b9186" alt="Menu do seletor de agentes mostrando a opção Install From ACP Registry" width="606" height="556" data-path="images/cli/acp/jetbrains-acp-registry-menu.png" />
    </Frame>
  </Step>

  <Step title="Faça login no Devin (opcional)">
    Na primeira vez que você se conectar, talvez seja solicitado que se autentique. Siga as
    instruções para fazer login na sua conta do Devin.

    <Frame>
      <img src="https://mintcdn.com/cognitionai/-ptQDbeV2RztJi0W/images/cli/acp/jetbrains-acp-login.png?fit=max&auto=format&n=-ptQDbeV2RztJi0W&q=85&s=68a49822822688804a2371bf28dbc761" alt="Fazendo login no Devin pelo JetBrains AI Chat" width="502" height="103" data-path="images/cli/acp/jetbrains-acp-login.png" />
    </Frame>
  </Step>

  <Step title="Comece a conversar com o Devin">
    Selecione **Devin** no seletor de agentes e envie uma mensagem para iniciar uma sessão.

    <Frame>
      <img src="https://mintcdn.com/cognitionai/-ptQDbeV2RztJi0W/images/cli/acp/jetbrains-devin-selected.png?fit=max&auto=format&n=-ptQDbeV2RztJi0W&q=85&s=d7e7ecd2fed9920f5f03e99c6a3422fe" alt="Devin selecionado como agente no rodapé do AI Chat" width="910" height="254" data-path="images/cli/acp/jetbrains-devin-selected.png" />
    </Frame>
  </Step>
</Steps>

<div id="manual-setup-custom-acp">
  ## Configuração manual (ACP personalizado)
</div>

Se você preferir executar o Devin usando sua própria instalação do Devin CLI, pode adicioná-lo
como um agente ACP personalizado em vez de instalá-lo pelo registro.

<div id="prerequisites">
  ### Pré-requisitos
</div>

* Devin CLI instalado e autenticado. Se você ainda não o instalou, siga o
  [Quickstart](/pt-BR/cli/index) e, em seguida, execute `devin auth login`.
* O caminho absoluto para o binário `devin`. Você pode encontrá-lo com:

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

  Normalmente, isso retorna algo como `~/.local/bin/devin`.

<Tip>
  Para **JetBrains Remote Development**, o Devin CLI deve ser instalado no **host
  remoto** (onde o backend é executado), não no cliente local. Execute `which devin` em um
  terminal no host remoto e use esse caminho na configuração abaixo.
</Tip>

<Steps>
  <Step title="Abra o AI Chat">
    Clique no ícone **AI Chat** na barra de ferramentas à direita.

    <Frame>
      <img src="https://mintcdn.com/cognitionai/9EKnqBIslwD5kWvk/images/cli/acp/jetbrains-ai-chat-icon.png?fit=max&auto=format&n=9EKnqBIslwD5kWvk&q=85&s=1de025a909c3869041a8bd5d1aad10e2" alt="Ícone do AI Chat na barra de ferramentas do JetBrains" width="54" height="357" data-path="images/cli/acp/jetbrains-ai-chat-icon.png" />
    </Frame>
  </Step>

  <Step title="Adicione um agente personalizado">
    Clique no menu de três pontos no canto superior direito do painel do AI Chat e selecione
    **Add Custom Agent**. Isso abre o arquivo de configuração `acp.json`.

    <Frame>
      <img src="https://mintcdn.com/cognitionai/9EKnqBIslwD5kWvk/images/cli/acp/jetbrains-add-custom-agent.png?fit=max&auto=format&n=9EKnqBIslwD5kWvk&q=85&s=12e5619e373efe6adb98941f181b7da2" alt="Opção Add Custom Agent no menu do AI Chat" width="425" height="536" data-path="images/cli/acp/jetbrains-add-custom-agent.png" />
    </Frame>
  </Step>

  <Step title="Configure o agente Devin">
    Adicione Devin ao bloco `agent_servers` em `acp.json`. Defina `command` como o
    caminho absoluto do binário `devin` (obtido com `which devin`) e passe `acp` como
    único argumento:

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

    Salve o arquivo. Devin agora aparece como um agente selecionável no AI Chat.
  </Step>

  <Step title="Comece a conversar com Devin">
    Selecione **devin** como agente no AI Chat e envie uma mensagem para iniciar uma
    sessão. Na primeira vez que se conectar, talvez seja necessário fazer autenticação;
    Devin usa as credenciais de `devin auth login` (ou `WINDSURF_API_KEY`, se
    definida).
  </Step>
</Steps>

<div id="managing-the-integration">
  ## Gerenciando a integração
</div>

O menu de três pontos no painel do AI Chat inclui algumas ações úteis para o
agente Devin:

* **Redefinir a autenticação do ACP** — limpe as credenciais do ACP armazenadas e faça a autenticação novamente.
* **Abrir os logs do ACP** — abra os logs do ACP, úteis para depurar problemas de conexão ou
  inspecionar o que o agente está fazendo nos bastidores.

<div id="notes-and-limitations">
  ## Observações e limitações
</div>

* A saída do terminal/shell do Devin CLI é exibida pela renderização ACP do JetBrains AI Chat, que difere da UI nativa do terminal do Devin CLI. Algumas interações mais avançadas só estão disponíveis no CLI independente.
* O subcomando `devin acp` foi projetado para ser iniciado por um cliente compatível com ACP
  (como o JetBrains AI Chat) como um subprocesso — ele usa JSON-RPC via stdio e não
  deve ser executado de forma interativa. Consulte
  [`devin acp`](/pt-BR/cli/reference/commands#devin-acp) na referência de comandos.