装好并登录 Shopify CLI

Shopify CLI 是 Shopify 官方的命令行工具。建站岗位的「网页模板」用它做三件事：把你的主题拉到本机、改好之后推成一份未发布副本给你预览、跑官方的 Liquid 检查。上线（发布主题）永远等你在卡上点头。

这一篇只在你的品牌是 Shopify 店时有用；别的建站平台不需要装它。

1. 一键安装

1. 打开建站岗位页（或连接页），找到「Shopify CLI」那张卡。
2. 点 一键安装，等它从「正在下载」走到「装好了」，一般一两分钟。

• 不用开终端、不用自己装 Node：Agents 工坊用安装包里自带的那份 Node，把 CLI 装进它自己的数据目录，不改系统设置、不要管理员权限。
• 你电脑上本来就装过 Shopify CLI 的，卡上会直接认出来，不用再装。
• 失败了卡上会说一句原因（多半是网络或代理），点「重试」即可；想看具体输出，点「详情」。

2. 登录 Shopify（你自己登）

1. 装好之后点 登录 Shopify，浏览器会打开 Shopify 的登录页。
2. 用你管理这家店的账号登进去、按提示确认（网页上的确认码和卡上显示的一样）。
3. 登完回到工作台，卡片会自己变绿。

• 浏览器没弹出来：点卡上的「没弹出来？点这里打开」。
• 不想登了：点「取消」。
• 账号和密码只在 Shopify 自己的页面上输入，Agents 工坊不经手、不保存。
• 登录后的凭据由 Shopify CLI 自己存在你电脑上它自己的位置，我们不读它，也不写进任何日志。

3. 想自己在终端里装（可选）

习惯用终端的话，「详情」里有这两条命令可以复制：

npm install -g @shopify/cli@latest
shopify auth login

这样装要求 Node.js 22 或更新。装完回到卡上点「重新检查」。想退出登录：在终端里跑 shopify auth logout。

4. 装好之后会怎样

• 网页模板在改主题时会：拉主题 → 在本机副本里改 → 跑 shopify theme check → 推一份未发布副本 → 把预览链接放在卡上给你看。
• 发布主题、删除主题这类会换掉顾客看到那一份的事，一律出卡等你批。
• 它只跑 shopify theme 这一组命令，不跑别的。

常见问题

• 没装会怎样：不影响别的岗位。网页模板会先走店铺后台接口改主题文件，只是没法本地预览、也跑不了官方检查。
• 我的品牌改成了别的平台：这张卡会自动消失，相关的 Shopify 技能也会停用；你电脑上装好的 CLI 我们不会去卸。
• 公司里有好几个品牌：每个品牌各自判断。Shopify 的品牌才会看到这张卡。
• CLI 会上报使用数据吗：Agents 工坊在替你跑 CLI 时会带上 SHOPIFY_CLI_NO_ANALYTICS=1，把它的使用统计关掉。