Skip to content

Digitizers/vs-code-rtl-extension

 
 

Repository files navigation

Claude Code RTL Logo Claude Code RTL Support

Adds Right-to-Left (RTL) text support for Hebrew, Arabic & Persian to Claude Code in VS Code, Cursor, Antigravity & Kiro.

Extends the official Claude Code for VS Code extension injects RTL CSS into the chat interface while keeping code blocks, tool output, and UI elements properly LTR.

Enhancer Version IDE License

If you find this extension useful, please rate it on the VS Code Marketplace or Open VSX, and give it a ⭐ on GitHub — it helps others discover it!


GitHub stars Open VSX Installs VS Code Marketplace Installs

🌐 Languages | שפות | اللغات | زبان‌ها

Language Quick Links
🇺🇸 English GB View Extension Explanation ↓
🇮🇱 עברית IL להסבר על התוסף בעברית ↓
🇸🇦 عربية SA لشرح الملحق بالعربية ↓
🇮🇷 فارسی IR برای توضیح افزونه به فارسی ↓

🎬 Demo

🖼️ RTL Button RTL Toggle Button
🖼️ Status Bar Status Bar

🔝 Back to top

🇺🇸 English

A VS Code extension that adds Right-to-Left (RTL) text direction support to the Claude Code chat interface in VS Code, Cursor, Antigravity, and Kiro. Designed for Hebrew, Arabic, and Persian speakers who want natural text alignment when chatting with Claude — without affecting code blocks or UI elements.

🤔 Why is this needed?

The original Claude Code for VS Code extension lacks native RTL support. This often results in:

  • ❌ Hebrew, Arabic, and Persian text appearing misaligned
  • ❌ Difficulty reading mixed-language conversations (code + RTL text)
  • ❌ Inconsistent UI behavior in the chat panel

Claude Code RTL Support fixes these issues by intelligently injecting CSS to handle text direction — while strictly preserving LTR for code blocks and terminal outputs.

✨ Features

Feature Description
▶️ Activate RTL Injects CSS and a toggle button into the Claude Code chat
📌 Activate RTL (Always) Permanently enables RTL without a toggle button
👁️ Activate RTL (Auto) Auto-detects Hebrew/Arabic/Persian per bubble and sets direction (Recommended)
🔧 Fix BiDi Activates RTL and fixes reversed text (e.g. "םולש" → "שלום")
⏹️ Deactivate RTL Restores original files from backup
🔍 Check Status Shows which installations have RTL enabled
📊 Status Bar Shows current RTL state at a glance — click to manage
🔄 Auto-reactivate Automatically restores RTL after Claude Code updates

🆕 What's New (v0.4.0)

  • Custom font settings — Two new VS Code settings let you choose the fonts Claude Code uses:
    • claude-code-rtl.textFont — font family for messages and the input box (e.g. Vazirmatn for proper Persian rendering, Tahoma for Hebrew/Arabic)
    • claude-code-rtl.codeFont — font family for code blocks and diff editor (e.g. JetBrains Mono, Fira Code)
    • Leave a setting blank to keep Claude Code's default font.
  • Kiro IDE support — The extension now detects and supports Kiro alongside VS Code, Cursor, and Antigravity.

💡 Recommended: Use Auto mode (Claude RTL: Activate RTL (Auto)) for the best experience — each element gets the right direction automatically, including Plan Preview and permission dialogs.

Previous versions

v0.3.9

  • Plan Preview RTL support — Claude Code's new Plan Mode tab (separate editor tab for plans) now gets full RTL support. In Auto mode, the plan content is automatically detected and switched to RTL when it contains Hebrew, Arabic, or Persian text. In Active mode, a ⇄ toggle button appears. In Always mode, the plan is always RTL. Code blocks within plans stay LTR.

v0.3.8

  • Smart Permission RTL (Auto mode) — In Auto mode, permission requests and follow-up questions now detect RTL direction per element. Questions and options in Hebrew, Arabic, or Persian flow right-to-left; English ones stay left-to-right.

v0.3.7

  • Antigravity IDE support — The extension now detects and supports Antigravity alongside VS Code and Cursor.

v0.3.6

  • Smart input direction — The input field now detects text direction on the fly based on the first character you type. Start with a Hebrew, Arabic, or Persian letter and it flows RTL; start with English and it stays LTR. The only exception is Active mode with the ⇄ button toggled on — there the input is always RTL.
  • Fallback button placement — When the chat header isn't rendered yet (e.g. resuming an active session on startup), the ⇄ toggle button now appears above the input area so you're never left without it.
  • Safer auto-reactivate — Version tracking ensures RTL is cleanly re-injected after a Claude Code update instead of stacking on stale CSS.

v0.3.5

  • Auto RTL mode — An intelligent mode that auto-detects Hebrew, Arabic, and Persian text per chat bubble using a MutationObserver. Only bubbles containing RTL text get right-to-left direction — English-only bubbles stay LTR. No manual toggling needed.

v0.3.0

  • Always RTL mode — A new mode that permanently enables RTL without needing the toggle button. CSS is injected directly without class dependency, so RTL is always active. Switch between modes via the status bar menu or command palette.
  • Auto-reactivate — RTL is automatically restored when Claude Code updates replace its files. No need to manually re-activate.
  • Auto-activate on install — RTL activates automatically on first install.

v0.2.0

  • Fix BiDi command — Solves the reversed text issue where Hebrew/Arabic/Persian words appear mirrored (e.g. "םולש" instead of "שלום"). This happens because Claude Code injects a * { direction: ltr; unicode-bidi: bidi-override; } rule that forces all text to LTR. The new Fix BiDi command activates RTL and removes this problematic rule automatically.

📋 Requirements


💻 Supported Platforms

🛠️ IDEs
VS Code
Cursor
Antigravity
Kiro

🚀 How to Use

📊 Option 1: Status Bar

After installation, a status bar item appears at the bottom of VS Code:

Status Meaning
RTL: Active RTL is injected with toggle button
RTL: Always 📌 RTL is permanently on (no toggle needed)
RTL: Auto 👁️ RTL auto-detects per bubble (Recommended)
RTL: Inactive RTL is not installed
RTL: N/A Claude Code for VS Code extension not found

Click the status bar item to open a menu with Activate / Activate (Always) / Deactivate / Status options.

🎯 Option 2: Command Palette

Press Ctrl+Shift+P (or Cmd+Shift+P on macOS) and search for:

Command Action
Claude RTL: Activate RTL ▶️ Enable RTL support with toggle button
Claude RTL: Activate RTL (Always) 📌 Enable RTL permanently without toggle button
Claude RTL: Activate RTL (Auto) 👁️ Auto-detect RTL per bubble (Recommended)
Claude RTL: Fix BiDi 🔧 Activate RTL + fix bidirectional text issues
Claude RTL: Deactivate RTL ⏹️ Disable RTL and restore original files
Claude RTL: Check Status 🔍 View installation status

🔄 The window reloads automatically after Activate / Deactivate to apply changes.

💬 Using RTL in Chat

Active mode — After activating RTL and reloading:

  1. Open the Claude Code chat panel
  2. Click the button in the chat header
  3. The interface switches to RTL — text aligns to the right
  4. Click again to return to LTR

Always mode — RTL is permanently on. No button needed — text is always right-to-left.

Auto mode — RTL is automatically detected per chat bubble. Bubbles with Hebrew/Arabic/Persian text become RTL; English-only bubbles stay LTR. Best for mixed-language conversations.

💡 Tip (Active mode): Not every conversation needs RTL — you can toggle it per chat session. Use ⇄ only in conversations where you write in Hebrew, Arabic, or Persian.

💡 Tip (Always mode): Use this if you always write in Hebrew, Arabic, or Persian and don't want to toggle each time.

💡 Tip (Auto mode): Best for mixed conversations — each bubble gets the right direction automatically.

🔄 Auto-reactivate: If Claude Code updates and replaces its files, RTL is automatically restored on the next startup.


↔️ What Changes in RTL Mode?

✅ Becomes RTL 🔒 Stays LTR
User messages Code blocks
Claude's text responses Tool calls and results
Lists and paragraphs Thinking blocks
Question/answer blocks Slash commands
Plan Preview tab Buttons and UI elements

⚙️ Font Settings (optional)

Customize the fonts Claude Code uses by adding these to your settings.json (Ctrl+, / Cmd+, → search claude-code-rtl):

Setting Description Example values
claude-code-rtl.textFont Font for messages and the input box Vazirmatn, Tahoma
claude-code-rtl.codeFont Font for code blocks and diff editor JetBrains Mono, Fira Code
{
  "claude-code-rtl.textFont": "Vazirmatn",
  "claude-code-rtl.codeFont": "JetBrains Mono"
}

💡 Persian users: Vazirmatn is strongly recommended for proper Persian numeral and character rendering — install it from vazirmatn.rastikerdar.com.

💡 Leave a setting blank to keep Claude Code's default font.

🔄 After changing a font setting, you'll be prompted to reload the window so the new CSS takes effect.


🔧 Troubleshooting

❓ Can't find the plugin in Cursor, Antigravity or Kiro
  • Search for the plugin by its ID: claude-code-rtl
  • The display name "Claude Code RTL Support" may not appear in search results on all platforms
  • Use the exact ID claude-code-rtl in the extensions search bar
❓ Extension doesn't find Claude Code for VS Code
  • Make sure the "Claude Code for VS Code" extension is installed
  • Check status with the Claude RTL: Check Status command
❓ Changes not visible after activating
  • Reload the window: Ctrl+Shift+PDeveloper: Reload Window
  • Or close and reopen VS Code / Cursor completely
❓ RTL stopped working after a Claude Code update
  • When "Claude Code for VS Code" updates, it replaces its files and RTL support is removed
  • Starting from v0.3.0, RTL is automatically restored on the next startup
  • If it doesn't restore automatically, run Claude RTL: Activate RTL manually
❓ Hebrew/Arabic text appears reversed (e.g. "םולש" instead of "שלום")
  • This is caused by a bidi-override CSS rule in Claude Code that forces LTR direction on all text
  • Use Claude RTL: Fix BiDi instead of Activate RTL to fix this
  • Note: Running Activate RTL again will bring back the issue — use Fix BiDi each time
❓ Permission Denied error
  • Windows: Try running VS Code as Administrator
  • macOS / Linux: Check file permissions on the extensions directory

🤝 Related RTL-for-AI Projects

A small community of independent developers maintains userland RTL fixes for the AI-tooling stack. The surfaces are largely disjoint — pick whichever matches where you're hitting the BiDi problem, and cross-install as needed:

  • Adaptive-RTL-Extension by Lidor Mashiach — generic browser extension with click-to-select RTL for any web page, including LLM chat UIs (Claude.ai, ChatGPT, Gemini, etc.).
  • Claude.ai RTL Support (Chrome extension) — Chrome extension purpose-built for the Claude.ai web UI specifically. Lighter than the generic adaptive one if you only need RTL on Claude's website.
  • rtl-for-vs-code-agents by Guy Ronnen — VS Code extension covering the broader agent webview layer: GitHub Copilot, Cursor, Antigravity, Gemini Code Assist. Complementary to this extension's IDE-panel-specific fix.
  • Claude-for-word-RTL-fix by Asaf Aizone — Hebrew/Arabic RTL fix for the Claude for Microsoft Office (Word/Excel/PowerPoint) add-in.
  • kivun-terminal-wsl by Noam Brand — terminal-layer fix for the claude CLI itself: a kivun-claude-bidi Node wrapper for Claude Code's TUI output, plus a one-click installer for WSL2+Konsole on Windows or native shell installers on Linux.

⭐ Like it? Star it!

If this extension helped you, please give it a ⭐ on GitHub — it helps others discover it!


📄 License

MIT — see LICENSE for details.

🔝 Back to top


🔝 חזרה למעלה

🇮🇱 עברית

תוסף ל-VS Code שמוסיף תמיכת כיווניות מימין לשמאל (RTL) לממשק הצ'אט של Claude Code ב-VS Code, Cursor, Antigravity ו-Kiro. מיועד לדוברי עברית, ערבית ופרסית שרוצים יישור טקסט טבעי בשיחה עם Claude — מבלי לפגוע בבלוקי קוד או ברכיבי הממשק.

🤔 למה זה נחוץ?

תוסף Claude Code for VS Code המקורי חסר תמיכת RTL מובנית. הדבר גורם לעיתים קרובות ל:

  • ❌ טקסט עברי, ערבי ופרסי שמוצג בצורה לא מיושרת
  • ❌ קושי בקריאת שיחות בשפות מעורבות (קוד + טקסט RTL)
  • ❌ התנהגות ממשק לא עקבית בפאנל הצ'אט

Claude Code RTL Support פותר בעיות אלה על ידי הזרקה חכמה של CSS לטיפול בכיווניות הטקסט — תוך שמירה קפדנית על LTR עבור בלוקי קוד ופלטי טרמינל.

✨ תכונות

תכונה תיאור
▶️ הפעלת RTL מזריק עיצוב CSS וכפתור מתג לממשק הצ'אט
📌 הפעלת RTL (תמיד) מפעיל RTL לצמיתות ללא כפתור מתג
👁️ הפעלת RTL (אוטו) מזהה אוטומטית עברית/ערבית/פרסית לכל בועה וקובע כיוון (מומלץ)
🔧 תיקון BiDi מפעיל RTL ומתקן טקסט הפוך (למשל "םולש" → "שלום")
⏹️ כיבוי RTL משחזר קבצים מקוריים מגיבוי
🔍 בדיקת סטטוס מציג אילו התקנות פועלות עם RTL
📊 שורת מצב מציג את המצב הנוכחי בתחתית המסך — לחץ לניהול
🔄 הפעלה מחדש אוטומטית משחזר RTL אוטומטית לאחר עדכון Claude Code

🆕 מה חדש (v0.4.0)

  • הגדרות גופן מותאמות אישית — שתי הגדרות חדשות ב-VS Code לבחירת הגופנים ש-Claude Code משתמש בהם:
    • claude-code-rtl.textFont — גופן להודעות ולשדה הקלט (למשל Vazirmatn לרינדור נכון של פרסית, Tahoma לעברית/ערבית)
    • claude-code-rtl.codeFont — גופן לבלוקי קוד ולעורך ה-diff (למשל JetBrains Mono, Fira Code)
    • השאירו את ההגדרה ריקה כדי לשמור על גופן ברירת המחדל של Claude Code.
  • תמיכה ב-Kiro IDE — התוסף מזהה ותומך כעת ב-Kiro לצד VS Code, Cursor ו-Antigravity.

💡 מומלץ: השתמשו במצב Auto ‏(Claude RTL: Activate RTL (Auto)) לחוויה הטובה ביותר — כל רכיב מקבל את הכיוון הנכון אוטומטית, כולל Plan Preview ודיאלוגי הרשאות.

גרסאות קודמות

v0.3.9

  • תמיכת RTL בכרטיסיית Plan Preview — כרטיסיית Plan Mode החדשה של Claude Code (כרטיסייה נפרדת לתוכניות) מקבלת כעת תמיכת RTL מלאה. במצב Auto, תוכן התוכנית מזוהה אוטומטית ועובר ל-RTL כשהוא מכיל עברית, ערבית או פרסית. במצב Active, מופיע כפתור ⇄. במצב Always, התוכנית תמיד RTL. בלוקי קוד בתוכניות נשארים LTR.

v0.3.8

  • RTL חכם בשאלות הרשאה (מצב Auto) — במצב Auto, בקשות הרשאה ושאלות המשך מזהות כעת כיוון RTL לכל רכיב בנפרד. שאלות ואפשרויות בעברית, ערבית או פרסית זורמות מימין לשמאל; באנגלית נשארות משמאל לימין.

v0.3.7

  • תמיכה ב-Antigravity IDE — התוסף מזהה ותומך כעת ב-Antigravity לצד VS Code ו-Cursor.

v0.3.6

  • כיוון חכם בשדה הקלט — שדה הקלט מזהה עכשיו את כיוון הטקסט בזמן אמת לפי התו הראשון שמקלידים. מתחילים באות עברית, ערבית או פרסית — הטקסט זורם ימינה; מתחילים באנגלית — נשאר שמאלה. היוצא מן הכלל הוא מצב Active כשכפתור ⇄ לחוץ — אז הקלט תמיד RTL.
  • מיקום חלופי לכפתור — כשהכותרת של הצ'אט עדיין לא נטענה (למשל בחזרה לשיחה פעילה עם הפעלה), כפתור ⇄ מופיע מעל שדה הקלט כדי שתמיד יהיה נגיש.
  • הפעלה מחדש אוטומטית בטוחה יותר — מעקב אחר גרסה מבטיח שה-RTL מוזרק מחדש בצורה נקייה לאחר עדכון Claude Code במקום להיערם על CSS ישן.

v0.3.5

  • מצב RTL אוטומטי — מצב חכם שמזהה אוטומטית טקסט בעברית, ערבית ופרסית לכל בועת צ'אט באמצעות MutationObserver. רק בועות שמכילות טקסט RTL מקבלות כיווניות מימין לשמאל — בועות באנגלית בלבד נשארות LTR. ללא צורך בהחלפה ידנית.

v0.3.0

  • מצב RTL תמידי — מצב חדש שמפעיל RTL לצמיתות ללא צורך בכפתור מתג. ה-CSS מוזרק ישירות ללא תלות ב-class, כך ש-RTL תמיד פעיל. ניתן לעבור בין מצבים דרך תפריט שורת המצב או לוח הפקודות.
  • הפעלה מחדש אוטומטית — RTL משוחזר אוטומטית כאשר עדכון Claude Code מחליף את הקבצים. אין צורך להפעיל ידנית מחדש.
  • הפעלה אוטומטית בהתקנה — RTL מופעל אוטומטית בהתקנה ראשונה.

v0.2.0

  • פקודת Fix BiDi — פותרת את בעיית הטקסט ההפוך שבה מילים בעברית/ערבית/פרסית מופיעות מראה (למשל "םולש" במקום "שלום"). זה קורה כי Claude Code מזריק כלל CSS בעייתי * { direction: ltr; unicode-bidi: bidi-override; } שכופה כיוון LTR על כל הטקסט. הפקודה החדשה Fix BiDi מפעילה RTL ומסירה את הכלל הבעייתי אוטומטית.

📋 דרישות

  • Claude Code for VS Code (anthropic.claude-code) — מותקן אוטומטית כתלות

💻 פלטפורמות נתמכות

🛠️ סביבות פיתוח
VS Code
Cursor
Antigravity
Kiro

🚀 איך להשתמש

📊 אפשרות 1: שורת המצב (Status Bar)

לאחר ההתקנה, מופיע פריט בשורת המצב בתחתית המסך:

סטטוס משמעות
RTL: Active RTL מופעל עם כפתור מתג
RTL: Always 📌 RTL פעיל תמיד (ללא כפתור)
RTL: Auto 👁️ RTL מזהה אוטומטית לכל בועה (מומלץ)
RTL: Inactive RTL לא מותקן
RTL: N/A התוסף לא נמצא

לחץ על פריט שורת המצב כדי לפתוח תפריט עם אפשרויות הפעלה / הפעלה (תמיד) / כיבוי / סטטוס.

🎯 אפשרות 2: לוח הפקודות (Command Palette)

לחץ Ctrl+Shift+P (macOS: Cmd+Shift+P) וחפש:

פקודה פעולה
Claude RTL: Activate RTL ▶️ הפעלת תמיכת RTL עם כפתור מתג
Claude RTL: Activate RTL (Always) 📌 הפעלת RTL לצמיתות ללא כפתור מתג
Claude RTL: Activate RTL (Auto) 👁️ זיהוי אוטומטי של RTL לכל בועה (מומלץ)
Claude RTL: Fix BiDi 🔧 הפעלת RTL + תיקון בעיות טקסט דו-כיווני
Claude RTL: Deactivate RTL ⏹️ כיבוי ושחזור קבצים מקוריים
Claude RTL: Check Status 🔍 הצגת מצב ההתקנה

🔄 החלון נטען מחדש אוטומטית לאחר הפעלה / כיבוי כדי להחיל שינויים.

💬 שימוש בצ'אט

מצב Active — לאחר הפעלה וטעינה מחדש:

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

מצב Always — RTL פעיל תמיד. אין צורך בכפתור — הטקסט תמיד מימין לשמאל.

מצב Auto — RTL מזוהה אוטומטית לכל בועת צ'אט. בועות עם עברית/ערבית/פרסית הופכות ל-RTL; בועות באנגלית בלבד נשארות LTR. מתאים לשיחות בשפות מעורבות.

💡 טיפ (מצב Active): לא כל שיחה צריכה RTL — ניתן להחליט לכל שיחה בנפרד. לחץ ⇄ רק בשיחות שבהן אתה כותב בעברית, ערבית או פרסית.

💡 טיפ (מצב Always): השתמש במצב זה אם אתה תמיד כותב בעברית, ערבית או פרסית ולא רוצה להדליק את המתג בכל פעם.

💡 טיפ (מצב Auto): מתאים לשיחות מעורבות — כל בועה מקבלת את הכיוון הנכון אוטומטית. (מומלץ)

🔄 הפעלה מחדש אוטומטית: אם Claude Code מתעדכן ומחליף את הקבצים, RTL משוחזר אוטומטית בהפעלה הבאה.


↔️ מה משתנה במצב RTL?

✅ הופך לכיווניות מימין לשמאל 🔒 נשאר בכיווניות רגילה
הודעות המשתמש בלוקי קוד
תשובות טקסט של Claude כלים ותוצאותיהם
רשימות ופסקאות בלוק חשיבה
שאלות ותשובות בממשק פקודות
כרטיסיית Plan Preview כפתורים וממשק

⚙️ הגדרות גופן (אופציונלי)

ניתן להתאים אישית את הגופנים ש-Claude Code משתמש בהם דרך settings.json ‏(Ctrl+, / Cmd+, ← חפשו claude-code-rtl):

הגדרה תיאור דוגמאות
claude-code-rtl.textFont גופן להודעות ולשדה הקלט Vazirmatn, Tahoma
claude-code-rtl.codeFont גופן לבלוקי קוד ולעורך diff JetBrains Mono, Fira Code
{
  "claude-code-rtl.textFont": "Tahoma",
  "claude-code-rtl.codeFont": "JetBrains Mono"
}

💡 השאירו הגדרה ריקה כדי לשמור על גופן ברירת המחדל של Claude Code.

🔄 לאחר שינוי הגדרת גופן תופיע התראה לטעון את החלון מחדש כדי שה-CSS החדש ייכנס לתוקף.


🔧 פתרון בעיות

❓ לא מוצאים את התוסף ב-Cursor, Antigravity או Kiro
  • חפשו את התוסף לפי המזהה שלו: claude-code-rtl
  • השם המלא "Claude Code RTL Support" לא תמיד מופיע בתוצאות חיפוש בכל הפלטפורמות
  • השתמשו במזהה המדויק claude-code-rtl בשורת החיפוש של התוספים
❓ התוסף לא מוצא את Claude Code for VS Code
  • וודא שהתוסף "Claude Code for VS Code" מותקן
  • בדוק סטטוס עם הפקודה Claude RTL: Check Status
❓ השינויים לא נראים לאחר ההפעלה
  • טען חלון מחדש: Ctrl+Shift+PDeveloper: Reload Window
  • או סגור ופתח מחדש את VS Code / Cursor
❓ ה-RTL הפסיק לעבוד לאחר עדכון Claude Code
  • כשהתוסף "Claude Code for VS Code" מתעדכן, הוא מחליף את קבציו ותמיכת ה-RTL נמחקת
  • החל מגרסה v0.3.0, RTL משוחזר אוטומטית בהפעלה הבאה
  • אם זה לא משוחזר אוטומטית, הפעל ידנית את Claude RTL: Activate RTL
❓ טקסט עברי/ערבי מופיע הפוך (למשל "םולש" במקום "שלום")
  • זה נגרם על ידי כלל bidi-override ב-CSS של Claude Code שכופה כיוון LTR על כל הטקסט
  • השתמש ב-Claude RTL: Fix BiDi במקום Activate RTL כדי לתקן את זה
  • שים לב: הפעלת Activate RTL שוב תחזיר את הבעיה — השתמש ב-Fix BiDi בכל פעם
❓ שגיאת הרשאות
  • Windows: נסה להריץ את VS Code כמנהל מערכת
  • macOS / Linux: בדוק הרשאות קבצים בתיקיית ההרחבות

🤝 פרויקטים קשורים (RTL לכלים מבוססי AI)

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

  • Adaptive-RTL-Extension (מאת Lidor Mashiach) — תוסף דפדפן כללי עם בחירת RTL בלחיצה לכל דף אינטרנט, כולל ממשקי צ'אט של LLM (כמו Claude.ai, ChatGPT, Gemini ועוד).
  • Claude.ai RTL Support (Chrome extension) — תוסף כרום ייעודי לממשק הרשת של Claude.ai. קליל יותר מהתוסף הכללי אם אתם צריכים RTL רק לאתר של Claude.
  • rtl-for-vs-code-agents (מאת Guy Ronnen) — תוסף ל-VS Code המכסה את שכבת ה-webview הרחבה יותר של סוכני AI: כמו GitHub Copilot, Cursor, Antigravity, Gemini Code Assist. משלים את התיקון הספציפי של התוסף הזה.
  • Claude-for-word-RTL-fix (מאת Asaf Aizone) — תיקון RTL (עברית/ערבית) לתוסף Claude עבור Microsoft Office (Word/Excel/PowerPoint).
  • kivun-terminal-wsl (מאת Noam Brand) — תיקון ברמת הטרמינל עבור ה-CLI של claude עצמו: מעטפת Node בשם kivun-claude-bidi לפלט ה-TUI של Claude Code, בתוספת מתקין בקליק אחד עבור WSL2+Konsole ב-Windows או מתקיני shell מובנים ב-Linux.

⭐ אהבתם? תנו כוכב!

אם התוסף עזר לכם, תנו לו ⭐ ב-GitHub — זה עוזר לאחרים לגלות אותו!


📄 רישיון

MIT — ראה קובץ LICENSE לפרטים.

🔝 חזרה למעלה


🔝 العودة إلى الأعلى

🇸🇦 عربية

إضافة لـ VS Code تضيف دعم اتجاه النص من اليمين إلى اليسار (RTL) لواجهة المحادثة في Claude Code على VS Code و Cursor و Antigravity و Kiro. مصممة لمتحدثي العربية والعبرية والفارسية الذين يريدون محاذاة طبيعية للنص عند التحدث مع Claude — دون التأثير على كتل الكود أو عناصر الواجهة.

🤔 لماذا هذا مطلوب؟

إضافة Claude Code for VS Code الأصلية تفتقر إلى دعم RTL المدمج. وهذا كثيرًا ما يؤدي إلى:

  • ❌ ظهور النصوص العربية والعبرية والفارسية بمحاذاة غير صحيحة
  • ❌ صعوبة قراءة المحادثات متعددة اللغات (كود + نص RTL)
  • ❌ سلوك غير متسق لواجهة المستخدم في لوحة المحادثة

Claude Code RTL Support تحل هذه المشكلات عن طريق حقن CSS بذكاء للتعامل مع اتجاه النص — مع الحفاظ الصارم على LTR لكتل الكود ومخرجات الطرفية.

✨ الميزات

الميزة الوصف
▶️ تفعيل RTL تحقن تنسيقات CSS وزر تبديل في واجهة المحادثة
📌 تفعيل RTL (دائم) تفعيل RTL بشكل دائم بدون زر تبديل
👁️ تفعيل RTL (تلقائي) كشف تلقائي للعربية/العبرية/الفارسية لكل فقاعة وتحديد الاتجاه (موصى به)
🔧 إصلاح BiDi تفعيل RTL وإصلاح النص المعكوس (مثل "ملاس" → "سلام")
⏹️ إيقاف RTL تستعيد الملفات الأصلية من النسخ الاحتياطية
🔍 فحص الحالة يعرض التثبيتات التي تعمل بـ RTL
📊 شريط الحالة يعرض الحالة الحالية في أسفل الشاشة — انقر للإدارة
🔄 إعادة تفعيل تلقائية تستعيد RTL تلقائيًا بعد تحديث Claude Code

🆕 ما الجديد (v0.4.0)

  • إعدادات خط مخصصة — إعدادان جديدان في VS Code يسمحان لك باختيار الخطوط التي يستخدمها Claude Code:
    • claude-code-rtl.textFont — خط الرسائل وحقل الإدخال (مثل Vazirmatn للعرض الصحيح للفارسية، Tahoma للعربية/العبرية)
    • claude-code-rtl.codeFont — خط كتل الكود ومحرر diff (مثل JetBrains Mono، Fira Code)
    • اترك الإعداد فارغًا للحفاظ على الخط الافتراضي لـ Claude Code.
  • دعم Kiro IDE — الإضافة الآن تكتشف وتدعم Kiro إلى جانب VS Code و Cursor و Antigravity.

💡 موصى به: استخدم وضع Auto ‏(Claude RTL: Activate RTL (Auto)) للحصول على أفضل تجربة — كل عنصر يحصل على الاتجاه الصحيح تلقائيًا، بما في ذلك Plan Preview ونوافذ الأذونات.

الإصدارات السابقة

v0.3.9

  • دعم RTL لعلامة تبويب Plan Preview — علامة تبويب Plan Mode الجديدة في Claude Code (علامة تبويب منفصلة للخطط) تحصل الآن على دعم RTL كامل. في وضع Auto، يتم اكتشاف محتوى الخطة تلقائيًا والتبديل إلى RTL عند احتوائه على نص عربي أو عبري أو فارسي. في وضع Active، يظهر زر ⇄. في وضع Always، الخطة دائمًا RTL. كتل الكود داخل الخطط تبقى LTR.

v0.3.8

  • RTL ذكي لطلبات الأذونات (وضع Auto) — في وضع Auto، تكتشف طلبات الأذونات وأسئلة المتابعة اتجاه RTL لكل عنصر على حدة. الأسئلة والخيارات بالعربية أو العبرية أو الفارسية تتدفق من اليمين لليسار؛ الإنجليزية تبقى من اليسار لليمين.

v0.3.7

  • دعم Antigravity IDE — الإضافة الآن تكتشف وتدعم Antigravity إلى جانب VS Code و Cursor.

v0.3.6

  • اتجاه ذكي في حقل الإدخال — حقل الإدخال الآن يكتشف اتجاه النص تلقائيًا بناءً على أول حرف تكتبه. ابدأ بحرف عربي أو عبري أو فارسي ويتجه النص لليمين؛ ابدأ بالإنجليزية ويبقى لليسار. الاستثناء الوحيد هو وضع Active عند تفعيل زر ⇄ — حيث يكون الإدخال دائمًا RTL.
  • موقع بديل للزر — عندما لا يكون رأس المحادثة معروضًا بعد (مثلاً عند استئناف جلسة نشطة عند بدء التشغيل)، يظهر زر ⇄ فوق منطقة الإدخال حتى لا تبقى بدونه.
  • إعادة تفعيل تلقائية أكثر أمانًا — تتبع الإصدار يضمن إعادة حقن RTL بشكل نظيف بعد تحديث Claude Code بدلاً من التراكم على CSS قديم.

v0.3.5

  • وضع RTL التلقائي — وضع ذكي يكتشف تلقائيًا النص العربي والعبري والفارسي لكل فقاعة محادثة باستخدام MutationObserver. الفقاعات التي تحتوي على نص RTL فقط تحصل على اتجاه من اليمين إلى اليسار — الفقاعات الإنجليزية تبقى LTR. لا حاجة للتبديل اليدوي.

v0.3.0

  • وضع RTL الدائم — وضع جديد يفعّل RTL بشكل دائم بدون الحاجة لزر التبديل. يتم حقن CSS مباشرة بدون اعتماد على class، لذا RTL يكون دائمًا نشطًا. يمكنك التبديل بين الأوضاع عبر قائمة شريط الحالة أو لوحة الأوامر.
  • إعادة تفعيل تلقائية — يتم استعادة RTL تلقائيًا عندما يقوم تحديث Claude Code باستبدال ملفاته. لا حاجة لإعادة التفعيل يدويًا.
  • تفعيل تلقائي عند التثبيت — يتم تفعيل RTL تلقائيًا عند التثبيت لأول مرة.

v0.2.0

  • أمر Fix BiDi — يحل مشكلة النص المعكوس حيث تظهر الكلمات العربية/العبرية/الفارسية بشكل معكوس (مثل "ملاس" بدلاً من "سلام"). يحدث هذا لأن Claude Code يحقن قاعدة CSS * { direction: ltr; unicode-bidi: bidi-override; } التي تجبر كل النص على LTR. الأمر الجديد Fix BiDi يفعّل RTL ويزيل هذه القاعدة تلقائيًا.

📋 المتطلبات

  • Claude Code for VS Code (anthropic.claude-code) — يتم تثبيتها تلقائيًا كتبعية

💻 المنصات المدعومة

🛠️ بيئات التطوير
VS Code
Cursor
Antigravity
Kiro

🚀 طريقة الاستخدام

📊 الخيار 1: شريط الحالة

بعد التثبيت، يظهر عنصر في شريط الحالة في أسفل المحرر:

الحالة المعنى
RTL: Active RTL مفعّل مع زر تبديل
RTL: Always 📌 RTL نشط دائمًا (بدون زر)
RTL: Auto 👁️ RTL يكتشف تلقائيًا لكل فقاعة (موصى به)
RTL: Inactive RTL غير مثبت
RTL: N/A الإضافة غير موجودة

انقر على عنصر شريط الحالة لفتح قائمة بخيارات التفعيل / التفعيل (دائم) / الإيقاف / الحالة.

🎯 الخيار 2: لوحة الأوامر

اضغط Ctrl+Shift+P (ماك: Cmd+Shift+P) وابحث عن:

الأمر الإجراء
Claude RTL: Activate RTL ▶️ تفعيل دعم RTL مع زر تبديل
Claude RTL: Activate RTL (Always) 📌 تفعيل RTL بشكل دائم بدون زر تبديل
Claude RTL: Activate RTL (Auto) 👁️ كشف تلقائي لـ RTL لكل فقاعة (موصى به)
Claude RTL: Fix BiDi 🔧 تفعيل RTL + إصلاح مشاكل النص ثنائي الاتجاه
Claude RTL: Deactivate RTL ⏹️ إيقاف الدعم واستعادة الملفات الأصلية
Claude RTL: Check Status 🔍 عرض حالة التثبيت

🔄 يتم إعادة تحميل النافذة تلقائيًا بعد التفعيل / الإيقاف لتطبيق التغييرات.

💬 الاستخدام في المحادثة

وضع Active — بعد التفعيل وإعادة التحميل:

  1. افتح لوحة المحادثة
  2. اضغط على الزر في أعلى المحادثة
  3. ستتحول الواجهة إلى اتجاه من اليمين إلى اليسار — سيتم محاذاة النص إلى اليمين
  4. اضغط على الزر مرة أخرى للعودة إلى الاتجاه العادي

وضع Always — RTL نشط دائمًا. لا حاجة لزر — النص دائمًا من اليمين إلى اليسار.

وضع Auto — يتم اكتشاف RTL تلقائيًا لكل فقاعة محادثة. الفقاعات التي تحتوي على عربية/عبرية/فارسية تصبح RTL؛ الفقاعات الإنجليزية تبقى LTR. مثالي للمحادثات متعددة اللغات.

💡 نصيحة (وضع Active): ليست كل المحادثات تحتاج RTL — يمكنك تفعيله لكل محادثة على حدة. استخدم ⇄ فقط في المحادثات التي تكتب فيها بالعربية أو العبرية أو الفارسية.

💡 نصيحة (وضع Always): استخدم هذا الوضع إذا كنت تكتب دائمًا بالعربية أو العبرية أو الفارسية ولا تريد التبديل في كل مرة.

💡 نصيحة (وضع Auto): مثالي للمحادثات المختلطة — كل فقاعة تحصل على الاتجاه الصحيح تلقائيًا.

🔄 إعادة تفعيل تلقائية: إذا تم تحديث Claude Code واستبدال ملفاته، يتم استعادة RTL تلقائيًا عند بدء التشغيل التالي.


↔️ ماذا يتغير في وضع RTL؟

✅ يتحول إلى RTL 🔒 يبقى LTR
رسائل المستخدم كتل الكود
ردود نص Claude الأدوات ونتائجها
القوائم والفقرات كتلة التفكير
الأسئلة والأجوبة في الواجهة الأوامر
علامة تبويب Plan Preview الأزرار والواجهة

⚙️ إعدادات الخط (اختياري)

يمكنك تخصيص الخطوط التي يستخدمها Claude Code عبر settings.json ‏(Ctrl+, / Cmd+, ← ابحث عن claude-code-rtl):

الإعداد الوصف أمثلة
claude-code-rtl.textFont خط الرسائل وحقل الإدخال Vazirmatn, Tahoma
claude-code-rtl.codeFont خط كتل الكود ومحرر diff JetBrains Mono, Fira Code
{
  "claude-code-rtl.textFont": "Tahoma",
  "claude-code-rtl.codeFont": "JetBrains Mono"
}

💡 لمستخدمي الفارسية: يُنصح بشدة باستخدام Vazirmatn لعرض صحيح للأرقام والحروف الفارسية — يمكنك تثبيته من vazirmatn.rastikerdar.com.

💡 اترك أي إعداد فارغًا للحفاظ على الخط الافتراضي لـ Claude Code.

🔄 بعد تغيير إعداد الخط، سيظهر لك إشعار لإعادة تحميل النافذة حتى يدخل CSS الجديد حيز التنفيذ.


🔧 حل المشاكل

❓ لا يمكن العثور على الإضافة في Cursor أو Antigravity أو Kiro
  • ابحث عن الإضافة باستخدام معرّفها: claude-code-rtl
  • الاسم الكامل "Claude Code RTL Support" قد لا يظهر في نتائج البحث على جميع المنصات
  • استخدم المعرّف الدقيق claude-code-rtl في شريط البحث عن الإضافات
❓ الإضافة لا تجد Claude Code for VS Code
  • تأكد من تثبيت إضافة "Claude Code for VS Code"
  • تحقق من الحالة باستخدام الأمر Claude RTL: Check Status
❓ التغييرات لا تظهر بعد التفعيل
  • أعد تحميل النافذة: Ctrl+Shift+PDeveloper: Reload Window
  • أو أغلق VS Code / Cursor وأعد فتحه
❓ توقف RTL عن العمل بعد تحديث Claude Code
  • عند تحديث إضافة "Claude Code for VS Code"، يتم استبدال ملفاتها وتُحذف تهيئة RTL
  • بدءًا من الإصدار v0.3.0، يتم استعادة RTL تلقائيًا عند بدء التشغيل التالي
  • إذا لم تتم الاستعادة تلقائيًا، شغّل Claude RTL: Activate RTL يدويًا
❓ النص العربي/العبري يظهر معكوسًا (مثل "ملاس" بدلاً من "سلام")
  • هذا بسبب قاعدة bidi-override في CSS الخاص بـ Claude Code التي تجبر اتجاه LTR على كل النص
  • استخدم Claude RTL: Fix BiDi بدلاً من Activate RTL لإصلاح هذا
  • ملاحظة: تشغيل Activate RTL مرة أخرى سيعيد المشكلة — استخدم Fix BiDi في كل مرة
❓ خطأ في الصلاحيات
  • Windows: جرّب تشغيل VS Code كمسؤول
  • macOS / Linux: تحقق من صلاحيات الملفات في مجلد الإضافات

🤝 مشاريع RTL ذات صلة بأدوات الذكاء الاصطناعي

يحتفظ مجتمع صغير من المطورين المستقلين بإصلاحات RTL لمختلف أدوات الذكاء الاصطناعي. المشاريع غالبًا ما تكمل بعضها البعض — اختر الحل الذي يناسب مشكلة الاتجاه التي تواجهها، وقم بتثبيتها معًا حسب الحاجة:

  • Adaptive-RTL-Extension (بواسطة Lidor Mashiach) — إضافة متصفح عامة مع إمكانية تحديد RTL بنقرة لأي صفحة ويب، بما في ذلك واجهات محادثة LLM (مثل Claude.ai و ChatGPT و Gemini وغيرها).
  • Claude.ai RTL Support (Chrome extension) — إضافة كروم مخصصة لواجهة الويب Claude.ai. أخف من الإضافة العامة إذا كنت تحتاج فقط إلى RTL على موقع Claude.
  • rtl-for-vs-code-agents (بواسطة Guy Ronnen) — إضافة VS Code تغطي طبقة الـ webview الأوسع لوكلاء الذكاء الاصطناعي: GitHub Copilot، Cursor، Antigravity، Gemini Code Assist. تكمل هذا الإصلاح المخصص.
  • Claude-for-word-RTL-fix (بواسطة Asaf Aizone) — إصلاح RTL (عربي/عبري) لإضافة Claude لبرامج Microsoft Office (Word/Excel/PowerPoint).
  • kivun-terminal-wsl (بواسطة Noam Brand) — إصلاح على مستوى الطرفية (Terminal) لـ CLI الخاص بـ claude نفسه: غلاف Node يسمى kivun-claude-bidi لمخرجات TUI الخاصة بـ Claude Code، بالإضافة إلى مثبت بنقرة واحدة لـ WSL2+Konsole على Windows أو مثبتات shell الأصلية على Linux.

⭐ أعجبتك؟ امنحها نجمة!

إذا أعجبتك هذه الإضافة، امنحها ⭐ على GitHub — هذا يساعد الآخرين في اكتشافها!


📄 الترخيص

MIT — انظر ملف LICENSE للتفاصيل.

🔝 العودة إلى الأعلى


🔝 بازگشت به بالا

🇮🇷 فارسی

یک افزونه VS Code که پشتیبانی از جهت متن راست به چپ (RTL) را به رابط چت Claude Code در VS Code، Cursor، Antigravity و Kiro اضافه می‌کند. طراحی شده برای فارسی‌زبانان، عبری‌زبانان و عربی‌زبانانی که می‌خواهند تراز متن طبیعی هنگام چت با Claude داشته باشند — بدون تأثیر بر بلوک‌های کد یا عناصر رابط کاربری.

🤔 چرا این مورد نیاز است؟

افزونه اصلی Claude Code for VS Code فاقد پشتیبانی بومی RTL است. این اغلب منجر به موارد زیر می‌شود:

  • ❌ نمایش نامرتب متن فارسی، عربی و عبری
  • ❌ دشواری در خواندن مکالمات چندزبانه (کد + متن RTL)
  • ❌ رفتار ناسازگار رابط کاربری در پنل چت

Claude Code RTL Support این مشکلات را با تزریق هوشمند CSS برای مدیریت جهت متن حل می‌کند — در حالی که LTR را برای بلوک‌های کد و خروجی‌های ترمینال کاملاً حفظ می‌کند.

✨ ویژگی‌ها

ویژگی توضیح
▶️ فعال‌سازی RTL CSS و یک دکمه تغییر را به رابط چت تزریق می‌کند
📌 فعال‌سازی RTL (همیشه) فعال‌سازی دائمی RTL بدون دکمه تغییر
👁️ فعال‌سازی RTL (خودکار) شناسایی خودکار فارسی/عربی/عبری در هر حباب و تعیین جهت (پیشنهادی)
🔧 رفع BiDi فعال‌سازی RTL و رفع متن معکوس (مثلاً "ملاس" → "سلام")
⏹️ غیرفعال‌سازی RTL فایل‌های اصلی را از نسخه پشتیبان بازیابی می‌کند
🔍 بررسی وضعیت نشان می‌دهد کدام نصب‌ها RTL فعال دارند
📊 نوار وضعیت وضعیت فعلی RTL را نمایش می‌دهد — برای مدیریت کلیک کنید
🔄 فعال‌سازی مجدد خودکار RTL را به‌طور خودکار پس از به‌روزرسانی Claude Code بازیابی می‌کند

🆕 تازه‌ها (v0.4.0)

  • تنظیمات فونت سفارشی — دو تنظیم جدید VS Code که به شما اجازه می‌دهد فونت‌های مورد استفاده Claude Code را انتخاب کنید:
    • claude-code-rtl.textFont — فونت پیام‌ها و فیلد ورودی (مثلاً Vazirmatn برای نمایش صحیح فارسی، Tahoma برای عبری/عربی)
    • claude-code-rtl.codeFont — فونت بلوک‌های کد و ویرایشگر diff (مثلاً JetBrains Mono، Fira Code)
    • تنظیم را خالی بگذارید تا فونت پیش‌فرض Claude Code حفظ شود.
  • پشتیبانی از Kiro IDE — افزونه اکنون Kiro را در کنار VS Code، Cursor و Antigravity شناسایی و پشتیبانی می‌کند.

💡 پیشنهادی: از حالت Auto ‏(Claude RTL: Activate RTL (Auto)) برای بهترین تجربه استفاده کنید — هر عنصر به‌صورت خودکار جهت صحیح را دریافت می‌کند، از جمله Plan Preview و دیالوگ‌های مجوز.

نسخه‌های قبلی

v0.3.9

  • پشتیبانی RTL برای تب Plan Preview — تب جدید Plan Mode در Claude Code (تب ویرایشگر جداگانه برای برنامه‌ها) اکنون پشتیبانی کامل RTL دارد. در حالت Auto، محتوای برنامه به‌صورت خودکار شناسایی شده و در صورت وجود متن فارسی، عربی یا عبری به RTL تغییر می‌کند. در حالت Active، دکمه ⇄ نمایش داده می‌شود. در حالت Always، برنامه همیشه RTL است. بلوک‌های کد درون برنامه‌ها LTR باقی می‌مانند.

v0.3.8

  • RTL هوشمند برای درخواست‌های مجوز (حالت Auto) — در حالت Auto، درخواست‌های مجوز و سؤالات پیگیری اکنون جهت RTL را برای هر عنصر جداگانه تشخیص می‌دهند. سؤالات و گزینه‌ها به فارسی، عربی یا عبری از راست به چپ جریان می‌یابند؛ انگلیسی از چپ به راست باقی می‌ماند.

v0.3.7

  • پشتیبانی از Antigravity IDE — افزونه اکنون Antigravity را در کنار VS Code و Cursor شناسایی و پشتیبانی می‌کند.

v0.3.6

  • جهت هوشمند در فیلد ورودی — فیلد ورودی اکنون جهت متن را به‌صورت خودکار بر اساس اولین کاراکتر تایپ‌شده تشخیص می‌دهد. با حرف فارسی، عربی یا عبری شروع کنید و متن به سمت راست جریان می‌یابد؛ با انگلیسی شروع کنید و در سمت چپ باقی می‌ماند. تنها استثنا حالت Active است وقتی دکمه ⇄ فعال باشد — در آن صورت ورودی همیشه RTL است.
  • مکان جایگزین برای دکمه — وقتی هدر چت هنوز رندر نشده (مثلاً هنگام بازگشت به جلسه فعال در راه‌اندازی)، دکمه ⇄ بالای فیلد ورودی نمایش داده می‌شود تا همیشه در دسترس باشد.
  • فعال‌سازی مجدد خودکار امن‌تر — ردیابی نسخه تضمین می‌کند که RTL پس از به‌روزرسانی Claude Code به‌صورت تمیز دوباره تزریق شود به جای انباشته شدن روی CSS قدیمی.

v0.3.5

  • حالت RTL خودکار — حالت هوشمندی که به‌طور خودکار متن فارسی، عربی و عبری را در هر حباب چت با استفاده از MutationObserver شناسایی می‌کند. فقط حباب‌هایی که متن RTL دارند جهت راست به چپ می‌گیرند — حباب‌های انگلیسی LTR باقی می‌مانند. بدون نیاز به تغییر دستی.

v0.3.0

  • حالت RTL همیشه — حالت جدیدی که RTL را به‌صورت دائمی فعال می‌کند بدون نیاز به دکمه تغییر. CSS مستقیماً بدون وابستگی به class تزریق می‌شود، بنابراین RTL همیشه فعال است. می‌توانید بین حالت‌ها از طریق منوی نوار وضعیت یا پالت فرمان جابجا شوید.
  • فعال‌سازی مجدد خودکار — RTL به‌طور خودکار بازیابی می‌شود وقتی به‌روزرسانی Claude Code فایل‌هایش را جایگزین می‌کند. نیازی به فعال‌سازی مجدد دستی نیست.
  • فعال‌سازی خودکار هنگام نصب — RTL به‌طور خودکار هنگام نصب اولیه فعال می‌شود.

v0.2.0

  • دستور Fix BiDi — مشکل متن معکوس را حل می‌کند که در آن کلمات فارسی/عربی/عبری به صورت آینه‌ای نمایش داده می‌شوند (مثلاً "ملاس" به جای "سلام"). این اتفاق می‌افتد زیرا Claude Code یک قاعده CSS * { direction: ltr; unicode-bidi: bidi-override; } تزریق می‌کند که همه متن‌ها را به LTR مجبور می‌کند. دستور جدید Fix BiDi پشتیبانی RTL را فعال کرده و این قاعده مشکل‌ساز را به‌صورت خودکار حذف می‌کند.

📋 نیازمندی‌ها

  • Claude Code for VS Code (anthropic.claude-code) — به‌صورت خودکار به عنوان وابستگی نصب می‌شود

💻 پلتفرم‌های پشتیبانی‌شده

🛠️ محیط‌های توسعه
VS Code
Cursor
Antigravity
Kiro

🚀 نحوه استفاده

📊 گزینه ۱: نوار وضعیت

پس از نصب، یک آیتم در نوار وضعیت پایین VS Code نمایش داده می‌شود:

وضعیت معنی
RTL: Active RTL فعال با دکمه تغییر
RTL: Always 📌 RTL همیشه فعال (بدون دکمه)
RTL: Auto 👁️ RTL به‌طور خودکار برای هر حباب شناسایی می‌شود (پیشنهادی)
RTL: Inactive RTL نصب نشده است
RTL: N/A افزونه پیدا نشد

روی آیتم نوار وضعیت کلیک کنید تا منویی با گزینه‌های فعال‌سازی / فعال‌سازی (همیشه) / غیرفعال‌سازی / وضعیت باز شود.

🎯 گزینه ۲: پالت فرمان

Ctrl+Shift+P (مک: Cmd+Shift+P) را فشار دهید و جستجو کنید:

فرمان عملکرد
Claude RTL: Activate RTL ▶️ فعال‌سازی پشتیبانی RTL با دکمه تغییر
Claude RTL: Activate RTL (Always) 📌 فعال‌سازی دائمی RTL بدون دکمه تغییر
Claude RTL: Activate RTL (Auto) 👁️ شناسایی خودکار RTL برای هر حباب (پیشنهادی)
Claude RTL: Fix BiDi 🔧 فعال‌سازی RTL + رفع مشکلات متن دوجهته
Claude RTL: Deactivate RTL ⏹️ غیرفعال‌سازی و بازیابی فایل‌های اصلی
Claude RTL: Check Status 🔍 نمایش وضعیت نصب

🔄 پنجره به‌طور خودکار مجدداً بارگذاری می‌شود پس از فعال‌سازی / غیرفعال‌سازی.

💬 استفاده در چت

حالت Active — پس از فعال‌سازی و بارگذاری مجدد:

  1. پانل چت را باز کنید
  2. روی دکمه در هدر چت کلیک کنید
  3. رابط به RTL تغییر می‌کند — متن به سمت راست تراز می‌شود
  4. برای بازگشت به LTR دوباره کلیک کنید

حالت Always — RTL همیشه فعال است. نیازی به دکمه نیست — متن همیشه از راست به چپ است.

حالت Auto — RTL به‌طور خودکار برای هر حباب چت شناسایی می‌شود. حباب‌هایی با فارسی/عربی/عبری به RTL تبدیل می‌شوند؛ حباب‌های انگلیسی LTR باقی می‌مانند. مناسب برای مکالمات چندزبانه.

💡 نکته (حالت Active): همه مکالمات نیاز به RTL ندارند — می‌توانید آن را برای هر مکالمه جداگانه فعال کنید. از ⇄ فقط در مکالماتی استفاده کنید که به فارسی، عربی یا عبری می‌نویسید.

💡 نکته (حالت Always): اگر همیشه به فارسی، عربی یا عبری می‌نویسید و نمی‌خواهید هر بار تغییر دهید، از این حالت استفاده کنید.

💡 نکته (حالت Auto): مناسب برای مکالمات مختلط — هر حباب به‌طور خودکار جهت صحیح را دریافت می‌کند.

🔄 فعال‌سازی مجدد خودکار: اگر Claude Code به‌روزرسانی شد و فایل‌هایش جایگزین شدند، RTL به‌طور خودکار در راه‌اندازی بعدی بازیابی می‌شود.


↔️ چه چیزی در حالت RTL تغییر می‌کند؟

✅ تبدیل به RTL 🔒 باقی می‌ماند LTR
پیام‌های کاربر بلوک‌های کد
پاسخ‌های متنی Claude فراخوانی‌های ابزار و نتایج
لیست‌ها و پاراگراف‌ها بلوک‌های تفکر
بلوک‌های سوال/جواب دستورات Slash
تب Plan Preview دکمه‌ها و عناصر رابط کاربری

⚙️ تنظیمات فونت (اختیاری)

می‌توانید فونت‌های مورد استفاده Claude Code را از طریق settings.json ‏(Ctrl+, / Cmd+, ← جستجو کنید claude-code-rtl) سفارشی کنید:

تنظیم توضیح نمونه‌ها
claude-code-rtl.textFont فونت پیام‌ها و فیلد ورودی Vazirmatn, Tahoma
claude-code-rtl.codeFont فونت بلوک‌های کد و ویرایشگر diff JetBrains Mono, Fira Code
{
  "claude-code-rtl.textFont": "Vazirmatn",
  "claude-code-rtl.codeFont": "JetBrains Mono"
}

💡 برای کاربران فارسی‌زبان: فونت Vazirmatn به‌شدت توصیه می‌شود تا اعداد و حروف فارسی به‌درستی نمایش داده شوند — می‌توانید آن را از vazirmatn.rastikerdar.com نصب کنید.

💡 هر تنظیم را خالی بگذارید تا فونت پیش‌فرض Claude Code حفظ شود.

🔄 پس از تغییر تنظیم فونت، یک اعلان نمایش داده می‌شود تا پنجره را بارگذاری مجدد کنید و CSS جدید اعمال شود.


🔧 عیب‌یابی

❓ افزونه را در Cursor، Antigravity یا Kiro پیدا نمی‌کنید
  • افزونه را با شناسه آن جستجو کنید: claude-code-rtl
  • نام کامل "Claude Code RTL Support" ممکن است در نتایج جستجوی همه پلتفرم‌ها نمایش داده نشود
  • از شناسه دقیق claude-code-rtl در نوار جستجوی افزونه‌ها استفاده کنید
❓ افزونه Claude Code for VS Code را پیدا نمی‌کند
  • مطمئن شوید که افزونه "Claude Code for VS Code" نصب شده است
  • وضعیت را با دستور Claude RTL: Check Status بررسی کنید
❓ تغییرات پس از فعال‌سازی نمایان نیستند
  • پنجره را مجدداً بارگذاری کنید: Ctrl+Shift+PDeveloper: Reload Window
  • یا VS Code / Cursor را ببندید و دوباره باز کنید
❓ RTL پس از به‌روزرسانی Claude Code کار نمی‌کند
  • هنگامی که افزونه "Claude Code for VS Code" به‌روزرسانی می‌شود، فایل‌هایش جایگزین شده و پشتیبانی RTL حذف می‌شود
  • از نسخه v0.3.0، RTL به‌طور خودکار بازیابی می‌شود در راه‌اندازی بعدی
  • اگر به‌طور خودکار بازیابی نشد، دستور Claude RTL: Activate RTL را دستی اجرا کنید
❓ متن فارسی/عربی به صورت معکوس نمایش داده می‌شود
  • این به دلیل قاعده bidi-override در CSS مربوط به Claude Code است که جهت LTR را بر همه متن‌ها اعمال می‌کند
  • به جای Activate RTL از Claude RTL: Fix BiDi استفاده کنید
  • توجه: اجرای مجدد Activate RTL مشکل را بازمی‌گرداند — هر بار از Fix BiDi استفاده کنید
❓ خطای مجوز
  • Windows: VS Code را به عنوان Administrator اجرا کنید
  • macOS / Linux: مجوزهای فایل در پوشه افزونه‌ها را بررسی کنید

🤝 پروژه‌های مرتبط RTL برای ابزارهای هوش مصنوعی

جامعه کوچکی از توسعه‌دهندگان مستقل اصلاحات RTL را برای ابزارهای مختلف هوش مصنوعی نگهداری می‌کنند. این پروژه‌ها عمدتاً مکمل یکدیگر هستند — راه‌حلی را انتخاب کنید که با مشکل جهت متنی که با آن مواجه هستید مطابقت داشته باشد و در صورت نیاز آن‌ها را در کنار هم نصب کنید:

  • Adaptive-RTL-Extension (توسط Lidor Mashiach) — افزونه مرورگر عمومی با امکان انتخاب RTL با کلیک برای هر صفحه وب، از جمله رابط‌های چت LLM (مانند Claude.ai، ChatGPT، Gemini و غیره).
  • Claude.ai RTL Support (Chrome extension) — افزونه کروم که به طور خاص برای رابط کاربری وب Claude.ai ساخته شده است. اگر فقط در سایت Claude به RTL نیاز دارید، از افزونه عمومی سبک‌تر است.
  • rtl-for-vs-code-agents (توسط Guy Ronnen) — افزونه VS Code که لایه گسترده‌تر webview نمایندگان هوش مصنوعی را پوشش می‌دهد: GitHub Copilot، Cursor، Antigravity، Gemini Code Assist. مکمل این اصلاح خاص است.
  • Claude-for-word-RTL-fix (توسط Asaf Aizone) — اصلاح RTL (عربی/عبری) برای افزونه Claude در Microsoft Office (Word/Excel/PowerPoint).
  • kivun-terminal-wsl (توسط Noam Brand) — اصلاح در سطح ترمینال برای خود CLI claude: یک پوشش Node به نام kivun-claude-bidi برای خروجی TUI مربوط به Claude Code، به علاوه نصب‌کننده با یک کلیک برای WSL2+Konsole در ویندوز یا نصب‌کننده‌های بومی shell در لینوکس.

⭐ پسندیدید؟ ستاره بدهید!

اگر این افزونه به شما کمک کرد، لطفاً یک ⭐ در GitHub بدهید — این به دیگران کمک می‌کند آن را پیدا کنند!


📄 مجوز

MIT — برای جزئیات فایل LICENSE را ببینید.

🔝 بازگشت به بالا

About

VS Code/Cursor/Antigravity extension that adds RTL (Right-to-Left) support for Hebrew and Arabic to the "Claude Code for VS Code" extension

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 99.2%
  • JavaScript 0.8%