マシンを管理する

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

​

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

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

​

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

Cognoのデスクトップアプリで設定 → コンピューターを開くと、このコンピューターでサインインできます。 先にTaskを作る必要はありません。 このコンピューターで実行できる場合、サインインにはCognoの同梱CLIを使います。 同梱版を使えない場合は、このコンピューターのエージェント設定で選択したCLIを使います。カスタムパスも対象です。 実行ファイルの設定に対応していない古いEngineでは、インストール済みのCLIを使います。 これはデスクトップアプリを開いているコンピューターへのサインインです。ブラウザではローカルのサインイン欄は表示されません。 別のコンピューターで実行するTaskは、そのコンピューターでサインインしてください。 Taskでエージェントを動かすを参照してください。

​

実行アクセスを管理する

あなたのマシン の各マシンには、2つのアクセス設定があります。 それぞれに 承認を求める、Workspace 内で自動、フルアクセス のいずれかを選びます。ユーザー開始時の設定はマシン側の上限です。各Sessionにもcomposerの Session のアクセス権限 があり、Engineは2つのうち制限が強い方を使います。自律実行の設定は無人キューターンを直接制御します。 古いEngineは安全な Workspace 内で自動 の境界を維持し、フルアクセス を選択できません。Sessionのアクセス制御を使う前にEngineを更新してください。

​

Engineを動かし続ける

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

​

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

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

​

リファレンス

​

振り分け

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

​

Engineの状態

​

マシンの状態

​

トラブルシューティング

ここに無いものはトラブルシューティングを参照してください。

​

関連ドキュメント

• Agent run中のアクセス制御を理解する
• 自分のサーバーでCognoを動かす
• エンタープライズのリモート実行
• projectを用意する
• APIキーを作る