PandaPaw: โฮสต์ระยะไกลสำหรับ Claude Code, Codex และ PandaCode

PandaPaw เปลี่ยนเครื่อง Windows, macOS หรือ Linux ที่คุณควบคุมให้เป็นโฮสต์เอเจนต์ของ PandaNpc เอ็นจินการเขียนโค้ด ไฟล์โปรเจกต์ เชลล์ และเครื่องมือทั้งหมดยังคงอยู่บนโฮสต์นั้น ไคลเอ็นต์ PandaNpc มอบอินเทอร์เฟซที่ซิงค์กันให้คุณจากโทรศัพท์ เบราว์เซอร์ หรือเดสก์ท็อปเครื่องอื่น

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

สิ่งที่ PandaPaw จัดการ

• การเชื่อมต่อเอเจนต์ระยะไกล สำหรับ Claude Code, OpenAI Codex และ PandaCode
• บริการเบื้องหลังและการเริ่มอัตโนมัติ เพื่อให้โฮสต์กลับมาทำงานได้หลังรีบูตตามปกติ
• การอนุญาตเครื่องตามบัญชี โดยไม่ต้องคัดลอก Bridge ID, โทเค็น หรือคีย์เซ็นชื่อที่มีอายุยาวด้วยตนเอง
• ความช่วยเหลือในการติดตั้งเอ็นจิน เมื่อเอ็นจินการเขียนโค้ดที่รองรับหายไป
• การฉายภาพ Agent Center ที่แสดงคำแนะนำ ทักษะ ความทรงจำ และนิยามเอเจนต์ของแต่ละเอ็นจินในรูปแบบดั้งเดิม
• เครือข่ายอุปกรณ์ส่วนตัว สำหรับเครื่องที่เข้าร่วมผ่านขั้นตอน Connected Devices
• การจัดการอัปเดตและถอนการติดตั้ง เพื่อให้เครื่องมือที่มีอยู่ก่อน PandaPaw ยังคงอยู่

PandaPaw ไม่ได้ให้การสมัครสมาชิกโมเดลด้วยตัวเอง Claude Code, Codex และ PandaCode ยังคงใช้ข้อมูลประจำตัวและขีดจำกัดของผู้ให้บริการที่กำหนดค่าไว้สำหรับเอ็นจินของตน

วิธีการทำงานของการดำเนินการระยะไกล

ทั้งสองฝ่ายเริ่มการเชื่อมต่อขาออก ดังนั้นการตั้งค่าบ้านหรือสำนักงานทั่วไปจึงไม่จำเป็นต้องมีกฎไฟร์วอลล์ขาเข้า ที่อยู่ IP สาธารณะ การส่งต่อพอร์ตเราเตอร์ หรือเซิร์ฟเวอร์ SSH ที่เปิดเผยต่อสาธารณะ รีเลย์ทำหน้าที่ส่งข้อความ สถานะ และการอนุมัติ การทำงานของเครื่องมือเกิดขึ้นบนโฮสต์

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

แพลตฟอร์มโฮสต์ที่รองรับ

ไคลเอ็นต์การดู PandaNpc มีเมทริกซ์แพลตฟอร์มที่กว้างกว่า ดู ติดตั้ง PandaNpc และ PandaPaw เมื่อเลือกแพ็กเกจไคลเอ็นต์และโฮสต์

การติดตั้งที่แนะนำ

1. ลงชื่อเข้าใช้ PandaNpc
2. เปิด Connected Devices
3. เลือก เพิ่มอุปกรณ์ คีย์แบบใช้ครั้งเดียวจะถูกออก และกล่องโต้ตอบแสดงคำสั่งหนึ่งคำสั่งสำหรับระบบปฏิบัติการที่ตรวจพบ
4. คัดลอกคำสั่งนั้นไปยังโฮสต์และรันที่นั่น
5. ปล่อยกล่องโต้ตอบไว้หากคุณต้องการให้ตรวจจับเครื่องใหม่โดยอัตโนมัติ

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

ตัวติดตั้ง macOS/Linux เปล่า

ใช้รูปแบบนี้เมื่อคุณต้องการอนุญาตผ่านเบราว์เซอร์แทนคีย์ที่เตรียมไว้:

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

ตัวติดตั้ง Windows PowerShell เปล่า

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

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

ตรวจสอบโฮสต์

ก่อนอื่นตรวจสอบตัวโฮสต์เอง:

pandapaw status

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

พรอมป์ทดสอบ: พิมพ์ไดเรกทอรีทำงานปัจจุบันและแสดงรายการไฟล์ระดับบนสุด อย่าแก้ไขอะไรทั้งสิ้น

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

สำหรับโปรเจกต์ Agent Center ให้รัน:

pandapaw agent status --root /absolute/path/to/project

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

การอนุญาตบัญชีและเอกลักษณ์การเชื่อมต่อ

pandapaw login ใช้เซสชันการอนุญาตอุปกรณ์ผ่านเบราว์เซอร์ หลังจากที่คุณอนุมัติ โฮสต์จะได้รับข้อมูลประจำตัวที่จำกัดเฉพาะอุปกรณ์และคีย์ตรวจสอบ Agent Center ผ่าน TLS เขียนการกำหนดค่าเครื่องภายใต้ ~/.pandapaw/ ลงทะเบียนการเชื่อมต่อเอ็นจินที่รองรับ และผูกโปรเจกต์ Git ที่รู้จัก

รัน pandapaw login --force เฉพาะเมื่อคุณต้องการสลับบัญชีหรือแทนที่ข้อมูลประจำตัวโฮสต์ที่หมดอายุอย่างตั้งใจ การอนุญาตเครื่องที่สุขภาพดีอีกครั้งโดยไม่มีเหตุผลอาจสร้างข้อมูลประจำตัวที่ซ้ำซ้อนหรือถูกแทนที่อย่างสับสน

pandapaw qr ยังคงสร้างลิงก์เชื่อมต่อแบบใช้ครั้งเดียวที่มีอายุสั้นเพื่อความเข้ากันได้และกรณีพิเศษ ไม่ใช่ขั้นตอนหลักสำหรับโฮสต์ใหม่ Connected Devices ตรวจสอบได้ง่ายกว่าและไม่ต้องให้ผู้ใช้เข้าใจ Bridge ID

การซิงค์ Agent Center

Agent Center เป็นแบบขับเคลื่อนด้วยเหตุการณ์ในสภาวะคงที่:

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

Claude Code, Codex และ PandaCode ได้รับการฉายภาพแยกกันเนื่องจากคาดหวังไดเรกทอรีและรูปแบบคำสั่งที่แตกต่างกัน PandaCode เตรียมรีลีสที่ตรวจสอบล่าสุดก่อนประกอบพรอมป์เซสชันใหม่ ดังนั้นการกำหนดค่าที่ดึงในตอนเริ่มต้นอาจส่งผลต่อเซสชันเดียวกันนั้น

หาก Agent Center ไม่พร้อมใช้งานชั่วคราว เอ็นจินจะดำเนินการต่อด้วยรีลีสที่ตรวจสอบแล้วในเครื่อง การทำงานผิดพลาดของเครือข่ายไม่ควรแทนที่การกำหนดค่าที่ลงนามด้วยเนื้อหาที่ไม่ผ่านการตรวจสอบอย่างเงียบ ๆ

คำสั่งที่มีประโยชน์

pandapaw login
pandapaw status
pandapaw agent status --root /absolute/path/to/project
pandapaw update --restart
pandapaw uninstall

ตรวจสอบ ประวัติเวอร์ชัน PandaPaw เมื่อคำสั่งหรือ UI แตกต่างจากภาพหน้าจอหรือบทช่วยสอนเก่า

ขอบเขตความปลอดภัย

• ผู้ปฏิบัติการระยะไกลสามารถใช้เครื่องมือและไดเรกทอรีทำงานที่เซสชันเอเจนต์ที่เลือกอนุญาต การเข้าถึงระยะไกลไม่ได้เป็นแบบอ่านอย่างเดียวโดยอัตโนมัติ
• เก็บคำสั่งอุปกรณ์แบบใช้ครั้งเดียว ลิงก์เชื่อมต่อด้วยตนเอง คีย์ผู้ให้บริการ และโทเค็นบัญชีให้พ้นจากล็อกและภาพหน้าจอ
• อย่าเปิดพอร์ตเราเตอร์ขาเข้าเพียงเพื่อทำให้ PandaPaw เข้าถึงได้
• นำโฮสต์ที่คุณไม่ได้เป็นเจ้าของอีกต่อไปออกจาก Connected Devices
• ตรวจสอบการอนุมัติเครื่องมือและยืนยันไดเรกทอรีทำงานก่อนอนุญาตการแก้ไขหรือคำสั่งเชลล์
• เมื่อแชร์การเชื่อมต่อสด ผู้รับจะใช้โควตาเอ็นจินของเจ้าของโฮสต์และสามารถดำเนินการบนโฮสต์ได้ อ่าน การแชร์การเชื่อมต่อ ก่อน

การแก้ไขปัญหา

ไม่พบ `pandapaw` หลังการติดตั้ง

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

ติดตั้งสำเร็จ แต่ไม่มีเครื่องปรากฏ

รัน pandapaw status หากเครื่องไม่มีการอนุญาตบัญชี ให้รัน pandapaw login หากใช้คีย์แบบใช้ครั้งเดียวที่เตรียมไว้ ให้สร้างคีย์ใหม่แทนการลองคำสั่งที่ใช้ไปแล้ว

เครื่องปรากฏแต่ยังออฟไลน์

ยืนยันว่าโฮสต์ตื่นอยู่และมีการเข้าถึงอินเทอร์เน็ต ตรวจสอบสถานะ PandaPaw ในเครื่อง พร็อกซีองค์กรหรือไฟร์วอลล์ต้องอนุญาตเส้นทาง HTTPS/WebSocket ขาออก พอร์ตขาเข้าไม่ได้แก้การเชื่อมต่อขาออกที่ถูกบล็อก

โฮสต์ออนไลน์ แต่ Claude Code หรือ Codex ไม่ตอบ

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

เซสชันเปิดในโปรเจกต์ผิด

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

การเปลี่ยนแปลง Agent Center ไม่ปรากฏ

รัน pandapaw agent status --root /path/to/project จาก Git root ที่ถูกต้อง ยืนยันว่าโปรเจกต์ถูกผูกไว้ โฮสต์เข้าสู่ระบบ และไฟล์ในเครื่องเป็นส่วนหนึ่งของการฉายภาพที่จัดการ เก็บรีลีสที่ตรวจสอบล่าสุดไว้ในระหว่างการตรวจสอบแทนการลบไดเรกทอรีที่จัดการ

อัปเดตและถอนการติดตั้ง

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

pandapaw uninstall ใช้แมนิเฟสต์การติดตั้งเพื่อลบรายการที่ PandaPaw สร้างขึ้น การติดตั้ง Claude Code, Codex, PandaCode หรือ Node ที่เข้ากันได้ซึ่งมีอยู่แล้วจะถูกเก็บรักษาไว้โดยเจตนา หลังถอนการติดตั้ง ให้นำโฮสต์ออกจาก Connected Devices หากไม่ควรเชื่อถืออีกต่อไป