> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cloud Mode

`--remote` モードを使うと、Qoder CLI のタスクを Qoder が管理するクラウド VM 上で直接実行できます。ローカルのマシンは起動したままにしたりアクティブな状態を保ったりする必要はありません。コマンドの送信から結果の生成まで全フローがクラウド上でホストされ、ローカルターミナルはエントリーポイントとしてのみ機能します。

> 既存の [Remote Control](https://docs.qoder.com/ja/cli/remote-control) モードと相補的に利用できます。

## 適用シナリオ

* **長時間タスク**: 学習、大規模リファクタ、大規模コードレビューなど、ローカルマシンを長時間占有するのが難しい場合。
* **オフラインでの開始**: 飛行機や地下鉄でプロンプトを書いておき、後で結果を確認できます。
* **統一された環境**: チームメンバーが同じ依存関係とツールチェーンを共有し、「私の環境では動く」という問題を回避します。
* **リソース分離**: クラウド VM は独立した CPU / メモリ / ネットワーククォータを持ち、ローカルリソースと競合しません。

## クイックスタート

### 1. クラウドでタスクを開始する

ターミナルで `--remote` パラメータを直接渡します。

```bash theme={null}
qodercli --remote "review the auth middleware in src/middleware and suggest improvements"
```

<Note>
  `Cannot find package` エラーが発生した場合、現在の CLI バージョンではクラウド依存パッケージが完全にバンドルされていない可能性があります。代わりに [HTTP API クイックスタート](/ja/cloud-agents/quickstart) から curl で直接 Cloud Agents API を呼び出してください。
</Note>

CLI は次の処理を行います。

1. 選択したリモート環境に新しいクラウドセッション (Cloud Session) を作成します。
2. タスクの説明をクラウド Agent に送信します。
3. クラウド Agent の出力（思考、ツール呼び出し、最終結果）をリアルタイムでローカルターミナルにストリーム出力します。
4. タスク完了後、ローカルターミナルにセッション URL が表示され、Web 側で継続して追跡できます。

```plaintext theme={null}
Cloud remote session created.
Session ID: qs_01krxhzz******351vhya
Environment: Default (env_01kqs75n******6x6hmj53ds)
URL: https://qoder.com/agents/session/qs_01krxhzz******351vhya
```

タスク開始後、ローカルターミナルを閉じても、クラウド Agent は引き続き実行されます。次回 CLI を再度開くか Web コンソールにアクセスすれば、追跡を再開できます。

### 2. /remote-env でクラウド実行環境を選択する

既存の qodercli インタラクティブセッションで次のように入力します。

```plaintext theme={null}
/remote-env
```

CLI が環境セレクターを表示します。

```plaintext theme={null}
Remote Environment

Select the default cloud environment.

❯ 1. Default
  2. Sessions: test · Network: trusted
```

選択内容はユーザーレベル設定 `~/.qoder/settings.json` に書き込まれます。

```json theme={null}
{
  "remote": {
    "defaultCloudEnvironmentId": "env_01kq********hmj53ds"
  }
}
```

これ以降のすべての `--remote` 呼び出しは、このデフォルト環境を再利用するため、毎回選択し直す必要はありません。

## コマンドリファレンス

### `qodercli --remote "<task>"`

| 項目          | 説明                                                                        |
| ----------- | ------------------------------------------------------------------------- |
| 用途          | CLI からクラウドセッションを開始し、Qoder が管理する VM でタスクを実行します                             |
| コンテキスト      | ローカルの作業ディレクトリには依存せず、すべての読み書きはクラウド環境で行われます                                 |
| 中断動作        | ローカルで `Ctrl+C` を押してもターミナルの購読が切断されるだけで、クラウドタスクは引き続き実行されます                  |
| ログイン要否      | 必須（初回使用時に `qodercli login` がトリガーされます）                                     |
| Github 認証要否 | Qoder に対応する Github リポジトリの権限を認可する必要があります（Qoder 公式サイト > サービス連携 > Github 連携） |

**例**：

```bash theme={null}
# 基本的な使い方
qodercli --remote "summarize the latest 50 PRs in this repo"
```

### `/remote-env`

| 項目     | 説明                                                  |
| ------ | --------------------------------------------------- |
| トリガー位置 | qodercli のインタラクティブセッション内のみ（`/` を入力して選択）             |
| 用途     | クラウド実行環境を選択 / 切り替え / 作成し、`--remote` のデフォルト値として設定    |
| 影響範囲   | ユーザーレベル（`~/.qodercli/config.json` に書き込み）、複数ターミナルで共有 |

## よくある質問

**Q: 未保存のローカル変更は `--remote` モードで読み取れますか?**

いいえ。`--remote` タスクは独立したクラウド VM 上で実行され、現在の環境に対応する Remote Github のプロジェクトにアクセスします。

**Q: 1 台のマシンで複数の `--remote` タスクを同時に実行できますか?**

はい。各 `--remote` 呼び出しは独立したクラウド Session を作成し、互いに干渉しません。タスクリストは [Cloud Agents コンソール](https://qoder.com/agents) で確認できます。

## 関連ドキュメント

* [Remote Control ガイド](./remote-control)