终端兼容性 - Devin Docs

Devin CLI 可在多种终端模拟器中运行，但不同终端的使用体验有所差异。本页介绍兼容性级别、推荐选择和配置建议。

兼容性概览

终端根据功能支持情况分为三个层级：

这些终端支持 Kitty 键盘协议，能够可靠地识别 Shift+Enter 等按键组合，从而支持多行输入。

这些终端可与 Devin CLI 配合使用，但并非理想选择，因为它们不支持 Kitty 键盘协议。例如，Shift+Enter 无法插入换行——请改用 Alt+Enter 或 Ctrl+J。

Terminal	Platform	Notes
Terminal.app	macOS†	macOS 内置终端。使用 `Alt` 快捷键需要先将 Option 配置为 Meta。
Git Bash	Windows	Git for Windows 已包含。
DEC VT100	Various	在 `/config` 中将终端模式设为 `legacy`。
Generic ANSI terminals	Various	任何支持基本 ANSI 转义码的终端。
Alacritty	macOS†, Linux, Windows	强烈不建议使用，不利于获得最佳性能。

† 在 macOS 上，我们建议将 Option 配置为 Meta，以获得基于 Alt 快捷键的最佳体验。

在 macOS 终端中，如果未配置将 Option 配置为 Meta，则 Alt+Enter 这类用于多行输入的 Alt (Option) 快捷键将无法使用。请参阅下方的 Configuring Option-as-Meta on macOS。

这些终端目前不受支持，使用时可能会出现严重问题。强烈建议切换到受支持的终端。

终端	平台	说明
cmd.exe (conhost)	Windows	旧版 Windows 命令提示符。请改用 Windows Terminal。

在 macOS 上，大多数终端默认会将 Option 键用作组合键，因此基于 Alt 的快捷键 (例如用于多行输入的 Alt+Enter，或用于循环切换思考级别的 Alt+T) 在你将终端配置为把 Option 识别为 Meta/Alt 之前无法使用。

iTerm2

Terminal.app

Alacritty

将以下内容添加到你的 alacritty.toml 配置文件中：

[keyboard]
option_as_alt = "Both"

Kitty

将以下内容添加到你的 kitty.conf 配置文件中：

macos_option_as_alt yes

修改后，重启 Kitty。Kitty 文档

Ghostty

将以下内容添加到你的 Ghostty 配置文件中：

macos-option-as-alt = true

修改后，重启 Ghostty。Ghostty 文档

WezTerm

将以下内容添加到你的 ~/.wezterm.lua 配置文件中：

config.send_composed_key_when_left_alt_is_pressed = false
config.send_composed_key_when_right_alt_is_pressed = false