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

# Compatibilidade com terminais

> Terminais compatíveis e recomendações para a melhor experiência com o Devin CLI

O Devin CLI funciona em uma ampla variedade de emuladores de terminal, mas alguns oferecem uma experiência melhor que outros. Esta página apresenta os níveis de compatibilidade, recomendações e dicas de configuração.

***

<div id="compatibility-overview">
  ## Visão geral da compatibilidade
</div>

Os terminais são agrupados em três níveis, com base no suporte a recursos:

<div id="fully-supported-all-features-work">
  ### Totalmente compatível (todos os recursos funcionam)
</div>

Estes terminais são compatíveis com o [protocolo de teclado Kitty](https://sw.kovidgoyal.net/kitty/keyboard-protocol/), que permite detectar com confiabilidade combinações de teclas como `Shift+Enter` para entrada multilinha.

| Terminal                                    | Plataforma             | Observações                                                                                                  |
| ------------------------------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------ |
| [Kitty](https://sw.kovidgoyal.net/kitty/)   | macOS†, Linux          | Recomendado para usuários avançados. Usado pelos desenvolvedores do Devin CLI.                               |
| [Ghostty](https://ghostty.org/)             | macOS†, Linux          | Recomendado para usuários avançados. Usado pelos desenvolvedores do Devin CLI.                               |
| [WezTerm](https://wezfurlong.org/wezterm/)  | macOS†, Linux, Windows | Recomendado para usuários avançados.                                                                         |
| [iTerm2](https://iterm2.com/)               | macOS†                 | Recomendado para a maioria dos usuários. A versão 3.5+ é necessária para melhor compatibilidade.             |
| [Windows Terminal](https://aka.ms/terminal) | Windows                | Recomendado para a maioria dos usuários. A versão 1.25 ou superior é necessária para melhor compatibilidade. |

<div id="supported-some-features-limited">
  ### Compatíveis (alguns recursos limitados)
</div>

Estes terminais funcionam com o Devin CLI, mas não são ideais porque não oferecem suporte ao protocolo de teclado Kitty. Por exemplo, `Shift+Enter` não insere uma nova linha — use `Alt+Enter` ou `Ctrl+J`.

| Terminal                                                             | Plataforma             | Observações                                                                                                                         |
| -------------------------------------------------------------------- | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| [Terminal.app](https://support.apple.com/guide/terminal/welcome/mac) | macOS†                 | Terminal nativo do macOS. Requer a [configuração de Option como Meta](#configuring-option-as-meta-on-macos) para atalhos com `Alt`. |
| Git Bash                                                             | Windows                | Incluído no [Git for Windows](https://git-scm.com/download/win).                                                                    |
| DEC VT100                                                            | Várias                 | Defina o modo do terminal como `legacy` em `/config`.                                                                               |
| Terminais ANSI genéricos                                             | Várias                 | Qualquer terminal com suporte básico a códigos de escape ANSI.                                                                      |
| [Alacritty](https://alacritty.org/)                                  | macOS†, Linux, Windows | Fortemente desaconselhado / não recomendado para obter o melhor desempenho.                                                         |

† No macOS, recomendamos [configurar Option como Meta](#configuring-option-as-meta-on-macos) para ter a melhor experiência com atalhos baseados em `Alt`.

<Note>
  Em terminais do macOS que não foram configurados para Option como Meta, atalhos com `Alt` (Option), como `Alt+Enter` para entrada multilinha, não funcionarão. Veja [Configuring Option-as-Meta on macOS](#configuring-option-as-meta-on-macos) abaixo.
</Note>

<div id="unsupported">
  ### Sem suporte
</div>

Estes terminais não têm suporte e podem apresentar problemas significativos. Recomendamos fortemente mudar para um terminal com suporte.

| Terminal          | Plataforma | Observações                                                                             |
| ----------------- | ---------- | --------------------------------------------------------------------------------------- |
| cmd.exe (conhost) | Windows    | Prompt de comando legado do Windows. Use o [Windows Terminal](https://aka.ms/terminal). |

***

<div id="recommendations">
  ## Recomendações
</div>

| Plataforma                             | Recomendação                                                                                                             |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **Windows**                            | [Windows Terminal](https://aka.ms/terminal) 1.25 ou mais recente                                                         |
| **macOS** (geral)                      | [iTerm2](https://iterm2.com/)                                                                                            |
| **macOS / Linux** (usuários avançados) | [Kitty](https://sw.kovidgoyal.net/kitty/), [Ghostty](https://ghostty.org/) ou [WezTerm](https://wezfurlong.org/wezterm/) |

***

<div id="configuring-option-as-meta-on-macos">
  ## Configurar Option como Meta no macOS
</div>

No macOS, a tecla Option é usada como tecla de composição por padrão na maioria dos terminais. Isso significa que atalhos baseados em `Alt` (como `Alt+Enter` para entrada multilinha ou `Alt+T` para alternar entre níveis de raciocínio) não funcionarão até que você configure o terminal para tratar a Option como Meta/Alt.

<AccordionGroup>
  <Accordion title="iTerm2">
    1. Abra **iTerm2 > Configurações** (ou pressione `Cmd+,`)
    2. Vá para **Profiles > Keys > General**
    3. Defina **Left Option Key** como **Esc+**
    4. Opcionalmente, defina **Right Option Key** também como **Esc+**

    [documentação do iTerm2](https://iterm2.com/documentation-preferences-profiles-keys.html)
  </Accordion>

  <Accordion title="Terminal.app">
    1. Abra **Terminal > Configurações** (ou pressione `Cmd+,`)
    2. Vá para **Profiles** e selecione seu perfil ativo
    3. Clique na aba **Keyboard**
    4. Marque **Use Option as Meta Key**

    [documentação da Apple](https://support.apple.com/guide/terminal/change-profiles-keyboard-settings-trmlkbrd/mac)
  </Accordion>

  <Accordion title="Alacritty">
    Adicione o seguinte ao arquivo de configuração `alacritty.toml`:

    ```toml theme={null}
    [keyboard]
    option_as_alt = "Both"
    ```

    [referência de configuração do Alacritty](https://alacritty.org/config-alacritty.html)
  </Accordion>

  <Accordion title="Kitty">
    Adicione o seguinte ao arquivo de configuração `kitty.conf`:

    ```text theme={null}
    macos_option_as_alt yes
    ```

    Reinicie o Kitty após fazer essa alteração.

    [documentação do Kitty](https://sw.kovidgoyal.net/kitty/conf/#opt-kitty.macos_option_as_alt)
  </Accordion>

  <Accordion title="Ghostty">
    Adicione o seguinte ao arquivo de configuração do Ghostty:

    ```text theme={null}
    macos-option-as-alt = true
    ```

    Reinicie o Ghostty após fazer essa alteração.

    [documentação do Ghostty](https://ghostty.org/docs/config/reference#macos-option-as-alt)
  </Accordion>

  <Accordion title="WezTerm">
    Adicione o seguinte ao arquivo de configuração `~/.wezterm.lua`:

    ```lua theme={null}
    config.send_composed_key_when_left_alt_is_pressed = false
    config.send_composed_key_when_right_alt_is_pressed = false
    ```

    [documentação do WezTerm](https://wezfurlong.org/wezterm/config/lua/config/send_composed_key_when_left_alt_is_pressed.html)
  </Accordion>
</AccordionGroup>