I-install ang MercaderIA hakbang sa hakbang
Walang kailangang teknikal na kaalaman. Sasabihin namin sa iyo ng eksakto kung ano ang makikita mo sa screen sa bawat sandali at ano ang gawin kung hindi mo ito makikita. Kung may kakaibang pakiramdam, karamihan ng oras ito ay normal: ipapasalaysay namin sa iyo kapag kailangan.
Ang MercaderIA ay umaasa sa apat na piraso. Hindi mo kailangang maintindihan kung paano sila gumagana, kailangan lang na mayroon ka ng ito:
- Node.js: Ang engine na nagpapatakbo sa mga tool sa likod.
- Git: Isang utility na ginagamit ng mga tool na ito sa loob.
- Claude Code: Ang artificial intelligence na magtatrabaho sa iyong store.
- MercaderIA: Ang agentic system na gumagawang automatic ang lahat ng iyong store.
Ang pinakamahalagang bahagi ng buong pahina na ito
Ang MercaderIA ay mag-i-install ng Git at Claude Code para sa iyo, ngunit kailangan mong i-install ang Node.js mo mismo muna. Kung laktawan mo ang order na ito, ang app ay magsasabi na may kulang. Magsimula sa hakbang 1.
Ito ay dapat bago i-download ang MercaderIA. Pumunta sa opisyal na website at i-download ang bersyon na sinasabing LTS.
I-download ang Node.js LTSLTS ay nangangahulugang "stable version na may long-term support". Kung makikita mo ang dalawang button, piliin lagi ang LTS, hindi kailanman ang sinasabing "Current".
Kapag ini-install ito: susunod, susunod, susunod. Huwag baguhin ang kahit ano, tanggapin ang lahat ng default.
Isara ang lahat ng terminal at i-restart ang computer
Kung ito ang unang pagkakataon mong nag-install ng Node, i-restart ang iyong computer. Ang system ay tumatagal upang "mapasin" na may bagong programa, at ang pag-restart ay ang siguradong paraan upang ito ay makaalam. Ito ay nakakaiwas sa pinakakaraniwang error ng buong installation.
Suriin na ito ay gumana:
Buksan ang Terminal (ipapasalaysay namin sa iyo kung paano sa hakbang 2) at isulat:
node --versionDapat itong sumagot tulad ng v22.14.0. Kung gayon, tapos na.
Kung sinasabi nito ang “command not found: node”, hindi ito nag-install o hindi ka nag-restart: i-restart at subukan ulit.
Ang terminal ay isang window kung saan isusulat mo ang mga utos sa teksto, pindutin ang Enter at ang programa ay sumagot sa iyo. Iyan lang. Hindi ka makakasira ng kahit ano.
macOS
- Pindutin ang Cmd + Space.
- Isulat ang terminal.
- Pindutin ang Enter.
Windows
- Pindutin ang Windows key.
- Isulat ang powershell.
- Buksan ang Windows PowerShell.
maria@MacBook ~ % node --version v22.14.0 maria@MacBook ~ %
Ang itim o asul na window na may teksto ay ganap na normal: ganito ang hitsura ng isang terminal na kakapuksa ng bukas.
Kopya at pasta ay pinapayagan (at inirerekumenda)
Hindi mo kailangang isulat ang kahit ano nang manu-mano. Gamitin ang Kopyahin na button ng bawat block sa gabay na ito at i-paste sa terminal gamit ang Cmd + V.
Kapaki-pakinabang na tip para sa hinaharap: kung ang terminal ay nagtatanong sa iyo ng password, hindi makikita ang kahit ano habang isinusulat mo — walang mga tuldok o asterisk. Ito ay proteksyon, hindi ito sira. Sa MercaderIA hindi ito mangyayari sa iyo, ngunit dapat mong malaman.
May dalawang paraan. Pareho ang bisa:
Opsyon A — manu-mano mula sa terminal (inirerekumenda)
Buksan ang Terminal at i-paste ang linyang ito:
curl -fsSL https://claude.ai/install.sh | bashOpsyon B — hayaan ang MercaderIA na gawin ito
Kapag binuksan mo ang MercaderIA sa unang pagkakataon, isang assistant ay nakakahanap kung ano ang kulang at nag-i-install ng Git at Claude Code mag-isa. Ito ang pinakamadali, ngunit minsan ay tumatagal upang kumalat at kailangang isara at muling buksan ang app upang ito ay makita. Ang pag-restart ng iyong computer o paghihintay ng ilang minuto ay kumonekta ang lahat nang mag-isa. Ito ay nangyayari lamang sa simula: hindi na kailanman mangyari muli kapag naka-konekta na.
Maraming teksto ang dadaan sa screen. Ito ay normal. Natapos na ito kapag ang linya kung saan isinusulat mo ay muling lumitaw ($).
Pagkatapos i-install ang Claude Code, isinusulat mo ang claude sa terminal at ito ay tumutugon sa iyo:
zsh: command not found: claude
Relax: ito ay inaasahan, hindi ito isang kakaibang error. Ang programa ay tunay na naka-install, ngunit nananatili ito sa isang folder na ang terminal ay walang sa kanyang listahan ng mga lugar na dapat tuklasin. Ito ay parang may libro sa bahay ngunit hindi sa bookshelf kung saan lagi kang tumingin: kailangan mong sabihin sa computer kung nasaan ito.
macOS — i-paste ang dalawang linyang ito, isa pagkatapos ng isa:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrcsource ~/.zshrcAng una ay nagdadagdag ng folder sa listahan nang permanente (halimbawa /Users/maria/.local/bin). Ang pangalawa ay gumagawang ang terminal ay nakakita na, nang walang pag-restart.
Suriin gamit ang:
claude --versionKung hindi pa rin ito gumagana, hindi ito malaking problema
Ang MercaderIA ay naghahanap ng programa sa maraming iba't ibang folder at karaniwan itong nakakahanap kahit ang terminal ay hindi ito nakikita. Magpatuloy at subukan ang app.
Ang Claude Code ay kailangan ng account. Ang unang pagkakataon ay nagtatanong ito na mag-sign in: isang tab ng browser ay bubuksan, papasok ka gamit ang iyong Claude account, tumatanggap at bumalik sa app.
Ang MercaderIA ay binabuksan ang tab na iyon nang awtomatiko kapag tapos na itong nag-install ng Claude Code sa unang pagkakataon. Kung mayroon na kang Claude na naka-install dati, ang app ay ipapalagay na nag-sign in ka na at hindi ito bubuksan. Kung ito ay nangyari na walang ginawa, inayos ito sa pamamagitan ng pagbubukas ng terminal at pagsulat:
claude…at sumusunod sa lilitaw sa screen.
Dalawang magkakaibang bagay ang ito, huwag gawing kalito
Kailangan mo ng Claude account na may active plan at, nang hiwalay, isang lisensya ng MercaderIA. Ang isa ay hindi kasama ang iba.
Kung ang macOS ay hindi pinapayagan kang buksan ang app
Buksan ang .dmg at i-drag ang MercaderIA sa Applications folder. Kung ang pagsisimula ay nagpapakita ng babala, i-right click ang app → Buksan → Buksan. Ito ay lumilitaw dahil ang app ay hindi pa naka-sign ng Apple, hindi dahil ito ay mapanganib.
Makikita mo ang isang listahan na may Git, Claude Code at Node.js, bawat isa ay may status nito, at ang app ay nag-i-install mag-isa kung ano ang kulang.
- Node.jsNahanap — v22.14.0
- GitNag-i-install…
- Claude CodeHindi nahanap
Kung may kahit ano pa ring lumalabas bilang "hindi nahanap" pagkatapos i-install ito
Isara ang MercaderIA nang buo at buksan itong muli. Ang app ay nag-inherit ng listahan ng mga programa mula sa system sa sandaling ito ay nagsimula, kaya ang na-install habang ito ay bukas ay hindi ito nakikita hanggang sa susunod na pagsisimula. Hindi ito isang error, ganyan ito gumagana. Sa isang computer kung saan hindi kailanman na-install ang kahit ano dito, normal na kailangang i-restart ang app minsan o dalawang beses bago lahat ay lumabas sa berde.
Kung ang listahan ay parang naka-freeze, sinusuri ito
Ang pagsusuri ng bawat programa ay naghihintay ng hanggang 10 segundo. Bigyan ito ng oras.
Ang app ay magtatanong sa iyo para sa address ng iyong store sa format na ito:
mitienda.myshopify.comPansin: ito ang address, hindi ang magandang domain ng iyong store. Upang mahanap ito, pumunta sa Shopify dashboard → Mga setting → Domains: doon lumilitaw ang iyong .myshopify.com domain, minarkahan bilang internal Shopify domain.
Pagkatapos ay bubuksan ang browser na may screen ng Shopify na humihiling ng pahintulot sa authorization. Ito ay isang mahabang listahan at normal: ang assistant ay kailangan na makabasa at mag-edit ng mga produkto, order, inventory, shipping at returns upang magtrabaho para sa iyo. Suriin itong mabuti at tanggapin.
Kung nag-konekta ka na ng store dati
Ang app ay maaaring muling humingi ng authorization upang magdagdag ng bagong pahintulot mula sa mas bagong bersyon. Ito ay inaasahan, hindi ito isang error.
Markahan ang bawat punto. Kung nandoon ang lahat ng lima, magsimula ka na ng pagsasalita sa iyong store.
Mga karaniwan na problema
claude: command not found / "hindi kinikilala ang command"
Ang programa ay naka-install ngunit ang terminal ay hindi alam kung saan hanapin ito. I-apply ang ayos mula sa hakbang 4 (PATH) at subukan muli gamit ang claude --version. Sa Windows, isara at muling buksan ang PowerShell.
node: command not found pagkatapos i-install ang Node
I-restart ang computer. Ang system ay kailangan na mag-reboot upang ilatala ang bagong programa. Pagkatapos subukan ang node --version.
Ang app ay nagsasabi na may kulang na bagay na na-install ko na
Isara ang MercaderIA nang buo at buksan itong muli. Ang app ay binabasa ang kapaligiran sa pagsisimula; ang na-install habang ito ay bukas ay hindi ito nakikita hanggang sa susunod na pagsisimula.
Ang screen ng Shopify permissions ay nagkakaroon ng error
Isara ang tab at muling i-launch ang koneksyon mula sa app. Kung patuloy pa rin, magsulat sa amin ng screenshot.
Ang macOS ay hindi pinapayagan akong buksan ang app
I-right click ang MercaderIA sa Applications → Buksan → Buksan. Ito ang babala ng app na walang naka-sign, hindi isang tunay na problema sa seguridad.
Ang Windows ay nagsasabi na ang programa ay hindi secure
Mas maraming impormasyon → I-execute nang lahat. Ang SmartScreen ay nagpapakita ng babala na ito sa bagong installer.
Sa bagong computer ay hindi ito nakakahanap ng kahit ano
Ito ay normal. Tamang order: i-install ang Node.js, i-restart ang computer, buksan ang MercaderIA at hayaan itong mag-install ng Git at Claude Code, at i-restart ang app. Lahat sa berde.
Stuck ka pa ba?
Magsulat sa amin at kasama ka namin hanggang ito ay gumagana. Sabihin sa amin kung aling hakbang ang ginagawa mo at ano ang lumabas sa screen (ang screenshot ay tumutulong ng malaki).
todo@mercaderia.co