PandaNpc Work: התחלה מהירה — חיבור הסוכן הראשון שלך

התחל להשתמש ב-PandaNpc Work, סביבת העבודה AI רב-מנועית. חבר מחשב עם PandaPaw, בחר מנוע סוכן, ווודא סשן מרוחק.

עודכן

מדריך זה מחבר מחשב אחד אל PandaNpc Work ומאמת שאתם יכולים להריץ Claude Code, Codex או PandaCode ממכשיר אחר. PandaNpc Work הוא סביבת העבודה AI מרובת-מנועים שבה אתם מאצילים עבודה ועוקבים אחריה בין מכשירים. הסוכן עדיין פועל על המחשב המחובר; PandaPaw מספק את הגשר ואת סביבת ההרצה המקומית, בעוד PandaNpc Work נותן לכם ממשק מסונכרן להודעות, אישורים, שאלות והיסטוריית סשנים.

המסלול הזה מתאים ביותר לאנשים שכבר מרגישים בנוח עם Claude Code, Codex או סוכן קידוד דומה. רוב האנשים צריכים להשתמש בתהליך הוספת התקן מכיוון שהוא יוצר פקודת התקנה חד-פעמית שכבר מקושרת לחשבון שלהם. הקצו לכך כחמש דקות, בתוספת כל התחברות לספק מודלים שהמנוע לקידוד שלכם דורש. כדי לחקור את ממשק Agent לפני חיבור מחשב, פתחו את PandaNpc Agent בדפדפן.

לפני שתתחילו

תצטרכו:

  • חשבון PandaNpc שפתחתם באפליקציית ווב, באפליקציית דסקטופ או באפליקציית iOS.
  • מחשב מחובר שמריץ Windows x64, macOS או Linux x86_64.
  • גישה לאינטרנט מהמארח והרשאה להתקין שירות רקע ברמת המשתמש.
  • תיקיית פרויקט שמותר לכם לשנות.
  • חשבון Claude, ChatGPT/Codex או חשבון מודל מותאם אישית אם המנוע שבחרתם עדיין לא מאומת.

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

1. יצירת פקודת ההתקנה של המארח

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

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

אם אתם מעדיפים אימות בדפדפן במקום מפתח מוכן מראש, השתמשו במתקין הרגיל בשלב הבא. הוא מריץ 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

הפקודה אמורה לזהות את השירותים המותקנים ולהציג את המחשב המחובר לחשבון. אם ה-shell לא מוצא את 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. השלימו את ההתחברות הרגילה של המנוע, ואז נסו שוב את הסשן.

הסוכן נפתח בתיקייה הלא נכונה

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

השלבים הבאים