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

# 基本概念

> セッション、プロジェクト、クラウドサーバー、あなたのデバイス上での実行、Harness とモデル、モデルソース、権限、対応が必要、サブエージェント、そして画面の各エリアの役割について説明します。

このページでは、Cloud Agent を使ううえで繰り返し登場する概念を説明します。最も重要なのは **セッション** と **クラウドサーバー** の 2 つです。セッションでエージェントに作業を任せ、エージェントはクラウドサーバーまたはあなたのコンピューター上で作業を完了します。

## セッション

**セッション** は、1 つの作業についてあなたとエージェントがやり取りした完全な記録で、あなたのメッセージ、エージェントの手順、返信、変更内容を含みます。セッションはプロジェクトに属することも、どのプロジェクトにも属さないこともできます。サイドバーの **New chat** をクリックするとセッションを開始できます。終わったセッションはアーカイブでき、別の方向を試したいときはメッセージから新しいセッションをフォークできます。[セッションを開始する](https://docs.aihubmix.com/jp/cloud/sessions/start-a-session.md) と [セッションの管理](https://docs.aihubmix.com/jp/cloud/sessions/manage-sessions.md) を参照してください。

## プロジェクト

**プロジェクト** は、セッションが属するコードディレクトリまたはリポジトリです。次の 2 種類があります。

* **クラウドプロジェクト**：クラウドで作成する、GitHub からインポートする、またはコンピューターからアップロードしたプロジェクトです。クラウドサーバー上で実行され、環境を構成できます。
* **ローカルプロジェクト**：デスクトップアプリでリンクした、コンピューター上のフォルダーです。セッションはそのコンピューター上で実行され、フォルダーはクラウドに同期されません。

どのプロジェクトにも属さないセッションは、一時的な作業ディレクトリで実行されます。後からプロジェクトに移動できます。[プロジェクトと環境構築](https://docs.aihubmix.com/jp/cloud/environments/projects.md) を参照してください。

## クラウドサーバーとあなたのデバイス上での実行

**クラウドサーバー** は、Plus に含まれる、パブリック IP を持つ専用の Linux マシンです。クラウドサーバー上で実行中のセッションは、コンピューターの電源を切っても続行します。リモートデスクトップを開いてエージェントの操作を確認したり、自分で操作を引き継いだりできます。

**あなたのデバイス上での実行**（画面上の表示は **Run on your device**）は、もう 1 つの実行方法です。エージェント自体はクラウドにありますが、ファイルの読み書きとコマンドの実行は選択したコンピューター上で行われ、ローカルで実行した場合と同じ結果になります。そのコンピューターはデスクトップアプリにサインインし、**Allow execution** をオンにしておく必要があります。

| | クラウドサーバー | あなたのデバイス上 |
| - | - | - |
| 使用する環境とファイル | クラウドサーバー上のプロジェクトのコピーとプロジェクト環境 | そのコンピューター上の環境とプロジェクトフォルダー |
| 利用できるプロジェクト | クラウドプロジェクト、どのプロジェクトにも属さないセッション | そのコンピューター上のローカルプロジェクト、どのプロジェクトにも属さないセッション |
| 対応する Harness | すべて | 現在は Claude Code のみ |
| コンピューターの電源オフまたはオフライン時 | 影響なし | 現在のタスクが一時停止し、再接続後に自動的に再開 |

実行場所はセッションの作成時に選択し、後から変更することはできません。[クラウドサーバー](https://docs.aihubmix.com/jp/cloud/environments/cloud-host.md) と [あなたのデバイス上で実行する](https://docs.aihubmix.com/jp/cloud/environments/your-device.md) を参照してください。

## Harness とモデル

**Harness** は、Claude Code や Codex CLI などの、エージェントを実行するフレームワークです。**モデル** は、Harness が呼び出す大規模言語モデルです。セッションで最初のメッセージを送信した後は Harness を変更できませんが、モデルは変更できます。**推論レベル**（画面上の表示は **Effort**）は、モデルがどの程度深く考えるかを設定します。選択できるレベルはモデルによって異なります。[モデルの選び方](https://docs.aihubmix.com/jp/cloud/models/choose-a-model.md) を参照してください。

## モデルソース

**モデルソース** は、誰がモデルを提供し、使用量がどこで計上されるかを決めます。

| | Plus モデル | 自分のサブスクリプション | BYOK |
| - | - | - | - |
| 内容 | Plus プランに含まれるモデル | 自分の ChatGPT、Claude などのサブスクリプションアカウント | 自分で追加した API キー |
| 使用量の計上先 | Plus プラン（追加料金なし） | そのサブスクリプションアカウントの利用枠 | 対応するプロバイダー（そのプロバイダーの料金で請求） |

BYOK において、AIHubMix は一般的なゲートウェイプロバイダーの 1 つです。追加した AIHubMix の API キーは他のキーと同じ方法で請求され、Plus とは関係ありません。[モデルソース](https://docs.aihubmix.com/jp/cloud/models/model-sources.md) を参照してください。

## 権限

**権限** は、エージェントが操作を行う前にあなたに確認するかどうかを決めます。入力欄の左下で選択します。

* **Ask for approval**：環境外のファイルを変更する前や、インターネットにアクセスする前に、必ず確認します。
* **Approve for me**：安全でない可能性のある操作を検出した場合にのみ確認します。
* **Full access**：インターネットとクラウド環境内のすべてのファイルに制限なくアクセスします。新しいセッションではこのレベルがデフォルトです。

権限はセッション中いつでも変更できます。

## 対応が必要

エージェントが、コマンドの承認、質問への回答、シークレットの入力、またはサインインのようにエージェントが代わりに行えない操作をあなたに求めて停止すると、そのセッションは **対応が必要** な状態になります。リクエストは入力欄の上に表示され、サイドバーでもセッションに印が付きます。対応すると、セッションは自動的に続行します。[エージェントとの共同作業](https://docs.aihubmix.com/jp/cloud/sessions/work-with-agent.md) を参照してください。

## サブエージェント

**サブエージェント** は、エージェントが同じセッション内で起動し、作業の一部を並行して処理させる補助役です。すべて完了すると、結果はメインのセッションに統合されます。各サブエージェントの作業過程は右側パネルで確認できますが、サブエージェントに直接メッセージを送ることはできません。サブエージェントは、手動でフォークしたセッションとは異なります。フォークすると、独立した通常のセッションが作成されます。[サブエージェント](https://docs.aihubmix.com/jp/cloud/sessions/subagents.md) を参照してください。

## 画面の概要

* **アイコンバー**：ウィンドウの左端にあるアイコンの列です。Cloud Tasks、Scheduled、Projects、Cloud servers、Activity を切り替えます。下部のアバターからアカウントメニューを開きます。
* **サイドバー**：セッションの一覧で、Pinned、Cloud projects、Local projects、Recents にグループ分けされています。
* **セッションエリア**：ウィンドウ中央のメインエリアです。あなたとエージェントのメッセージ、エージェントの手順、結果を表示します。
* **入力欄**：セッションエリアの下部にあります。メッセージの送信、添付ファイルの追加、モデル、推論レベル、権限の選択を行います。
* **右側パネル**：変更内容、ファイル、Web プレビュー、クラウドサーバーのリモートデスクトップ、サイドチャット、サブエージェントはすべてここに表示されます。

> [!NOTE]
>
> モバイル Web にはアイコンバーがありません。同じ項目はサイドバーの下部にあります。右側パネルを開くと、ページ全体に表示されます。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.