MercaderIA
Comprar
安装指南

分步安装 MercaderIA

无需技术基础。我们会告诉你每一步屏幕上会出现什么,以及看不到时该怎么办。如果某处看起来奇怪,通常都是正常的:我们会在对应位置解释。

步骤 0: 你要安装什么、为什么

MercaderIA 依赖四个组件。你不需要理解它们如何运作,只要它们在就行:

  • Node.js: 驱动底层工具运行的引擎。
  • Git: 这些工具内部使用的一个实用程序。
  • Claude Code: 将在你店铺里工作的人工智能。
  • MercaderIA: 让你整个店铺自动化的智能体系统。

整页最重要的一点

MercaderIA 会替你安装 Git 和 Claude Code,但 Node.js 必须你自己先装。跳过这个顺序,应用会提示缺少组件。请从步骤 1 开始。

步骤 1: 安装 Node.js(始终第一步)

这一步在下载 MercaderIA 之前。进入官网,下载标注 LTS 的版本。

下载 Node.js LTS

LTS 表示“长期支持的稳定版本”。如果看到两个按钮,永远选 LTS,不要选 “Current”。

安装时:下一步、下一步、下一步。什么都不要改,全部保持默认。

关闭所有终端并重启电脑

如果这是你第一次安装 Node,请重启电脑。系统需要一点时间才会“发现”新程序,重启是最稳妥的办法。这能避免整个安装过程中最常见的错误。

确认是否成功:

打开Terminal(步骤 2 有说明),输入:

zsh — Terminal
node --version

它应该回应类似 v22.14.0 的内容。出现了就说明成功。

如果提示 “command not found: node”,说明没装好或者没重启:重启后再试。

步骤 2: 如何打开终端

终端就是一个窗口:你输入文字命令,按回车,程序回应。仅此而已。你不会弄坏任何东西。

macOS

  1. 按 Cmd + 空格。
  2. 输入 terminal。
  3. 按回车。

Windows

  1. 按 Windows 键。
  2. 输入 powershell。
  3. 打开 Windows PowerShell。
maria@MacBook ~ % node --version
v22.14.0
maria@MacBook ~ %

满是文字的黑色或蓝色窗口完全正常:刚打开的终端就是这样。

允许复制粘贴(而且推荐)

不需要手动输入任何内容。使用本指南每个代码块的“复制”按钮,然后用 Cmd + V 粘贴到终端。

以后有用的小知识:如果终端某天要求输入密码,输入时屏幕上什么都不会显示 — 没有圆点也没有星号。这是保护机制,不是坏了。用 MercaderIA 不会遇到,但值得知道。

步骤 3: 安装 Claude Code

有两条路。两条都可以:

方案 A — 在终端手动安装 (推荐)

打开Terminal,粘贴这一行:

zsh — Terminal
curl -fsSL https://claude.ai/install.sh | bash

方案 B — 让 MercaderIA 来做

首次打开 MercaderIA 时,助手会检测缺少什么并自动安装 Git 和 Claude Code。这是最省事的方式,但有时生效较慢,需要关闭并重新打开应用才能识别。重启电脑或等几分钟,一切会自动连上。这只发生在开始阶段:连接成功后不会再出现。

屏幕上会滚动很多文字。这是正常的。当输入行再次出现($)就表示完成。

步骤 4: PATH 问题

安装完 Claude Code 后,你在终端输入 claude,它回应:

zsh: command not found: claude

别紧张:这是预期之中的,不是奇怪的故障。程序确实已安装,只是被放在了终端搜索列表之外的文件夹里。就像书在家里,却不在你常翻的那个书架上:得告诉电脑它在哪。

macOS — 依次粘贴这两行:

zsh — Terminal
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

zsh — Terminal
source ~/.zshrc

第一行把该文件夹永久加入列表(例如 /Users/maria/.local/bin)。第二行让终端立刻生效,无需重启。

用这条命令确认:

zsh — Terminal
claude --version

如果仍然不行,也没什么大问题

MercaderIA 会在很多不同目录中查找该程序,即使终端看不到通常也能找到。继续往下走,试试应用。

步骤 5: 登录 Claude

Claude Code 需要账号。第一次会要求登录:浏览器打开一个标签页,用你的 Claude 账号登录、确认,然后回到应用。

当 MercaderIA 刚刚首次安装完 Claude Code 时,会自动打开该标签页。如果你之前就装过 Claude,应用会默认你已登录而不打开它。如果其实没登录,只需打开终端输入:

zsh — Terminal
claude

……然后按屏幕提示操作。

这是两件不同的事,别混淆

你需要一个有效套餐的 Claude 账号,另外还需要一份 MercaderIA 许可证。两者互不包含。

步骤 6: 下载并安装 MercaderIA

下载 .dmg(macOS)也提供 Windows 版(.exe)

如果 macOS 提示无法验证开发者

打开 .dmg,把 MercaderIA 拖到“应用程序”文件夹。打开时若出现提示,右键点击应用 → 打开 → 打开。出现提示是因为应用尚未由 Apple 签名,并不是因为它危险。

步骤 7: 首次启动:依赖助手

你会看到 Git、Claude Code 和 Node.js 的列表,各自显示状态,应用会自动安装缺少的部分。

  • Node.js已找到 — v22.14.0
  • Git安装中…
  • Claude Code未找到

如果安装后仍显示“未找到”

完全关闭 MercaderIA 再重新打开。应用在启动时继承系统的程序列表,所以在它运行期间安装的东西,要到下次启动才能看到。这不是故障,而是运行机制。在一台从未装过这些的电脑上,重启应用一两次才全部变绿是很正常的。

如果列表看起来卡住了,那是在检测

每个程序的检测最多等待 10 秒。请耐心等待。

步骤 8: 连接你的 Shopify 店铺

应用会要求输入你的店铺地址,格式如下:

店铺地址
mitienda.myshopify.com

注意:是这个地址,不是你店铺的自定义域名。查找方法:进入 Shopify 后台 → 设置 → 域名,那里会显示标注为 Shopify 内部域名的 .myshopify.com 地址。

随后浏览器会打开 Shopify 授权页面。清单很长,这是正常的:助手需要读取和编辑商品、订单、库存、发货与退货,才能替你工作。查看后同意即可。

如果你之前已经连接过店铺

应用可能会再次请求授权,以添加新版本引入的权限。这是预期行为,不是错误。

步骤 9: 确认一切正常

逐项勾选。五项都完成,你就可以开始用对话来管理店铺了。

常见问题

claude: command not found / “无法识别该命令”

程序已安装,但终端不知道去哪里找。执行步骤 4(PATH)的修复,然后再次运行 claude --version。Windows 上请关闭并重新打开 PowerShell。

安装 Node 后仍提示 node: command not found

重启电脑。系统需要重启才能注册新程序。之后再运行 node --version。

应用提示缺少我已经安装的组件

完全关闭 MercaderIA 再重新打开。应用在启动时读取环境;运行期间安装的内容要到下次启动才能看到。

Shopify 授权页面报错

关闭标签页,从应用重新发起连接。若仍然失败,请附上截图联系我们。

macOS 不让我打开应用

在“应用程序”中右键点击 MercaderIA → 打开 → 打开。这是未签名应用提示,并非真正的安全问题。

Windows 提示程序不安全

更多信息 → 仍要运行。SmartScreen 对新安装包都会显示该提示。

新电脑上什么都检测不到

这是正常情况。正确顺序:安装 Node.js,重启电脑,打开 MercaderIA 让它安装 Git 和 Claude Code,再重启应用。全部变绿。

还是卡住了?

写信给我们,我们会陪你直到跑通。告诉我们你卡在哪一步、屏幕上出现了什么(附截图会非常有帮助)。

todo@mercaderia.co