התחלה מהירה: הרצת Claude Code או Codex מרחוק

עודכן

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

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

לפני שמתחילים

אתם צריכים:

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

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

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

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

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

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

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

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

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

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

פתרון בעיות

המכונה אינה מופיעה בסוכן

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

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

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

הצעדים הבאים