PandaPaw: מארח מרוחק עבור Claude Code, Codex, ו-PandaCode

עודכן

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

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

מה PandaPaw מנהל

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

PandaPaw אינו מספק מנוי למודל בעצמו. Claude Code, Codex ו-PandaCode עדיין משתמשים באישורי הספק ובמגבלות המוגדרים עבור המנוע שלהם.

כיצד פועלת ביצוע מרוחק

flowchart LR Client["PandaNpc client\nweb · iOS · desktop · Chrome"] -->|outbound authenticated session| Relay["PandaNpc relay"] Host["PandaPaw host"] -->|outbound authenticated session| Relay Host --> Claude["Claude Code"] Host --> Codex["Codex"] Host --> PandaCode["PandaCode"] Claude --> Project["Local project and tools"] Codex --> Project PandaCode --> Project

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

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

פלטפורמות מארח נתמכות

פלטפורמת מארח חבילה הערות
Windows x64 קובץ הפעלה מקורי ושירותי רמת משתמש הרץ את המתקין ב-PowerShell
macOS, Apple Silicon או Intel יישום/קובץ בינארי אוניברסלי של PandaPaw אותה חבילה תומכת בשתי הארכיטקטורות
Linux x86_64 בינארי מקורי ושירות משתמש מיועד להפצות נפוצות מבוססות glibc

לקוח הצפייה של PandaNpc כולל מטריצת פלטפורמות רחבה יותר. ראה התקנת PandaNpc ו-PandaPaw בעת בחירת חבילות לקוח ומארח.

התקנה מומלצת

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

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

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

אימות המארח

תחילה בדוק את המארח עצמו:

bash
pandapaw status

לאחר מכן פתח את PandaNpc Agent ואשר שלמכונה יש מחוון מקוון ירוק. התחל סשן בספריית בדיקה זמנית או לקריאה-בלבד ושאל:

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

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

עבור פרויקט במרכז סוכנים, הרץ:

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

זה מראה האם הפרויקט מקושר והאם תצורה מנוהלת זמינה מקומית. Git remote יציב עוזר ל-PandaPaw לזהות את אותו פרויקט בין מכונות.

אימות חשבון וזהות חיבור

pandapaw login משתמש בסשן אימות התקן מבוסס דפדפן. לאחר שתאשר, המארח מקבל אישורים בהיקף התקן ומפתח אימות של מרכז סוכנים דרך TLS, כותב את תצורת המכונה שלו תחת ~/.pandapaw/, רושם את חיבורי המנוע הנתמכים, ומקשר פרויקטים של Git הניתנים לזיהוי.

הרץ pandapaw login --force רק כאשר אתה מחליף חשבונות בכוונה או מחליף אישור מארח שפג תוקפו. אימות מחדש של מכונה בריאה ללא סיבה יכול ליצור זהויות כפולות או מוחלפות מבלבלות.

pandapaw qr עדיין יוצר קישור חיבור ידני קצר מועד עבור תאימות ומקרים מיוחדים. זה אינו הזרימה העיקרית למארח חדש; התקנים מחוברים קל יותר לביקורת ואינו דורש מהמשתמשים להבין מזהי גשר.

סנכרון מרכז סוכנים

מרכז הסוכנים מונע אירועים במצב יציב:

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

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

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

פקודות שימושיות

bash
pandapaw login
pandapaw status
pandapaw agent status --root /absolute/path/to/project
pandapaw update --restart
pandapaw uninstall
פקודה שימוש
pandapaw login אמת מכונה מותקנת שעדיין לא מחוברת לחשבון
pandapaw status בדוק שירותים מותקנים, חיבור מכונה ובריאות בסיסית
pandapaw agent status --root … בדוק את מצב מרכז הסוכנים עבור פרויקט אחד
pandapaw update --restart אמת, התקן והפעל את גרסת ה-PandaPaw החדשה ביותר
pandapaw uninstall הסר את השירותים והקבצים המנוהלים על ידי PandaPaw באופן שמרני

בדוק את היסטוריית גרסאות PandaPaw כאשר פקודה או ממשק משתמש שונים מצילום מסך או מדריך ישנים יותר.

גבולות אבטחה

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

פתרון בעיות

`pandapaw` לא נמצא לאחר ההתקנה

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

ההתקנה הצליחה, אך אף מכונה לא מופיעה

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

המכונה מופיעה אך נשארת במצב לא מקוון

ודא שהמארח פעיל ובעל גישה לאינטרנט. בדוק את סטטוס PandaPaw מקומית. פרוקסי ארגוני או חומת אש חייבים לאפשר את נתיב ה-HTTPS/WebSocket היוצא; יציאה נכנסת אינה פותרת חיבור יוצא חסום.

המארח מקוון, אך Claude Code או Codex אינם עונים

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

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

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

שינויים במרכז הסוכנים אינם מופיעים

הרץ pandapaw agent status --root /path/to/project מתוך שורש ה-Git הנכון. ודא שהפרויקט מקושר, המארח מחובר לחשבון, והקובץ המקומי הוא חלק מהקרנה מנוהלת. השאר את המהדורה המאומתת האחרונה במקומה בזמן החקירה במקום למחוק ספריות מנוהלות.

עדכון והסרה

pandapaw update --restart מוריד את הבינארי הנוכחי, מאמת את סכום ה-SHA-256 שלו, מחליף את העותק המותקן, ומפעיל מחדש את השירותים המנוהלים כך שהגרסה הופכת לפעילה. צימוד החשבון הקיים נשמר.

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