פרק 14

מלכודות נפוצות, תקלות ופתרונות מעשיים

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

#1. "האם נדרש מנוי Ultra כדי להשתמש ב-Grok Bot?"

הסבר: לא. בעבר נדרשה תוכנית מיוחדת בהשקה, אך כיום כל מנוי קרסור בתשלום (כולל Pro, Pro+, Ultra ומושבי Teams רגילים) כולל גישה מובנית לאפליקציית Grok Bot תחת אותו חשבון משתמש. תוכנית Hobby החינמית אינה כוללת את הבוט.

#2. קישור חשבון SuperGrok לחשבון ה-Cursor הלא נכון

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

#3. "רכשתי מנוי אך מודל Cursor Grok 4.6 אינו מופיע בבורר"

פתרון:

ודאו שהמנוי שלכם פעיל ושאינכם מחוברים בטעות תחת תוכנית Hobby.
בסביבת צוות (Teams / Enterprise): ודאו שמנהל המערכת (Admin) לא חסם את מודלי Cursor / SpaceXAI בהגדרות המודלים המרכזיות של הארגון.
בצעו רענון של חלון העורך דרך פלטת הפקודות: Developer: Reload Window.

#4. עורך ריק והסוכן "אינו רואה את קובצי הפרויקט"

גורם: העורך נפתח על קובץ בודד או ללא פרויקט פתוח. פתרון: גשו תמיד לתפריט העליון File -> Open Folder ופתחו את תיקיית השורש של הפרויקט. לעולם אל תפתחו את תיקיית הבית (~) או כונן שלם.

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

גורם: סמן המקלדת ממוקם בתוך תיבת השיחה של הסוכן או שההשלמה מושהית. פתרון:

לחצו עם העכבר בתוך חלון עורך הקוד שבו מופיע הטקסט האפור.
בדקו בסרגל הסטטוס התחתון שמחוון Cursor Tab אינו נמצא במצב השהיה (Snooze) או כבוי (Disabled).

#6. מקש Shift+Tab מדלג בין שדות במקום להחליף מצב סוכן

גורם: מיקוד המקלדת נמצא מחוץ לתיבת הקלט של ה-Agent. פתרון: לחצו בתוך תיבת הטקסט של הסוכן והקישו Shift+Tab. חלופה נוחה: הקישו Cmd+. במק / Ctrl+. ב-Windows/Linux כדי לפתוח את תפריט המצבים ישירות.

#7. ביקשתם הסבר וקיבלתם שכתוב קוד לא מתוכנן

גורם: שלחתם שאילתת הסבר במצב Agent (שמטרתו עריכת קוד) במקום במצב Ask. פתרון:

שחזרו את הקוד למצבו הקודם באמצעות נקודת השחזור האחרונה (Checkpoint) או בעזרת Git.
החליפו מצב ל-Ask (Shift+Tab) ושלחו את השאלה מחדש. במצב זה הסוכן נעול לקריאה בלבד.

#8. היעדר תכונות חדשות או אי-הופעת חלון Agents Window

גורם: שימוש בגרסה ותיקה של קרסור (Agents Window זמין החל מגרסה 3 ומעלה). פתרון:

ב-macOS: תפריט עליון Cursor -> Check for Updates.
ב-Windows: תפריט Help -> Check for Updates.
ב-Linux: עדכון חבילות דרך sudo apt update && sudo apt upgrade או sudo dnf upgrade.

#9. שרת MCP מסומן באדום או אינו מגיב

פתרון:

פתחו את חלונית הפלט (View -> Output או Cmd+Shift+U / Ctrl+Shift+U) ובחרו ב-MCP Logs.
בדקו אם ישנן שגיאות התחברות (פורט שגוי, פרוטוקול http במקום https, היעדר כותרת Authorization).
ודאו שהשרת המקומי רץ ואינו חסום על ידי חומת אש או חיבור VPN.
כבו והדליקו מחדש את מתג השרת במסך Customize -> MCP.

#10. שגיאת אימות 403 או לולאת התחברות תקועה

פתרון:

בצעו יציאה מלאה מהחשבון (Sign Out) מתוך הגדרות קרסור.
סגרו את כל חלונות היישום לחלוטין.
פתחו מחדש ובצעו התחברות מסודרת דרך חלון הדפדפן. ודאו שאינכם משלבים שני חשבונות שונים.

#11. הסוכן מריץ פקודות מסוכנות או מוחק קבצים

גורם: מצב ההרצה מוגדר על Run Everything. פתרון:

גשו ל-Settings -> Agents -> Approvals & Execution.
העבירו את המצב ל-Auto-review או ל-Allowlist (הדורש אישור ידני לכל פקודה שאינה מוגדרת ברשימה).
הקפידו לבצע Git Commit לפני משימות רחבות כדי לאפשר שחזור קל.

#12. "הפעלתי Privacy Mode ובכל זאת הקוד נשלח החוצה"

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

#13. סוכן ענן (Cloud Agent) אינו מתחיל בריצה

גורם:

היעדר מנוי פעיל בתשלום.
היעדר הרשאות כתיבה במאגר ה-Git המקושר (GitHub/GitLab). פתרון: בדקו את מצב החיבור במסך האינטגרציות וודאו שלמשתמש יש הרשאות Push למאגר.

#14. חבר צוות אינו רואה סוכני ענן של הפרויקט

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

#15. הרחבות מ-VS Code אינן פעילות

פתרון: פתחו את פלטת הפקודות (Cmd+Shift+P / Ctrl+Shift+P), הקלידו Import Settings from VS Code ואשרו את הייבוא. שימו לב כי הרחבות מסוימות של VS Code התלויות בסביבות ייחודיות אינן נתמכות.

#16. טקסט עברי מוצג בכיוון הפוך בטרמינל

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

#דיווח באגים ופנייה לתמיכה

במידה ונתקלתם בבאג שלא נפתר באמצעות השלבים לעיל:

היעזרו במדריך הדיווח הרשמי: Reporting bugs.
עבור בעיות תשלום, חיוב וחשבונות: פנו ישירות לצוות התמיכה של קרסור דרך מרכז העזרה.

#כלל הזהב לעבודה יומיומית

התאימו תמיד את הכלי הנכון לגודל המשימה:

להשלמת מילים ושורות תוך כדי כתיבה: Cursor Tab.
לשינוי ממוקד בפונקציה בודדת: Inline Edit (Cmd+K).
לתכנון משימה מורכבת וגדולה: Plan Mode.
לאיתור ותיקון שורש באג: Debug Mode.
לפיתוח תכונה רב-קובצית: Agent Mode.

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