APP クイックスタート

デスクトップ APP をゼロからインストールし、最初のタスクを完了するまで、約 10 分かかります。

なぜデスクトップ APP を使うのか

Web 版はワークスペースの「リモコン」であり、デスクトップ APP こそが真の「実行端末」です。以下のことができるのは APP 端末だけです。

✅ ローカルファイルの読み書き（ディレクトリの整理、レポートの生成、コードの修正）
✅ Shell コマンドの実行（npm install、git 操作、スクリプトの実行）
✅ IM チャネルへの接続（Telegram、DingTalk、Feishu、Teams など 14 以上のプラットフォーム）
✅ 定時タスクの作成（毎日自動実行、Cron 式、通知プッシュ）
✅ LLM モデルの設定（複数の API Key、能力タグ）
✅ MCP ツールのインストール（AI 能力の拡張）
✅ サンドボックス実行（信頼できないコードを隔離して実行）
✅ アカウントメモリの管理（閲覧、編集、グラフによる可視化）

Web 版はインターフェースがより軽量ですが、すべての「実際に手を動かす」能力は少なくとも 1 台の APP ノードによって提供される必要があります。

ステップ 1 · ダウンロードとインストール

インストールパッケージの取得

入手元	説明
Web 版のダウンロードボタン	Web 版（`https://www.gptbots.ai/workspace`）にログインし、左下の ⬇️ `APP Download` ボタンから最新のインストールパッケージを取得します
内部配布	エンタープライズ版ユーザーには専用のダウンロードリンクがある場合があります。管理者にお問い合わせください

プラットフォームサポート

プラットフォーム	ファイル	インストール方法
macOS（Intel / Apple Silicon）	`.dmg`	ダブルクリックで開き、Applications にドラッグします
Windows	`.exe` または `.msi`	ダブルクリックしてインストーラーを実行します
Linux	`.AppImage`	実行権限を付与してから直接実行します

ステップ 2 · 起動とログイン

アプリケーション一覧または Launchpad から Workspace（macOS）/ Workspace（Windows）を見つけて起動します
初回起動時にログイン画面が表示されます
Web 版と同じエンタープライズアカウント（メールアドレス/電話番号/SSO）でログインします
ログインに成功すると、APP は自動的に ノードとして Gateway に登録 されます

スクリーンショット位置

ログイン後、デフォルトで Work 対話ページに入ります。左側のメニューは順に Work / Search / ワークフロー / エージェント であり、下部には ⚙️ 設定 / 🌐 言語 / 🟢 ユーザーアバター があります。

ステップ 3 · LLM モデルを 1 つ設定する

Agent が動作するには少なくとも 1 つの LLM が必要です。デスクトップ APP には独自の「モデル設定」機能があり、API Key を提供する必要があります。

推奨される第一選択：Claude Sonnet 4

左下の ⚙️ 設定 をクリックします
左側のメニューで モデル を選択します
+ モデルを追加 をクリックします
プロバイダー Anthropic を選択します
Anthropic API Key を貼り付けます（https://console.anthropic.com から取得）
モデル claude-sonnet-4 または claude-3-5-sonnet を選択します
保存します

モデル選定早見表

ニーズ	推奨
日常対話、コスト重視	GPT-4o-mini / Qwen-plus
複雑な推論、長文ドキュメント	Claude Opus 4 / Claude Sonnet 4
コード開発	Claude Sonnet 4 / DeepSeek-chat
超長コンテキスト	GPT-4.1（1M）
中国語タスク	Qwen-max

詳細な選定の提案と能力マトリクスについてはモデル設定およびサポートされているモデル一覧を参照してください。

ステップ 4 · 初めての対話

Work（左側メニューの最初の項目）に戻ります。

入力ボックスの下に以下が表示されます：
- ノード名：Workspace (あなたのコンピュータ名)
- モデル：先ほど設定したモデル
- 作業ディレクトリ：デフォルトはホームディレクトリ（クリックで切り替え可能）
タスクを入力します（例：デスクトップ上のすべてのファイルを一覧表示して）
Enter を押して送信します

Agent は以下を行います：

自動的に List Directory ツールを呼び出します
実行プロセスをリアルタイムでストリーミング表示します
完了後に結果を出力します

ステップ 5 · 本物のツール呼び出しを試す

より複雑なタスクを試して、Agent Loop を体感してみましょう。

シンプルなタスク

デスクトップに hello.txt ファイルを作成して、内容は「Hello from Workspace」にして

                      
                      デスクトップに hello.txt ファイルを作成して、内容は「Hello from Workspace」にして

このコードブロックをポップアップで表示

→ Agent が Write File ツールを呼び出し、自動的にファイルを作成 します

確認が必要なコマンド（初回はポップアップが表示されます）

デスクトップに demo ディレクトリを作成して、git リポジトリとして初期化して

                      
                      デスクトップに demo ディレクトリを作成して、git リポジトリとして初期化して

このコードブロックをポップアップで表示

→ Agent が Bash（P1 レベルのツール、初回は権限確認ウィンドウがポップアップします）を呼び出します
→ コマンドを確認したうえで「許可」または「常に許可」をクリックします

複数ステップのタスク（Agent Loop を体験する）

デスクトップのファイルを整理してください： 1. 拡張子で分類（画像 / ドキュメント / コード / その他） 2. 各分類ごとにサブディレクトリを作成 3. ファイルを対応するディレクトリに移動

                      
                      デスクトップのファイルを整理してください：
1. 拡張子で分類（画像 / ドキュメント / コード / その他）
2. 各分類ごとにサブディレクトリを作成
3. ファイルを対応するディレクトリに移動

このコードブロックをポップアップで表示

→ Agent は自動的に複数のステップに分解します：ファイルの一覧表示 → 分類 → ディレクトリの作成 → ファイルの移動
→ 対話の中で各ステップのツール呼び出しを確認できます

ステップ 6 · 自動化能力を有効にする

ここまでで基本的な能力を使えるようになりました。次は APP 独自の「スーパーパワー」です。

🤖 定時タスク（Agent を定期的に自動実行させる）

設定 → 定時タスク → 新規作成。詳しくは定時タスクを参照してください。

💬 IM チャネル（チームがグループチャットで AI を使えるようにする）

設定 → チャネル → Telegram / DingTalk / Feishu などを選択し、手順に従って設定します。詳しくはチャネル設定を参照してください。

🧩 MCP ツール（さらに多くの能力を拡張する）

設定 → ツール → MCP ツールエリア → MCP サーバーを追加。詳しくはツール管理を参照してください。

🧠 サブエージェントの事前登録（専門的な役割を設定する）

設定 → サブエージェント → 新規作成（例：「コードレビュアー」「ドキュメント作成者」）。詳しくはサブエージェント管理を参照してください。

🛡️ ランタイムセキュリティ（ツールの権限レベルを調整する）

設定 → ランタイムセキュリティ → Bash/Web Fetch などのツールの P0/P1/P2 レベルを調整します。詳しくはランタイムセキュリティを参照してください。

ステップ 7 · AI にあなたを覚えてもらう

対話の中で次のように伝えます：

覚えておいてください。私はコードを TypeScript で書くのが好みで、コードスタイルは 2 スペースのインデントを使います。

                      
                      覚えておいてください。私はコードを TypeScript で書くのが好みで、コードスタイルは 2 スペースのインデントを使います。

このコードブロックをポップアップで表示

Agent は memory_manage ツールを呼び出して アカウントメモリ に書き込みます。次回新しい対話を作成すると、この好みが自動的に注入され、Agent は自然にあなたの好みに沿って返答します。

APP → 設定 → メモリで、すべてのメモリを閲覧、編集、削除でき、グラフによる可視化 で知識ポイント間の関連性を確認することもできます。詳しくはメモリ管理を参照してください。

よくある質問

Q：Web 版はどうやって APP がオンラインになったことを知るのか

Web 版 → スペース管理 → Work メニューでノード一覧を確認します。あなたの APP は Agent タイプのノードとして表示されるはずです。表示されない場合は、APP がログイン済みで、ネットワークが正常であるかを確認してください。

Q：チームの同僚も私のこの APP を使えるようにする

APP ノードを enterprise 範囲に設定します：

APP → 設定 → ランタイムセキュリティ → ノード
ノードの可視性を エンタープライズ（enterprise）に変更します
同じ組織のメンバーが自分の Web 版でこのノードを確認し、呼び出せるようになります

注意：enterprise に設定すると、同僚のタスクがあなたのコンピュータ上で実行される可能性があることを意味します。これにはファイルの読み書きやコマンドの実行が含まれます。チームメンバーを信頼できることを確認してください。

Q：APP は複数起動できるか

同一アカウントでの複数起動は推奨しません。複数のノード登録が発生し、ルーティングの混乱を引き起こす可能性があります。複数デバイスでの連携が必要な場合は、1 台のデバイスにつき 1 つの APP としてください。

Q：オフラインで使用できるか

ほとんどの機能は Gateway と LLM API への接続が必要であり、オフラインでは使用できません。将来的には一部のローカルオフライン能力（ローカル LLM など）がサポートされる可能性があります。

次のステップ

APP 設定を全体的に理解したい → APP 設定概要
高度な使い方を学びたい → 対話インタラクション、サブエージェント
組織を管理したい → スペース管理概要