コンテンツにスキップ

macOSミニオンのセットアップ

Mac に Minion を入れると、その Mac をミニオンとして使えます。Minion はバックグラウンドのサービスとして動き、Minion Workspace へ自分から接続し(ポートを開ける必要はありません)、自分で更新します。

  • Apple シリコンの Mac(macOS 13 以降)
  • 管理者のアカウント — Minion を入れるときと、minion アカウントのパスワードを決めるときに使います
  • Minion Workspace のアカウント
  1. Minion をダウンロード からインストーラー(.pkg)をダウンロードします。
  2. ダブルクリックし、画面の案内に沿って進めて、管理者のパスワードを入れます。

インストーラーは、ミニオン用の 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 が新しいコードを出します。ミニオンは ミニオン ページに現れ、数秒でつながります。

macOS では、インストーラーが画面共有をオンにすることはできません。システム設定 → 一般 → 共有 → 画面共有 を自分でオンにしてください。

4. minion アカウントでログインする

Section titled “4. minion アカウントでログインする”

ミニオンの AI は macOS のユーザー minion として動き、このユーザーがログインしているあいだだけ仕事をします。それまでは、ミニオンのページに このコンピューターの minion アカウントにサインインすると、作業役が起動します と出ます。

  1. パスワードを決める(初回だけ)。 ターミナルで次のコマンドを実行し、管理者のパスワードのあとに、minion のパスワードを 2 回入れます(12 文字以上)。

    Terminal window
    sudo /usr/local/minion/bin/minion configure-worker
  2. minion でログインする。 アップルメニューの ログアウト(またはコントロールセンターのユーザの切り替え)から、ミニオン(ユーザ名 minion)に、決めたパスワードでログインします。

そのあと別のユーザーに切り替えて使ってもかまいません。minion がログインしたままなら、ミニオンは仕事を続けます。

Minion Workspace のミニオンのページで 頭脳 タブを開き、Claude Code を入れてから、ミニオンが使うものを選びます。ミニオンAI、自分の Anthropic の API キー(つなぎ方)、自分の Claude のプラン(タブからサインインします。Minion Workspace の中でミニオンのターミナルが開きます)のどれかです。

ミニオンのページで、次を確かめます。

  • ミニオンが オンライン になっている
  • ターミナル を開くと、minion としてシェルが開く
  • 画面共有 で Mac の画面が見える

そのあと、チャットからメッセージを送ってみてください。

Minion は自分で更新します。数時間ごとに新しい版を確かめ、ミニオンが仕事をしていないときに入れます。すぐに更新するときは、ミニオンのページの バージョン … に今すぐ更新する を押すか、sudo /usr/local/minion/bin/minion update --now を実行します。minion update で更新役の状態が見られます。

したいこと方法
Minion が動いていて、つながっているか「アプリケーション」フォルダの Minion を開く。またはターミナルで minion status
再起動するミニオンのページの Agent を再起動
Mac を再起動したあともう一度 minion でログインする(FileVault がオンなら先にロックを解除)
Mac をスリープさせないシステム設定で、自動でスリープしないようにし、スクリーンセーバーのあとにパスワードを求めないようにする

ターミナルで次のコマンドを実行します。Minion が Mac に残したデータ(minion アカウントも含む)も一緒に消え、画面共有の設定は入れる前に戻ります。

Terminal window
sudo /usr/local/minion/bin/minion uninstall

ミニオンが要らなければ、ミニオン ページからも削除してください。

同じ Mac に Minion を入れ直したときは、元のミニオンにつなぎ直せます。名前・所属するワークスペースとプロジェクトのメンバー・チケットの担当など、Minion Workspace にあるものはそのまま使えます。Mac の上のデータ(メモリー・ルーティン・ToDo など)は、アンインストールしたときに消えています。

  1. Minion Workspace でミニオンの 概要 タブを開き、ペアリングを解除 を押します
  2. Minion を入れ直し、承認のページの つなぎ方 で 既存のミニオンに付け直す を選んで、元のミニオンを選びます

ディスプレイをつながずに動かす

Section titled “ディスプレイをつながずに動かす”

画面共有には Mac の画面に出ているものが映ります。モニターをつないでいない Mac mini では、黒い画面やとても小さい画面になることがあります。HDMI ダミープラグ を挿すと、macOS がディスプレイがあるものとして扱います。

以前のミニオンがある Mac で、インストールが途中で失敗する

Section titled “以前のミニオンがある Mac で、インストールが途中で失敗する”

以前のミニオン(Node.js 版)は元どおり動き続けます。よくある原因と対処は 新しい Minion への乗り換え → うまくいかないとき を参照してください。

ミニオンのページに「minion アカウントにサインイン」と出る

Section titled “ミニオンのページに「minion アカウントにサインイン」と出る”

minion ユーザーがログインしていません。手順 4 を行ってください。再起動したあとは、もう一度ログインします。

画面共有がつながらない・黒い

Section titled “画面共有がつながらない・黒い”

システム設定 → 一般 → 共有 → 画面共有 がオンか確かめます(手順 3)。モニターが無いときは HDMI ダミープラグを使います。

「アプリケーション」フォルダの Minion を開くか、ターミナルで minion status を実行します。waiting for approval とコード・リンクが出ていれば、リンクを開いて承認します。