Back to Blog
AI12 min read

Fix Hebrew RTL Reversal in Claude Code & VS Code: The Complete Guide

Complete guide to fixing Hebrew RTL reversal in Claude Code, Copilot, and AI agents in VS Code. Includes recommended RTL extension, practical tips, and essential settings.

JOYO Digital·

הבעיה שכל מפתח ישראלי מכיר: העברית הפוכה

אם אתם מפתחים ישראליים שעובדים עם Claude Code, GitHub Copilot, או כל סוכן AI אחר ב-VS Code - סביר מאוד שנתקלתם בבעיה המתסכלת של היפוך העברית. במקום לקרוא "שלום עולם" אתם רואים טקסט שמיושר לא נכון, מילים בסדר הפוך, או סתם בלגן שקשה לקרוא.

Enjoying this? There's more where this came from.

Practical guides, new tools, and AI & digital tips — straight to your inbox, once a week. Never miss a thing.

הבעיה נובעת מכך שהתוסף של Claude Code ב-VS Code (וגם תוספים אחרים של סוכני AI) יצא לפני זמן קצר, והגרסאות הראשונות פשוט לא תמכו נכון בשפות RTL (Right-to-Left) כמו עברית וערבית. ההודעות בצ'אט של הסוכן מוצגות ביישור לשמאל, סדר המילים מתהפך, והחוויה הופכת מתסכלת.

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

הפתרון המומלץ: תוסף RTL for VS Code Agents

הפתרון הטוב ביותר שקיים כיום הוא תוסף שפותח על ידי Guy Ronnen - מפתח ישראלי מוכשר שזיהה את הבעיה ובנה פתרון שעובד עם כל הסוכנים. התוסף נקרא "RTL for VS Code Agents" והוא זמין בחינם ב-GitHub.

מה התוסף עושה?

  • מיישר עברית לימין - בכל הודעות הצ'אט של סוכני AI ב-VS Code
  • שומר על הסדר הנכון - מילים בעברית מוצגות בסדר הקריאה הנכון (ימין לשמאל)
  • לא פוגע באנגלית - קוד וטקסט באנגלית נשארים מיושרים לשמאל כרגיל
  • עובד עם כולם - Claude Code, GitHub Copilot, ואפילו Antigravity
  • קונפיגורבילי - אפשר להתאים את ההתנהגות לפי העדפה אישית

התקנה שלב אחרי שלב

  1. פתחו את VS Code
  2. לחצו על Extensions (Ctrl+Shift+X / Cmd+Shift+X)
  3. חפשו: "RTL for VS Code Agents"
  4. לחצו Install
  5. הפעילו מחדש את VS Code
  6. סיימתם! העברית כבר מיושרת נכון

קישור ישיר למאגר: github.com/GuyRonnen/rtl-for-vs-code-agents

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

פתרון משלים: Multi-RTL Extension

פתרון נוסף ששווה להכיר הוא Multi-RTL - תוסף שמיישר תוכן RTL באופן קונפיגורבילי לא רק ב-VS Code, אלא בכל אתר שהוא. זה כולל:

  • VS Code (Claude Code, Copilot) - יישור עברית בצ'אט הסוכנים
  • NotebookLM - המחברת של גוגל, עכשיו עם עברית מסודרת
  • Perplexity - תוצאות חיפוש AI בעברית קריאה
  • Slack - הודעות בעברית מיושרות לימין
  • WhatsApp Web - שיפור תצוגת עברית
  • כל אתר אחר - התוסף עובד על כל דף ווב

פרטים נוספים: multi-rtl.asia-digital.online

הגדרות VS Code מומלצות לעבודה בעברית

מעבר לתוסף RTL, יש כמה הגדרות שכדאי להפעיל ב-VS Code כדי לשפר את חוויית העבודה בעברית:

1. הגדרת כיוון ברירת מחדל

פתחו את ההגדרות (Ctrl+, או Cmd+,) וחפשו:

editor.wordWrap: "on"
editor.accessibilitySupport: "off" (מונע בעיות RTL מסוימות)

2. גופנים שתומכים בעברית

לא כל גופני mono תומכים טוב בעברית. גופנים מומלצים:

  • Cascadia Code - הגופן של מיקרוסופט, תמיכה מצוינת בעברית
  • Fira Code - גופן פופולרי עם ligatures ותמיכה טובה ב-RTL
  • JetBrains Mono - גופן מצוין עם תמיכה מלאה ב-Unicode
  • Noto Sans Hebrew Mono - הגופן של גוגל, מותאם במיוחד לעברית

3. הגדרת Terminal לעברית

"terminal.integrated.rightClickBehavior": "default"
"terminal.integrated.unicodeVersion": "11"

טיפים מעשיים לעבודה עם AI בעברית

טיפ 1: כתבו את הפרומפט בעברית ברווח

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

טיפ 2: הגדירו את שפת הפלט

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

טיפ 3: הפרידו קוד מתוכן עברי

כשאתם מבקשים מ-AI לכתוב קוד שמכיל טקסט בעברית (למשל ממשק משתמש), בקשו ממנו:

  • לשים את כל הטקסטים בעברית בקובץ נפרד (i18n/locale)
  • להוסיף dir="rtl" לאלמנטים בעברית
  • להשתמש ב-CSS Logical Properties (margin-inline-start במקום margin-left)

טיפ 4: השתמשו בקובצי CLAUDE.md לעברית

אם אתם עובדים עם Claude Code, צרו קובץ CLAUDE.md בשורש הפרויקט שמכיל:

## שפה ותרבות
- כל הודעות המשתמש, תגובות, טקסטי ממשק ותוכן באתר - בעברית
- כיוון ברירת מחדל: RTL
- גופן מומלץ לעברית: [שם הגופן]
- תמיד הוסף dir="rtl" לאלמנטי HTML עם תוכן בעברית

ככה Claude Code ידע אוטומטית להתנהל נכון עם עברית בכל פקודה.

טיפ 5: בדיקת RTL אוטומטית

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

  • בדקו שכל אלמנט עם טקסט עברי מכיל dir="rtl"
  • וודאו ש-CSS Logical Properties משמשים במקום כיוונים קשיחים
  • בדקו שהמספרים מוצגים נכון (LTR בתוך טקסט RTL)

הבעיה ההיסטורית: למה זה קרה?

כדי להבין את הבעיה, צריך להבין קצת על איך RTL עובד בדפדפנים ובסביבות פיתוח:

Unicode Bidirectional Algorithm (BiDi)

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

  • הקונטיינר לא מגדיר כיוון (חסר dir attribute)
  • הקונטיינר מוגדר כ-LTR ויש בו טקסט RTL
  • יש ערבוב של סימנים (סוגריים, נקודות, פסיקים) שמבלבלים את האלגוריתם
  • הפרוגרמה שמציגה את הטקסט לא מטפלת ב-BiDi כראוי

למה VS Code בעייתי?

VS Code הוא בעיקרו עורך קוד, וקוד הוא LTR. לכן הכיוון ברירת המחדל הוא שמאל-לימין. כשתוספי AI (כמו Claude Code) מציגים טקסט בצ'אט, הם משתמשים ב-Webview של VS Code, שברירת מחדל מוגדר כ-LTR. בלי התערבות מפורשת, העברית פשוט לא מוצגת נכון.

מה התוסף של Guy Ronnen עושה טכנית?

התוסף מזהה אוטומטית בלוקים של טקסט עברי בתוך ה-Webview של הסוכנים ומוסיף להם:

  • כיוון dir="rtl" לפסקאות עבריות
  • יישור טקסט text-align: right
  • טיפול ב-Bidi override לסימנים בעייתיים
  • שמירה על LTR לבלוקי קוד (כדי שהקוד לא יתהפך)

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

סקירת כלי AI וההתמודדות שלהם עם עברית

Claude Code

רמת העברית: מצוינת. Claude מבין ומייצר עברית ברמה גבוהה מאוד, כולל ניואנסים תרבותיים וסלנג. הבעיה היחידה היא תצוגת RTL ב-VS Code, שנפתרה עם התוסף.

GitHub Copilot

רמת העברית: טובה. Copilot יכול להשלים קוד עם הערות בעברית ולייצר תיעוד בעברית. גם כאן התוסף של Guy Ronnen מתקן את תצוגת ה-RTL.

Google Gemini (בדפדפן)

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

ChatGPT / GPT-4

רמת העברית: טובה מאוד. OpenAI שיפרו משמעותית את התמיכה בעברית. בממשק הרשמי (chat.openai.com) אין בעיית RTL.

טעויות נפוצות וטיפול בהן

הטקסט עדיין הפוך אחרי התקנת התוסף

פתרון: ודאו שהפעלתם מחדש את VS Code. אם זה לא עוזר, בדקו שהתוסף מופעל (לא Disabled). נסו גם: Ctrl+Shift+P → "Developer: Reload Window".

הקוד מיושר לימין במקום לשמאל

פתרון: התוסף אמור לזהות בלוקי קוד ולשמור אותם LTR. אם זה לא עובד, עדכנו לגרסה האחרונה. אם הבעיה נמשכת, פתחו issue ב-GitHub של התוסף.

ביצועים איטיים אחרי ההתקנה

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

מספרים וסימנים מוצגים לא נכון

פתרון: זו בעיית BiDi קלאסית. השתמשו בתווי Unicode Bidi control כשצריך: LRM (Left-to-Right Mark) ו-RLM (Right-to-Left Mark) כדי לכפות כיוון לסימנים ספציפיים.

עתיד ה-RTL בכלי AI

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

  • תמיכה מובנית - צפוי שגם Claude Code וגם Copilot יוסיפו תמיכת RTL מובנית ב-VS Code, מה שיפחית את הצורך בתוספים חיצוניים
  • שיפור BiDi - VS Code עצמו משפר את התמיכה ב-BiDi עם כל גרסה חדשה
  • AI שמבין כיוון - מודלי AI עתידיים יבינו אוטומטית באיזו שפה כותבים ויתאימו את הפלט בהתאם
  • קהילה ישראלית פעילה - מפתחים כמו Guy Ronnen מראים שהקהילה הישראלית מובילה פתרונות לבעיות RTL

מעבר ל-Claude Code: טיפים כלליים לפיתוח בעברית

HTML ו-CSS

  • תמיד הגדירו dir="rtl" ו-lang="he" על תג ה-<html>
  • השתמשו ב-CSS Logical Properties: margin-inline-start במקום margin-left, padding-inline-end במקום padding-right
  • השתמשו ב-Flexbox עם direction: rtl - הסדר מתהפך אוטומטית
  • לנתוני קלט מספריים, הוסיפו dir="ltr" על ה-input

React ו-Next.js

  • השתמשו ב-next-intl או react-intl לניהול RTL
  • הגדירו dir דינמי ב-layout component
  • ב-Tailwind CSS, השתמשו ב-rtl: modifier (Tailwind 3.3+)
  • בדקו שכל הקומפוננטות עובדות ב-RTL - במיוחד טבלאות, טפסים, ו-navigation

Git ו-CI/CD

  • הוסיפו .editorconfig עם: end_of_line = lf
  • השתמשו ב-UTF-8 everywhere (ברוב המקרים זה ברירת מחדל)
  • ב-commit messages, כתבו באנגלית (העברית יכולה להתהפך ב-git log)

קרדיט וקישורים

תודה מיוחדת ל-Guy Ronnen על הפיתוח של תוסף RTL for VS Code Agents שפותר את הבעיה בצורה אלגנטית ויעילה.

שאלות נפוצות

האם התוסף חינמי?

כן, לחלוטין. קוד פתוח, זמין ב-GitHub.

האם התוסף עובד גם עם ערבית?

כן! התוסף תומך בכל שפות RTL כולל ערבית, פרסית, ואורדו.

האם צריך להגדיר משהו אחרי ההתקנה?

לא. התוסף עובד אוטומטית (plug & play). אם תרצו להתאים הגדרות, יש אפשרויות קונפיגורציה בהגדרות VS Code.

האם התוסף מאט את VS Code?

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

מה עושים אם יש באג?

פתחו issue ב-GitHub: github.com/GuyRonnen/rtl-for-vs-code-agents/issues. Guy Ronnen מגיב מהר וקשוב לקהילה.

סיכום

עברית ו-AI הם שילוב שעובד מצוין - כשהכלים מסודרים. הבעיה של היפוך RTL ב-Claude Code ובסוכני AI ב-VS Code נפתרה, הודות לתוסף של Guy Ronnen ולפתרון Multi-RTL.

אם אתם מפתחים ישראליים שעובדים עם AI, ההמלצה היא פשוטה:

  1. התקינו את התוסף של Guy Ronnen
  2. עדכנו לגרסה 8.0.0 ומעלה
  3. הגדירו CLAUDE.md עם הנחיות RTL
  4. בחרו גופן שתומך בעברית
  5. תכתבו בעברית ותהנו

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

Want more content like this?

Every week we send practical AI tips, new tools, and strategies that work — straight to your inbox, no spam.

100% FreeUnsubscribe anytimeNo spam

At JOYO Digital we help businesses grow with AI and digital:

Hands-on AI Workshops
Websites + CRM
Digital Marketing
Tech Consulting