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

# ターミナルの互換性

> Devin CLI を快適に利用するための、サポート対象ターミナルと推奨事項

Devin CLI は幅広いターミナルエミュレータで動作しますが、ターミナルによって使い勝手に差があります。このページでは、互換性のレベル、推奨事項、設定のヒントを紹介します。

***

<div id="compatibility-overview">
  ## 互換性の概要
</div>

ターミナルは、サポートされる機能に応じて3つのティアに分類されます：

<div id="fully-supported-all-features-work">
  ### 完全対応 (すべての機能が利用可能)
</div>

これらのターミナルは [Kitty keyboard protocol](https://sw.kovidgoyal.net/kitty/keyboard-protocol/) に対応しており、複数行入力で `Shift+Enter` などのキーの組み合わせを確実に検出できます。

| Terminal                                    | Platform               | Notes                                     |
| ------------------------------------------- | ---------------------- | ----------------------------------------- |
| [Kitty](https://sw.kovidgoyal.net/kitty/)   | macOS†, Linux          | パワーユーザー向けに推奨。Devin CLI の開発者も使用しています。      |
| [Ghostty](https://ghostty.org/)             | macOS†, Linux          | パワーユーザー向けに推奨。Devin CLI の開発者も使用しています。      |
| [WezTerm](https://wezfurlong.org/wezterm/)  | macOS†, Linux, Windows | パワーユーザー向けに推奨。                             |
| [iTerm2](https://iterm2.com/)               | macOS†                 | ほとんどのユーザーに推奨。最適なサポートにはバージョン 3.5+ 以降が必要です。 |
| [Windows Terminal](https://aka.ms/terminal) | Windows                | ほとんどのユーザーに推奨。最適なサポートには 1.25 以降が必要です。      |

<div id="supported-some-features-limited">
  ### サポート対象 (一部機能に制限あり)
</div>

これらのターミナルはDevin CLIで利用できますが、Kitty keyboard protocolをサポートしていないため、最適ではありません。たとえば、`Shift+Enter` を押しても改行は挿入されません。代わりに `Alt+Enter` または `Ctrl+J` を使用してください。

| ターミナル                                                                | プラットフォーム               | 備考                                                                                                   |
| -------------------------------------------------------------------- | ---------------------- | ---------------------------------------------------------------------------------------------------- |
| [Terminal.app](https://support.apple.com/guide/terminal/welcome/mac) | macOS†                 | macOS標準のターミナルです。`Alt` ショートカットを使うには、[Option-as-Meta の設定](#configuring-option-as-meta-on-macos) が必要です。 |
| Git Bash                                                             | Windows                | [Git for Windows](https://git-scm.com/download/win) に含まれています。                                        |
| DEC VT100                                                            | Various                | `/config` でターミナルモードを `legacy` に設定してください。                                                             |
| Generic ANSI terminals                                               | Various                | 基本的なANSIエスケープコードに対応する任意のターミナルです。                                                                     |
| [Alacritty](https://alacritty.org/)                                  | macOS†, Linux, Windows | 最適なパフォーマンスのため、非推奨です。                                                                                 |

† macOSでは、`Alt` ベースのショートカットを快適に使うため、[Option as Metaの設定](#configuring-option-as-meta-on-macos) を推奨します。

<Note>
  Option-as-Meta が設定されていないmacOSターミナルでは、複数行入力に使う `Alt+Enter` などの `Alt` (Option) ショートカットは機能しません。以下の [macOSでのOption-as-Metaの設定](#configuring-option-as-meta-on-macos) を参照してください。
</Note>

<div id="unsupported">
  ### 非対応
</div>

これらのターミナルはサポート対象外であり、重大な問題が発生する可能性があります。サポート対象のターミナルへの切り替えを強く推奨します。

| ターミナル             | プラットフォーム | 注記                                                                                    |
| ----------------- | -------- | ------------------------------------------------------------------------------------- |
| cmd.exe (conhost) | Windows  | レガシー Windows コマンド プロンプトです。代わりに [Windows Terminal](https://aka.ms/terminal) を利用してください。 |

***

<div id="recommendations">
  ## 推奨事項
</div>

| プラットフォーム                      | 推奨                                                                                                                         |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Windows**                   | [Windows Terminal](https://aka.ms/terminal) 1.25 以降                                                                        |
| **macOS** (一般的な用途)            | [iTerm2](https://iterm2.com/)                                                                                              |
| **macOS / Linux** (パワーユーザー向け) | [Kitty](https://sw.kovidgoyal.net/kitty/), [Ghostty](https://ghostty.org/), または [WezTerm](https://wezfurlong.org/wezterm/) |

***

<div id="configuring-option-as-meta-on-macos">
  ## macOS で Option-as-Meta を設定する
</div>

macOS では、ほとんどのターミナルで Option キーはデフォルトで compose キーとして使われます。そのため、ターミナルが Option を Meta/Alt として扱うように設定するまで、`Alt` ベースのショートカット (複数行入力の `Alt+Enter` や思考レベルの切り替えに使う `Alt+T` など) は利用できません。

<AccordionGroup>
  <Accordion title="iTerm2">
    1. **iTerm2 > Settings** を開きます (または `Cmd+,` を押します)
    2. **Profiles > Keys > General** に移動します
    3. **Left Option Key** を **Esc+** に設定します
    4. 必要に応じて、**Right Option Key** も **Esc+** に設定します

    [iTerm2 ドキュメント](https://iterm2.com/documentation-preferences-profiles-keys.html)
  </Accordion>

  <Accordion title="Terminal.app">
    1. **Terminal > Settings** を開きます (または `Cmd+,` を押します)
    2. **Profiles** に移動し、アクティブなプロファイルを選択します
    3. **Keyboard** タブをクリックします
    4. **Use Option as Meta Key** をチェックします

    [Apple ドキュメント](https://support.apple.com/guide/terminal/change-profiles-keyboard-settings-trmlkbrd/mac)
  </Accordion>

  <Accordion title="Alacritty">
    次の内容を `alacritty.toml` 設定ファイルに追加します。

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

    [Alacritty 設定リファレンス](https://alacritty.org/config-alacritty.html)
  </Accordion>

  <Accordion title="Kitty">
    次の内容を `kitty.conf` 設定ファイルに追加します。

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

    変更後に Kitty を再起動します。

    [Kitty ドキュメント](https://sw.kovidgoyal.net/kitty/conf/#opt-kitty.macos_option_as_alt)
  </Accordion>

  <Accordion title="Ghostty">
    次の内容を Ghostty の設定ファイルに追加します。

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

    変更後に Ghostty を再起動します。

    [Ghostty ドキュメント](https://ghostty.org/docs/config/reference#macos-option-as-alt)
  </Accordion>

  <Accordion title="WezTerm">
    次の内容を `~/.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
    ```

    [WezTerm ドキュメント](https://wezfurlong.org/wezterm/config/lua/config/send_composed_key_when_left_alt_is_pressed.html)
  </Accordion>
</AccordionGroup>
