Cài đặt MercaderIA từng bước
Không cần kiến thức kỹ thuật. Chúng tôi cho bạn biết chính xác bạn sẽ thấy gì trên màn hình ở mỗi bước và phải làm gì nếu bạn không thấy. Nếu cái gì đó có vẻ lạ, nó hầu như luôn bình thường: chúng tôi sẽ giải thích khi cần.
MercaderIA dựa vào bốn thành phần. Bạn không cần phải hiểu cách chúng hoạt động, chỉ cần chúng ở đó:
- Node.js: Động cơ chạy các công cụ ở phía dưới.
- Git: Một tiện ích mà các công cụ đó sử dụng nội bộ.
- Claude Code: Trí tuệ nhân tạo sẽ làm việc trong cửa hàng của bạn.
- MercaderIA: Hệ thống agéntica làm cho toàn bộ cửa hàng của bạn tự động hóa.
Điều quan trọng nhất trên toàn trang này
MercaderIA cài đặt Git và Claude Code cho bạn, nhưng bạn phải cài đặt Node.js trước. Nếu bạn bỏ qua thứ tự này, ứng dụng sẽ cho bạn biết rằng thiếu cái gì đó. Hãy bắt đầu từ bước 1.
Điều này diễn ra trước khi tải xuống MercaderIA. Truy cập trang web chính thức và tải xuống phiên bản có nêu LTS.
Tải xuống Node.js LTSLTS có nghĩa là "phiên bản ổn định với hỗ trợ dài hạn". Nếu bạn thấy hai nút, luôn chọn nút LTS, không bao giờ chọn nút nói "Current".
Khi cài đặt: tiếp theo, tiếp theo, tiếp theo. Không thay đổi bất cứ điều gì, chấp nhận tất cả mặc định.
Đóng tất cả các terminal và khởi động lại máy tính
Nếu đây là lần đầu tiên bạn cài đặt Node, hãy khởi động lại máy tính. Hệ thống mất một khoảng thời gian để "nhận ra" có một chương trình mới, và khởi động lại là cách chắc chắn để nó biết. Điều này tránh lỗi phổ biến nhất trong toàn bộ quá trình cài đặt.
Kiểm tra xem nó có hoạt động:
Mở Terminal (chúng tôi sẽ giải thích cách làm ở bước 2) và viết:
node --versionNó phải trả lời điều gì đó giống như v22.14.0. Nếu nó làm, chúng tôi xong.
Nếu nó nói “command not found: node”, nó chưa được cài đặt hoặc bạn chưa khởi động lại: khởi động lại và thử lại.
Terminal là một cửa sổ nơi bạn viết lệnh dưới dạng văn bản, nhấn Enter và chương trình trả lời cho bạn. Không gì khác. Bạn sẽ không phá hỏng bất cứ điều gì.
macOS
- Nhấn Cmd + Không gian.
- Viết terminal.
- Nhấn Enter.
Windows
- Nhấn phím Windows.
- Viết powershell.
- Mở Windows PowerShell.
maria@MacBook ~ % node --version v22.14.0 maria@MacBook ~ %
Cửa sổ đen hoặc xanh với văn bản hoàn toàn bình thường: đây là cách terminal mới mở trông như thế nào.
Sao chép và dán được phép (và được khuyên)
Không cần phải viết bất cứ điều gì bằng tay. Sử dụng nút Sao chép từ mỗi khối trong hướng dẫn này và dán vào terminal bằng Cmd + V.
Mẹo hữu ích cho tương lai: nếu terminal yêu cầu mật khẩu, bạn sẽ không thấy bất cứ điều gì khi bạn viết — không phải dấu chấm cũng không phải dấu sao. Đó là bảo vệ, nó không bị hỏng. Với MercaderIA, nó sẽ không xảy ra cho bạn, nhưng điều này rất tốt để biết.
Có hai cách. Cả hai đều hợp lệ:
Tùy chọn A — bằng tay từ terminal (được khuyến nghị)
Mở Terminal và dán dòng này:
curl -fsSL https://claude.ai/install.sh | bashTùy chọn B — để MercaderIA làm điều đó
Khi mở MercaderIA lần đầu tiên, một trợ lý phát hiện những gì bị thiếu và cài đặt Git và Claude Code một mình. Đó là cách dễ nhất, nhưng đôi khi mất thời gian để lan truyền và bạn phải đóng và mở lại ứng dụng để nó công nhận. Khởi động lại máy tính hoặc chờ vài phút sẽ kết nối mọi thứ một mình. Điều này chỉ xảy ra lúc đầu: nó không bao giờ xảy ra lại khi đã kết nối.
Sẽ có khá nhiều văn bản chạy qua màn hình. Đó là bình thường. Nó kết thúc khi dòng nơi bạn viết lại xuất hiện ($).
Sau khi cài đặt Claude Code, bạn viết claude trong terminal và nó trả lời:
zsh: command not found: claude
Đừng lo lắng: đó là điều dự kiến, không phải là lỗi lạ. Chương trình được cài đặt, nhưng nó được lưu trong một thư mục mà terminal không có trong danh sách các nơi để tìm kiếm. Nó giống như có cuốn sách ở nhà nhưng không ở trên kệ nơi bạn luôn nhìn: bạn phải cho máy tính biết nó ở đâu.
macOS — dán hai dòng này, một cái sau cái kia:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrcsource ~/.zshrcThứ nhất thêm thư mục vào danh sách vĩnh viễn (ví dụ /Users/maria/.local/bin). Thứ hai làm cho terminal nhận ra ngay bây giờ, không cần khởi động lại.
Kiểm tra với:
claude --versionNếu vẫn không hoạt động, không có gì nghiêm trọng
MercaderIA tìm kiếm chương trình trong nhiều thư mục khác nhau và thường tìm thấy nó ngay cả khi terminal không thấy nó. Tiếp tục và thử ứng dụng.
Claude Code cần một tài khoản. Lần đầu tiên nó yêu cầu đăng nhập: một tab trình duyệt mở ra, bạn đăng nhập bằng tài khoản Claude của mình, chấp nhận và quay lại ứng dụng.
MercaderIA mở tab đó tự động khi vừa cài đặt xong Claude Code lần đầu tiên. Nếu bạn đã có Claude cài đặt từ trước, ứng dụng cho rằng bạn đã đăng nhập và không mở nó. Nếu hóa ra bạn chưa, nó được sửa bằng cách mở terminal và viết:
claude…và làm theo những gì xuất hiện trên màn hình.
Đó là hai điều khác nhau, đừng nhầm lẫn chúng
Bạn cần một tài khoản Claude với kế hoạch hoạt động và, riêng biệt, một giấy phép MercaderIA. Cái này không bao gồm cái kia.
Nếu macOS nói rằng nó không thể kiểm tra nhà phát triển
Mở .dmg và kéo MercaderIA vào thư mục Ứng dụng. Nếu khi mở nó xuất hiện cảnh báo, nhấp chuột phải trên ứng dụng → Mở → Mở. Nó xuất hiện vì ứng dụng chưa được ký bởi Apple, không phải vì nó nguy hiểm.
Bạn sẽ thấy một danh sách có Git, Claude Code và Node.js, mỗi cái có trạng thái của nó, và ứng dụng tự động cài đặt những gì bị thiếu.
- Node.jsTìm thấy — v22.14.0
- GitĐang cài đặt…
- Claude CodeKhông tìm thấy
Nếu cái gì đó vẫn hiển thị là "không tìm thấy" sau khi cài đặt nó
Đóng MercaderIA hoàn toàn và mở lại nó. Ứng dụng kế thừa danh sách các chương trình từ hệ thống tại thời điểm khởi động, vì vậy những gì được cài đặt trong khi nó mở sẽ không thấy nó cho đến khi khởi động tiếp theo. Nó không phải là một lỗi, đó là cách nó hoạt động. Trên máy tính nơi không bao giờ cài đặt bất cứ điều gì như thế này, bình thường phải khởi động lại ứng dụng một hoặc hai lần trước khi mọi thứ trở nên xanh.
Nếu danh sách có vẻ bị đóng băng, nó đang kiểm tra
Kiểm tra từng chương trình chờ tối đa 10 giây. Cho nó thời gian.
Ứng dụng sẽ yêu cầu địa chỉ cửa hàng của bạn với định dạng này:
mitienda.myshopify.comChú ý: đó là địa chỉ đó, không phải tên miền tốt đẹp của cửa hàng bạn. Để tìm nó, nhập bảng điều khiển Shopify → Cài đặt → Tên miền: tên miền .myshopify.com của bạn xuất hiện ở đó, được đánh dấu là tên miền nội bộ Shopify.
Sau đó trình duyệt mở ra với màn hình Shopify yêu cầu xác thực quyền hạn. Đó là một danh sách dài và bình thường: trợ lý cần có khả năng đọc và chỉnh sửa sản phẩm, đơn hàng, hàng tồn kho, vận chuyển và hoàn trả để có thể làm việc cho bạn. Xem xét và chấp nhận nó.
Nếu bạn đã kết nối cửa hàng trước đây
Ứng dụng có thể yêu cầu bạn xác thực lại để thêm quyền hạn mới từ phiên bản gần đây hơn. Đó là dự kiến, nó không phải là một lỗi.
Đánh dấu từng điểm. Nếu năm điểm đó, bạn đã có thể bắt đầu làm việc bằng cách nói chuyện với cửa hàng của bạn.
Các vấn đề thường gặp
claude: command not found / "không nhận ra lệnh"
Chương trình được cài đặt nhưng terminal không biết tìm kiếm ở đâu. Áp dụng bản sửa của bước 4 (PATH) và thử lại với claude --version. Trong Windows, đóng và mở lại PowerShell.
node: command not found sau khi cài đặt Node
Khởi động lại máy tính. Hệ thống cần phải khởi động lại để đăng ký chương trình mới. Sau đó thử node --version.
Ứng dụng nói rằng thiếu cái gì đó mà tôi đã cài đặt
Đóng MercaderIA hoàn toàn và mở lại nó. Ứng dụng đọc môi trường khi khởi động; những gì được cài đặt trong khi nó mở sẽ không được nhìn thấy cho đến khi khởi động tiếp theo.
Màn hình quyền hạn Shopify có lỗi
Đóng tab và khởi động lại kết nối từ ứng dụng. Nếu nó tiếp tục, hãy viết cho chúng tôi bằng ảnh chụp màn hình.
macOS không cho phép tôi mở ứng dụng
Nhấp chuột phải trên MercaderIA trong Ứng dụng → Mở → Mở. Đó là cảnh báo ứng dụng không ký, không phải là vấn đề bảo mật thực sự.
Windows nói rằng chương trình không an toàn
Thêm thông tin → Chạy dù sao. SmartScreen hiển thị cảnh báo đó với bất kỳ trình cài đặt mới nào.
Trên máy tính mới, nó không phát hiện bất cứ điều gì
Đây là trường hợp bình thường. Thứ tự chính xác: cài đặt Node.js, khởi động lại máy tính, mở MercaderIA và để nó cài đặt Git và Claude Code, và khởi động lại ứng dụng. Tất cả đều xanh.
Bạn vẫn bị kẹt?
Hãy viết cho chúng tôi và chúng tôi sẽ hỗ trợ bạn cho đến khi nó hoạt động. Hãy cho chúng tôi biết bạn đang làm bước nào và những gì xuất hiện trên màn hình của bạn (ảnh chụp màn hình rất hữu ích).
todo@mercaderia.co