Claude Code RTL Support Pro

پشتیبانی از متن راست‌به‌چپ (RTL) برای عربی و فارسی در Claude Code — برای VS Code، Cursor، Kiro و Antigravity.

🌐 Languages | اللغات | زبان‌ها

🎬 Demo

🖼️ RTL ⇄ Button

🔝 Back to top

🇺🇸 English

A VS Code extension that adds Right-to-Left (RTL) text support to the Claude Code chat interface. Works with VS Code, Cursor, Kiro, and Antigravity. If you write in Arabic or Persian, this makes Claude Code feel natural — text flows the right way, and code blocks are left untouched.

🤔 Why does this exist?

Claude Code has no built-in RTL support. For Arabic and Persian speakers, this means:

• ❌ Text appears misaligned or jumbled
• ❌ Mixed-language conversations (code + RTL text) are hard to read
• ❌ The chat panel behaves inconsistently

This extension fixes all of that by injecting CSS that handles text direction — while keeping code blocks, tool outputs, and UI elements strictly LTR.

✨ Features

📋 Requirements

• Claude Code for VS Code (anthropic.claude-code) — installed automatically as a dependency

💻 Supported Platforms

🚀 How to Use

📊 Option 1: Status Bar

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

Click the status bar item to open a quick 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:

🔄 The window reloads automatically after activating or deactivating.

💬 Using RTL in Chat

Active mode — After activating and reloading:

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

Always mode — RTL is permanently on. No button, no toggling.

Auto mode — Each bubble is handled independently. Arabic/Persian bubbles go RTL; English bubbles stay LTR. Great for mixed conversations.

💡 Active mode tip: Not every conversation needs RTL. Use ⇄ only when you're writing in Arabic or Persian.

💡 Always mode tip: Best if you exclusively write in Arabic or Persian and don't want to think about it.

💡 Auto mode tip: The most hands-off option — each bubble gets the right direction on its own.

🔄 Auto-reactivate: If a Claude Code update removes RTL, it'll be restored automatically on the next startup.

⚙️ Font Settings

You can customize the fonts Claude Code uses by adding these to your settings.json (Cmd+, → search claude-rtl):

{
  "claude-rtl.textFont": "Vazirmatn",
  "claude-rtl.codeFont": "JetBrains Mono"
}

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

🔄 Changing a font automatically re-injects CSS and reloads the window.

↔️ What Changes in RTL Mode?

🔧 Troubleshooting

• Search by extension ID: claude-code-rtl-pro
• The display name "Claude Code RTL Support" may not show up in all marketplaces
• Use the exact ID claude-code-rtl-pro in the extensions search bar

• Make sure the "Claude Code for VS Code" extension is installed
• Run Claude RTL: Check Status to see more details

• Try reloading the window manually: Ctrl+Shift+P → Developer: Reload Window
• Or close and reopen VS Code / Cursor completely

• This is caused by a bidi-override CSS rule in Claude Code that forces all text to LTR
• Use Claude RTL: Fix BiDi instead of Activate RTL
• Note: if you later run Activate RTL, the issue comes back — always use Fix BiDi in that case

• Claude Code updates replace its files, which removes RTL support
• RTL is automatically restored on the next startup
• If it doesn't come back on its own, run Claude RTL: Activate RTL manually

• Windows: Run VS Code as Administrator
• macOS / Linux: Check file permissions on the extensions directory

📄 License

MIT — see LICENSE for details.

🔝 Back to top

{
  "claude-rtl.textFont": "Vazirmatn",
  "claude-rtl.codeFont": "JetBrains Mono"
}

{
  "claude-rtl.textFont": "Vazirmatn",
  "claude-rtl.codeFont": "JetBrains Mono"
}