Muse Codeの使い方：全体の流れ

最初から承認のしくみとOSのサンドボックスが有効になっているので、何も設定しなくても、いきなりPC全体を書き換えられる心配はありません。

インストールと最初の起動

STEP 1：インストールする

macOS・Linuxはターミナルで、WindowsはPowerShellで実行します。

# macOS・Linux
curl -fsSL https://dev.meta.ai/install.sh | sh

# Windows（PowerShell）
irm https://dev.meta.ai/install.ps1 | iex

# 入ったか確認
muse --version

STEP 2：サインインする

作業したいプロジェクトのフォルダに移動して muse を実行すると、ブラウザでサインインするか、APIキーを貼り付けるかを選べます。あとから選び直すときは、セッションの中で /login を使います。

CIなど画面のない環境では、環境変数 META_API_KEY にAPIキーを入れます。複数ある場合は、META_API_KEY、保存したキー、ブラウザのサインインの順に使われます。サインアウトは muse logout です（META_API_KEY は自分で消す必要があります）。

STEP 3：プロジェクトの説明書を作る

muse init

プロジェクトのフォルダに AGENTS.md ができます。ビルドやテストのコマンド、コードの書き方の決まりなどを書いておくと、毎回説明しなくても守ってくれます。

毎日の作業で便利な操作

動いている最中に指示を足す・予約する

「あ、テストも走らせて」と気づいたときに、作業を止めずに伝えられるのが便利です。急ぎでなければ Alt+Enter で予約しておけば、今の作業の邪魔をしません。

よく使うスラッシュコマンド

画像を見せて質問する

エラー画面のスクリーンショットなどを入力欄に貼り付けるかドロップすると、[Image #1] のような番号が付きます。「[Image #1] のエラーの原因は？」のように番号で指して質問できます。

巻き戻してもファイルは戻らない

承認モードとサンドボックスを使い分ける

承認モード（--approval-mode）

確認が出たときは「今回だけ許可」「このワークスペースでは常に許可」「拒否」から選べます。「常に許可」はコマンドの先頭部分ごとに保存されますが、python・bash・node のように何でも実行できるコマンドは、まとめて許可できないようになっています。

サンドボックスで書き込める範囲

macOS・Linux・Windowsのどれでも、書き込めるのは作業中のフォルダと一時フォルダだけで、それ以外は読み取り専用です。作業中のフォルダの中でも、.git・.muse・.agents は書き換えられません。ネットワークは初期設定（proxy-only）では、接続先ごとに確認が出ます。

Claude Codeから乗り換える・併用するときのコツ

スキルを取り込む

# Claude Codeのスキルを取り込む（Codexからは --from codex）
muse skills import --from claude

# 入っているスキルを確認
muse skills list

プロジェクト用のスキルは .agents/skills/<スキル名>/SKILL.md に置きます。Claude Codeと同じ SKILL.md の形なので、作ったスキルを使い回しやすくなっています。

MCPサーバーをつなぐ

設定ファイル ~/.config/muse/settings.json の mcp_servers に書きます。設定ファイルには "schema_version": 1 が必要です。

{
  "schema_version": 1,
  "mcp_servers": {
    "my-tools": { "transport": "stdio", "command": "my-mcp-server", "args": [] }
  }
}

MCPのツールはサンドボックスの外で動きます。信頼できるサーバーだけをつないでください。

Hooksで決まった処理を挟む

プロジェクトの .muse/hooks.json に、PreToolUse・PostToolUse・Stop などのタイミングで動かすコマンドを書けます。Hooksもサンドボックスの外で動くので、中身を読んだコマンドだけを登録します。

スクリプトやCIで動かす（muse exec）

# 1つの指示を最後まで実行して終わる
muse exec "CHANGELOGを最新リリースに合わせて更新し、テストを実行して"

# 指示をファイルから読む／結果をJSONLで受け取る
muse exec --prompt-file ./task.txt
muse exec --json "認証モジュールを整理してテストを実行して"

• --max-model-steps で手数の上限を決めておくと、行き詰まったときに延々と回り続けません
• 終了コードは、完了が 0、失敗・中断が 1、使い方の誤りが 2 です
• 公式ドキュメントは「0 で終わっても作業が正しいとは限らない」としています。合否は自分のテストコマンドで判定します
• Linuxのサンドボックスにはbubblewrapが必要です。動かない環境では、サンドボックス内のコマンドが失敗します

よくある質問

まとめ

今日できる最初の一歩として、練習用のリポジトリで muse init を実行し、/plan で小さな修正を1つ頼んでみてください。