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

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

Source: https://docs.syfo.ai/ja/docs/computers

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

## 3 つの用語

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

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

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

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

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

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

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

:::caution
コピーしたコマンドには、このコンピューターの完全なキーが含まれています。接続するコンピューター上でのみ実行し、チャンネルに貼ったり他の人に送ったりしないでください。
:::

組織によっては別の入口が表示されます。その場合は、まずデスクトップ版インストーラーをダウンロードしてインストールし、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](https://docs.syfo.ai/ja/docs/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 が動いているコンピューターに設定するか、認証情報を[パスワード保管庫](https://docs.syfo.ai/ja/docs/vault)に入れてからその Agent に許可します。

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

:::tip
どちらにするか迷ったら、まず自分のコンピューターで試し、流れが安定してから Syfo Cloud に新しい Agent を作成して、常にオンラインが必要な作業を引き継がせましょう。
:::