התקנת PandaNpc ו-PandaPaw

עודכן

להגדרת סוכן קוד מרוחק יש שני חלקים בלתי תלויים:

  • לקוח PandaNpc — הממשק שבו אתה משתמש כדי לקרוא סשנים, לשלוח הנחיות ולאשר כלים. הוא רץ על האינטרנט, iOS, Windows, macOS ו-Linux.
  • מארח PandaPaw — שירות הרקע במחשב שבו Claude Code, Codex או PandaCode פועלים בפועל.

התקן רק את הלקוח לצ'אט של PandaNpc ולשימוש מקומי בשולחן העבודה. התקן את שני החלקים כאשר ברצונך לגשת לסוכן קוד הרץ על מכונה אחרת.

ראה PandaNpc לשולחן העבודה כדי לדעת מה מוסיפה אפליקציית Windows/macOS/Linux מעבר לשלבי ההתקנה שלהלן, כולל היסטוריית השחרורים שלה.

בחר מה להתקין

תרחיש לקוח מארח PandaPaw
השתמש בצ'אט של PandaNpc בדפדפן פתח את אפליקציית האינטרנט לא נדרש
שלוט בסוכן על אותו שולחן עבודה אפליקציית שולחן עבודה תלוי במצב המקומי/מרוחק הנבחר
שלוט במכונת פיתוח מטלפון או דפדפן התקן/פתח לקוח על המכשיר שממנו צופים נדרש במכונת הפיתוח
הרץ סוכנים על שרת ללא שולחן עבודה גרפי אינטרנט, שולחן עבודה או iOS במקום אחר נדרש על השרת

לנתיב המלא הקצר ביותר, השתמש במדריך התחלה מהירה.

התקנת לקוח PandaNpc

השתמש בדף ההורדה של PandaNpc כמקור האמת למתקינים עדכניים. הימנע מאתרי הורדה של צד שלישי, מכיוון שהם עלולים לספק חבילות ישנות או מהונדסות.

אינטרנט

פתח את pandanpc.com/agent בדפדפן עדכני. שום דבר לא מותקן. אחסון הדפדפן שומר את מצב הכניסה המקומי, כך שחלונות פרטיים/אנונימיים עשויים לדרוש ממך להיכנס שוב.

iOS

עקוב אחר קישור ה-App Store בדף ההורדה והתקן את PandaNpc. iOS שימושית לבדיקת התקדמות, מענה על שאלות ואישור כלים בזמן שאתה רחוק מהמארח. תהליך הקידוד עדיין רץ על מכונת המארח המחוברת. ראה PandaNpc ל-iOS כדי לדעת מה האפליקציה מכסה, כולל היסטוריית השחרורים.

Windows

  1. הורד את מתקין Windows העדכני.
  2. הרץ אותו ופעל לפי הנחיות המתקין.
  3. הפעל את PandaNpc מתפריט התחל.
  4. אם Windows מציג אזהרת מפרסם או מוניטין, ודא שהקובץ הגיע מ-pandanpc.com לפני שתמשיך.

macOS

  1. הורד את קובץ ה-.dmg של macOS.
  2. גרור את PandaNpc אל יישומים.
  3. הפעל אותו מהיישומים והשלם כל הנחיית אבטחה של macOS.

גרסת ה-macOS היא אוניברסלית, כך שאותה חבילה תומכת ב-Apple Silicon וב-Intel Macs.

Linux

הורד את ה-AppImage עבור x86_64, הפוך אותו לקובץ הרצה והרץ אותו:

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

אם ה-AppImage לא נפתח, הרץ אותו מהמסוף פעם אחת ושמור את פלט השגיאה המדויק. הפצות ישנות עשויות לחסור בספריית ריצה הנדרשת למעטפת שולחן העבודה.

התקנת PandaPaw על מארח הסוכן

PandaPaw כרגע מספק מתקינים למארח עבור Windows x64, macOS אוניברסלית ו-Linux x86_64. הרץ את הפקודה על המחשב שמחזיק בקבצי הפרויקט ואמור לבצע את הכלים של הסוכן.

המסלול המומלץ הוא מכשירים מחוברים: בחר הוסף מכשיר, ולאחר מכן העתק את הפקודה החד-פעמית שנוצרה. היא מקשרת את המארח לחשבון שלך במהלך ההתקנה.

macOS או Linux

מתקין פשוט עם הרשאת דפדפן:

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

טופס מפתח חד-פעמי מוכן:

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

Windows PowerShell

מתקין פשוט:

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

טופס מפתח חד-פעמי מוכן:

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

צינור ה-iwr | iex של PowerShell אינו יכול להעביר ארגומנטים רגילים של סקריפט, ולכן מתקין Windows קורא את המפתח החד-פעמי מ-PANDANET_KEY.

מה משנה מתקין המארח

המתקין:

  1. מוסיף את PandaPaw לתיקיית היישומים/בתיקיית ה-bin של המשתמש הנוכחי ומעדכן את PATH של המשתמש בעת הצורך.
  2. רושם את שירותי הרקע המתאימים כדי שיתחילו אוטומטית.
  3. מתקין מנועי קוד נתמכים שחסרים, כאשר הפלטפורמה מאפשרת זאת.
  4. מספק סביבת ריצה פרטית של Node.js כאשר למערכת אין גרסה מתאימה.
  5. מתחיל הרשאת חשבון או מממש את מפתח ההתקן המוכן.
  6. רושם אילו קבצים הוא יצר כדי שהסרת ההתקנה תוכל לשמר כלים תואמים שכבר היו קיימים.

התקנת מנוע אינה רוכשת או מאמתת אוטומטית מנוי מודל. Claude Code ו-Codex עדיין יכולים לבקש התחברות לספק משלהם בפעם הראשונה שהם רצים.

אמת את ההתקנה

פתח מסוף חדש לאחר ההתקנה והרץ:

bash
pandapaw status

לאחר מכן פתח את סוכן PandaNpc. המארח אמור להופיע כמקוון. התחל סשן בפרויקט בדיקה ובקש ממנו לדווח על תיקיית העבודה הנוכחית מבלי לשנות קבצים. זה מאמת את הבינארי, שירות הרקע, הצימוד לחשבון, חיבור הממסר, המנוע והתיקייה שנבחרה—ולא רק את שלב ההורדה.

עדכון

לקוחות שולחן העבודה מודיעים לך כאשר קיים עדכון. עדכוני iOS מתבצעים דרך ה-App Store.

עדכן את PandaPaw והפעל מחדש את השירותים המנוהלים על ידו עם:

bash
pandapaw update --restart

המתעדכן מאמת את הבינארי שהורד מול סכום ה-SHA-256 שפורסם לפני החלפת העותק המותקן. הצימוד לחשבון וזהות החיבור הקיימת נשמרים. הפעלה חוזרת של פקודת ההתקנה נתמכת גם כאשר המתעדכן עצמו אינו זמין.

הסרת התקנה

  • לקוח Windows: הגדרות ← אפליקציות ← אפליקציות מותקנות ← PandaNpc ← הסר התקנה.
  • לקוח macOS: צא מ-PandaNpc, ולאחר מכן העבר אותו מהיישומים לפח.
  • לקוח Linux: הסר את ה-AppImage ואת כל משגר שיצרת עבורו.
  • מארח PandaPaw: הרץ את pandapaw uninstall על המארח.

מניפסט ההסרה של PandaPaw מבחין בין כלים שהמתקין יצר לבין כלים תואמים שכבר היו קיימים. הוא שמרני במכוון ולא מוחק התקנה קודמת של Claude Code, Codex, PandaCode או Node.

בעיות התקנה

הפקודה הסתיימה אבל המארח לא מחובר

הרץ את pandapaw login. התקנת מארח והרשאת חשבון הם שלבים נפרדים, והמתקין יכול להסתיים גם אם הרשאת הדפדפן נדחתה או הופרעה.

המעטפת (shell) לא מוצאת את `pandapaw`

פתח מסוף חדש. ב-macOS/Linux, בדוק את ~/.local/bin; ב-Windows, בדוק את %LOCALAPPDATA%\Programs\pandapaw. אל תתקין שוב ושוב עד שתאשר האם הקובץ ההרצה קיים ורק PATH מיושן.

מנוע קוד נכשל בהתקנה

מתקין המארח מתייחס להורדות מנוע אופציונליות כאל מאמץ מיטבי, כך שהשבתה של ספק אחד לא מסירה התקנת PandaPaw תקינה. התקן או תקן את המנוע באמצעות המתקין הרשמי שלו, אמת אותו באופן רגיל, ולאחר מכן הרץ שוב את pandapaw status.

ה-AppImage או אפליקציית שולחן העבודה לא נפתחים

ודא שהורדת את החבילה עבור הארכיטקטורה הנכונה, ולאחר מכן הפעל אותה מהמסוף כדי ללכוד את השגיאה הראשונה. כלול שגיאה זו ואת גרסת מערכת ההפעלה שלך כשתפנה לתמיכה; צילומי מסך של חלון סגור לרוב אינם מספיקים כדי לאבחן ספריית ריצה חסרה.

לבדיקות חיבור ספציפיות למארח, המשך עם מדריך PandaPaw או שאלות נפוצות.