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

​
適用シナリオ

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

​
クイックスタート

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

ターミナルで --remote パラメータを直接渡します。 
qodercli --remote "review the auth middleware in src/middleware and suggest improvements"
Cannot find package エラーが発生した場合、現在の CLI バージョンではクラウド依存パッケージが完全にバンドルされていない可能性があります。代わりに HTTP API クイックスタート から curl で直接 Cloud Agents API を呼び出してください。
CLI は次の処理を行います。
  1. 選択したリモート環境に新しいクラウドセッション (Cloud Session) を作成します。
  2. タスクの説明をクラウド Agent に送信します。
  3. クラウド Agent の出力（思考、ツール呼び出し、最終結果）をリアルタイムでローカルターミナルにストリーム出力します。
  4. タスク完了後、ローカルターミナルにセッション URL が表示され、Web 側で継続して追跡できます。
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 インタラクティブセッションで次のように入力します。 
/remote-env
CLI が環境セレクターを表示します。 
Remote Environment

Select the default cloud environment.

❯ 1. Default
  2. Sessions: test · Network: trusted
選択内容はユーザーレベル設定 ~/.qoder/settings.json に書き込まれます。 
{
  "remote": {
    "defaultCloudEnvironmentId": "env_01kq********hmj53ds"
  }
}
これ以降のすべての --remote 呼び出しは、このデフォルト環境を再利用するため、毎回選択し直す必要はありません。

​
コマンドリファレンス

​
qodercli --remote "<task>"

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

​
関連ドキュメント