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

# 基本コマンド

> これだけは覚えておきたい...

<div id="starting-devin-cli">
  ## Devin CLI の起動
</div>

デフォルトでは、セッションは REPL で行われます。REPL は、Devin と対話しながらその動作を確認できるグラフィカルなターミナル インターフェースです。

```bash theme={null}
devin                            # インタラクティブREPLを起動（プロンプトなし）
devin -- your prompt here        # 初期プロンプトを指定してREPLを起動
devin -p "prompt"                # シングルターン（REPLなし）：標準出力にレスポンスを表示して終了
devin -p -- prompt words here    # 同上（-- セパレーターを使用、こちらも有効）
```

<Note>
  サブコマンドではなくプロンプトとして解釈されるよう、プロンプトの前に `--` を付けてください。
</Note>

<Tip>
  シングルターンモード (`-p`) は、スクリプトや自動化での利用に最適です。
</Tip>

<Note>
  プロンプト入力欄で `@` を入力すると、ローカルのファイルやディレクトリのオートコンプリートが表示されます。1 つ選択すると、メッセージの前提情報として追加されます。
</Note>

<Tip>
  **Ctrl+V** でクリップボードから画像を貼り付けられます。アタッチされた画像は入力欄に表示され、**Left/Right** で切り替え、**Backspace** で削除できます。
</Tip>

<div id="running-shell-commands">
  ## シェルコマンドの実行
</div>

Devin は作業中にシェルコマンドを実行することがあります。コマンドが既定の待機時間を過ぎても完了しない場合、Devin はそのコマンドをバックグラウンドに移し、待機時間とバックグラウンドのシェル ID を表示します。その後も、Devin は作業を続けながら、あとでコマンドの出力を確認できます。

***

<div id="modes">
  ## モード
</div>

Devin CLI には、4 つの組み込み権限モード (**Normal**、**Accept Edits**、**Bypass**、**Autonomous**) と、3 つのエージェントモード (**Normal**、**Plan**、**Ask**) があります。Plan と Ask を使う場合は、`/plan` と `/ask` を利用してください。

<AccordionGroup>
  <Accordion title="Normal" defaultOpen icon="robot">
    現在のディレクトリ内での読み取り専用のツール操作は自動承認され、書き込みや実行を伴う操作では権限の確認が求められます。

    ```bash theme={null}
    /normal
    # または
    /mode normal
    ```

    これがデフォルトのモードです。
  </Accordion>

  <Accordion title="Accept Edits" icon="check">
    ワークスペース内のファイル編集は自動承認されますが、シェルコマンドやその他のアクションについては引き続き確認が求められます。通常は、このモードで作業する時間が最も長くなることを想定しています。

    ```bash theme={null}
    /accept-edits
    # または
    /mode accept-edits
    ```
  </Accordion>

  <Accordion title="Bypass" icon="bolt">
    <Warning>
      書き込みやシェルコマンドを含む **すべて** のツール呼び出しを自動承認します。
    </Warning>

    ```bash theme={null}
    /bypass
    # または
    /mode bypass
    ```

    Bypass モードで開始することもできます。

    ```bash theme={null}
    devin --permission-mode bypass
    ```

    エイリアス: `/yolo`, `/dangerous`

    <Note>
      Bypass モードでも、管理者が [Team Settings](/ja/cli/enterprise/team-settings) で設定した組織レベルの権限が上書きされることは**ありません**。管理者によって強制された deny ルールと ask ルールが**常に**優先されます。
    </Note>
  </Accordion>

  <Accordion title="Autonomous" icon="robot">
    現在のワークスペースでは Accept Edits とほぼ同等ですが、それに加えて [OS-level sandbox](/ja/cli/reference/configuration/config-file#sandbox) 内で任意のシェルコマンドを実行できます (それらのコマンドが実際にアクセスできる範囲を制限するためです) 。

    ```bash theme={null}
    devin --sandbox --permission-mode autonomous
    ```

    `--sandbox` を付けて実行する場合に利用できる権限モードは **Autonomous** だけで、自動的に選択されます。Normal、Accept Edits、Bypass はサンドボックス セッションでは表示されません。

    Autonomous モードでは...

    * **コマンドではなく capabilities** について確認が求められます。
      * コマンドは、ファイルシステム サンドボックスを通じて `Write` と `Read` のスコープに従います。
      * コマンドがネットワークリソースへの接続を試みると、確認が表示されます。
    * 現在のディレクトリ内での読み取り専用操作は自動承認されます。

    <Note>
      Autonomous は安全性をサンドボックスに依存しています。`--sandbox` なしではこのモードは利用できません。OS レベルの分離なしで無人実行したい場合は、Bypass を利用してください。直接比較については、以下の [Bypass vs Autonomous](#bypass-vs-autonomous) を参照してください。
    </Note>
  </Accordion>
</AccordionGroup>

<div id="bypass-vs-autonomous">
  ### Bypass と Autonomous
</div>

Bypass と Autonomous はどちらも承認プロンプトを減らしますが、採用している安全メカニズムは異なります。

|                                                            | Bypass   | Autonomous                                                                             |
| ---------------------------------------------------------- | -------- | -------------------------------------------------------------------------------------- |
| `--sandbox` が必要                                            | いいえ      | はい (サンドボックス セッションでのみ利用可能)                                                              |
| シェルコマンド                                                    | 自動承認、無制限 | 自動承認、サンドボックス内に制限される                                                                    |
| `edit`/`write` ツールによるファイル書き込み                              | どこでも自動承認 | 引き続き承認を求める (スコープを付与するとサンドボックスが拡張される)                                                   |
| ネットワークアクセス                                                 | 無制限      | サンドボックスの[ドメイン許可/拒否リスト](/ja/cli/reference/configuration/config-file#sandbox)でフィルタリングされる |
| 管理者の[Team Settings](/ja/cli/enterprise/team-settings)を尊重する | はい       | はい                                                                                     |

エージェントにマシン全体を任せられるなら、Bypass を選んでください。エージェントがアクセスできるファイルやドメインを OS レベルで制限しつつ無人実行したい場合は、`--sandbox` (Autonomous が選択されます) を選んでください。Bypass のような使い勝手が好みで、エージェント専用のコンピューターも持たせたいなら、cloud Devin を試してみてください。

<div id="session-history">
  ## セッション履歴
</div>

会話の履歴は保存されるため、後でセッションを再開できます。

```bash theme={null}
devin -c              # 現在のディレクトリで最新のセッションを続行する
devin --continue

devin -r              # 最近のセッションから選択する
devin --resume
devin -r brisk-otter  # IDで特定のセッションを再開する
```

***

<div id="slash-commands">
  ## スラッシュコマンド
</div>

アクティブなセッション中に、これらのコマンドを利用できます。

<div id="navigation-control">
  ### ナビゲーションと操作
</div>

| コマンド               | 説明               |
| ------------------ | ---------------- |
| `/help`            | 使用可能なすべてのコマンドを表示 |
| `/exit` or `/quit` | アプリケーションを終了      |
| `/clear` or `/new` | 会話履歴を消去 (最初から開始) |

<Tip>
  `/` プレフィックスなしで、プレーンテキストとして `exit` または `quit` と入力して終了することもできます。
</Tip>

<div id="mode-switching">
  ### モードの切り替え
</div>

| コマンド              | 説明                                                                              |
| ----------------- | ------------------------------------------------------------------------------- |
| `/mode`           | 現在のモードを表示                                                                       |
| `/mode <name>`    | モードを切り替え (`normal`、`accept-edits`、`plan`、`bypass`。サンドボックス セッションでは `autonomous`) |
| `/normal`         | Normal モードに切り替え (デフォルト)                                                         |
| `/plan`           | Plan モードに切り替え                                                                   |
| `/ask <question>` | コードを変更せずに質問する (oneshot)                                                         |
| `/bypass`         | Bypass モードに切り替え (エイリアス: `/yolo`、`/dangerous`)                                   |

<div id="model-switching">
  ### モデルの切り替え
</div>

| コマンド     | 説明         |
| -------- | ---------- |
| `/model` | モデル選択画面を表示 |

<div id="session-management">
  ### セッション管理
</div>

| コマンド               | 説明                                                  |
| ------------------ | --------------------------------------------------- |
| `/resume`          | 対話型のセッション選択画面を開く                                    |
| `/resume <id>`     | IDを指定してセッションを再開する                                   |
| `/ls`              | 現在のディレクトリ内にある最近のセッションを一覧表示する (別名: `/list-sessions`) |
| `/ls --all`        | すべてのディレクトリにまたがる全セッションを一覧表示する                        |
| `/continue`        | 最新のセッションを再開する                                       |
| `/continue <id>`   | IDを指定してセッションを再開する                                   |
| `/rm-session <id>` | IDを指定してセッションを完全に削除する                                |

<div id="workspace">
  ### ワークスペース
</div>

| コマンド                   | 説明                                         |
| ---------------------- | ------------------------------------------ |
| `/workspace`           | ワークスペース ディレクトリを一覧表示 (エイリアス: `/workspaces`) |
| `/add-dir <path>`      | ワークスペース ディレクトリを追加                          |
| `/undo-add-dir <path>` | ワークスペース ディレクトリを削除                          |

<div id="automation">
  ### 自動化
</div>

| コマンド             | 説明                                                                        |
| ---------------- | ------------------------------------------------------------------------- |
| `/loop <prompt>` | プロンプトを実行し、その後、差分の Auto-review をループで繰り返します (開始するには git の状態がクリーンである必要があります) |

<div id="extensibility">
  ### 拡張性
</div>

| コマンド     | 説明                                           |
| -------- | -------------------------------------------- |
| `/hooks` | 読み込まれているすべてのフックを、ID、イベントタイプ、ソースパスとともに一覧表示します |

<div id="account-system">
  ### アカウントとシステム
</div>

| コマンド       | 説明                     |
| ---------- | ---------------------- |
| `/login`   | Devinにログインする           |
| `/logout`  | 保存された認証情報を削除して終了する     |
| `/update`  | アップデートを確認してインストールする    |
| `/upgrade` | サブスクリプションプランをアップグレードする |
| `/bug`     | Devin CLIの開発者にバグを報告する  |
| `/compact` | 会話を強制的に圧縮する            |

<Note>
  Homebrew経由でDevin for Terminalをインストールした場合、`/update` を実行すると、自己アップデートの代わりに `brew upgrade devin` を利用するよう案内されます。
</Note>

***

<div id="keyboard-shortcuts">
  ## キーボード ショートカット
</div>

以下は、特に重要なキーボード ショートカットです。その他のショートカットについては、[Keyboard Shortcuts](/ja/cli/reference/keyboard-shortcuts)を参照してください。

| ショートカット                    | 説明                                                        |
| -------------------------- | --------------------------------------------------------- |
| `Shift+Tab`                | モード (Normal、Accept Edits、Plan、Bypass、Autonomous) を順に切り替える |
| `Ctrl+C`                   | 入力テキストをクリアする、または実行中のエージェントをキャンセルする                        |
| `Esc`                      | 実行中のエージェントをキャンセルする                                        |
| `Shift+Enter`              | 改行を挿入する (複数行入力)                                           |
| `Ctrl+V` or `Shift+Insert` | クリップボードから貼り付ける                                            |
| `Ctrl+G`                   | 外部エディタを開く                                                 |
| `Ctrl+O`                   | 全画面の思考トレース ビューアを開く                                        |
| `@`                        | 前提情報に追加するファイルをメンションする                                     |
