เริ่มต้นใช้งาน: รัน Claude Code หรือ Codex จากระยะไกล

อัปเดต

คู่มือนี้อธิบายการเชื่อมต่อเครื่องพัฒนาเครื่องหนึ่งเข้ากับ PandaNpc และตรวจสอบว่าคุณสามารถรัน Claude Code, Codex หรือ PandaCode จากอุปกรณ์อื่นได้ ตัวเอเจนต์ยังคงทำงานบนเครื่องพัฒนาของคุณ PandaNpc ให้อินเทอร์เฟซระยะไกลที่ซิงโครไนซ์สำหรับข้อความ การอนุมัติ คำถาม และประวัติเซสชัน

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

ก่อนเริ่มต้น

คุณต้องมี:

  • บัญชี PandaNpc ที่เปิดใน เว็บแอป, แอปเดสก์ท็อป หรือแอป iOS
  • โฮสต์ที่ใช้ Windows x64, macOS หรือ Linux x86_64
  • การเข้าถึงอินเทอร์เน็ตจากโฮสต์และสิทธิ์ในการติดตั้งบริการเบื้องหลังระดับผู้ใช้
  • โฟลเดอร์โปรเจกต์ที่คุณได้รับอนุญาตให้แก้ไข
  • บัญชี Claude, ChatGPT/Codex หรือโมเดลแบบกำหนดเอง หากเอนจินที่คุณเลือกยังไม่ได้ตรวจสอบสิทธิ์

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

1. สร้างคำสั่งติดตั้งบนโฮสต์

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

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

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

2. ติดตั้ง PandaPaw บนโฮสต์

macOS หรือ Linux

รันคำสั่งสำเร็จรูปจากอุปกรณ์ที่เชื่อมต่อ หรือใช้ตัวติดตั้งธรรมดา:

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

Windows PowerShell

รันคำสั่งสำเร็จรูปจากอุปกรณ์ที่เชื่อมต่อ หรือใช้:

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

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

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

bash
pandapaw login

3. ตรวจสอบบริการบนโฮสต์

บนโฮสต์ ให้รัน:

bash
pandapaw status

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

สำหรับโปรเจกต์ Git คุณยังสามารถตรวจสอบว่า Agent Center รู้จักรากโปรเจกต์หรือไม่:

bash
pandapaw agent status --root /path/to/your/project

ใช้พาธโปรเจกต์จริงแบบสัมบูรณ์ การผูกโปรเจกต์กับ Agent Center จะทำงานได้ดีที่สุดเมื่อไดเรกทอรีมี remote.origin.url ของ Git ที่คงที่

4. เริ่มเซสชันระยะไกลครั้งแรก

  1. เปิด PandaNpc Agent บนโทรศัพท์ เบราว์เซอร์ หรือเดสก์ท็อปเครื่องอื่น
  2. ค้นหาเครื่องที่เชื่อมต่อใหม่ ตัวบ่งชี้สถานะสีเขียวหมายความว่าโฮสต์สามารถเข้าถึงได้ในขณะนี้
  3. เลือก Claude Code, Codex หรือ PandaCode และเลือกไดเรกทอรีทำงานของโปรเจกต์
  4. เริ่มเซสชัน หากเอนจินขอให้คุณลงชื่อเข้าใช้ ให้ทำการให้สิทธิ์ของผู้ให้บริการบนโฮสต์หรือผ่านขั้นตอนการลงชื่อเข้าที่แสดง
  5. ส่งพรอมต์ทดสอบแบบไม่ทำลาย เช่น: Show the current working directory and list the top-level files. Do not edit anything.

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

5. ยืนยันพฤติกรรมการเชื่อมต่อใหม่

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

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

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

เครื่องไม่ปรากฏใน Agent

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

ไม่รู้จัก `pandapaw`

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

เครื่องแสดงในรายการแต่ออฟไลน์

ตรวจสอบว่าโฮสต์เปิดอยู่ ตื่นอยู่ และสามารถเข้าถึงอินเทอร์เน็ตได้ จากนั้นตรวจสอบ pandapaw status ไฟร์วอลล์ขององค์กรต้องอนุญาตทราฟฟิก HTTPS/WebSocket ขาออก คุณไม่ควรสร้างกฎการส่งต่อพอร์ตขาเข้า

การเชื่อมต่อทำงานแต่เอนจินขอให้ตรวจสอบสิทธิ์

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

เอเจนต์เปิดในโฟลเดอร์ผิด

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

ขั้นตอนถัดไป