デスクトップ版エージェント:複数のコーディングエージェントを並行で動かす
デスクトップ版で Claude Code や Codex などを並行実行。タスクごとのワークツリー、実際のターミナル、通知、レビュー、マージや PR、目標を分担するプロジェクト。
%BRAND% デスクトップ版のエージェントは、自分で AI を動かすのではなく、パソコンに入っている AI コーディングエージェント(Claude Code、Codex CLI、Gemini CLI、Cursor Agent、GitHub Copilot CLI、opencode、Aider、または自分のコマンド)に仕事を任せます。複数を同時に、互いに干渉せずに動かし、必要なときだけ呼びます。
1 タスク = 1 ワークスペース
- サイドバーのエージェント →新しいタスク(ランチャーの「Claude Code に頼む:…」でも可)。
- フォルダを選びます。git リポジトリなら専用のワークスペースが既定でオン:
git worktreeで、選んだブランチから新しいブランチ(ws/…)と別のコピーを作り、エージェントはそこで作業します。並行して動かしても上書きし合わず、元のフォルダはそのままです。 - エージェントを選び、内容を書いて権限を選び、開始(Ctrl + Enter / ⌘↵)。
エージェントはタスクのターミナルで、自分の対話画面のまま実際に動きます(ターミナルで claude と打つのと同じ)。ファイルの編集やコマンドの実行の前にはそこで確認してくるので、ターミナルをクリックして答えたり、指示を足したり、操作を代わったりできます。
ボードと通知
ボードではタスクを 待機 / 実行中 / あなたの番 / レビュー待ち / 完了 に分け、カードに最新の出力行・時間・使用量を表示します。
- 承認待ち・ひと区切り・失敗のときはシステム通知を出し、サイドバーの「エージェント」にバッジを付けます。
- Claude Code と Codex は公式のフック(hooks / notify)で正確に状態を伝えます。ほかのエージェントはターミナルの出力から判断します(出力が止まったら返事待ち)。
- 同時に動かす数は「エージェントと設定」で 1〜8 から選べます。超えた分は待機し、返事待ちは数えません。
レビュー・テスト・マージ
タスクには 3 つのタブがあります。
- ターミナル:エージェント本体。
- 変更:開始時点からのすべての変更(未コミットや新しいファイルも含む)をファイルごとに表示。かたまりごとに取り消す(ワークスペースで元に戻す)か確認済みにできます。ファイル全体も取り消せます。
- シェル:ワークスペースで自分のシェルを開きます。上の欄にテストのコマンド(
npm testやcargo testなどを自動で推測)を入れて「テストを実行」。
確認したら:
- コミット:ワークスペースの変更をタスクのブランチにコミット。
- main にマージ(または開始したブランチ):元のフォルダで
git merge --no-ff。元のフォルダがそのブランチで、未コミットの変更がないときだけ行い、コンフリクトがあれば中止して何も変えません。 - プッシュして PR を作成:先に確認してから、パソコンの
git pushとgh pr createを使います(gh がなければ GitHub の比較ページを開きます)。自分の git / gh のログインを使い、私たちのサーバーは通りません。 - 「…」から タスクをアーカイブ すると一覧から非表示になり、ワークスペース・ブランチ・履歴・添付ファイルは保持します。「アーカイブ」で解除できます。
- 空き容量を増やすには 履歴を残してワークスペースを削除 を選びます。ターミナル履歴、レビュー資料、画像、関連する PR は確認でき、未マージのブランチは元のリポジトリに残ります。タスクの記録も不要な場合は、タスクとワークスペースを削除します。
- 先にタスクを停止し、テスト用シェルを終了して、所属するプロジェクトを完了してください。未コミット・未追跡・無視されたファイル(依存パッケージのフォルダなど)があれば削除を中止します。フォルダ内で整理してください。強制削除はしません。
- 既存の PR を関連付け では、このリポジトリの GitHub PR の URL を入力できます。空欄で関連付けを解除します。PR 作成時は同じ作成元・作成先ブランチの公開中 PR を優先します。GitHub の比較ページは PR として保存しません。
タスクをまとめて整理する
デスクトップ版 1.20.0 から、詳細を一つずつ開かずに整理できます。
- ボードまたはアーカイブでタスク・リポジトリ・結果を検索し、状態やエージェントで絞り込みます。
- チェックボックスで選ぶ(Shift クリックで範囲選択、⌘ / Ctrl クリックでカードを追加)か、表示中の範囲をすべて選択します。実行中のタスクも選べますが削除専用で、アーカイブは終了したタスクだけが対象です。テスト用シェルが開いている場合やプロジェクトが未完了の場合などはアーカイブを中止し、対象の一つでも条件に合わなければ全件を元の状態に保ちます。
- 選択したタスクをまとめてアーカイブし、アーカイブ画面からまとめて解除できます。操作後は取り消すこともできます。
検索や絞り込みを変えると選択が解除され、非表示のタスクへの誤操作を防ぎます。ワークスペース、ブランチ、履歴、画像、レビュー資料は保持します。空き容量を増やす操作は「履歴を残してワークスペースを削除」から別に行います。保存に失敗した場合は元の状態と選択が残り、再試行できます。
削除とクリーンアップ
デスクトップ版 1.23.3 から、実行中のものも含め、どのタスクでも削除できます。
- タスク画面右上の「⋯」→「タスクを削除」、またはボードやアーカイブで複数選択して「選択したものを削除」。
- 確認画面に、実行中のエージェントとターミナルを先に停止し、ワークスペース(未コミットの変更も含む)、ターミナルの記録、フック、レビューのスクリーンショット、添付ファイルを削除すること、解放されるおおよその容量が表示されます。未マージのコミットがあるブランチは既定で残し、ワークスペースだけ削除します。「未マージのブランチも削除する」をオンにすると一緒に削除します。一度確認すれば実行されます。
- まとめて片付けるときはボード上部の「クリーンアップ…」。条件(完了、停止、失敗、N 日以上動きなし、不要になったデータ)を選ぶと、件数と解放される容量を先に表示します(詳細も開けます)。確認すると進行状況つきで実行します。削除できなかったもの(別のアプリが使用中のファイルなど)は飛ばして結果に表示し、ほかは削除します。
不要になったデータは、以前のバージョンが残して今は使われていないものです。どのタスクにも属さないワークスペース、存在しないタスクの記録や証拠、使われていない添付ファイル、読み込めないプロジェクトフォルダ、Loops がプロジェクトに統合された後の旧 Loops のデータ、プロジェクトが削除されたタスクが該当します。
使用容量:「エージェントと設定」の一番上で、ワークスペース、ターミナルの記録、レビューの証拠、添付ファイル、セッションデーモン、プロジェクト、バックグラウンド実行ごとに表示し、容量の大きいタスクも一覧にします。ボードのカードに各タスクのサイズを表示し、絞り込みバーで「容量の大きい順」に並べ替えられます。プロジェクトを削除するときに実行記録もまとめて削除できます。
削除するのは Agents が作成したデータだけで(ワークスペースは Agents の worktrees フォルダ内にあるものに限ります)、リポジトリ本体には触れません。削除は元に戻せません。一覧から隠したいだけならアーカイブを使ってください。
チャット表示:会話するようにエージェントと作業
画面構成(1.23.15 から Claude Code の Web 版と同じ):左のサイドバーに「新規 / 検索 / 対応が必要 / ボード / バックグラウンド実行」とセッション一覧があります。タスクでは左のタイトル(⌄)からタスク情報・名前の変更・添付・PR、右のアイコンでチャット / 変更 / ターミナルを切り替え、エビデンス・成果物・シェルなどは ⋯ にあります。いちばん右は停止 / 再開 / 完了です。入力欄は 1 本のバーで、左に +、右に停止とマイク(端末内の音声入力。先にサイトの「メッセージ › 設定 › 音声と文字起こし」でモデルをダウンロードしてください。Windows と Intel Mac は未対応)、下にモデルと推論の強さ、権限モード、コンテキストのリングがあります。
Claude Code のタスクは チャット タブで開き、Claude Code の Web 版と同じ配置です:左にセッション一覧、中央に会話、右にセッションレール(⌘. で隠せます)。
会話
- 自分のメッセージは右側のグレーの吹き出しに表示されます。返信は Markdown(見出し、リスト、表)で整形され、コードブロックには言語名と色分けがあり、ワンクリックでコピーできます。「N 秒考えました」は展開できます。
- ツールごとに専用の表示があります。 コマンドはコマンド・終了コード(0 以外は赤)・所要時間を表示し、展開すると出力が見えます。読み込みはファイルと行範囲(例:「1–40 行」)、展開すると行番号付きの内容。編集・書き込みは +追加 −削除と差分(統合表示または左右)。検索は一致したファイルの一覧。Web 取得は URL・ステータス・結果。サブエージェントは種類・ステップ数・時間と、その中のステップを入れ子で。MCP ツールはサーバーと引数。ToDo は進み具合。連続したステップは 1 行にまとまり(「3 個のファイルを読み込み · 1 個のファイルを編集 · 2 個のコマンドを実行」)、実行中のまとまりは自動で開きます。
- ファイル名をクリックすると、エディタを開かずにすぐ横でプレビューできます。エディタで開くこともできます。
- Ctrl+O で詳細表示に切り替え、すべてのステップと思考を展開します。
確認が必要なとき
- コマンドの実行やファイルの編集の前にカードが出ます:許可(1)/ このタスクでは常に許可(2)/ 理由を添えて拒否(3)。
- エージェントが質問したら答えを選びます(複数選択や「その他」も可)。
- プランモードの計画は「はい、編集を自動承認」「はい、編集ごとに確認」「計画を練り直す」(意見を添えて)から選べます。
入力欄
- Enter で送信、Shift+Enter で改行(Claude Code と同じ。⌘/ で ⌘Enter 送信に変更できます)。日本語入力の変換中に Enter を押しても送信されません。
- エージェントの作業中も送信できます。メッセージはキューに入り(「キュー待ち」)、エージェントが読む前なら ✕ で取り消して入力欄に戻せます。Option+Enter で中断して送信、Esc で停止します。
- 入力欄が空のとき ↑ / ↓ で以前のメッセージを呼び出せます。
@でワークスペースのファイルを参照、/でコマンド:/clear、/compact [重点]、/context、/model 名前、/effort 強さ、/mode、/rename 名前、/rewind、/fork、/cost、/help、プロジェクトやエージェント独自のコマンドも使えます。- 左下の + で画像やファイルを追加(貼り付け・ドロップも可)。その横が権限モード(毎回確認 / 編集を自動承認 / プランモード / すべての確認をスキップ、⌘⇧M)。右下にモデルと推論の強さ(⌘⇧I / ⌘⇧E)、コンテキストのリング、送信 / 停止ボタンがあります。
巻き戻しと分岐
- 自分のメッセージにマウスを乗せて「ここまで巻き戻す」:コードと会話の両方、会話だけ、コードだけを選べます。コードはエージェントがツールで編集したファイルだけを戻します(コマンドによる変更は対象外)。ダイアログに戻すファイルが先に表示されます。会話を巻き戻すと、そのメッセージは入力欄に戻るので直して送り直せます。
- 「ここから分岐」(自分のメッセージかエージェントの返信で):その時点までを新しいセッションにコピーします。元のセッションはそのままで、同じフォルダーで作業します。
- 「再試行」はメッセージをもう一度送ります。失敗したターンにも再試行ボタンがあります。
セッションレール
- 変更:このチャットで変更したファイルと追加・削除行数。クリックで「変更」タブへ。
- コンテキスト:常に開いています(Claude Code の Web 版と同じ)。「31% 使用」、区分バー、種類ごとの使用量(トークンと割合、遅延読み込みは「—」)、自動圧縮までの残り、「セッションを圧縮」。いっぱいに近づくと入力欄の上でお知らせします。
- 出力:このセッションでエージェントが作った画像・PDF・Web ページ・文書など。クリックでプレビューします。
- コネクタ:このセッションの MCP サーバー。ターンごとに本当の状態(接続済み・失敗・要ログイン・接続中)に更新します。
- バックグラウンドタスク:実行中のものを先に表示し(サブエージェントはトークン数とステップ数も)、終わったものは「n 件終了」の 1 行にまとめます。最後のターンの終わりにも状況を 1 文で表示します。どれも本当の状態——実行中(タイマー付き、個別に停止可能)、完了と所要時間、失敗と終了コード、停止。エージェントのプロセスが止まったりアプリを再起動したりすると、終わっていないものは「停止」と表示します。
- ToDo、使用量(トークン、Claude Code が報告した費用、実行時間、5 時間 / 週ごとの上限)、環境(モデル、モード、ブランチ、フォルダー、ターミナル・エディタ・フォルダーで開くボタン)。
エージェントに付け加える約束事(証拠、成果物の説明など)は会話には表示されず、最初のメッセージにカーソルを合わせて ⓘ で確認できます。アプリを閉じている間もエージェントが作業を続けていた場合、次に会話を続けるときに Claude Code のセッション記録からその部分を補い、そのことを表示します。「ターミナル(生のストリーム)」タブには元の出力が表示されます。Codex などほかのエージェントと 1.23.9 より前のタスクはターミナル表示のままです。プロジェクトの実行者もチャット表示で進み具合を見られます。実行中は中断されず、入力した内容はこのランの後に渡されます。
セッション一覧とショートカット
- サイドバー上部でセッションを検索でき、「セッション」見出しから状態 / フォルダー / 日付でグループ化できます。各行には状態アイコン(回転 = 実行中、オレンジの点 = 確認待ち、青い点 = 完了で未確認)と変更行数が表示されます。マウスを乗せて ⋯(または右クリック)から名前の変更、ターミナル / エディタ / フォルダーで開く、アーカイブ、削除(確認あり)。タスク名のダブルクリックでも名前を変更できます。
- ⌘K でセッション切り替えとコマンド、⌘N で新しいセッション、Ctrl+Tab または ⌘⇧] / ⌘⇧[ で次 / 前のセッション、⌘⇧D で「変更」、⌘/ ですべてのショートカット。新しいセッションではモデルと推論の強さを選べます。
- 「変更」タブでは行番号の横の + で行にコメントし、いくつかまとめて「エージェントに送信」できます。「統合 / 左右」の切り替えや、ほかのブランチとの「比較対象」(読み取り専用)も選べます。
タスクに画像を添付する
タスク説明にスクリーンショットを貼り付けるか、画像をドラッグするか、「画像を追加」を選びます。PNG・JPEG・WebP に対応し、最大 4 枚、各 5 MB、各辺 8192 ピクセル、1600 万画素までです。開始前にプレビュー・削除できます。作成に失敗しても文章と画像は保持し、変更した下書きを閉じるときは確認します。
Codex には画像を直接添付します。Claude Code(チャット表示)は最初のメッセージと一緒に画像を直接受け取ります。選んだエージェントのモデルと権限に従って処理されます。ほかのエージェントとプロジェクトは画像に未対応です。切り替えても下書きは保持し、必要な操作を表示します。アーカイブやワークスペース削除後も画像はタスク履歴に残り、タスク記録の削除時に削除します。
レビュー用エビデンス:スクリーンショットと録画
エージェントが一区切りつくと、デスクトップ版が変更にエビデンスを自動で添えます。タスクの エビデンス タブで、コードを読まなくても結果を判断できます:
- Web 画面の変更:タスクのワークスペースでプロジェクトを起動し(
npm run devなどのコマンドを推測。静的なサイトは内蔵のローカルサーバーを使用)、変更前のバージョンも起動して、PC の Chrome / Edge をバックグラウンドで使い 変更前 / 変更後 をライト・ダーク、デスクトップ・スマホ幅で撮影します。スライダーで比べる、並べて表示、差分(変わった部分をオレンジで表示)が選べます。 - 録画:エージェントが短い「デモ台本」(どこを押して何を入力するか)を書き、デスクトップ版がそのとおりに操作して録画します。1 フレームずつ、または 0.5〜4 倍速で再生できます。台本がない場合はページを開いてスクロールする様子を録画します。.webm 動画としても開けます。
- 画面のない変更:テストコマンドを自動で実行し、再生できるターミナルの記録にします。
- コンソール:ページのエラーと警告。
- エージェントがワークスペースの
.ws-evidence/フォルダに保存したスクリーンショットや動画も表示します(このフォルダはコミットされません)。
スクリーンショットや録画のどこかをクリックするとコメントでき、エージェントに送る を押すとコメント(指した位置つき)が修正依頼としてエージェントに届きます。直し終わるとエビデンスを作り直します。ボードのカードにもサムネイルが出ます。
プロジェクトでは、コーディネーターも検収のときにこのスクリーンショットを見て、明らかに崩れた画面は差し戻します。
成果物:エージェントが描いたものを見る
エージェントに「案をいくつか描いて」「HTML のプロトタイプを作って」「フロー図を描いて」「説明を書いて」と頼むと、結果がタスクの 成果物 タブに表示され、ファイルを探さずにそのまま見られます。
- 置き場所:新しいタスクのプロンプトで、見せたいものをタスクフォルダの
.ws-artifacts/(コミットされません)に置くよう伝えてあります。タイトルやグループはmanifest.jsonに書けます。変更内の HTML・画像・Markdown も自動で一覧に出ます(「変更から」と表示)。 - 見方:グリッド、左右で比較、1 件ずつ(← → で切り替え)。HTML は デスクトップ / タブレット / スマホ のサイズと ライト / ダーク で確認できます。HTML、Markdown、画像、SVG、PDF、動画、Mermaid、表(CSV)、コード / JSON、ホワイトボードに対応しています。
- コメント:1 件ずつ表示で コメント をオンにし、ページのどこかをクリックして意見を書きます。全体の意見も書けます。まとまったら エージェントに送る と、コメントに沿って修正されます(終了したタスクは前回の会話を再開します)。新しい版は自動で表示され、前の版と比較 できます。元のタスクを残したいときは 続きのタスクを作成 を使います。
- この案に決める:気に入った案を選び、理由を添えます(任意)。エージェントには「案 3 を選びました。理由…」と届き、その案で進めます。プロジェクトではマネージャーが「決定事項」にも記録します。
- ホワイトボード:エージェントがフロー図、ワイヤーフレーム、付箋を描けます(
*.board.json)。付箋・四角形・テキスト・矢印の追加、ペンでの書き込み、ドラッグでの移動、ダブルクリックでの文字編集ができ、自動で保存されます。PNG / SVG に書き出せます(.ws-artifacts/exports/)。Excalidraw の.excalidrawファイルも読み取り専用で開けます。 - チャットに送る:成果物のタイトルカードを友だちやグループに送れます。
再起動のあと
タスク・会話・ターミナルの記録はパソコンに保存され、再起動しても残ります。
- 1.16 から、終了・アップデート・クラッシュでエージェントは止まりません:エージェントはアプリのバックグラウンド「セッションプロセス」で動き(macOS・Windows・Linux のすべてで、tmux は不要)、アプリはそれを表示しているだけです。終了しても、アップデートを入れても、アプリがクラッシュしても作業は続き、次に開くと自動でつながり直し、その間の出力や終わったターンも反映されます。「設定 → Agents」の「終了後も続ける」でオフにできます。
- パソコンの再起動・シャットダウンではセッションプロセスを含むすべてのプロセスが終了します。そのあと続けるを押すと、Claude Code は
--continue、Codex はresume --lastで前回の会話を再開し、ほかのエージェントは起動し直します。 - 1.15 以前に tmux で動かしていたエージェントはこれまでどおりつながり直します。1.16 以降の新しいタスクはセッションプロセスで動きます。
プロジェクト:1 つの目標を複数のエージェントで
新しいタスクの画面でプロジェクトに切り替えます(「新しいプロジェクト」でも可)。
- git リポジトリを選び、目標と確認方法を書きます。
- コーディネーター(既定はパソコンの Claude Code)と実行するエージェント、同時に動かす数、レビュー前に実行する確認コマンド(例:
npm test、空欄可)を選びます。 - 開始すると、コーディネーターがまずリポジトリのルール(
CLAUDE.md、AGENTS.md、README…)を読み、目標を番号(T-001…)・優先度・合格基準・依存関係・担当ファイル付きのタスクに分け、プロジェクトのタスク台帳に書きます。
アプリは優先度と依存関係に沿ってタスクを実行役に渡します。各タスクは上と同じく専用のワークスペースとターミナルを持ち、依存するタスクはそのブランチから続けます。
- 実行役が承認を待つと台帳の項目が保留中になり、通知します。そのターミナルで答えると続きます。
- ひと区切りするとレビュー中へ:ワークスペースで確認コマンドを実行し、コーディネーターが実際の差分を合格基準と照らします。合格したものだけ完了にして変更をタスクのブランチにコミットし、不合格なら理由をそのまま実行役に返します(3 回まで。そのあとは保留にしてあなたに任せます)。自分で「合格にする」「もう一度レビュー」も可能です。
- 右側はコーディネーターとの会話:要件の追加・優先度の変更・取り消し・進捗の確認をいつでも。影響するタスクだけが変わります。カードからも優先度の変更・取り消し・再試行ができます。
- 終わったら完了分をマージで、依存関係の順に元のブランチへマージします(問題があればそこで止まって知らせます)。
プロジェクトが自分で進む仕組み
1.16.2 から、プロジェクトが「実行中」のまま何時間も放置されることはなくなりました。
- ターンが終わるたびにコーディネーターが確認:ワーカーがターンを終えると、コーディネーターが最後の報告を読み、完了(レビューへ)、ブロック中(アクセス権・認証情報・ソースマップ不足や、あなたの判断が必要——ブロック中にして通知し、解除方法を書きます)、途中経過(次の指示を自動で送ります)のどれかを判断します。
- コーディネーターの指示がワーカーに届く:「進捗を報告させて」と頼むと、指示は待機列に入り、ワーカーが空いたら新しいメッセージとしてそのセッションに入力されます(「エージェントに送る」と同じ経路)。カードに「待機中」「届けました」が表示されます。ワーカーが承認待ちのときは入力しません。
- 状態判定のフォールバック:通常は Claude Code / Codex の状態フックで判定します。フックから報告がないとき(再開したセッションがまだ新しいターンを始めていない場合など)も、ターミナルが静かで入力プロンプトで止まっていれば「ターン終了」または「返事待ち」と判断するので、ずっと実行中のままにはなりません。ボードとタスク画面に「最終アクティビティ x 分前」を表示します。
- 再起動のあとも続きから:アプリの再起動でワーカーのプロセスが終わった場合、会話を再開できるエージェントは自動で再開し「続けて最後に報告して」と伝えます。台帳も実際の状態で更新します。
- 長い間進展がないとき(既定は 45 分間ファイルの変更も新しい動きもない場合。プロジェクト設定で変更可):まずコーディネーターが一度問い合わせ、それでも進展がなければ「ブロック中:長時間進展なし」にして通知します。
- コーディネーターに「なぜこんなに時間がかかるの?」と聞くと、各ワーカーの最新の出力、最終アクティビティ、変更の件数を見て、どこで止まっているかを答えます。
モデルを変える:好きなプロバイダーで Claude Code / Codex を動かす
デスクトップ版にはモデルゲートウェイが内蔵されています。ほかのツールを入れなくても、Claude Code や Codex を DeepSeek、Kimi、Zhipu GLM、MiniMax、Qwen、OpenRouter、ローカルの Ollama などのモデルで動かせます。
- 設定 → モデルゲートウェイ:オンにして プロバイダーを追加 し、1 つ選んで API キーを貼り付けます(システムのキーチェーンにだけ保存し、画面には末尾 4 文字だけ表示)。続けて モデルを取得 します。1 つのプロバイダーに複数のキーを追加できます。保存すると自動で一度試します。取得できないときは理由(タイムアウト、接続拒否、キーが拒否された、パスが違う、相手のサービスのエラー、モデル一覧ではない)とリクエスト先、再試行 を表示します。接続をテスト では相手が magpie かどうか(バージョン)もわかります。
- 複数のモデルを 1 つとして使うには ルーティンググループ を作り、メンバーを順番に選びます。エラー(接続不可・レート制限・上限到達)が出ると次のキーやメンバーに切り替わり、エージェントは気づきません。
- 新しいタスク で Claude Code か Codex を選んだら モデルを変える をオンにし、モデルかルーティンググループを選びます。プロジェクト ではコーディネーターとワーカーで別々に選べます(強いモデルで調整、安いモデルで作業)。今回の実行だけに使われ、エージェント自体の設定は変わりません。
- ターミナルの新しいタブのメニューにも Claude Code / Codex を別のモデルで起動 があります。
プロバイダーには「Claude Code で使える」(Anthropic API あり)や「Codex で使える」(Responses API あり)の印が付きます。Chat API しかないプロバイダーは、この 2 つではまだ使えません。設定 → モデルゲートウェイ → 使用量 と AI 使用量 で、モデル別・エージェント別のトークン数と自動切り替えの回数を確認できます。
ゲートウェイは 127.0.0.1 だけで待ち受け、すべてのリクエストにこのコンピュータのトークンが必要です。エージェントに渡るのはこのトークンで、API キーではありません。
magpie をお使いですか? 設定画面が自動で見つけます。プロバイダーと API キーを 取り込む ことも(設定は読み取るだけで、選んで確認するまで取り込みません。サブスクリプションのサインインはまだ取り込めません)、そのまま使い続けることもできます。magpie の実行中は、新しいタスクのモデル一覧に magpie のモデルも表示されます。ウィジェット堂の MCP をワンクリックで magpie の Library に追加することもできます。モデルゲートウェイの設計はオープンソースの magpie(yetone/magpie、MIT)を参考にしています。
権限レベル
| レベル | 意味 | 例 |
|---|---|---|
| 読み取りのみ | コードを読んで計画するだけ | Claude --permission-mode plan、Codex --sandbox read-only |
| 毎回確認 | 編集やコマンドの前にターミナルで確認 | 各エージェントの既定 |
| ファイルを編集 | 編集は自動で許可、コマンドは確認 | Claude acceptEdits、Codex workspace-write |
| すべて自動で許可 | 確認しない:どのファイルも、どのコマンドも、ネットワークも | Claude --dangerously-skip-permissions |
- 各エージェントは対応するレベルだけを提供し、黙って広いレベルに変えることはありません。
- 既定の権限:「エージェントと設定」で「既定の権限」を選ぶと、新しいタスクとプロジェクトはその権限で始まります(エージェントにその段階がない場合はひとつ狭い段階)。完全に任せたいときは「すべて自動で許可」を選びます。
- 「すべて自動で許可」は最初の一度だけリスクの確認があり、以後は記憶して毎回は聞きません。メール・Web ページ・選択テキスト・コマンドラインから来たタスクには、プロンプトインジェクションの確認がもう一つありますが、これも一度だけです。設定でいつでも取り消せます。
- プロジェクトの権限はいつでも変更:プロジェクト名の横の権限ラベル、または「プロジェクト設定 → ワーカーの権限」から変更すると、その後に開始するタスクに反映されます。自動運転中でも「すべて自動で許可」を使えます。
- ターミナルに行かなくて大丈夫:タスクが承認待ちになると、タスク画面・プロジェクトの一覧・「対応が必要」に すべて自動許可にして続行 が表示されます。一度確認すると、エージェントは同じ会話を続けます(Claude Code と Codex。プロジェクトの今後のタスクにも適用できます)。
- 読み取りのみの Claude Code は計画を書き終えるとレビュー待ちになり、「編集を始めますか」で止まりません。プロジェクトマネージャーの計画とレビューはバックグラウンドで対話なしに動き、終われば自動で完了します。
ToDo とつなぐ
- ToDo から:ToDo の「エージェントに渡す」は、タイトル・説明・サブタスク・メモ・期限、Linear / Todoist の説明とコメント、完了の条件(スクリーンショット / 録画)をまとめて渡します。新規ウィンドウの上部に「ToDo から」と表示され、その ToDo の Linear プロジェクト / チーム、Todoist のプロジェクト、ToDo のプロジェクトで前回使ったフォルダが選ばれます。エージェント・フォルダ・権限・モデルを確認して「開始」を押します。
- ToDo をリンク:自分でタスクやプロジェクトを作るときは「リンクした ToDo」でタイトル・プロジェクト・Linear の ID から検索できます。
- ToDo に追加:タスクの「⋯ → ToDo に追加」でエージェントの報告の 1 行を ToDo にします(既定ではリンクした ToDo のサブタスク)。プロジェクトのカードの「+ ToDo」は台帳のタスクを追加します。ToDo から始めたプロジェクトでは、コーディネーターのタスクがサブタスクとして同期されます(プロジェクトの設定でオフにできます)。
- 状態:ToDo に 実行中 / 確認待ち / 停止中 / レビュー待ち / 完了 が表示され、レビューで承認またはマージすると、ToDo の設定に従って完了にし、Linear / Todoist に書き戻します。
- ToDo → リポジトリ:設定に記憶したフォルダが並び、変更や削除ができます。このコンピューターにだけ保存されます。
ほかの場所から始める
- SOP / ウェブサイト:SOP の手順の「エージェントに任せる」は新しいタスクの画面に下書きするだけです。フォルダを選んで自分で開始します。フォルダや権限は指定できません。
- ToDo:ToDo の詳細・右クリックメニュー・選択バーの「エージェントに渡す」。上の「ToDo とつなぐ」を参照してください。
- ランチャー:「Claude Code に頼む:…」。
- コマンドライン:WidgetStore CLI からのタスクは確認画面が出ます。これらは「バックグラウンド実行」に表示されます。
使用量
タスクごとにトークン数とおおよその費用を表示します。Claude Code は自身のローカルのセッション記録、Codex はそのワークスペースのセッション記録から計算します(設定の「AI 使用量」と同じ情報源。サブスクリプションはトークン課金ではないので目安です)。
安全とプライバシー
- エージェントは選んだフォルダ(または専用のワークスペース)でだけ動き、%BRAND% のログイン情報やトークンは渡しません。
- リモートへのプッシュは毎回確認します。
- タスク・台帳・会話・ターミナルの記録はこのパソコンだけに保存します。
- ウェブサイトのページはエージェントやターミナルの機能を一切使えず、下書きしかできません。
バックグラウンド実行の履歴と長い回答
デスクトップ版 1.21.1 から、バックグラウンド実行にツールの開始と結果、成功・失敗、変更の抜粋、状態メッセージが残ります。同じ名前のツールが同時に動いても、それぞれの呼び出しに結果を対応させます。ツール行を開くと入力と結果を確認できます。履歴の読み込み中に届いたメッセージも保持します。
終了した実行では「回答をコピー」で、この PC に保存された最後の回答を取得できます。保存上限は UTF-8 テキストで 1 MiB です。経過のプレビューは抜粋の場合があります。上限を超えた場合や、以前の実行に要約しか残っていない場合は、保存済みの部分だけをコピーしたことを表示します。保存されていなかった内容は復元できません。
無頭実行の停止・タイムアウト・終了時は、その実行の子プロセスを回収して出力待ちを終えます。対話型タスクのセッションプロセスは従来どおり動作します。複数の実行が同時に終わっても履歴を順に保存します。新しいコマンドライン認可ではノートとブログへの書き込みも選べます。既存の認可は「コマンドライン」で再接続し、ブラウザーの同意画面で必要な権限を選んでください。
最終更新:2026年11月19日