เริ่มต้นใช้งาน PandaNpc Work: เชื่อมต่อเอเจนต์แรกของคุณ

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

เส้นทางนี้เหมาะที่สุดสำหรับผู้ที่คุ้นเคยกับ Claude Code, Codex หรือ coding agent ที่คล้ายกันอยู่แล้ว คนส่วนใหญ่ควรใช้ขั้นตอน Add a device เพราะมันสร้างคำสั่งติดตั้งแบบใช้ครั้งเดียวที่เชื่อมโยงกับบัญชีแล้ว เผื่อเวลาประมาณห้านาที บวกกับการลงชื่อเข้าใช้ผู้ให้บริการโมเดลที่เอนจินเขียนโค้ดของคุณต้องการ หากต้องการสำรวจอินเทอร์เฟซ Agent ก่อนเชื่อมต่อคอมพิวเตอร์ ให้เปิด PandaNpc Agent ในเบราว์เซอร์

ก่อนที่คุณจะเริ่ม

คุณต้องมี:

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

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

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

ขณะลงชื่อเข้าใช้ ให้เปิด Connected Devices และเลือก Add a device PandaNpc สร้างคีย์อุปกรณ์แบบใช้ครั้งเดียวและแสดงคำสั่งที่แน่นอนสำหรับระบบปฏิบัติการของคุณ

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

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

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

macOS หรือ Linux

รันคำสั่งที่เตรียมไว้จาก Connected Devices หรือใช้ตัวติดตั้งแบบธรรมดา:

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

Windows PowerShell

รันคำสั่งที่เตรียมไว้จาก Connected Devices หรือใช้:

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

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

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

pandapaw login

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

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

pandapaw status

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

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

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 ได้ แม้ว่าการเชื่อมต่อที่บันทึกไว้จะยังปรากฏในบัญชีของคุณ

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

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

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

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

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

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

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

การเชื่อมต่อทำงานได้แต่เอนจินขอการยืนยันตัวตน

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

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

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

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

• อ่าน PandaPaw host guide ฉบับเต็มสำหรับการอัปเดต การตรวจสอบบริการ และสถาปัตยกรรมการเชื่อมต่อ
• ดู Account and billing เพื่อทำความเข้าใจว่าการสมัครสมาชิกหรือผู้ให้บริการใดเป็นผู้จ่ายสำหรับแต่ละเซสชัน
• เพิ่ม custom AI providers เมื่อคุณต้องการปลายทางที่เข้ากันได้กับ OpenAI โมเดลที่โฮสต์เอง หรือ API Key แยกต่างหาก