Instal MercaderIA langkah demi langkah
Tanpa pengetahuan teknis. Kami memberi tahu Anda dengan tepat apa yang akan Anda lihat di layar di setiap saat dan apa yang harus dilakukan jika tidak melihatnya. Jika ada yang terlihat aneh, kemungkinan besar itu normal: kami akan menjelaskannya saat tiba.
MercaderIA bergantung pada empat komponen. Anda tidak perlu memahami cara kerjanya, hanya pastikan ada:
- Node.js: Mesin yang membuat alat-alat berfungsi di balik layar.
- Git: Utilitas yang digunakan alat-alat ini secara internal.
- Claude Code: Kecerdasan buatan yang akan bekerja di toko Anda.
- MercaderIA: Sistem agentic yang mengotomatisasi seluruh toko Anda.
Hal yang paling penting di seluruh halaman ini
MercaderIA menginstal Git dan Claude Code untuk Anda, tetapi Anda harus menginstal Node.js terlebih dahulu. Jika Anda melewati urutan ini, aplikasi akan memberi tahu Anda bahwa sesuatu tidak ada. Mulai dari langkah 1.
Ini harus dilakukan sebelum mengunduh MercaderIA. Kunjungi situs web resmi dan unduh versi yang bertuliskan LTS.
Unduh Node.js LTSLTS berarti "versi stabil dengan dukungan jangka panjang". Jika Anda melihat dua tombol, selalu pilih yang LTS, bukan yang bertuliskan "Current".
Saat menginstal: berikutnya, berikutnya, berikutnya. Jangan ubah apa pun, terima semuanya secara default.
Tutup semua terminal dan restart komputer
Jika ini pertama kalinya Anda menginstal Node, restart perangkat. Sistem membutuhkan waktu untuk "menyadari" ada program baru, dan restart adalah cara yang pasti agar sistem menyadarinya. Ini menghindari kesalahan paling umum dalam seluruh proses instalasi.
Verifikasi bahwa ini berfungsi:
Buka Terminal (kami menjelaskan cara melakukannya di langkah 2) dan ketik:
node --versionSeharusnya merespons dengan sesuatu seperti v22.14.0. Jika ya, selesai.
Jika mengatakan “command not found: node”, tidak terinstal atau Anda tidak restart: restart dan coba lagi.
Terminal adalah jendela tempat Anda mengetik perintah dalam teks, menekan Enter, dan program merespons. Hanya itu. Anda tidak akan memecahkan 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 sepenuhnya normal: begitulah tampilan terminal yang baru saja dibuka.
Menyalin dan menempel diizinkan (dan direkomendasikan)
Tidak perlu mengetik apa pun secara manual. Gunakan tombol Salin di setiap blok panduan ini dan tempel ke terminal dengan Cmd + V.
Fakta berguna untuk masa depan: jika terminal meminta kata sandi, tidak ada yang terlihat saat Anda mengetik — tidak ada titik atau tanda bintang. Ini perlindungan, tidak rusak. Anda tidak akan mengalami ini dengan MercaderIA, tetapi perlu diketahui.
Ada dua cara. Kedua-duanya bekerja:
Opsi A — 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 menginstal Git dan Claude Code sendiri. Ini paling mudah, tetapi terkadang membutuhkan waktu untuk menyebar dan Anda harus menutup dan membuka kembali aplikasi agar sistem mengenalinya. Restart komputer atau menunggu beberapa menit akan menghubungkan semuanya secara otomatis. Ini hanya terjadi di awal: tidak akan pernah terjadi lagi setelah terhubung.
Akan ada banyak teks yang muncul di layar. Itu normal. Selesai ketika baris tempat Anda mengetik muncul lagi ($).
Setelah menginstal Claude Code, Anda mengetik claude di terminal dan merespons:
zsh: command not found: claude
Tenang: ini seperti yang diharapkan, bukan kesalahan aneh. Program memang terinstal, tetapi tersimpan di folder yang tidak dimiliki terminal dalam daftar tempat untuk mencari. Ini seperti memiliki buku di rumah tetapi tidak di rak tempat Anda selalu melihat: Anda harus memberi tahu komputer di mana letak buku itu.
macOS — tempel kedua baris ini, satu demi satu:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrcsource ~/.zshrcBaris pertama menambahkan folder ke daftar secara permanen (misalnya /Users/maria/.local/bin). Baris kedua membuat terminal menyadarinya sekarang, tanpa restart.
Verifikasi dengan:
claude --versionJika masih tidak berfungsi, itu tidak apa-apa
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, setujui, dan kembali ke aplikasi.
MercaderIA membuka tab itu secara otomatis setelah menginstal Claude Code untuk pertama kalinya. Jika Anda sudah memiliki Claude yang terinstal sebelumnya, aplikasi mengasumsikan 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 berbeda, jangan bingung
Anda memerlukan akun Claude dengan paket aktif dan, terpisah, lisensi MercaderIA. Satu tidak termasuk yang lain.
Jika macOS mengatakan itu tidak dapat memverifikasi pengembang
Buka .dmg dan seret MercaderIA ke folder Aplikasi. Jika ketika membukanya muncul peringatan, klik kanan pada aplikasi → Buka → Buka. Itu 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 menginstal sendiri apa yang hilang.
- Node.jsDitemukan — v22.14.0
- GitMenginstal…
- Claude CodeTidak ditemukan
Jika sesuatu terus muncul sebagai "tidak ditemukan" setelah menginstalnya
Tutup MercaderIA sepenuhnya dan buka lagi. Aplikasi mewarisi daftar program dari sistem pada saat peluncuran, jadi apa yang diinstal saat terbuka tidak terlihat sampai kali berikutnya dibuka. Ini bukan bug, begitulah cara kerjanya. Di komputer tempat tidak ada yang diinstal sebelumnya, adalah normal harus restart aplikasi sekali atau dua kali sebelum semuanya berubah menjadi hijau.
Jika daftarnya terlihat beku, sedang memeriksa
Pemeriksaan setiap program menunggu hingga 10 detik. Beri waktu.
Aplikasi akan meminta alamat toko Anda dengan format ini:
mitienda.myshopify.comHati-hati: ini adalah alamat itu, 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 membuka dengan layar Shopify meminta otorisasi izin. Ini daftar yang panjang dan itu normal: asisten perlu dapat membaca dan mengedit produk, pesanan, inventaris, pengiriman, dan pengembalian untuk bekerja untuk Anda. Tinjau dan terima.
Jika Anda sudah menghubungkan toko sebelumnya
Aplikasi dapat meminta otorisasi lagi untuk menambahkan izin baru dari versi yang lebih baru. Ini diharapkan, bukan kesalahan.
Periksa setiap poin. Jika kelima poin ada, Anda sudah dapat mulai bekerja dengan berbicara ke toko Anda.
Masalah yang sering terjadi
claude: command not found / "perintah tidak dikenali"
Program terinstal tetapi terminal tidak tahu di mana mencarinya. Terapkan perbaikan dari langkah 4 (PATH) dan coba lagi dengan claude --version. Di Windows, tutup dan buka kembali PowerShell.
node: command not found setelah menginstal Node
Restart komputer. Sistem perlu restart untuk mendaftarkan program baru. Kemudian coba node --version.
Aplikasi mengatakan sesuatu yang sudah saya instal tidak ada
Tutup MercaderIA sepenuhnya dan buka lagi. Aplikasi membaca lingkungan saat startup; apa yang diinstal saat terbuka tidak terlihat sampai startup berikutnya.
Layar izin Shopify menampilkan kesalahan
Tutup tab dan luncurkan koneksi lagi dari aplikasi. Jika tetap berlanjut, kirim kami screenshot.
macOS tidak membiarkan saya membuka aplikasi
Klik kanan pada MercaderIA di Aplikasi → Buka → Buka. Ini peringatan aplikasi tidak ditandatangani, bukan masalah keamanan nyata.
Windows mengatakan program tidak aman
Informasi selengkapnya → Jalankan bagaimanapun juga. SmartScreen menampilkan peringatan itu dengan installer baru apa pun.
Di komputer baru itu tidak mendeteksi apa pun
Itu kasus normal. Urutan yang benar: instal Node.js, restart komputer, buka MercaderIA dan biarkan menginstal Git dan Claude Code, dan restart aplikasi. Semuanya hijau.
Masih tersangkut?
Hubungi kami dan kami akan membantu Anda sampai semuanya berfungsi. Beri tahu kami langkah apa yang Anda lakukan dan apa yang muncul di layar (screenshot sangat membantu).
todo@mercaderia.co