使い始める

mu には 2 つの形があります。必要なものをすべて内蔵したデスクトップアプリと、mu コマンドラインです。どちらもアカウント、設定、セッション、教訓を共有するので、片方で始めたタスクをもう片方で続けられます。

デスクトップアプリ

1. Releases から、またはホームページから、お使いのシステム用のビルドをダウンロードします。ホームページではシステムが自動で選ばれます。

   システム	ファイル
   macOS、Apple シリコン	mu-<version>-mac-arm64.dmg
   macOS、Intel	mu-<version>-mac-x64.dmg
   Windows x64 / Arm	mu-<version>-win-x64.exe / mu-<version>-win-arm64.exe
   Linux x64 / Arm（Debian、Ubuntu）	mu-<version>-linux-amd64.deb / mu-<version>-linux-arm64.deb

   リリースページの SHA256SUMS に、すべてのファイルのチェックサムが載っています。macOS 版は Apple の署名と公証を受けています。Windows 版はまだコード署名がないため、初回は SmartScreen が警告します。詳細情報を選び、実行を選んでください。

2. アプリを開きます。初回ガイドが 4 つのステップを案内します。モデル、権限モード、判定器、開始です。

   • モデル。 API キーを貼り付けると、mu はキーの形からサービスを見分け（DeepSeek、Kimi、Qwen、GLM、SiliconFlow、OpenRouter、OpenAI、Anthropic、Google Gemini、xAI など）、1 回のリクエストで確かめます。または ChatGPT、Claude、Grok、Google のサブスクリプションでサインインします。キーの誤り、残高不足、対応していない地域、接続できない場合には、それぞれどうすればよいかを説明します。
   • 権限。 最初から「Jev が承認」が選ばれています。権限と安全性を参照してください。
   • 判定器。 キーがなければ、無料の Jev が答えます。この設定にはいつでも戻れます。
   • 開始。 Claude Code や Codex の会話が見つかると、インポートを提案します。

3. フォルダを選んで会話を始めます。

ほかにインストールするものはありません。Node.js は不要で、初回起動時にも何もダウンロードしません。新しいリリースが出ると、アプリはそのバージョンとサイズを知らせ、あなたが同意してからダウンロードし、再起動時にインストールします。

コマンドライン

npm i -g mu-agent      # Node.js 22.19 以降
mu setup               # モデルを接続し、判定器を選ぶ
mu                     # 現在のディレクトリでセッションを始める

mu setup は、中国語か英語で一つずつ尋ねます。スキップした場合は、モデルがない状態で初めて mu を実行したときに、いま設定するかどうかを一度だけ尋ねます。スクリプトでは、mu setup --help で対話なしの書き方を確認できます。キーは標準入力から読み込み、コマンドラインから読むことはありません。

試してみるとよいこと：

セッションの中では、/status で判定器、各判定ポイントのモード、最新の判定が表示され、/help ですべてのコマンドが一覧できます。全体の一覧はコマンドラインのページにあります。

最初のタスク

プロジェクトのフォルダを開き、やってほしいことを自分の言葉で伝えます。そのあとの流れ：

1. まず Jev があなたのメッセージを読み、複数ステップのタスク · 重装備 のような 1 行の判定を表示します。1 秒もかかりません。Esc を押すとスキップできます。
2. モデルが作業します。 長いツール出力は、モデルに届く前に絞り込まれます。「Jev が承認」モードでは、プロジェクトの外に及ぶコマンドは承認を待ちます。
3. 終わったと言ったとき、mu は何かでその作業を確かめたかを確認し、確かめていなければ一度だけ促します。

条件が満たされるまで作業を続けさせるには、目標モードを使います：/goal all tests in packages/api pass。

判定器

mu は、セッション中の定型の問いを、小さくて速い判定器に尋ねます。自分で設定する必要はありません。Jev のキーがなければ OpenCode Zen の無料の Jev が答え、mu はそのことを 1 日 1 回知らせます。自分のキー、ローカルの判定器、別のモデルを使うには、判定器を参照してください。

すべての判定ポイントは最初から判定を反映し、判定はすべて記録されます（/status、mu ledger、アプリの判定タブ）。判定器を信頼する前に様子を見たい場合は、判定ポイントをシャドーモードにします。問い合わせと記録は続きますが、何も変わりません。

{ "modes": { "default": "shadow" } }

これは ~/.mu/agent/mu.json に書きます。/mu mode default shadow は、同じことを現在のセッションだけに適用します。

ファイルの場所

Windows では、~ はユーザーフォルダ（%USERPROFILE%）です。