คำแนะนำการติดตั้ง

ติดตั้ง MercaderIA ทีละขั้นตอน

ไม่จำเป็นต้องมีความรู้ทางเทคนิค เราจะบอกคุณว่าคุณจะเห็นอะไรบนหน้าจออยู่ตรงไหนและควรทำอย่างไร หากบางสิ่งดูแปลก เกือบทั้งหมดเป็นเรื่องปกติ: เราจะอธิบายให้เมื่อถึงเวลา

MercaderIA อาศัยอยู่บนสี่ชิ้นส่วน ไม่จำเป็นต้องเข้าใจว่าพวกมันทำงานอย่างไร เพียงแค่ให้มันอยู่ที่นั่น:

  • Node.js: เครื่องยนต์ที่ทำให้เครื่องมือด้านล่างทำงาน
  • Git: เครื่องมือยูทิลิตีที่เครื่องมือเหล่านั้นใช้ภายใน
  • Claude Code: ปัญญาประดิษฐ์ที่จะทำงานในร้านค้าของคุณ
  • MercaderIA: ระบบเอเจนต์ที่ทำให้ร้านค้าของคุณทั้งหมดเป็นอัตโนมัติ

สิ่งที่สำคัญที่สุดในหน้านี้

MercaderIA ติดตั้ง Git และ Claude Code สำหรับคุณ แต่คุณต้องติดตั้ง Node.js ด้วยตนเองก่อน หากคุณข้ามลำดับนี้ แอปจะบอกคุณว่ามีบางสิ่งขาดหายไป เริ่มต้นด้วยขั้นตอน 1

นี่จะมาก่อนที่จะดาวน์โหลด MercaderIA ไปที่เว็บไซต์ทางการและดาวน์โหลดเวอร์ชันที่บอกว่า LTS

ดาวน์โหลด Node.js LTS

LTS หมายถึง "เวอร์ชันที่เสถียรพร้อมการรองรับระยะยาว" หากคุณเห็นปุ่มสองปุ่ม เลือก LTS เสมอ ไม่เคยเลือกที่บอกว่า "Current"

เมื่อติดตั้ง: ถัดไป ถัดไป ถัดไป อย่าเปลี่ยนสิ่งใด ยอมรับทั้งหมดตามค่าเริ่มต้น

ปิดเทอร์มินัลทั้งหมดและรีสตาร์ทคอมพิวเตอร์

หากเป็นครั้งแรกที่คุณติดตั้ง Node ให้รีสตาร์ทเครื่อง ระบบใช้เวลาในการ "ตระหนักรู้" ว่ามีโปรแกรมใหม่ และการรีสตาร์ทคือวิธีที่ไม่ทำให้เสีย ท่านต้องติดตั้ง นี่หลีกเลี่ยงข้อผิดพลาดที่พบได้บ่อยที่สุดของการติดตั้งทั้งหมด

ตรวจสอบว่าทำงาน:

เปิด Terminal (เราอธิบายวิธีการในขั้นตอนที่ 2) และเขียน:

zsh — Terminal
node --version

ควรตอบสนองด้วยสิ่งที่ชอบ v22.14.0 หากเป็นเช่นนั้น เสร็จแล้ว

หากบอกว่า “command not found: node” ไม่ได้ติดตั้งหรือคุณไม่ได้รีสตาร์ท: รีสตาร์ทและลองอีกครั้ง

เทอร์มินัลคือหน้าต่างที่คุณเขียนคำสั่งในข้อความ กด Enter และโปรแกรมตอบสนองต่อคุณ นั่นคือทั้งหมด คุณจะไม่ทำให้สิ่งใดเสีย

macOS

  1. กด Cmd + Space
  2. เขียน terminal
  3. กด Enter

Windows

  1. กดคีย์ Windows
  2. เขียน powershell
  3. เปิด Windows PowerShell
maria@MacBook ~ % node --version
v22.14.0
maria@MacBook ~ % 

หน้าต่างสีดำหรือสีน้ำเงินที่มีข้อความนั้นปกติทั้งหมด: นี่คือลักษณะของเทอร์มินัลที่เพิ่งเปิด

อนุญาตการคัดลอกและวาง (และแนะนำ)

ไม่จำเป็นต้องเขียนอะไรด้วยตนเอง ใช้ปุ่ม Copy ในแต่ละบล็อกของคำแนะนำนี้และวางลงในเทอร์มินัลโดยใช้ Cmd + V

ข้อมูลที่มีประโยชน์สำหรับอนาคต: หากเทอร์มินัลขอรหัสผ่านคุณจะไม่เห็นอะไรขณะที่คุณเขียน — ไม่มีจุดหรือเครื่องหมายดอกจัน มันคือการปกป้อง มันไม่หัก MercaderIA จะไม่ทำให้คุณเกิดขึ้น แต่ก็ควรรู้

มีสองวิธี ทั้งคู่ใช้ได้:

ตัวเลือก A — ด้วยตนเองจากเทอร์มินัล (แนะนำ)

เปิด Terminal และวางบรรทัดนี้:

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

ตัวเลือก B — ให้ MercaderIA ทำเพื่อคุณ

เมื่อเปิด MercaderIA ครั้งแรก ตัวช่วยสร้างจะตรวจจับสิ่งที่ขาดหายไปและติดตั้ง Git และ Claude Code เพียงอย่างเดียว มันง่ายที่สุด แต่บางครั้งใช้เวลาในการแพร่กระจายและคุณต้องปิดและเปิดแอปอีกครั้งเพื่อให้รู้จัก การรีสตาร์ทคอมพิวเตอร์หรือรอสักครู่ทำให้ทุกอย่างเชื่อมต่อเอง สิ่งนี้เกิดขึ้นเฉพาะในตอนเริ่มต้น: ไม่เคยกลับมาเกิดอีกครั้งเมื่อเชื่อมต่อแล้ว

จะมีข้อความค่อนข้างมากผ่านหน้าจอ มันเป็นเรื่องปกติ มันจบลงเมื่อบรรทัดที่คุณเขียนกลับมาปรากฏ ($)

หลังจากติดตั้ง 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 ค้นหาโปรแกรมในโฟลเดอร์อื่น ๆ มากมายและมักจะค้นพบแม้ว่าเทอร์มินัลจะไม่เห็น ดำเนินการต่อและลองใช้แอป

Claude Code ต้องการบัญชี ครั้งแรกจะขอให้เข้าสู่ระบบ: เปิดแท็บเบราว์เซอร์ คุณเข้าสู่ระบบด้วยบัญชี Claude ของคุณ ยอมรับ และกลับไปที่แอป

MercaderIA เปิดแท็บนั้นโดยอัตโนมัติเมื่อเพิ่งติดตั้ง Claude Code เป็นครั้งแรก หากคุณมี Claude ติดตั้งไว้ก่อนแล้ว แอปจึงถือว่าคุณเข้าสู่ระบบแล้วและไม่เปิด หากปรากฎว่าไม่ใช่ ให้แก้ไขโดยเปิดเทอร์มินัลและเขียน:

zsh — Terminal
claude

…และทำตามที่ปรากฏบนหน้าจอ

เป็นสองสิ่งที่แตกต่าง อย่าสับสน

คุณต้องการบัญชี Claude ที่มีแผนที่ใช้งานอยู่และแยกจากนั้น ใบอนุญาต MercaderIA ไม่รวมกัน

หากmacOS บอกว่าไม่สามารถตรวจสอบนักพัฒนา

เปิด .dmg และลาก MercaderIA ไปยังโฟลเดอร์แอปพลิเคชัน หากเปิดมันแสดงคำเตือน คลิกขวาที่แอป → เปิด → เปิด มันออกมาเพราะแอปยังไม่ได้เซ็นชื่อโดย Apple ไม่ใช่เพราะมันมีอันตราย

คุณจะเห็นรายการที่มี Git, Claude Code และ Node.js พร้อมสถานะแต่ละอย่าง และแอปติดตั้งตัวเองสิ่งที่ขาดหายไป

  • Node.jsพบ — v22.14.0
  • Gitติดตั้ง…
  • Claude Codeไม่พบ

หากบางสิ่งยังคงปรากฏเป็น "ไม่พบ" หลังจากติดตั้ง

ปิด MercaderIA ทั้งหมดและเปิดใหม่ แอปสืบทอดรายการโปรแกรมจากระบบในขณะที่เริ่มต้น ดังนั้นสิ่งที่ติดตั้งขณะเปิดจะไม่เห็นจนกว่าจะเริ่มต้นครั้งต่อไป ไม่ใช่ข้อผิดพลาด นั่นคือวิธีที่มันทำงาน ในคอมพิวเตอร์ที่ไม่เคยมีสิ่งใด ๆ ที่ติดตั้งไว้ก่อน เป็นเรื่องปกติที่ต้องรีสตาร์ทแอปหนึ่งหรือสองครั้งก่อนที่ทุกอย่างจะออกมาเป็นสีเขียว

หากรายการดูเหมือนโยนคะแนน กำลังตรวจสอบอยู่

การตรวจสอบแต่ละโปรแกรมจะรอได้นานถึง 10 วินาที ให้เวลามัน

แอปจะขอที่อยู่ร้านค้าของคุณด้วยรูปแบบนี้:

ที่อยู่ร้านค้า
mitienda.myshopify.com

ใจเย็น: เป็นที่อยู่นั้น ไม่ใช่โดเมนที่สวยงามของร้านค้า หากต้องการค้นหา ไปที่แผงควบคุม Shopify → การตั้งค่า → โดเมน: ที่นั่นจะปรากฏโดเมน .myshopify.com ของคุณ ทำเครื่องหมายเป็นโดเมนภายในของ Shopify

หลังจากนั้นเบราว์เซอร์จะเปิดด้วยหน้าจอ Shopify ที่ขอการอนุญาต มันเป็นรายการที่ยาวและเป็นเรื่องปกติ: ผู้ช่วยสร้างต้องสามารถอ่านและแก้ไขผลิตภัณฑ์ คำสั่งซื้อ สินค้าคงคลัง การจัดส่ง และการคืนสินค้า เพื่อทำงานสำหรับคุณ ตรวจสอบและยอมรับ

หากคุณเชื่อมต่อร้านค้าก่อนแล้ว

แอปอาจขอการอนุญาตอีกครั้งเพื่อเพิ่มสิทธิ์ใหม่จากเวอร์ชันที่ใหม่กว่า มันคาดหวัง ไม่ใช่ข้อผิดพลาด

ทำเครื่องหมายแต่ละจุด หากทั้งห้าอยู่ที่นั่น คุณสามารถเริ่มทำงานโดยพูดคุยกับร้านค้าของคุณได้แล้ว

ปัญหาที่พบบ่อย

claude: command not found / "no se reconoce el comando"

โปรแกรมติดตั้งแล้ว แต่เทอร์มินัลไม่รู้ว่าจะค้นหาที่ไหน ใช้การแก้ไขจากขั้นตอนที่ 4 (PATH) และลองอีกครั้งด้วย claude --version ใน Windows ปิดแล้วเปิด PowerShell ใหม่

node: command not found หลังจากติดตั้ง Node

รีสตาร์ทคอมพิวเตอร์ ระบบต้องเริ่มต้นใหม่เพื่อลงทะเบียนโปรแกรมใหม่ หลังจากนั้นลอง node --version

แอปบอกว่าขาดบางสิ่งที่ฉันติดตั้งแล้ว

ปิด MercaderIA ทั้งหมดและเปิดใหม่ แอปอ่านสภาพแวดล้อมเมื่อเริ่มต้น สิ่งที่ติดตั้งในขณะเปิดจะไม่เห็นจนกว่าจะเริ่มต้นครั้งต่อไป

หน้าจอสิทธิ์ Shopify ให้ข้อผิดพลาด

ปิดแท็บและเปิดการเชื่อมต่ออีกครั้งจากแอป หากยังคงยืนกรรม ให้เขียนถึงเรา พร้อมการจับภาพหน้าจอ

macOS ไม่ให้ฉันเปิดแอป

คลิกขวาที่ MercaderIA ในแอปพลิเคชัน → เปิด → เปิด มันออกมาเพราะแอปยังไม่ได้เซ็นชื่อโดย Apple ไม่ใช่เพราะเป็นปัญหาด้านความปลอดภัยที่แท้จริง

Windows บอกว่าโปรแกรมไม่ปลอดภัย

ข้อมูลเพิ่มเติม → เรียกใช้อย่างไรก็ตาม SmartScreen แสดงคำเตือนนั้นกับโปรแกรมใหม่ใด ๆ

ในคอมพิวเตอร์เครื่องใหม่ มันไม่ตรวจจับสิ่งใด

นี่คือกรณีปกติ ลำดับที่ถูกต้อง: ติดตั้ง Node.js รีสตาร์ทคอมพิวเตอร์ เปิด MercaderIA และปล่อยให้ติดตั้ง Git และ Claude Code และรีสตาร์ทแอป ทั้งหมดเป็นสีเขียว

ติดขัดอยู่?

เขียนถึงเรา เราจะอยู่เคียงข้างคุณจนกว่าจะได้รับการแก้ไข บอกเราว่าคุณใช้ขั้นตอนใด และสิ่งที่ปรากฏบนหน้าจอ (ภาพหน้าจอช่วยได้มาก)

todo@mercaderia.co