1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Muse Codeを入れる前に確認するポイント6つ——学習に使うContributorモードは既定オン

1
Posted at

3 行まとめ

  • Meta のコーディングエージェント Muse Code は、承認と OS サンドボックスが最初から有効で、守りは固い。ただし公式ドキュメントを読むと、既定のままだと気づきにくい点がいくつかある
  • 一番大きいのは、サブスクリプションでは Contributor モード(送ったコードやプロンプトを Meta のモデル学習に使う代わりに使用量が増える)が既定でオンなこと。しかも muse exec では、設定ファイルの状態によってオンにもオフにもなる。CI では毎回 --contributor-mode off を付けておくのが安全だ
  • ほかに、①既定の権限プロファイルでは自動の判定役が承認を代行する、②--disable-sandbox はファイル操作ツールの制限まで外す、③hooks と MCP はサンドボックスの外で動く、④リポジトリの .agents/memory/ は信頼していないワークスペースでも読み込まれる、⑤muse exec の終了コード 0 は「作業が正しい」を意味しない、の5点も押さえておきたい

Muse Code とは

Muse Code は、Meta が出しているターミナルと CI 向けのコーディングエージェントだ。プロジェクトで起動すると、計画を立て、ファイルを編集し、コマンドを実行してタスクを進める。モデルは Muse Spark 向けに作られていて、Muse Wonder も使える。Muse 全体の流れは前の記事にまとめた。

この記事は、公式ドキュメント(dev.meta.ai/docs/muse-code)を読んで、入れる前・入れた直後に確認しておきたい設定を拾ったものだ。手元では Muse Code を動かしていないので、挙動はすべてドキュメントの記述に基づく。

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

インストールは1行で済む。

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

# Windows(PowerShell)
irm https://dev.meta.ai/install.ps1 | iex

muse --version

プロジェクトのディレクトリで muse を実行すると、対話セッションが始まる。最初に聞かれるのは次の2つだ。

  1. このワークスペースを信頼するか(信頼すると、プロジェクトのスキル・ルール・hooks が読み込まれる)
  2. 認証方法(ブラウザでのサインインか API キー。CI では環境変数 META_API_KEY)

既定のモデルは muse-spark-1.2 で、--model や /models で切り替えられる。ユーザー設定は ~/.config/muse/settings.json に置く。このファイルを作るときは "schema_version": 1 が必須で、抜けているとすべてのコマンドが malformed settings file で止まる。ファイル自体がないのは問題ない(既定値で動く)。

1. Contributor モードは既定でオン

Muse Code の料金は、トークン単位の従量課金と、月額のサブスクリプション(Everyday / High / Power / Maximum の4段階)から選ぶ。サブスクリプションには Contributor モードという設定がある。

  • オンにすると、プランで使える量が増える。代わりに、送ったプロンプト・コード・ファイル・コンテキストと、モデルの応答が、Meta の今後のモデルの学習に使われる
  • サブスクリプションでは、これが 既定でオン
  • 設定はマシンごとに保存される。新しいマシンでは、最初の対話セッションでオンになり、その旨の通知が出る

業務のコードを扱うなら、まずここを確認する。対話セッションでは /settings を開き、Model の下にある Contributor mode の行で切り替える。

muse exec の挙動に注意

罠になりやすいのは、ヘッドレス実行の muse exec だ。ドキュメントには次のように書かれている。

  • 設定ファイルがないマシンでは、ヘッドレス実行の Contributor モードはオフ
  • 設定ファイルはあるが、Contributor モードを一度も保存していない場合は、オンになることがある

つまり、CI のランナーで「別の設定を書くために settings.json を作った」だけで、学習に使われる側に倒れる可能性がある。ドキュメント自身も、スクリプトや CI では実行のたびにフラグか環境変数で指定するよう勧めている。

muse exec --contributor-mode off "Summarize the changes on this branch"

# または環境変数(1=オン、0=オフ。両方指定したらフラグが優先)
MUSE_CONTRIBUTOR_MODE=0 muse exec "Summarize the changes on this branch"

従量課金の場合と、Zero Data Retention(ZDR)が有効なアカウントでは、この設定の行自体が表示されない。組織の管理設定で制御している場合は、オフのまま固定され、フラグや環境変数も効かない。

2. 既定の権限プロファイルは「Auto-review」

セッションは、権限プロファイルのどれかで始まる。

プロファイル 中身
Ask me 承認が必要なものは、すべて自分で判断する
Auto-review(既定) Ask me と同じ権限だが、承認の判断を自動の判定役(approval judge)が代行する。判定役が使えないときは自分に聞いてくる
Unrestricted 承認もサンドボックスもなし。ワークスペースも信頼済みとして扱う。--yolo と同じ
Read-only 読むだけ。ファイルの書き込みや副作用のあるコマンドは不可

新規セッションの既定は Auto-review だ。何を通したかを全部自分の目で見たいなら、Ask me に切り替えるか、判定役を切る。

muse --approval-judge off

始めるときのプロファイルは、settings.json の permissions.default_profile で固定できる。

シェルコマンドは「段」ごとに審査される

承認の仕組みで面白いのは、複合コマンドを1行まるごとではなく、段(stage)に分けて審査するところだ。ドキュメントの例をそのまま引く。

wc -l report.log && echo cleaning && rm -rf report.log

wc -l と echo は読むだけなので自動で通る。rm -rf は危険と判定され、3段中の3段目で止まる。ここで拒否すると、前の安全な2段も含めて何も実行されない。全段が通ったときだけ、1つのコマンドとして実行される。

「このワークスペースでは常に許可」を選ぶと、コマンドのプレフィックス単位でルールが保存される。ただし python・bash・node のようなインタプリタは、広い許可として保存できない。後ろに何でも書けてしまうからだ。

承認モード(--approval-mode)には、既定の on-request のほかに、もっと厳しい untrusted と、何も止めない never がある。untrusted は、許可ルールに当たらないシェルの段をすべて止める。ただしファイルの読み込みと、ワークスペース内での write_file / edit_file は、どのモードでも通る。

3. サンドボックスの範囲を把握する

シェルコマンドは、OS が強制するサンドボックスの中で動く。macOS では Seatbelt、Linux では同梱の bubblewrap、Windows では Windows のサンドボックスを使う。

  • 書き込めるのは、ワークスペースと一時ディレクトリだけ。それ以外は読み取り専用
  • ワークスペースの中でも、.git・.muse・.agents は読み取り専用。エージェントが自分の履歴・設定・記憶を書き換えられないようにするためだ
  • サンドボックスが有効か確認できないときは、シェルコマンドを実行しない(Linux で bubblewrap が動かない環境や musl ビルドでは、すべてのシェルコマンドが失敗する)

ネットワークは --sandbox-network で切り替える。既定の proxy-only では、新しいホスト・ポート・プロトコルへの最初の接続が、シェルコマンドと同じように承認待ちで止まる。完全に遮断するなら restricted を使う。

注意したいのは --disable-sandbox だ。名前からは「シェルのサンドボックスだけを外す」ように見える。しかし実際には、ファイル操作ツールのワークスペース制限も外れ、write_file や edit_file がファイルシステムのどこにでも書けるようになる。ネットワークも全開放になり、--sandbox-network の指定は無視される。

4. hooks と MCP はサンドボックスの外で動く

サンドボックスが守るのは、エージェントが実行するシェルコマンドだ。次の2つは、その外で動く。

hooks:ライフサイクルのイベント(PreToolUse・PostToolUse・Stop など17種類)にシェルコマンドを結びつける仕組みだ。ドキュメントには、hooks のコマンドは サンドボックスと承認の外で、シェルから直接実行されると警告がある。追加の守りは、環境変数をクリアして少数の許可リストだけを残すことくらいだ。hooks の置き場所と、信頼の扱いは次のとおり。

置き場所 信頼の扱い
プロジェクト:<project-root>/.muse/hooks.json ワークスペースを信頼した後でだけ動く
ユーザー:自分の設定ファイル 信頼の確認なしで動く
管理:managed_hooks_path が指すファイル 信頼の確認なしで動く。このファイルを書ける人が、何を実行するかを決められる

MCP サーバー:stdio なら普通の子プロセスとして、HTTP なら直接のネットワーク接続として動き、ファイルシステムとネットワークのサンドボックスの外にある。承認はかかるが、封じ込めはされない。サーバー側で読み取り専用と宣言したツールは、既定の承認モードでは確認なしで実行される点も覚えておきたい。

どちらも封じ込めには頼れないので、中身を読んでから入れるのが基本になる。

5. 信頼していないリポジトリでも .agents/memory/ は読まれる

Muse Code には、エージェント向けのメモを Markdown で残しておく「メモリ」がある。範囲は3つだ。

  • 個人のプロジェクトメモリ(既定):リポジトリの外に保存され、自分だけが使う
  • プロジェクトメモリ:リポジトリの .agents/memory/ にコミットされ、clone した全員に共有される
  • 個人メモリ:マシン全体で使うメモ

ワークスペースを信頼していなければ、プロジェクトのスキル・ルール(AGENTS.md など)・hooks は読み込まれない。ところが、ドキュメントによると、コミットされたプロジェクトメモリは、信頼していないワークスペースでもモデルのコンテキストに読み込まれる。セッションの開始時に、MEMORY.md と、ほかのメモファイルのパス一覧(中身ではなくパスだけ、最大48件)が入る。

ドキュメント自身が、リポジトリの MEMORY.md をプロンプトインジェクションの入口として扱うよう書いていて、自分で管理していないチェックアウトでは中身を確認するよう書いている。他人のリポジトリを試しに clone して Muse Code に読ませるときは、先に .agents/memory/ を見ておく。

同じ理由で、--yolo は使いどころが限られる。--yolo は承認とサンドボックスを両方外すうえに、ワークスペースを信頼済みとして扱う。そのため、チェックアウトの AGENTS.md・ルール・スキルも読み込まれる。ドキュメントは、プルリクエストやフォークのチェックアウトでは、これらが「攻撃者が書いた指示」になりうると警告している。

6. muse exec の終了コード 0 は「正しい」ではない

muse exec は、プロンプトを1つ受け取って最後まで実行し、終了する。CI で使うとき、終了コードの意味を取り違えやすい。

終了コード 意味
0 ターンが完了した
1 失敗、またはキャンセル(--max-model-steps の上限に達した場合を含む)
2 使い方の誤り
130 / 143 SIGINT / SIGTERM

ドキュメントは太字で、終了コードは「実行がどう終わったかであって、作業が正しいかどうかではない」と書いている。エージェントがターンを完了(0)しつつ、「テストが落ちています」と報告することはありうる。CI の合否は、muse exec の後に自分のテストコマンドを走らせて決める。

ここまでの内容を CI 向けにまとめると、次のようになる。

# 認証は API キーで(シークレットから渡す)
export META_API_KEY="$MUSE_KEY"

# 学習には使わせない。承認は飛ばすが、サンドボックスは残す
muse exec --contributor-mode off --disable-approval --max-model-steps 50 \
  "Update the changelog for the latest release and run the tests."

# 合否はエージェントの終了コードではなく、自分のテストで判定する
npm test

--disable-approval は、承認を飛ばしつつサンドボックスは有効なままにする。Linux のランナーでは、サンドボックスのために bubblewrap が動き、musl ではないビルドを使っていることが前提になる。承認とサンドボックスの両方を外す --yolo は、信頼できるコードを使い捨ての隔離コンテナで動かすときだけにとどめる。

なお、サブスクリプションが適用されるのは、CLI のオンボーディングで自動的に接続される API キーだけだ。自分で追加発行した API キーは従量課金になり、Contributor モードの設定自体が出てこない。CI でどちらのキーを使うかで、この設定が効くかどうかも変わる。暴走したときの上限として --max-model-steps も付けておく(50 は例)。

Claude Code から来る人への補足

Claude Code を使っている場合、Muse Code は手元の資産をかなり読みに来る。

  • プロジェクトの指示ファイルは、ディレクトリごとに AGENTS.md、CLAUDE.md、.agents/AGENTS.md、.claude/CLAUDE.md の順で探し、最初に見つかった1つだけを使う。ワークスペースのルートから最寄りの .git まで遡って階層ごとに探し、深い階層のファイルが優先される
  • スキルは、~/.claude/skills と、リポジトリの .claude/skills も既定で探す。muse skills import --from claude で取り込むこともできる

便利な反面、Claude Code 向けに書いたスキルがそのまま Muse Code に読まれる。上で書いた「信頼」の判断は、.claude/ 配下も含めて考えておく必要がある。~/.claude/skills はユーザースキル扱いで、ワークスペースの信頼とは関係なく読まれる。不要なら、ユーザー設定で外部のスキル置き場を無効にできる。同じ階層に AGENTS.md と CLAUDE.md があると、CLAUDE.md は読まれない点にも注意したい。

まとめ

  • Muse Code は、承認・段ごとの審査・OS サンドボックス・.git などの読み取り専用化と、守りの仕組みが最初から入っている。既定の権限プロファイルは、自動の判定役が承認を代行する Auto-review
  • 一番の確認ポイントは Contributor モード。サブスクでは既定でオンで、送ったコードが学習に使われる。muse exec では設定ファイルの状態でオン/オフが変わるので、CI では --contributor-mode off か MUSE_CONTRIBUTOR_MODE=0 を毎回付ける
  • hooks と MCP はサンドボックスの外で動き、.agents/memory/ は信頼していないリポジトリでも読まれ、muse exec の終了コード 0 は作業が正しいことを意味しない。どれもドキュメントに明記されているが、既定のまま使っていると気づきにくい

この記事は Zenn にも同じ内容を投稿しています。

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?