> ## 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 Desktop の拡張ターミナルでは、Command モード、Cascade 統合、自動実行用の Turbo モード、コマンド制御用の許可/拒否リストを利用できます。

<div id="command-in-the-terminal">
  # ターミナルで Command を利用する
</div>

ターミナルで [Command](/ja/desktop/command/windsurf-overview) モード (`Cmd/Ctrl+I`) を利用すると、自然言語のプロンプトから適切な CLI 構文を生成できます。

<Frame style={{ border: 'none', background: 'none' }}>
  <img src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf-terminal-command.png?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=3e67784716df176170b2bccf1e002839" width="980" height="164" data-path="desktop/assets/windsurf-terminal-command.png" />
</Frame>

<div id="send-terminal-selection-to-cascade">
  # ターミナルの選択範囲をCascadeに送信する
</div>

スタックトレースの一部を選択して `Cmd/Ctrl+L` を押すと、その内容がCascadeに送信され、次のプロンプトでこの選択範囲を参照できます。

<Frame style={{ border: 'none', background: 'none' }}>
  <img src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf-terminal-selection-mention.png?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=9b04fbc1dd2ea876ff784e2745f4dd8a" width="744" height="144" data-path="desktop/assets/windsurf-terminal-selection-mention.png" />
</Frame>

<div id="mention-your-terminal">
  # ターミナルを@メンションする
</div>

現在アクティブなターミナルについて、Cascade とチャットできます。

<Frame>
  <video autoPlay muted loop playsInline src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/terminal-at-mention.mp4?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=2e28c374b0c7c9a413ecc4accb50faa0" data-path="desktop/assets/terminal-at-mention.mp4" />
</Frame>

<div id="auto-executed-cascade-commands">
  # Cascade コマンドの自動実行
</div>

Cascade には、ユーザーの許可を得たうえでターミナルコマンドを自動的に実行できる機能があります。Cascade によるコマンド実行の扱いは、4 つの自動実行レベルで設定できます。また、特定のターミナルコマンドは、Allow リストと Deny リストによって自動的に許可または拒否できます。

<div id="auto-execution-levels">
  ## 自動実行レベル
</div>

Devin Desktop には、コマンドの自動実行レベルが 4 段階あり、Cascade がターミナルコマンドをどのように実行するかを制御できます。

| Level       | Description                                                                                                   |
| ----------- | ------------------------------------------------------------------------------------------------------------- |
| **無効**      | 自動実行は完全に無効になります。すべてのコマンドで、実行前に手動承認が必要です。                                                                      |
| **許可リストのみ** | 許可リストの項目に一致するコマンドのみ自動実行されます。それ以外のコマンドはすべて手動承認が必要です。                                                           |
| **自動**      | Cascade が、コマンドを安全に自動実行できるかどうかを判断します。潜在的にリスクがあると判断されたコマンドについては、引き続き承認が必要です。この機能は、プレミアムモデルで送信されたメッセージでのみ利用できます。 |
| **Turbo**   | 拒否リストに含まれるものを除き、すべてのコマンドが即座に自動実行されます。                                                                         |

エディタ右下の Devin Settings パネルから、使用する自動実行レベルを選択できます。

<Frame>
  <img style={{ maxHeight: "500px" }} src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/cascade-turbo-mode.png?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=ae2e7e169ff832dbc848f2b486a1bc64" width="680" height="60" data-path="desktop/assets/windsurf/cascade/cascade-turbo-mode.png" />
</Frame>

<div id="admin-controlled-maximum-level-teams-enterprise">
  ### 管理者が制御する最大レベル (Teams & Enterprise)
</div>

Teams および Enterprise のユーザー向けに、管理者は組織で許可する自動実行レベルの上限を設定できます。この設定により、チームメンバーが選択できるレベルが制限され、管理者はセキュリティポリシーを適用しながら、その範囲内でユーザーに一定の柔軟性を持たせることができます。

管理者が最大レベルを設定すると、ユーザーはその上限までの任意のレベルを選択できます。たとえば、管理者が最大値を "Auto" に設定した場合、ユーザーは Disabled、Allowlist Only、または Auto を選択できますが、Turbo モードを有効にすることはできません。

管理者は、<a href="https://windsurf.com/team/settings" target="_blank">Admin Portal</a> のチーム設定でこの設定を構成できます。

<div id="team-wide-command-lists-teams-enterprise">
  ### チーム全体のコマンドリスト (Teams & Enterprise)
</div>

管理者は、すべてのチームメンバーに適用される**チーム全体の許可リストと拒否リスト**をターミナルコマンド向けに設定できます。これらのリストは、各ユーザー個別の許可/拒否リストに加えて適用されます。

| リストの種類    | 動作                                                                  |
| --------- | ------------------------------------------------------------------- |
| **許可リスト** | このリストのエントリにマッチするコマンドは、ユーザーの確認なしで自動実行されます (そのユーザーで自動実行が有効になっている場合) 。 |
| **拒否リスト** | このリストのエントリにマッチするコマンドは、ユーザー設定に関係なく、実行前に必ずユーザーの承認が必要になります。            |

**主な動作:**

* **チームとユーザーの設定は統合されます**: チームレベルのリストは、Devin Desktop の設定で構成した各ユーザーの許可/拒否リストと組み合わせて適用されます。チームまたはユーザーの許可リストのいずれかにマッチするコマンドは、自動実行されます (拒否リストでブロックされていない場合) 。
* **拒否リストは許可リストより優先されます**。コマンドが両方のリスト (チームレベルまたはユーザーレベル) にマッチする場合は、承認が必要になります

チーム全体のコマンドリストを設定するには、<a href="https://windsurf.com/team/settings" target="_blank">Admin Portal</a> → チーム設定 → Terminal Commands → **リストを管理** に移動します。

<div id="allow-list">
  ### 許可リスト
</div>

許可リストでは、常に自動実行されるターミナルコマンドのセットを定義します。たとえば、`git` を追加すると、Cascade は `git add -A` を常に受け入れるようになります。

この設定は、Command Palette → Open Settings (UI) → `windsurf.cascadeCommandsAllowList` を検索して見つけられます。

<Frame>
  <img style={{ maxHeight: "500px" }} src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/allow-list.png?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=1b754d3f929035d337194fd90d518e43" width="2098" height="770" data-path="desktop/assets/windsurf/cascade/allow-list.png" />
</Frame>

<div id="deny-list">
  ### 拒否リスト
</div>

拒否リストは、自動実行されないターミナルコマンドのセットを定義します。たとえば、`rm` を追加すると、Cascade は `rm index.py` を実行する前に必ず許可を求めます。

この設定は、Command Palette → Open Settings (UI) → `windsurf.cascadeCommandsDenyList` を検索して見つけられます。

<Frame>
  <img style={{ maxHeight: "500px" }} src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/deny-list.png?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=e87ec1ef4bab34330ee7896fe74b6ab7" width="2090" height="624" data-path="desktop/assets/windsurf/cascade/deny-list.png" />
</Frame>

<div id="dedicated-terminal">
  # 専用ターミナル
</div>

Wave 13 以降、Devin Desktop では、macOS 上で Cascade がコマンドを実行するための専用ターミナルが導入されました。
この専用ターミナルは既定のターミナルとは別のもので、シェルには *常に* `zsh` を利用します。

<Frame>
  <img style={{ maxHeight: "350px" }} src="https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/dedicated-terminal.png?fit=max&auto=format&n=WE51TvKjsiyk1ZHl&q=85&s=5950aff728dc78dcfb4d3f1304232496" width="1248" height="430" data-path="desktop/assets/windsurf/dedicated-terminal.png" />
</Frame>

この専用ターミナルでは zsh の設定が *そのまま* 利用されるため、`.zshrc` やその他の zsh 固有のファイルで設定したエイリアスや環境変数を利用できます。

`zsh` ではなく別のシェルを利用していて、Devin Desktop でも共通の環境変数を利用したい場合は、両方のシェルから読み込める共通の設定ファイルを作成することを推奨します。

<div id="troubleshooting">
  ### トラブルシューティング
</div>

専用ターミナルで問題が発生した場合は、Devin Desktopの設定で「Legacy Terminal Profile」オプションを有効にすると、レガシーターミナルに戻せます。
