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

# マシンを管理する

> 設定 → コンピューター — このコンピューターのEngine、environment、登録したサーバー、そしてrunの振り分け方。

**マシン** とはエージェントの作業を実行できるコンピューターのことです — デスクトップアプリを入れたあなた自身のコンピューターか、ワークスペースが登録したサーバーです。**設定 → コンピューター** は、マシンの準備ができているかを見て、そこで作業を動かすEngineを操作し、ワークスペースがどのマシンに届くかを確認する場所です。environment（projectが動くフォルダー）は各projectから設定し、サーバーの登録は専用のページを持ちます。

> [!NOTE]
>
> **設定 → コンピューター** の大半は、いま座っているコンピューターを管理するものなので、Cognoのデスクトップアプリが必要です。ブラウザで開いた場合は **あなたのマシン** の一覧だけが表示されます。
> **このマシン**、**起動とバックグラウンド**、サーバーの登録を見るには、デスクトップアプリからこのページを開いてください。

## コンピューターのページにあるもの

公開デモの `/demo` はサンプルのマシンを使います。デモを開いても、このコンピューターの再登録、Engineの認証情報の削除、保存済みサーバーへの再接続は行いません。元のWorkspaceに戻ると、通常のマシン登録確認が再開します。

| セクション | 何をするか |
| - | - |
| **このマシン** | いま使っているコンピューターの **Engine** の状態 — 登録済みか、接続できているか、実行準備はどうか。**開始** / **停止** / **再起動** の操作もここです。 |
| **起動とバックグラウンド** | **ログイン時に Cogno を開く** — サインインした時点でCognoをメニューバーに常駐させ、ウィンドウを開いていなくても作業が動くようにします。 |
| **あなたのマシン** | あなたのアカウントでサインインしているすべてのコンピューター。通信できているかどうかが出ます。 |
| **サーバー** | ワークスペースが登録したサーバーと、sshで新たに登録するための **新しいサーバーをセットアップ**。 |

## Taskを作る前にClaude Codeにサインインする

Cognoのデスクトップアプリで**設定 → コンピューター**を開くと、このコンピューターでサインインできます。
先にTaskを作る必要はありません。

**1. エージェントを選ぶ**

**エージェント**で**Claude Code**または**Codex**を選びます。

**2. サインインを開く**

**サインイン**の行で**サインイン**を選びます。
このコンピューターのエージェントの実行ファイルを読み込めるまでは、ボタンを使えません。

**3. ターミナルで完了する**

開いたターミナルでproviderのログインを完了してください。
ターミナルが開いただけではサインイン済みにはなりません。
ターミナルを開けない場合はエージェントの設定にエラーが出るので、再試行できます。

このコンピューターで実行できる場合、サインインにはCognoの同梱CLIを使います。
同梱版を使えない場合は、このコンピューターのエージェント設定で選択したCLIを使います。カスタムパスも対象です。
実行ファイルの設定に対応していない古いEngineでは、インストール済みのCLIを使います。

これはデスクトップアプリを開いているコンピューターへのサインインです。ブラウザではローカルのサインイン欄は表示されません。
別のコンピューターで実行するTaskは、そのコンピューターでサインインしてください。
[Taskでエージェントを動かす](/docs/ja/agents.md)を参照してください。

## 実行アクセスを管理する

**あなたのマシン** の各マシンには、2つのアクセス設定があります。

| 設定 | 適用対象 |
| - | - |
| **ユーザー開始時の上限** | このマシンでユーザーが開始または継続するSession。 |
| **Cogno 自律実行のアクセス権限** | このマシンで実行する無人キューターン。 |

それぞれに **承認を求める**、**Workspace 内で自動**、**フルアクセス** のいずれかを選びます。ユーザー開始時の設定はマシン側の上限です。各Sessionにもcomposerの **Session のアクセス権限** があり、Engineは2つのうち制限が強い方を使います。自律実行の設定は無人キューターンを直接制御します。

> [!WARNING]
>
> **フルアクセス** では、ネイティブ承認なしでSessionのWorkspace外にあるファイルの変更やコマンド実行が可能です。EngineのOSアカウントから利用できるファイルや認証情報にアクセスする可能性もあります。Cognoは有効化前に確認を求めます。ユーザー不在でも開始できる自律実行では、特に注意してください。

古いEngineは安全な **Workspace 内で自動** の境界を維持し、**フルアクセス** を選択できません。Sessionのアクセス制御を使う前にEngineを更新してください。

## Engineを動かし続ける

**Engine** は、マシン上でエージェントの作業を実行する常駐ランタイムです。**このマシン** の下に、その状態が **動作中**・**停止済み**・**起動していません** のいずれかで表示され、**開始**・**停止**・
**再起動** の操作が並びます。

> [!NOTE]
>
> ウィンドウを閉じたり**Quit Cogno**を選んだりしても、Engineは動き続けます。このマシンでのエージェントの作業を止めるには、**このマシン → 停止**を使ってください。**起動とバックグラウンド → ログイン時に Cogno を開く**を有効にすると、サインイン時にCognoが開きます。

macOSでは、バックグラウンドのエージェントを含め、エージェントが作業している間はEngineが自動スリープを抑止します。設定の変更や追加の権限許可は必要ありません。すべての作業が止まると通常の自動スリープに戻り、将来の実行予約を待っているだけではスリープを抑止しません。画面の消灯とロックは引き続き可能です。蓋を閉じたり手動でスリープさせたりすると、作業が中断することがあります。

2分間報告が途絶えたマシンは **オフライン** とみなされ、そのマシンに振り分けられたrunは戻ってくるまでqueueで待ちます。

## 実行準備の行を読む

**このマシン** には **実行準備** の行があります。**準備完了** と出ていれば、そのマシンは作業を引き取れます。そうでないときは、何が妨げているかが具体的に並びます。たとえば次のようなものです。

* Claude CodeとCodexのどちらも利用できない、またはproviderがサインアウトしている —
  修正方法として `claude auth login` または `codex login` が表示されます
* **git** や **Node.js** が無い
* **GitHub CLI** がサインアウトしている
* ディスクの空きがほとんど無い

行が名指ししたものを直せば、次のチェックインで **準備完了** に戻ります。新しいrunでは正常に使えるCLIを選び、両方が使える場合もどちらかを優先しません。**リセットして再登録** はCognoのマシン認証情報に使います。コーディングエージェントがサインアウトしている場合は、実行準備の詳細に表示されたprovider固有のログインコマンドを実行してください。

## environmentはproject側にある

**environment** は、マシン上のフォルダーと、そこで作業が動く設定（AIツール、model）です。
**設定 → コンピューター** はこのマシンが*登録した*フォルダーを表示しますが、projectのフォルダーをここで追加することはありません — メンバーはそれぞれ **projectの** 設定から自分のフォルダーをつなぎます。フォルダーの接続やrepositoryのcloneは
[projectを用意する](/docs/ja/projects.md)を参照してください。

## サーバーでマシンを動かす

自分が座っていないマシン — LinuxのマシンやクラウドのVM — で作業を動かすには、サーバーとして登録します。**新しいサーバーをセットアップ** がsshでの登録を案内し、サーバー上の `cogno doctor`
が各チェック項目とそれを直すコマンドを報告します。全体の流れは
[自分のサーバーでCognoを動かす](/docs/ja/remote-servers.md)を、台数の多い構成は
[エンタープライズのリモート実行](/docs/ja/enterprise-remote-execution.md)を参照してください。

## リファレンス

### 振り分け

runがどのマシンとディレクトリに着地するかの決まり方です。

| 選択 | 振り分けの挙動 |
| - | - |
| **自動** | taskの担当者と、ワークスペースで使えるマシンから選びます。 |
| 一覧から選んだenvironment | そのenvironmentのマシンとディレクトリへrunを送ります。明示した選択は担当者による振り分けより優先されます。 |

一度runしたtaskはそのenvironmentを保つので、以後のrunも同じマシン・同じディレクトリに着地します。多数の依頼が一度に届いたときは、マシンに振り分け済みでまだ開始していない作業も負荷として数えるので、1台に並ばず複数のマシンに分散します。run自体が辿る状態（pending → claimed → running → completed）は
[taskでエージェントを動かす](/docs/ja/agents.md#実行の状態)を参照してください。

### Engineの状態

| 状態 | 意味 |
| - | - |
| **動作中** | Engineが動いていて、作業を引き取れます。 |
| **停止済み** | Engineは停止されていて、開始するまで作業を引き取りません。 |
| **起動していません** | このコンピューターにEngineがいません。 |

### マシンの状態

| 状態 | 意味 |
| - | - |
| **通信中** | 直近2分以内に報告あり。作業を振り分けられます。 |
| **通信が途絶えています** | 2分以上報告なし。振り分けられたrunはqueueで待ちます。 |

## トラブルシューティング

| 症状 | 考えられる原因 | 対処 |
| - | - | - |
| ブラウザでは一覧しか出ない | デスクトップアプリではなくブラウザで開いている | Cognoのデスクトップアプリから **設定 → コンピューター** を開くと **このマシン** 以下が見えます。 |
| マシンが作業を引き取らない | Engineが停止、オフライン、または **準備完了** でない | **このマシン** を確認します — Engineを開始し、ネットワークとチェックインの状況を確かめ、**実行準備** の行が名指ししたものを解消します。 |
| projectに動かすフォルダーが無い | このマシンでenvironmentをつないでいない | ここではなくprojectの設定からフォルダーをつなぎます。[projectを用意する](/docs/ja/projects.md)を参照。 |
| 認証情報が拒否・失効した | マシンの認証情報が無効になっている | **リセットして再登録** を使うか、**このマシン** からもう一度サインインします。 |

ここに無いものは[トラブルシューティング](/docs/ja/troubleshooting.md)を参照してください。

## 関連ドキュメント

* [Agent run中のアクセス制御を理解する](/docs/ja/execution-access.md)
* [自分のサーバーでCognoを動かす](/docs/ja/remote-servers.md)
* [エンタープライズのリモート実行](/docs/ja/enterprise-remote-execution.md)
* [projectを用意する](/docs/ja/projects.md)
* [APIキーを作る](/docs/ja/api-keys.md)


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