コンピューターと実行場所

Agent を Syfo Cloud で動かすか自分のコンピューターで動かすか、そしてコンピューターを Syfo に接続する方法を説明します。

どの Agent にも、動くための場所が必要です。どこで動くかによって、使えるツール、アクセスできるファイル、常にオンラインでいられるかどうかが決まります。

3 つの用語

用語	意味
実行場所	Agent を作成するときに最初に選ぶ項目です。Syfo Cloud（Syfo がホスト）か自分のコンピューター（あなたが接続したコンピューター。ウィザードでは「自分のコンピューター」と表示）のどちらかです。
コンピューター	組織に接続済みで、Agent を実行できるマシンです。組織ナビゲーションの「コンピューター」にすべてのコンピューターが一覧表示され、「自己管理型コンピューター」と「Syfo がホストするクラウドコンピューター」の 2 つのグループに分かれます。1 台のコンピューターで複数の Agent を実行できます。
ランタイム	Agent が実際の作業に使う AI コーディングツールです（Claude Code、Codex など）。自分のコンピューターで使う場合は、先にそのコンピューターにランタイムをインストールしてログインしておく必要があります。

Syfo Cloud と自分のコンピューターの選び方

	Syfo Cloud	自分のコンピューター
オンライン状態	Syfo がホストし、常にオンライン。スマホからもウェブからも使えます	コンピューターの電源が入り、ネットワークにつながり、Syfo のバックグラウンドサービスが動いているときだけオンライン
アクセスできるもの	ホスト環境のため、あなたのコンピューターの設定は自動では引き継がれません。必要な認証情報はパスワード保管庫から許可します	そのコンピューター上のコードリポジトリ、コマンドラインツール、ログイン状態、ローカルファイルを直接使えます
作成できる人	組織の Owner と Admin は直接作成できます。一般メンバーは「申請の目的」を入力し、承認者として Owner または Admin を 1 人選んで申請を送信します	接続済みでオンラインのコンピューター上で作成します。誰がどのコンピューターを使えるかは権限の説明を参照してください
課金方法	実行環境の料金に応じて組織クレジットが差し引かれます。会話や作業時のモデル料金は別途差し引かれます	実行環境の料金はかかりません。モデル料金は自分のアカウントまたはキーで支払うか、「組織クレジット」を選ぶこともできます（後述）
向いている用途	スケジュール済みタスク、常にオンラインが必要な運用やカスタマーサポートの Agent、環境を自分で保守したくないチーム	開発やデバッグ、ローカルファイルや手元のツールが必要な作業

作成ウィザードでは Syfo Cloud に「おすすめ」が付いています。あなたのロールで Syfo Cloud を使えない場合は、カードに「管理者のみ」と表示されます。組織に使える残高がない場合は Cloud Agent を作成できず、先にチャージするよう案内が表示されます。クレジットの入手方法と消費のされ方は使用量と請求を参照してください。

コンピューターを接続する

コンピューターの接続は 1 回だけで済み、その後はそのコンピューター上で複数の Agent を作成できます。

組織ナビゲーションの「コンピューター」を開き、「コンピューターを追加する」をクリックします。Agent の作成時に「自分のコンピューター」を選び、コンピューター一覧で「新しいコンピューターを追加する」を選ぶこともできます。
ダイアログにインストールコマンドが生成されます。まずプラットフォーム（macOS / Linux または Windows）を選び、「コピーコマンド」をクリックします。
接続したいコンピューターでターミナルを開き、コマンドを貼り付けて Enter キーを押します。コピーしただけで実行しなければ、コンピューターは接続されません。
ダイアログに戻ると「コンピューターの接続を待機しています…」と表示され、自動で検出が行われます。接続に成功すると「コンピューターは正常に接続されました。」と表示されます。
わかりやすい「コンピューター名」を付けて、「完了」をクリックします。

組織によっては別の入口が表示されます。その場合は、まずデスクトップ版インストーラーをダウンロードしてインストールし、Syfo を開いて「組織に接続」をクリックしてから、ブラウザで承認します。サーバーや GUI のないマシンでは、「詳細設定：コマンドラインからインストール（サーバー / GUIなし）」を展開し、コマンドラインでインストールしてください。

コマンドは何度実行しても問題ありません。そのコンピューターに Syfo がすでにインストールされている場合、コマンドは現在の組織を追加するだけで、接続済みの他の組織には影響しません。

数分経っても「このコンピューターはまだ検出できませんでした。」と表示される場合は、まずインストールコマンドが最後までエラーなく実行されたか確認し、次にダイアログに示されたコマンドでバックグラウンドサービス（daemon）の状態とログを確認してください。「もう一度試す」をクリックすることもできます。

オフラインと再接続

コンピューターの電源が切れたり、ネットワークが切れたり、バックグラウンドサービスが停止したりすると、そのコンピューターは「オフライン」と表示され、そこで動く Agent も作業を一時停止します。

オフラインのコンピューターでは新しい Agent を作成できず、そこにある Agent の起動や再起動などの操作もできません。
Syfo のウェブ版から、コンピューターの電源を遠隔で入れたり、停止したバックグラウンドサービスを遠隔で起動したりすることはできません。そのコンピューター上で起動コマンドを実行してください（コンピューター詳細ページの「ローカルデーモンコマンド」に記載されています）。
コンピューターが再接続されると「オンライン」に戻ります。Powerpack のインストールなど、すでに送信済みのバックグラウンド操作は、再接続後に続行されます。

Syfo Cloud のコンピューターは Syfo が保守するため、ホストにログインする必要はありません。Agent が応答しない場合は、コンピューター詳細ページで「Syfoクラウドを再起動する」をクリックできます。再起動すると実行中のタスクは中断され、その後 Agent は自動で再接続されます。

コンピューターを管理する

「コンピューター」でコンピューターを開くと、オンライン状態、コンピューターの種類、OS、検出済みのランタイム、そこで動いている Agent を確認できます。

エージェントを再起動します：このコンピューター上の Agent を選択して、まとめて再起動するか、「リセットと再起動」を行います。
デーモンの更新：バックグラウンドサービスの更新を確認して適用します。更新できるのは組織の Owner と Admin だけです。更新するとバックグラウンドサービスが再起動するため、実行中の Agent が一時的に中断されることがあります。
コンピューターの削除：先にこのコンピューター上のすべての Agent を削除する必要があります。
パワーパック：このコンピューター上のすべての Agent に拡張機能をインストールします。詳しくは Powerpack を参照してください。

自分のコンピューターで使えるランタイム

自分のコンピューターでは、Agent はそのコンピューターにインストールしてログイン済みのランタイムを使って作業します。

対応：Claude Code、Codex CLI、Gemini CLI
Beta：Kimi Code、DeepSeek Reasonix、DeepSeek Harness、CodeBuddy / WorkBuddy、Grok Build、Pi Coding Agent

Agent を作成するときに選べるのは、そのコンピューターが利用可能と報告しているランタイムだけです。それ以外は「サポートされていますが、インストールされていません」の下に一覧表示され、設定ガイドが付いています。

自分のコンピューターで組織クレジットを使う

デフォルトでは、自分のコンピューターで動く Agent は、そのコンピューター上のランタイムのアカウントまたはキーを使います。組織でこの機能が有効になっている場合は、組織クレジットで支払うように切り替えることもでき、その場合はコンピューターにキーを設定する必要がありません。

選ぶ場所：Agent の作成時に「モデルの支払い」で「組織クレジット」を選びます。既存の Agent は詳細ページの「モデルの支払い」で変更できます。
Codex のみ対応：このオプションは Codex ランタイムでのみ利用でき、さらにそのコンピューターで管理対象 Codex の設定を先に完了しておく必要があります（画面の案内：このコンピューターで最新の Syfo セットアップを実行してください）。完了していない場合は「このコンピューターは組織クレジットの準備ができていません」と表示されます。
使える人：Owner と Admin は直接選べます。一般メンバーは申請を送信し、Owner または Admin の承認を受ける必要があります。既存の Agent を組織クレジットに切り替えるには、「変更申請を送信」をクリックします。
このオプションが表示されない場合：組織でまだ有効になっていません。画面には「この組織では組織クレジットが有効になっていません。」と表示されます。

権限は実行場所に従う

Agent に何ができるかは、それが動いている場所に何があるかで決まります。

コードリポジトリがなければ、Agent はそれを変更できません。
コマンドラインツールがなければ、Agent はそれを呼び出せません。
外部システムに token が必要な場合は、Agent が動いているコンピューターに設定するか、認証情報をパスワード保管庫に入れてからその Agent に許可します。

すべての権限を 1 台のコンピューターに集めず、作業の範囲ごとに Agent とコンピューターを分けることをおすすめします。誰がコンピューターを管理でき、誰が Agent を再起動できるかは権限の説明を参照してください。