ویرگول
ورودثبت نام
Mostafa Amini
Mostafa Amini
Mostafa Amini
Mostafa Amini
خواندن ۲ دقیقه·۲ ماه پیش

ترمینال ویندوز و فارسی: چطور Claude Code را فارسی کردم

اگر با Claude Code کار می‌کنید و یک بار در ترمینال ویندوز فارسی نوشته باشید، نتیجه را دیده‌اید: بسته به ترمینال، حروفی که به هم نمی‌چسبند یا کلمه‌هایی که جابه‌جا می‌شوند، گیومه‌هایی که برعکس می‌شوند، اسم فایلی که وسط جمله تکه‌تکه و جابه‌جا می‌شود، و نیم‌فاصله‌ای که راهی برای تایپش نیست.

علت این خرابی جایی است که متن در آن نمایش داده می‌شود، یعنی خود ترمینال.

ترمینال برای فارسی ساخته نشده

ترمینال شبکه‌ای از خانه‌های هم‌اندازه است و هر حرف یک خانه می‌گیرد. خط فارسی پیوسته است: شکل هر حرف به حروف کناری‌اش بستگی دارد و جهتش راست‌به‌چپ است. وقتی فارسی و انگلیسی در یک خط کنار هم می‌آیند، الگوریتمی به اسم «دوجهته» (BiDi) باید ترتیب نمایش را درست کند.

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

همان Claude Code، در جای دیگر

در ویندوز، موتور مرورگر تنها موتور متنی است که فارسی را درست می‌چیند. پس به‌جای عوض کردن Claude Code، جایی را عوض کردم که خروجی‌اش نمایش داده می‌شود.

«کلاد فارسی» یک پنجرهٔ Edge بدون نوار آدرس است که زیرش همان Claude Code رسمی، بدون هیچ تغییری، اجرا می‌شود. حساب، تنظیمات، مهارت‌ها و هوک‌ها همان‌هایی است که دارید، و گفتگویی که اینجا شروع کنید با claude --resume در ترمینال هم باز می‌شود. سرور کوچکی که بین این دو پیام جابه‌جا می‌کند با پایتون خالص نوشته شده و فقط روی کامپیوتر خودتان کار می‌کند.

دو چیزی که در ساختنش یاد گرفتم

اول، مسیر فایل وسط جملهٔ فارسی. جمله‌ای مثل «فایل D:\projects\app\style.css را عوض کردم» اگر به حال خودش رها شود، بخش‌هایش جابه‌جا می‌شوند. هر مسیر، کد، آدرس و شمارهٔ نسخه باید جداگانه از بقیهٔ جمله جدا (isolate) شود تا جهت جمله را به‌هم نزند.

دوم، اولین حرف. مرورگر جهت یک پاراگراف را از اولین حرفش حدس می‌زند، پس پاراگراف فارسی‌ای که با یک کلمهٔ انگلیسی شروع شود چپ‌به‌راست نمایش داده می‌شود. برنامه به‌جای این حدس، حروف فارسی و انگلیسی هر بند را می‌شمارد و بعد جهت را تعیین می‌کند.

امکانات

  • دکمه‌ها، منوها، پرسش اجازه و راهنما، همه فارسی و راست‌به‌چپ

  • نیم‌فاصله با Shift+Space

  • پیش از هر تغییر به فارسی اجازه می‌گیرد و خود تغییر را نشان می‌دهد

  • چند گفتگو کنار هم، جستجوی گفتگوها، و «گفتگوی تازه از اینجا» زیر هر پیام

  • نصب با دوبار کلیک؛ اگر پایتون یا Claude Code نصب نباشد، نصب‌کننده نصبشان می‌کند

نصب

  1. از صفحهٔ پروژه آخرین نسخه را دانلود کنید.

  2. روی persian-claude-gui\setup.bat دوبار کلیک کنید.

  3. میان‌بر «کلاد فارسی» را از دسکتاپ باز کنید.

پیش‌نیاز: ویندوز ۱۰ یا ۱۱، و یک حساب Claude که Claude Code با آن کار کند.

https://github.com/229amini/ClaudeCodePersianPort

بازخورد

پروژه رایگان و متن‌باز است. هر جا حرفی به‌هم ریخت، دکمه‌ای پیدا نشد یا امکانی کم بود، در گیت‌هاب بنویسید. فرم‌ها فارسی‌اند. اگر به کارتان آمد، برای کسی بفرستید که با Claude Code کار می‌کند.

این پروژه مستقل است و به Anthropic وابسته نیست.

هوش مصنوعیمتن بازبرنامه نویسیویندوز
۰
۰
Mostafa Amini
Mostafa Amini
شاید از این پست‌ها خوشتان بیاید