ติดตั้ง PandaNpc และ PandaPaw

การตั้งค่า coding-agent แบบรีโมตมีสองส่วนที่แยกจากกัน:

• PandaNpc client — อินเทอร์เฟซที่คุณใช้เพื่ออ่านเซสชัน ส่งพรอมต์ และอนุมัติเครื่องมือ ทำงานบนเว็บ, iOS, Windows, macOS และ Linux
• PandaPaw host — บริการพื้นหลังบนคอมพิวเตอร์ที่ Claude Code, Codex หรือ PandaCode ทำงานจริง

ติดตั้งเฉพาะ client สำหรับ PandaNpc chat และใช้งานบนเดสก์ท็อปในเครื่อง ติดตั้งทั้งสองส่วนเมื่อคุณต้องการเข้าถึง coding agent ที่ทำงานบนเครื่องอื่น

ดู PandaNpc Desktop สำหรับสิ่งที่แอป Windows/macOS/Linux เพิ่มเติมนอกเหนือจากขั้นตอนการติดตั้งด้านล่าง รวมถึงประวัติการเผยแพร่

เลือกสิ่งที่ต้องการติดตั้ง

สำหรับเส้นทาง end-to-end ที่สั้นที่สุด ใช้ Quick Start Guide

ติดตั้ง client ของ PandaNpc

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

เว็บ

เปิด pandanpc.com/agent ในเบราว์เซอร์ปัจจุบัน ไม่มีการติดตั้งอะไร การจัดเก็บในเบราว์เซอร์จะเก็บสถานะการลงชื่อเข้าใช้ในเครื่อง ดังนั้นหน้าต่าง private/incognito อาจต้องให้ลงชื่อเข้าใช้อีกครั้ง

iOS

ทำตามลิงก์ App Store บนหน้าดาวน์โหลดและติดตั้ง PandaNpc iOS มีประโยชน์สำหรับการตรวจสอบความคืบหน้า ตอบคำถาม และอนุมัติเครื่องมือเมื่อไม่ได้อยู่ที่เครื่อง host กระบวนการเขียนโค้ดยังคงทำงานบนเครื่อง host ที่เชื่อมต่ออยู่ ดู PandaNpc for iOS สำหรับสิ่งที่แอปครอบคลุม รวมถึงประวัติการเผยแพร่

Windows

1. ดาวน์โหลดตัวติดตั้ง Windows ปัจจุบัน
2. รันและทำตามขั้นตอนของตัวติดตั้ง
3. เปิด PandaNpc จากเมนู Start
4. หาก Windows แสดงคำเตือนเกี่ยวกับผู้เผยแพร่หรือชื่อเสียง ให้ตรวจสอบว่าไฟล์มาจาก pandanpc.com ก่อนดำเนินการต่อ

macOS

1. ดาวน์โหลด .dmg ของ macOS
2. ลาก PandaNpc ไปที่ Applications
3. เปิดจาก Applications และทำตามพรอมต์ความปลอดภัยของ macOS ที่อาจปรากฏ

บิลด์ของ macOS เป็นแบบ universal ดังนั้นแพ็กเกจเดียวกันรองรับทั้ง Apple Silicon และ Intel Macs

Linux

ดาวน์โหลด AppImage แบบ x86_64 ทำให้เป็นไฟล์ที่รันได้ แล้วรัน:

chmod +x PandaNpc_*.AppImage
./PandaNpc_*.AppImage

หาก AppImage ไม่เริ่มทำงาน ให้รันจากเทอร์มินัลหนึ่งครั้งและเก็บเอาต์พุตข้อผิดพลาดที่แน่นอนไว้ ดิสทริบิวชันเก่าอาจขาดไลบรารีรันไทม์ที่จำเป็นสำหรับ desktop shell

ติดตั้ง PandaPaw บนเครื่อง host ของ agent

PandaPaw ในปัจจุบันมีตัวติดตั้ง host สำหรับ Windows x64, macOS universal และ Linux x86_64 รันคำสั่งบนคอมพิวเตอร์ที่เป็นเจ้าของไฟล์โปรเจกต์และควรเป็นเครื่องที่รันเครื่องมือของ agent

เส้นทางที่แนะนำคือ Connected Devices: เลือก Add a device จากนั้นคัดลอกคำสั่งแบบ one-time ที่สร้างขึ้น มันจะจับคู่ host กับบัญชีของคุณระหว่างการติดตั้ง

macOS หรือ Linux

ตัวติดตั้งแบบธรรมดาพร้อมการอนุญาตผ่านเบราว์เซอร์:

curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh

รูปแบบคีย์ one-time ที่เตรียมไว้:

curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh -s -- --mesh pnkey-xxxx

Windows PowerShell

ตัวติดตั้งแบบธรรมดา:

iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

รูปแบบคีย์ one-time ที่เตรียมไว้:

$env:PANDANET_KEY="pnkey-xxxx"; iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

ไปป์ไลน์ iwr | iex ของ PowerShell ไม่สามารถส่งอาร์กิวเมนต์สคริปต์ปกติได้ ดังนั้นตัวติดตั้ง Windows จึงอ่านคีย์ one-time จาก PANDANET_KEY

สิ่งที่ตัวติดตั้ง host เปลี่ยนแปลง

ตัวติดตั้ง:

1. เพิ่ม PandaPaw ไปยังไดเรกทอรี application/bin ของผู้ใช้ปัจจุบันและอัปเดต PATH ของผู้ใช้เมื่อจำเป็น
2. ลงทะเบียนบริการพื้นหลังที่เหมาะสมให้เริ่มทำงานโดยอัตโนมัติ
3. ติดตั้ง coding engines ที่รองรับซึ่งยังขาดอยู่เมื่อแพลตฟอร์มอนุญาต
4. จัดหา Node.js runtime ส่วนตัวเมื่อระบบไม่มีเวอร์ชันที่เหมาะสม
5. เริ่มการอนุญาตบัญชีหรือแลกคีย์อุปกรณ์ที่เตรียมไว้
6. บันทึกไฟล์ที่สร้างขึ้นเพื่อให้การถอนการติดตั้งสามารถเก็บรักษาเครื่องมือที่เข้ากันได้ซึ่งมีอยู่แล้ว

การติดตั้ง engine ไม่ได้ซื้อหรือยืนยันการสมัครใช้งานโมเดลโดยอัตโนมัติ Claude Code และ Codex ยังคงขอให้ลงชื่อเข้าผู้ให้บริการของตนเองในครั้งแรกที่รัน

ตรวจสอบการติดตั้ง

เปิดเทอร์มินัลใหม่หลังการติดตั้งแล้วรัน:

pandapaw status

จากนั้นเปิด PandaNpc Agent host ควรแสดงเป็นออนไลน์ เริ่มเซสชันในโปรเจกต์ทดสอบและขอให้มันรายงานไดเรกทอรีทำงานปัจจุบันโดยไม่เปลี่ยนไฟล์ ซึ่งเป็นการตรวจสอบไบนารี บริการพื้นหลัง การจับคู่บัญชี การเชื่อมต่อ relay engine และไดเรกทอรีที่เลือก—ไม่ใช่แค่ขั้นตอนการดาวน์โหลด

อัปเดต

Desktop clients แจ้งให้คุณทราบเมื่อมีอัปเดต iOS อัปเดตผ่าน App Store

อัปเดต PandaPaw และรีสตาร์ทบริการที่จัดการด้วย:

pandapaw update --restart

ตัวอัปเดตจะตรวจสอบไบนารีที่ดาวน์โหลดกับ SHA-256 checksum ที่เผยแพร่ก่อนแทนที่สำเนาที่ติดตั้งไว้ การจับคู่บัญชีและข้อมูลประจำตัวการเชื่อมต่อที่มีอยู่จะถูกเก็บรักษาไว้ การรันคำสั่งติดตั้งซ้ำก็รองรับเมื่อตัวอัปเดตเองไม่พร้อมใช้งาน

ถอนการติดตั้ง

• Windows client: การตั้งค่า → แอป → แอปที่ติดตั้ง → PandaNpc → ถอนการติดตั้ง
• macOS client: ออกจาก PandaNpc จากนั้นย้ายจาก Applications ไปที่ถังขยะ
• Linux client: ลบ AppImage และ launcher ใดๆ ที่คุณสร้างขึ้น
• PandaPaw host: รัน pandapaw uninstall บน host

รายการถอนการติดตั้งของ PandaPaw แยกแยะเครื่องมือที่ตัวติดตั้งสร้างขึ้นจากเครื่องมือที่เข้ากันได้ซึ่งมีอยู่ก่อนแล้ว โดยตั้งใจให้อนุรักษ์นิยมแทนที่จะลบการติดตั้ง Claude Code, Codex, PandaCode หรือ Node ที่มีอยู่ก่อน

ปัญหาการติดตั้ง

คำสั่งเสร็จสิ้นแต่ host ไม่เชื่อมต่อ

รัน pandapaw login การติดตั้ง host และการอนุญาตบัญชีเป็นขั้นตอนที่แยกจากกัน และตัวติดตั้งสามารถเสร็จสิ้นได้แม้การอนุญาตผ่านเบราว์เซอร์ถูกเลื่อนหรือขัดจังหวะ

เชลล์ไม่พบ `pandapaw`

เปิดเทอร์มินัลใหม่ บน macOS/Linux ให้ตรวจสอบ ~/.local/bin; บน Windows ให้ตรวจสอบ %LOCALAPPDATA%\Programs\pandapaw อย่าติดตั้งซ้ำซ้อนจนกว่าคุณจะยืนยันแล้วว่าไฟล์ปฏิบัติการมีอยู่หรือไม่ และมีเพียง PATH ที่ล้าสมัย

coding engine ติดตั้งไม่สำเร็จ

ตัวติดตั้ง host ถือว่าการดาวน์โหลด engine เพิ่มเติมเป็นแบบ best effort เพื่อให้การหยุดทำงานของผู้ให้บริการรายหนึ่งไม่ทำลายการติดตั้ง PandaPaw ที่ใช้งานได้ ติดตั้งหรือซ่อมแซม engine นั้นโดยใช้ตัวติดตั้งอย่างเป็นทางการ ยืนยันตัวตนตามปกติ จากนั้นรัน pandapaw status อีกครั้ง

AppImage หรือแอปเดสก์ท็อปไม่เปิด

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

สำหรับการตรวจสอบการเชื่อมต่อเฉพาะ host ให้ดำเนินการต่อด้วย คู่มือ PandaPaw หรือ FAQ