macOSミニオンのセットアップ
Mac に Minion を入れると、その Mac をミニオンとして使えます。Minion はバックグラウンドのサービスとして動き、Minion Workspace へ自分から接続し(ポートを開ける必要はありません)、自分で更新します。
- Apple シリコンの Mac(macOS 13 以降)
- 管理者のアカウント — Minion を入れるときと、minion アカウントのパスワードを決めるときに使います
- Minion Workspace のアカウント
1. Minion を入れる
Section titled “1. Minion を入れる”- Minion をダウンロード からインストーラー(
.pkg)をダウンロードします。 - ダブルクリックし、画面の案内に沿って進めて、管理者のパスワードを入れます。
インストーラーは、ミニオン用の macOS ユーザー(ユーザ名 minion)を作り、Minion Agent をサービスとして起動し、画面共有に Minion Agent だけが知るパスワードを設定して、「アプリケーション」フォルダに Minion を入れます。
2. Minion Workspace で Mac を承認する
Section titled “2. Minion Workspace で Mac を承認する”「アプリケーション」フォルダの Minion を開くと、Minion Agent の状態と、承認のコードとリンクが出ます。Minion Workspace にサインインした状態でリンクを開きます(minionworkspace.com/pair を開いてコードを入れても同じです)。
ページには Mac の名前・OS・接続元のアドレスが出ます。自分の Mac であることを確かめ、ミニオンの名前と、所属するワークスペース (自分がオーナーか管理者のもの) を決めて 承認する を押します。コードは 10 分で切れます。切れたら Minion が新しいコードを出します。ミニオンは ミニオン ページに現れ、数秒でつながります。
3. 画面共有をオンにする
Section titled “3. 画面共有をオンにする”macOS では、インストーラーが画面共有をオンにすることはできません。システム設定 → 一般 → 共有 → 画面共有 を自分でオンにしてください。
4. minion アカウントでログインする
Section titled “4. minion アカウントでログインする”ミニオンの AI は macOS のユーザー minion として動き、このユーザーがログインしているあいだだけ仕事をします。それまでは、ミニオンのページに このコンピューターの minion アカウントにサインインすると、作業役が起動します と出ます。
-
パスワードを決める(初回だけ)。 ターミナルで次のコマンドを実行し、管理者のパスワードのあとに、minion のパスワードを 2 回入れます(12 文字以上)。
Terminal window sudo /usr/local/minion/bin/minion configure-worker -
minion でログインする。 アップルメニューの ログアウト(またはコントロールセンターのユーザの切り替え)から、ミニオン(ユーザ名
minion)に、決めたパスワードでログインします。
そのあと別のユーザーに切り替えて使ってもかまいません。minion がログインしたままなら、ミニオンは仕事を続けます。
5. AI を使えるようにする
Section titled “5. AI を使えるようにする”Minion Workspace のミニオンのページで 頭脳 タブを開き、Claude Code を入れてから、ミニオンが使うものを選びます。ミニオンAI、自分の Anthropic の API キー(つなぎ方)、自分の Claude のプラン(タブからサインインします。Minion Workspace の中でミニオンのターミナルが開きます)のどれかです。
6. 動いていることを確かめる
Section titled “6. 動いていることを確かめる”ミニオンのページで、次を確かめます。
- ミニオンが オンライン になっている
- ターミナル を開くと、
minionとしてシェルが開く - 画面共有 で Mac の画面が見える
そのあと、チャットからメッセージを送ってみてください。
Minion は自分で更新します。数時間ごとに新しい版を確かめ、ミニオンが仕事をしていないときに入れます。すぐに更新するときは、ミニオンのページの バージョン … に今すぐ更新する を押すか、sudo /usr/local/minion/bin/minion update --now を実行します。minion update で更新役の状態が見られます。
| したいこと | 方法 |
|---|---|
| Minion が動いていて、つながっているか | 「アプリケーション」フォルダの Minion を開く。またはターミナルで minion status |
| 再起動する | ミニオンのページの Agent を再起動 |
| Mac を再起動したあと | もう一度 minion でログインする(FileVault がオンなら先にロックを解除) |
| Mac をスリープさせない | システム設定で、自動でスリープしないようにし、スクリーンセーバーのあとにパスワードを求めないようにする |
アンインストール
Section titled “アンインストール”ターミナルで次のコマンドを実行します。Minion が Mac に残したデータ(minion アカウントも含む)も一緒に消え、画面共有の設定は入れる前に戻ります。
sudo /usr/local/minion/bin/minion uninstallミニオンが要らなければ、ミニオン ページからも削除してください。
入れ直したとき
Section titled “入れ直したとき”同じ Mac に Minion を入れ直したときは、元のミニオンにつなぎ直せます。名前・所属するワークスペースとプロジェクトのメンバー・チケットの担当など、Minion Workspace にあるものはそのまま使えます。Mac の上のデータ(メモリー・ルーティン・ToDo など)は、アンインストールしたときに消えています。
- Minion Workspace でミニオンの 概要 タブを開き、ペアリングを解除 を押します
- Minion を入れ直し、承認のページの つなぎ方 で 既存のミニオンに付け直す を選んで、元のミニオンを選びます
ディスプレイをつながずに動かす
Section titled “ディスプレイをつながずに動かす”画面共有には Mac の画面に出ているものが映ります。モニターをつないでいない Mac mini では、黒い画面やとても小さい画面になることがあります。HDMI ダミープラグ を挿すと、macOS がディスプレイがあるものとして扱います。
トラブルシューティング
Section titled “トラブルシューティング”以前のミニオンがある Mac で、インストールが途中で失敗する
Section titled “以前のミニオンがある Mac で、インストールが途中で失敗する”以前のミニオン(Node.js 版)は元どおり動き続けます。よくある原因と対処は 新しい Minion への乗り換え → うまくいかないとき を参照してください。
ミニオンのページに「minion アカウントにサインイン」と出る
Section titled “ミニオンのページに「minion アカウントにサインイン」と出る”minion ユーザーがログインしていません。手順 4 を行ってください。再起動したあとは、もう一度ログインします。
画面共有がつながらない・黒い
Section titled “画面共有がつながらない・黒い”システム設定 → 一般 → 共有 → 画面共有 がオンか確かめます(手順 3)。モニターが無いときは HDMI ダミープラグを使います。
ミニオンがオフラインのまま
Section titled “ミニオンがオフラインのまま”「アプリケーション」フォルダの Minion を開くか、ターミナルで minion status を実行します。waiting for approval とコード・リンクが出ていれば、リンクを開いて承認します。