Codex CLI のエラー

Error: plugin requires --marketplace unless passed as <plugin>@<marketplace>

結論

プラグイン名だけでは足りない状態。どのマーケットプレイスのものかを必ず指定する。

確認した版 Codex CLI v0.153.0
確認日 2026年9月3日
最終更新 2026年9月3日
根拠 実機で確認

エラー文字列

Codex CLI
Error: plugin requires --marketplace unless passed as <plugin>@<marketplace>

⚠️ 標準エラーに出て、終了コードは 1 です。 plugin addplugin 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 を別引数にすると、渡し忘れが起きやすい

この手順で直りませんでしたか?

環境を添えて報告いただければ、追加の原因を検証してこのページに反映します。

エラーを報告する