Shopify AI Toolkit 用 plugin add shopify@openai-curated，不要抄 Claude 插件名

Shopify AI Toolkit 官方给 Codex 的推荐路径是装插件（文档检索、API schema、GraphQL / Liquid / 扩展校验，以及经 Shopify CLI 的店铺任务）。插件会随发布自动更新：

codex plugin add shopify@openai-curated
codex plugin list

插件 id 是 shopify@openai-curated。TUI /plugins 或桌面 Plugins 搜 Shopify 再装，效果一样。0.154 起先在当前会话看 /plugins；当前会话没有再新开。IDE 扩展没有 /plugins，用下面的 MCP 回退。需要 Node.js 18+。

只要开发者文档和 schema、不要整包插件时，官方 Codex 节是本地 stdio，无鉴权：

codex mcp add shopify-dev-mcp -- npx -y @shopify/dev-mcp@latest

[mcp_servers.shopify-dev-mcp]
command = "npx"
args = ["-y", "@shopify/dev-mcp@latest"]
enabled = true
startup_timeout_sec = 60

用户层表名官方就是带连字符的 shopify-dev-mcp（这不是插件 mcp.json，#33063 那套连字符问题不套这里）。冷 npx 握手默认 10 秒不够，先把 startup_timeout_sec 提到 30–60。这台不会登录你的店铺；改生产店铺仍走 Shopify CLI 的已认证上下文，不要把 Dev MCP 当成 Admin API 钥匙。

技能回退 npx skills add Shopify/shopify-ai-toolkit 不会随仓库自动更新，官方明确说要自己拉。那是给所有检测到的客户端拷 SKILL.md，不是 Codex /plugins。不确定就别跑。也不要手拷到 ~/.codex/skills。

遥测默认开。技能脚本和 MCP 子进程可能把检索词、校验代码片段送去 shopify.dev/mcp/usage。OPT_OUT_INSTRUMENTATION=true 只在子进程真继承到环境时有效；Codex exec 和从 Dock 拉起的桌面常常没有。官方推荐放一个空文件：

mkdir -p ~/.config/shopify-ai-toolkit && touch ~/.config/shopify-ai-toolkit/opt-out

不要做这些：

• 不要抄 Claude 的 claude plugin install shopify-ai-toolkit@claude-plugins-official。Codex 插件 id 是 shopify@openai-curated。
• 不要抄 Cursor 的 /add-plugin shopify。
• 不要抄 Claude 的 --transport stdio 或 mcpServers JSON。
• 不要把 Windows 的 cmd /k npx 包装抄进 WSL。
• 不要给 Dev MCP required = true 挂全局。
• 不要一上来 --yolo。扩展迁移和店铺命令仍要人审。

网页 Cloud 不读 ~/.codex/config.toml。改完用 codex plugin list 看 shopify@openai-curated，或 codex mcp get shopify-dev-mcp 看 command 是 npx。