נתקעת בהתקנה? רוב הבעיות נפתרות בדקה. מצא את הסימן שלך וקבל את הפתרון המדויק.
code.sai-app.com. אם משהו לא עובד, כמעט תמיד צריך פשוט לאשר את הכתובת הזו בסינון (נטפרי / רימון). זה פותר את רוב המקרים.
סימן: "שם המתחם לא נפתר", החיבור נתקע (timeout) או נקטע (TLS reset), או מתקבל דף-חסימה במקום תשובה.
פתרון: הוסף את code.sai-app.com לרשימת ההיתר בסינון. זו הכתובת היחידה שהכלי צריך — אישור שלה פותר את החסימה.
סימן: sai-code status לא מראה ENABLED, או Claude Code לא עובר דרך SAI.
פתרון: הרץ שוב את ההתחברות — sai-code activate (Mac/Linux) או "התחבר עם חשבון SAI" באפליקציה (Windows).
סימן: ההתחברות נחסמת או מציינת שאין הרשאה.
פתרון: נדרש חשבון SAI עם מסלול הכולל גישה ל-SAI Code. בדוק או שדרג ב-account.sai-app.com.
סימן: אפליקציית SAI Code מציגה סטטוס כתום/אדום (דרושה התקנה / החיבור חסום).
פתרון: עקוב אחר ההודעה — בדרך כלל לחיצה אחת על "התקן את הרכיבים הדרושים" או "נסה שוב". האפליקציה אומרת בדיוק מה חסר.
סימן: ההתקנה או החיבור נכשלים על שגיאת אבטחה/תעודה.
פתרון: הכלי סומך אוטומטית על מאגר התעודות של Windows. ודא שתעודת ה-CA של הסינון מותקנת במערכת (בד"כ כן בהתקנת נטפרי/רימון), והרץ שוב.
סימן: ההתקנה נעצרת בשלב עדכון Node.
פתרון: סגור טרמינלים ו-VS Code פתוחים, והרץ את ההתקנה שוב.
סימן: "הורדה חלקית או חסימת סינון".
פתרון: ודא ש-code.sai-app.com מאושר בסינון, בדוק את החיבור, ונסה שוב.
סימן: "Node.js לא מותקן" או "גרסת Node ישנה מדי (צריך 18+)".
פתרון: התקן מ-nodejs.org או brew install node, ואז הרץ sai-code install שוב.
סימן: ההתקנה ל-/usr/local/bin מבקשת אימות.
פתרון: זה תקין — הזן את סיסמת המנהל פעם אחת. (אם אין הרשאות, הכלי מותקן ל-~/.local/bin — ודא שהוא ב-PATH.)
סימן: "cannot be opened because it is from an unidentified developer".
פתרון: ההתקנה דרך הסקריפט מנקה זאת אוטומטית. בהורדה ידנית: System Settings → Privacy & Security → "Allow Anyway".
סימן: "checksum mismatch — aborting".
פתרון: בעיית רשת/הורדה חלקית. הרץ את פקודת ההתקנה שוב.
סימן: "linux/arm64 isn't published yet".
פתרון: כרגע נתמכים Linux x86-64 ו-macOS (Intel + Apple Silicon). ל-arm64 — פנה לתמיכה.