فارسی · Claude Code / راست‌به‌چپ

Claude Code به فارسی: تنظیم language، CLAUDE.md و متن راست‌به‌چپ

بله. مرجع تنظیمات Claude Code می‌گوید مقدار language همان‌گونه که نوشته شده به مدل می‌رسد، به‌عنوان دستوری برای پاسخ همیشگی به آن زبان. فهرست ثابتی از زبان‌های پاسخ وجود ندارد، پس هم persian و هم farsi کار می‌کنند و Claude Code املای آن را بررسی نمی‌کند (متن رسمی، تا 2026-11-12). بخش سخت ماجرا در فارسی نمایش است، نه تنظیم. متن راست‌به‌چپ جریان دارد، نیم‌فاصله U+200C است، و «ی» فارسی در برابر یاء عربی (YEH) و «ک» فارسی در برابر کاف عربی (KAF) نقطه‌کدهای متفاوتی هستند.

به‌روزرسانی شده 2026-11-18

یک کلید برای Claude، GPT و مدل‌های چینی، با صورت‌حساب به‌ازای توکن.

#تنظیم language#فایل CLAUDE.md#نیم‌فاصله U+200C#RTL و جست‌وجو

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

بدون فهرست ثابت

تنظیم زبان پاسخ

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

دیکته متفاوت است

چرا دیکته به انگلیسی برمی‌گردد

همان مقدار، زبان دیکته صوتی را هم تعیین می‌کند، و دیکته فهرست ثابتی از زبان‌های پشتیبانی‌شده دارد که فارسی در آن نیست؛ مستندات می‌گویند زبانی بیرون از این فهرست باعث می‌شود /voice به شما هشدار دهد و برای دیکته به انگلیسی برگردد، در حالی که پاسخ‌های متنی تحت‌تأثیر قرار نمی‌گیرند.

نیم‌فاصله

U+200C چیست

نیم‌فاصله همان U+200C ZERO WIDTH NON-JOINER است: مانع چسبیدن دو حرف به هم می‌شود. فصل 9 استاندارد Unicode پسوند جمع فارسی را به‌عنوان مثال خود نام می‌برد و می‌گوید نادیده گرفتن یا حذف این نویسه‌ها متنی با معنای متفاوت، یا متنی بی‌معنا تولید می‌کند.

دو الفبا، دو مجموعه رقم

چرا جست‌وجو چیزی پیدا نمی‌کند

در فارسی، ی برابر است با U+06CC ARABIC LETTER FARSI YEH و ک برابر است با U+06A9 ARABIC LETTER KEHEH؛ در عربی، یاء عربی برابر است با U+064A ARABIC LETTER YEH و کاف عربی برابر است با U+0643 ARABIC LETTER KAF، یعنی چهار نقطه‌کد متفاوت. ماجرای ارقام هم همین است: ارقام فارسی از U+06F0 تا U+06F9 و ارقام عربی-هندی از U+0660 تا U+0669 هستند. بنابراین جست‌وجوی نویسه‌ای برای یک صورت نوشتاری، صورت نوشتاری دیگر را از دست می‌دهد و ارقام مخلوط بر اساس کلاس دوجهته مرتب می‌شوند (ارقام فارسی در حکم EN و ارقام عربی-هندی در حکم AN شمرده می‌شوند). ابتدا صورت نوشتاری را نرمال‌سازی کنید، سپس مقایسه یا ذخیره کنید.

زبان پاسخ و قراردادهای مخزن دو موضوع جداگانه‌اند

مستندات رسمی دو چیز را از هم جدا می‌کنند. اینکه پاسخ‌ها به چه زبانی بیایند یک تنظیم است: مقدار زبان عیناً به مدل می‌رود، بدون فهرست ثابت و بدون اعتبارسنجی، و همان مقدار دیکته صوتی و عنوان‌های جلسه که به‌صورت خودکار تولید می‌شوند را هم هدایت می‌کند. قراردادهای مخزن — اینکه کامنت‌ها، شناسه‌ها و پیام‌های کامیت از چه زبانی استفاده کنند — به CLAUDE.md تعلق دارند: Markdown متن ساده، که در آغاز هر جلسه خوانده می‌شود، با توصیه رسمی به ماندن زیر 200 خط، زیرا فایل‌های طولانی‌تر پایبندی را کاهش می‌دهند. هر دو را بنویسید تا توضیحات فارسی با سبک کد پایدار به دست آورید.

سه دام رایج در پروژه‌های فارسی

① راست‌به‌چپ: خط عربی از راست به چپ نوشته می‌شود و پیاده‌سازی‌های منطبق باید آن را برای نمایش با الگوریتم دوجهته یونیکد بازآرایی کنند، بنابراین موقعیت مکان‌نما و ترتیب نویسه‌ها در ترمینال با موقعیت روی صفحه یکی نیستند. ② نیم‌فاصله حذف‌شده: کپی‌پیست یا یک اسکریپت پاک‌سازی U+200C را حذف می‌کند، واژه‌ها به هم می‌چسبند و معنا هم با آن‌ها می‌رود. ③ حروف مخلوط: یاء و کاف عربی (YEH و KAF) که از مطالب عربی کپی شده‌اند، نقاط کد یکسانی با ی و ک فارسی ندارند؛ بنابراین جست‌وجو و جایگزینی از یافتن آن‌ها بازمی‌مانند.

نسخه‌ها و تاریخ‌های سه منبع

2026-11-12

مرجع تنظیمات Claude Code و صفحه حافظه در وضعیت کنونی آن‌ها: هیچ فهرست ثابتی برای زبان و هیچ اعتبارسنجی‌ای وجود ندارد؛ CLAUDE.md متن ساده است، در آغاز هر جلسه خوانده می‌شود و توصیه شده است زیر 200 خط بماند.

2026-10-23

آخرین به‌روزرسانی صفحه Claude Help Center درباره استفاده از Claude به زبان ترجیحی شما؛ در آن آمده است که Claude در برنامه‌های وب و دسکتاپ به چندین زبان در دسترس است و زبان‌های رابط کاربری را فهرست می‌کند.

2026-10-25

تاریخ نسخه راهنمای options.txt در Vim: rightleft باعث می‌شود یک پنجره راست‌به‌چپ نمایش داده شود، و این گزینه مختص پنجره است.

مستندشده در برابر مخزن خودتان

مستندشده

① Claude Code: هیچ فهرست ثابتی برای زبان‌های پاسخ وجود ندارد، مقدار عیناً به مدل می‌رود و اعتبارسنجی نمی‌شود، بنابراین یک غلط تایپی هیچ خطایی ایجاد نمی‌کند؛ دیکته فهرست ثابتی دارد و زبانی خارج از آن برای دیکته به انگلیسی بازمی‌گردد، در حالی که پاسخ‌های متنی تحت تأثیر قرار نمی‌گیرند. ② CLAUDE.md: متن ساده است، در آغاز هر جلسه خوانده می‌شود، می‌تواند فایل‌های دیگر را با @path وارد کند، باید زیر 200 خط بماند، کامنت‌های HTML در سطح بلوک آن پیش از تزریق حذف می‌شوند، و به‌جای پیکربندی اجباری، زمینه است. ③ فصل 9 یونیکد: خط عربی از راست به چپ نوشته می‌شود و پیاده‌سازی‌های منطبق باید آن را برای نمایش با الگوریتم دوجهته بازآرایی کنند؛ نمونه نیم‌فاصله پسوند جمع فارسی است؛ FARSI YEH و YEH نقاط کد متفاوتی هستند. ④ W3C: کدهای کنترل نامرئی هستند، متن ساده فقط می‌تواند از آن‌ها استفاده کند، و کنترل‌های جداساز بر RLE، LRE و PDF توصیه می‌شوند. ⑤ راهنمای GNU Emacs: ویرایش دوجهته عربی، فارسی و عبری را پوشش می‌دهد و UBA را پیاده‌سازی می‌کند.

آنچه مستندات باز می‌گذارند

هیچ چیز رسمی وعده نمی‌دهد که یک مدل همیشه به فارسی پاسخ دهد: زبان فقط مقدار را به‌عنوان یک دستور منتقل می‌کند، و میزان پایبندی به آن به مدل و prompt بستگی دارد. اینکه یک جلسه طولانی به انگلیسی برگردد، اینکه حروف فارسی داخل شناسه‌ها بازنویسی شوند، و اینکه ترمینال شما چه مقدار عرض نمایش به U+200C می‌دهد، موضوعاتی هستند که فقط مخزن خودتان می‌تواند آن‌ها را روشن کند. یک هشدار رسمی ارزش نگه داشتن دارد: اسکریپت‌های دوجهته هنگام استفاده در شناسه‌ها ملاحظات امنیتی ایجاد می‌کنند.

دو مکان، دو وظیفه

settings.json — زبان پاسخ

کلید زبان تعیین می‌کند پاسخ‌ها به چه زبانی بیایند: مقدار عیناً و بدون اعتبارسنجی و بدون فهرست ثابت به مدل می‌رود؛ همچنین زبان دیکته صوتی را که فهرست ثابتی دارد و عنوان‌های جلسه که به‌صورت خودکار تولید می‌شوند را تنظیم می‌کند.

CLAUDE.md — قراردادهای نوشتن

اینکه کامنت‌ها، شناسه‌ها و پیام‌های کامیت از چه زبانی استفاده می‌کنند، آیا حروف فارسی در نام متغیرها جای دارند، کد نمونه از چه زبانی استفاده می‌کند — قراردادهایی از این دست در CLAUDE.md نوشته می‌شوند: Markdown متن ساده، که در آغاز هر نشست خوانده می‌شود و ترجیحاً کمتر از 200 خط باشد.

ابتدا زبان را تنظیم کنید، سپس قاعده را بنویسید.

ابتدا یک خط در ~/.claude/settings.json قرار دهید: { "language": "persian" } (مثال رسمی از japanese استفاده می‌کند؛ مقدار اعتبارسنجی نمی‌شود، بنابراین farsi هم کار می‌کند). دوم، قرارداد مخزن را در ./CLAUDE.md بنویسید؛ این بلوک آماده چسباندن است: پاسخ‌ها را فارسی بنویس؛ کد، نام متغیرها و پیام کامیت را انگلیسی نگه دار. (یعنی پاسخ‌ها را فارسی بنویسید؛ کد، نام متغیرها و پیام‌های کامیت را انگلیسی نگه دارید.) سوم، دستور /context all را در یک نشست اجرا کنید و بررسی کنید که فایل زیر Memory files فهرست شده است، سپس یک وظیفه واقعی به آن بدهید و بررسی کنید که فارسی پس از فراخوانی‌های ابزار همچنان حفظ می‌شود.

در QCode

تنظیم زبان و CLAUDE.md روی دستگاه شما قرار دارند: CLI آن‌ها را پیش از ارسال درخواست می‌خواند، بنابراین تغییر مدل‌ها هیچ‌یک از آن‌ها را تغییر نمی‌دهد. مدل‌های Claude در QCode از پروتکل Anthropic استفاده می‌کنند: ANTHROPIC_BASE_URL را روی https://api.qcode.cc/api تنظیم کنید و از کلید داشبورد خود که با cr_ شروع می‌شود استفاده کنید. نرخ هر مدل در /models قرار دارد و بر اساس توکن محاسبه می‌شود. بسته‌های پرداخت به‌ازای مصرف از $4 شروع می‌شوند و برای سهمیه یک‌باره‌ای هستند که ظرف 7 روز مصرف می‌کنید؛ اگر از قبل پلن شخصی دارید، هر زمان به سهمیه بیشتری نیاز داشتید یک بسته تقویتی اضافه کنید.

پرسش‌های متداول

آیا Claude Code از فارسی پشتیبانی می‌کند؟

بله، برای پاسخ‌ها. مرجع رسمی تنظیمات می‌گوید هیچ فهرست ثابتی برای زبان‌های پاسخ وجود ندارد: مقدار عیناً به مدل می‌رود و Claude Code آن را اعتبارسنجی نمی‌کند، بنابراین persian و farsi هر دو کار می‌کنند. دو جای دیگر متفاوت عمل می‌کنند: زبان رابط برنامه فهرست ثابت خودش را دارد، و دیکته صوتی هم فهرست ثابتی دارد؛ فارسی در فهرست دیکته نیست، بنابراین انتخاب آن به دیکته انگلیسی برمی‌گردد. پاسخ‌های متنی تحت تأثیر قرار نمی‌گیرند.

چگونه می‌توانید فارسی را به پیش‌فرض تبدیل کنید؟

مقدار { "language": "persian" } را در ~/.claude/settings.json قرار دهید؛ farsi هم کار می‌کند. مثال رسمی japanese است که نشان می‌دهد نوع آن هر نام زبانی می‌تواند باشد؛ مقدار اعتبارسنجی نمی‌شود و اشتباه تایپی خطایی ایجاد نمی‌کند، بنابراین املای آن را خودتان بررسی کنید. .claude/settings.json در سطح پروژه می‌تواند همان کلید را داشته باشد، و برای اینکه کل مخزن یکدست بماند، قرارداد را در ./CLAUDE.md هم ذکر کنید.

متن فارسی در ترمینال شما با ترتیب اشتباه نمایش داده می‌شود. حالا چه باید بکنید؟

دو اثر را از هم جدا کنید. خط عربی از راست به چپ نوشته می‌شود، و پیاده‌سازی‌های منطبق باید آن را برای نمایش با الگوریتم دوجهته یونیکد بازآرایی کنند، بنابراین صفحه از راست به چپ پیش می‌رود در حالی که فایل هنوز از چپ به راست ذخیره می‌شود؛ در یک خط ترکیبی، ارقام و بخش‌های انگلیسی همچنان از چپ به راست خوانده می‌شوند. وقتی الگوریتم به اشاره اضافی نیاز دارد، W3C کنترل‌های جداساز RLI، LRI و PDI را به‌جای RLE، LRE و PDF توصیه می‌کند. ویرایشگرها سوئیچ‌های رسمی دارند: rightleft در Vim باعث می‌شود پنجره از راست به چپ نمایش داده شود، و GNU Emacs گزینه bidi-display-reordering را دارد.

نیم‌فاصله به‌صورت کاراکتر نامفهوم نمایش داده می‌شود یا ناپدید می‌شود. چرا؟

نیم‌فاصله همان U+200C ZERO WIDTH NON-JOINER است. عرض آن صفر است، بنابراین کاراکتری که به نظر می‌رسد ناپدید شده معمولاً گلیف ندارد اما هنوز آنجاست. خطر واقعی حذف شدن است: فصل 9 استاندارد یونیکد می‌گوید نادیده گرفتن یا حذف این نیم‌فاصله‌ها متنی با معنای متفاوت یا متن بی‌معنا تولید می‌کند، و پسوند جمع فارسی مثال رسمی آن است. هنگام اشکال‌زدایی، نمایش کاراکترهای نامرئی را در ویرایشگر خود روشن کنید؛ W3C همچنین اشاره می‌کند که کدهای کنترلی نامرئی‌اند و به‌راحتی بدون پایان‌بند رها می‌شوند، و اینکه متن ساده فقط می‌تواند از آن‌ها استفاده کند.

آیا می‌توانید CLAUDE.md را به فارسی بنویسید؟

بله. CLAUDE.md یک فایل متن ساده است که Claude در آغاز هر نشست می‌خواند، بنابراین قواعد را به زبانی بنویسید که تیم شما می‌خواند. طول و جایگاه بیش از زبان اهمیت دارند: کمتر از 200 خط بمانید، زیرا فایل‌های طولانی‌تر پایبندی را کاهش می‌دهند؛ کامنت‌های HTML در سطح بلوک پیش از تزریق حذف می‌شوند، بنابراین قواعد را در آن‌ها پنهان نکنید؛ و وقتی فایل بزرگ‌تر می‌شود، برای باقی از import‌های @path استفاده کنید.

کامنت‌ها و پیام‌های کامیت باید از چه زبانی استفاده کنند؟

این یک قرارداد تیمی است، نه یک واقعیت از سوی ارائه‌دهنده؛ اما در هر صورت آن را مکتوب کنید. تقسیم رایج این است: فارسی برای توضیحات و انگلیسی برای کد و پیام‌های کامیت. حروف فارسی درون شناسه‌ها دو مشکل مشخص ایجاد می‌کنند. اسکریپت‌های دوجهته هنگام استفاده در شناسه‌ها ملاحظات امنیتی رسمی را مطرح می‌کنند، و «ی» فارسی و «ک» فارسی نقطه‌کدهایی متفاوت از یاء و کاف عربی (YEH و KAF) هستند، بنابراین جست‌وجو و بازبینی کد به‌راحتی آن‌ها را از دست می‌دهند. این قاعده را در CLAUDE.md قرار دهید؛ در آغاز هر جلسه خوانده می‌شود.

منابع

Claude Code: بخش زبان در مرجع تنظیمات، صفحه حافظه (نحوه خواندن CLAUDE.md، توصیه‌های طول، importها، کامنت‌های HTML)، و صفحه دیکته صوتی (فهرست دیکته و قاعده جایگزین)، همه در 2026-11-12 خوانده شدند. مرکز راهنمایی Anthropic: «استفاده از Claude به زبان ترجیحی شما» (آخرین به‌روزرسانی 2026-10-23). یونیکد: فصل 9، Middle East-I (جهت نوشتار، نیم‌فاصله، FARSI YEH، ارقام)، UAX #9 برای الگوریتم دوجهته، و ArabicShaping.txt به‌همراه UnicodeData.txt برای نقطه‌کدها و ویژگی‌ها. W3C: کدهای کنترلی در برابر نشانه‌گذاری در متن دوجهته. ویرایشگرها: بخش ویرایش دوجهته در راهنمای GNU Emacs و راهنمای options.txt در Vim (2026-10-25). از سوی QCode: آموزش Claude Code در docs.qcode.cc و صفحه‌های قیمت‌گذاری و پرداخت به‌ازای مصرف در qcode.cc.

آماده‌اید Claude Code را به فارسی اجرا کنید؟

یک کلید QCode ایجاد کنید، ANTHROPIC_BASE_URL را تنظیم کنید، و به‌ازای هر توکن پرداخت کنید. بسته‌های پرداخت به‌ازای مصرف نیازی به اشتراک ندارند.

مطالب مرتبط

راهنمای پرداخت با رمزارز

نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.

مستندات و استانداردهای ارائه‌دهنده تغییر می‌کنند؛ هر رفتاری که در اینجا نقل شده، در 2026-11-12 از صفحه‌های رسمی خوانده شده است، و متن مقاله تاریخ‌های نسخه را برای Vim و مرکز راهنمایی ذکر می‌کند. اینکه یک مدل چقدر با ثبات به فارسی پاسخ می‌دهد وعده ارائه‌دهنده نیست، بنابراین آن را در مخزن خودتان بررسی کنید.

مطمئن نیستید از کجا شروع کنید؟

یک هفته امتحان کنید

بسته کوچک: $4 برای $30 سهمیه، به مدت 7 روز معتبر

هر روز از آن استفاده کنید

Starter: $9.00/ماه با $5 سهمیه در هر روز — فقط $0.060 به‌ازای هر $1 سهمیه، در برابر حدود $0.113 برای بسته متوسط