Error: plugin requires --marketplace unless passed as <plugin>@<marketplace>
結論
プラグイン名だけでは足りない状態。どのマーケットプレイスのものかを必ず指定する。
確認した版
Codex CLI v0.153.0
確認日
2026年9月3日
最終更新
2026年9月3日
根拠
実機で確認
エラー文字列
Error: plugin requires --marketplace unless passed as <plugin>@<marketplace>
⚠️ 標準エラーに出て、終了コードは 1 です。 plugin add と plugin remove の両方で出ます。
何が起きているか
プラグイン名だけでは、どこのプラグインか決まりません。
Codex のプラグインは「マーケットプレイス」単位で管理されます。同じ名前のプラグインが別のマーケットプレイスにあり得るため、どちらを指すのかを必ず示す必要があります。
v0.149.0 で実測した対応表です。
| 実行したもの | 結果 |
|---|---|
codex plugin add foo |
Error: plugin requires --marketplace unless passed as <plugin>@<marketplace> |
codex plugin add foo@some-market |
次の段階へ進む(下記) |
次に出るもの
指定の形が正しくても、実在しなければこうなります。
Error: plugin `foo` was not found in marketplace `nonexistent-market`
⭐ メッセージが変わったら、書式は正しいということです。 あとは名前が実在するかだけの問題になります。
直し方
1. どのマーケットプレイスがあるか確認する
codex plugin marketplace list
⚠️ No plugin marketplaces in scope. と出たら、まだ1つも登録していません。 その状態ではどのプラグインも入れられません。先にマーケットプレイスを追加してください。
2. 入れられるプラグインを一覧する
codex plugin list
⭐ ここに出る名前をそのまま使ってください。 表示名ではなく識別子です。
3. 2つの書き方のどちらかで指定する
codex plugin add my-plugin@my-market
codex plugin add my-plugin --marketplace my-market
⚠️ 削除するときも同じ指定が要ります。 名前だけでは同じエラーになります。
codex plugin remove my-plugin@my-market
4. 入ったことを確認する
codex plugin list
再発防止
- プラグイン名は必ずマーケットプレイスとセットで扱う(
名前@マーケット) - 追加・削除の前に
codex plugin marketplace listで登録状況を見る - スクリプトに書くときは
名前@マーケットの形で固定する。--marketplaceを別引数にすると、渡し忘れが起きやすい