Pasang MercaderIA Langkah demi Langkah
Tanpa pengetahuan teknis. Kami memberitahu Anda dengan tepat apa yang akan Anda lihat di layar pada setiap saat dan apa yang harus dilakukan jika tidak melihatnya. Jika sesuatu tampak aneh, itu hampir selalu normal: kami akan menjelaskan ketika tiba saatnya.
MercaderIA mengandalkan empat komponen. Anda tidak perlu memahami cara kerjanya, hanya memastikan semuanya ada:
- Node.js: Mesin yang menjalankan alat di bawah permukaan.
- Git: Utilitas yang digunakan alat-alat ini secara internal.
- Claude Code: Kecerdasan buatan yang akan bekerja di toko Anda.
- MercaderIA: Sistem agentic yang mengotomatiskan seluruh toko Anda.
Hal terpenting di seluruh halaman ini
MercaderIA memasang Git dan Claude Code untuk Anda, tetapi Anda harus memasang Node.js sendiri lebih dulu. Jika Anda melewati urutan ini, aplikasi akan memberi tahu Anda bahwa ada yang hilang. Mulai dari langkah 1.
Ini sebelum mengunduh MercaderIA. Masuk ke situs resmi dan unduh versi yang mengatakan LTS.
Unduh Node.js LTSLTS berarti "versi stabil dengan dukungan jangka panjang". Jika Anda melihat dua tombol, selalu pilih yang berlabel LTS, jangan pernah yang mengatakan "Current".
Saat memasangnya: berikutnya, berikutnya, berikutnya. Jangan ubah apa pun, terima semuanya secara default.
Tutup semua terminal dan restart komputer
Jika ini pertama kali Anda memasang Node, restart komputer. Sistem membutuhkan waktu untuk "menyadari" bahwa ada program baru, dan restart adalah cara pasti untuk membuat sistem menyadarinya. Ini mencegah kesalahan paling umum dari seluruh instalasi.
Periksa bahwa itu berhasil:
Buka Terminal (kami akan menjelaskan cara membuka di langkah 2) dan ketik:
node --versionHarus merespons sesuatu seperti v22.14.0. Jika demikian, selesai.
Jika mengatakan “command not found: node”, tidak terpasang dengan baik atau Anda tidak melakukan restart: restart dan coba lagi.
Terminal adalah jendela tempat Anda mengetik perintah dalam teks, menekan Enter, dan program merespons. Itu saja. Anda tidak akan merusak apa pun.
macOS
- Tekan Cmd + Spasi.
- Ketik terminal.
- Tekan Enter.
Windows
- Tekan tombol Windows.
- Ketik powershell.
- Buka Windows PowerShell.
maria@MacBook ~ % node --version v22.14.0 maria@MacBook ~ %
Jendela hitam atau biru dengan teks sama sekali normal: begini tampilan terminal yang baru dibuka.
Menyalin dan menempel diizinkan (dan direkomendasikan)
Tidak perlu mengetik apa pun secara manual. Gunakan tombol Salin dari setiap blok dalam panduan ini dan tempel ke terminal dengan Cmd + V.
Tip berguna untuk masa depan: jika terminal pernah meminta kata sandi, Anda tidak akan melihat apa pun saat mengetik — tidak ada titik atau tanda bintang. Ini adalah perlindungan, bukan rusak. Ini tidak akan terjadi dengan MercaderIA, tetapi baik untuk diketahui.
Ada dua jalan. Keduanya valid:
Opsi A — secara manual dari terminal (direkomendasikan)
Buka Terminal dan tempel baris ini:
curl -fsSL https://claude.ai/install.sh | bashOpsi B — biarkan MercaderIA melakukannya
Saat membuka MercaderIA untuk pertama kalinya, asisten mendeteksi apa yang hilang dan memasang Git dan Claude Code sendiri. Ini yang paling mudah, tetapi terkadang membutuhkan waktu untuk menyebar dan Anda harus menutup dan membuka ulang aplikasi untuk mengenalinya. Dengan me-restart komputer atau menunggu beberapa menit, semuanya terhubung sendiri. Ini hanya terjadi di awal: tidak akan pernah terjadi lagi setelah terhubung.
Akan ada banyak teks berjalan di layar. Itu normal. Selesai ketika baris tempat mengetik muncul kembali ($).
Setelah memasang Claude Code, Anda mengetik claude di terminal dan itu merespons:
zsh: command not found: claude
Jangan khawatir: ini diharapkan, bukan kesalahan yang aneh. Program memang terpasang, tetapi disimpan di folder yang tidak ada dalam daftar tempat terminal mencari. Seperti memiliki buku di rumah tetapi tidak di rak tempat Anda selalu melihat: Anda harus memberi tahu komputer di mana letaknya.
macOS — tempel dua baris ini, satu setelah yang lain:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrcsource ~/.zshrcYang pertama menambahkan folder ke daftar secara permanen (misalnya /Users/maria/.local/bin). Yang kedua membuat terminal menyadarinya sekarang, tanpa restart.
Periksa dengan:
claude --versionJika masih tidak berhasil, tidak masalah
MercaderIA mencari program di banyak folder berbeda dan biasanya menemukannya meskipun terminal tidak melihatnya. Lanjutkan dan coba aplikasi.
Claude Code memerlukan akun. Pertama kali diminta untuk masuk: tab browser terbuka, Anda masuk dengan akun Claude Anda, menerima, dan kembali ke aplikasi.
MercaderIA membuka tab itu secara otomatis setelah selesai memasang Claude Code untuk pertama kalinya. Jika Anda sudah memiliki Claude terpasang sebelumnya, aplikasi menganggap Anda sudah masuk dan tidak membukanya. Jika ternyata tidak, itu diperbaiki dengan membuka terminal dan mengetik:
claude…dan ikuti apa yang muncul di layar.
Ini adalah dua hal yang berbeda, jangan sampai tertukar
Anda memerlukan akun Claude dengan paket aktif dan, terpisah, lisensi MercaderIA. Satu tidak termasuk yang lain.
Jika macOS mengatakan tidak dapat memverifikasi pengembang
Buka .dmg dan seret MercaderIA ke folder Aplikasi. Jika saat membukanya muncul peringatan, klik kanan pada aplikasi → Buka → Buka. Ini muncul karena aplikasi belum ditandatangani oleh Apple, bukan karena berbahaya.
Anda akan melihat daftar dengan Git, Claude Code, dan Node.js, masing-masing dengan statusnya, dan aplikasi memasang sendiri apa yang hilang.
- Node.jsDitemukan — v22.14.0
- GitMemasang…
- Claude CodeTidak ditemukan
Jika sesuatu terus muncul sebagai "tidak ditemukan" setelah dipasang
Tutup MercaderIA sepenuhnya dan buka kembali. Aplikasi mewarisi daftar program dari sistem saat startup, jadi apa yang dipasang saat dibuka tidak akan dilihat sampai startup berikutnya. Bukan kesalahan, begitu cara kerjanya. Di komputer yang tidak pernah memiliki apa pun yang terpasang, normal jika harus restart aplikasi satu atau dua kali sebelum semuanya menampilkan hijau.
Jika daftar tampak membeku, itu sedang memeriksa
Pemeriksaan setiap program menunggu hingga 10 detik. Berikan waktu.
Aplikasi akan meminta alamat toko Anda dengan format ini:
mitienda.myshopify.comPerhatian: itu alamat, bukan domain cantik toko Anda. Untuk menemukannya, masuk ke panel Shopify → Pengaturan → Domain: di sana muncul domain .myshopify.com Anda, ditandai sebagai domain internal Shopify.
Setelah itu browser terbuka dengan layar Shopify yang meminta otorisasi izin. Ini daftar yang panjang dan itu normal: asisten memerlukan kemampuan untuk membaca dan mengedit produk, pesanan, inventori, pengiriman, dan pengembalian untuk dapat bekerja untuk Anda. Tinjau dan terima.
Jika Anda sudah menghubungkan toko sebelumnya
Aplikasi mungkin meminta otorisasi lagi untuk menambahkan izin baru dari versi yang lebih baru. Ini diharapkan, bukan kesalahan.
Tandai setiap poin. Jika kelima-limanya ada, Anda sudah bisa mulai bekerja berbicara dengan toko Anda.
Masalah yang sering terjadi
claude: command not found / "tidak dikenali sebagai perintah"
Program terpasang tetapi terminal tidak tahu di mana mencarinya. Terapkan perbaikan dari langkah 4 (PATH) dan coba lagi dengan claude --version. Di Windows, tutup dan buka ulang PowerShell.
node: command not found setelah memasang Node
Restart komputer. Sistem perlu melakukan boot ulang untuk mendaftarkan program baru. Setelah itu coba node --version.
Aplikasi mengatakan ada yang hilang yang sudah saya pasang
Tutup MercaderIA sepenuhnya dan buka kembali. Aplikasi membaca lingkungan saat startup; apa yang dipasang saat terbuka tidak akan dilihat sampai startup berikutnya.
Layar izin Shopify memberi kesalahan
Tutup tab dan luncurkan koneksi lagi dari aplikasi. Jika terus berlanjut, tulis kepada kami dengan tangkapan layar.
macOS tidak membiarkan saya membuka aplikasi
Klik kanan pada MercaderIA di Aplikasi → Buka → Buka. Ini adalah peringatan aplikasi tanpa tanda tangan, bukan masalah keamanan nyata.
Windows mengatakan program tidak aman
Informasi selengkapnya → Jalankan bagaimanapun. SmartScreen menampilkan peringatan itu dengan installer baru.
Di komputer baru, tidak mendeteksi apa pun
Ini adalah kasus normal. Urutan yang benar: pasang Node.js, restart komputer, buka MercaderIA dan biarkan memasang Git dan Claude Code, dan restart aplikasi. Semuanya berwarna hijau.
Masih terjebak?
Tulis kepada kami dan kami akan membantu Anda sampai semuanya berfungsi. Beritahu kami langkah apa yang sedang Anda lakukan dan apa yang muncul di layar Anda (tangkapan layar sangat membantu).
todo@mercaderia.co