تنظیمات زبان: واداشتن Claude Code و Codex به پاسخ‌دادن به زبان شما

زبان پاسخ Claude Code و Codex را با CLAUDE.md و AGENTS.md تنظیم کنید، promptهای غیرانگلیسی را بدون شکستن کد بنویسید و فایل‌های UTF-8، نویسه‌های اکسنت‌دار و مسیرهای CJK را مدیریت کنید

به کلید API نیاز دارید؟ ثبت‌نام ←·نقاط پایانی و Base URL ←

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

این صفحه درباره زبان است. برای ساختار کلی خود فایل‌های دستورالعمل به راهنمای پیکربندی CLAUDE.md و راهنمای پیکربندی AGENTS.md مراجعه کنید.

1. در همان نشست بپرسید¶

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

2. آن را با CLAUDE.md ماندگار کنید (Claude Code)¶

بیان رسمی: «فایل‌های CLAUDE.md فایل‌های Markdown هستند که به Claude دستورالعمل‌های ماندگار برای یک پروژه، جریان کاری شخصی شما یا کل سازمان شما می‌دهند.» یک قاعده زبانی دقیقاً همین نوع دستورالعمل است.

قاعده را در یک بلوک قرار دهید و آن را کوتاه نگه دارید:

## Response language

- Reply in the language of my message unless I say otherwise.
- If I name a language explicitly (for example: "reply in 日本語"), use it for the whole session.
- Keep code, identifiers, file paths, shell commands and log output exactly as they are.
- Do not translate English comments, commit messages or API names inside files.

سه ابزار کمکی، با بیان رسمی:

• «برای تولید خودکار یک CLAUDE.md آغازین، /init را اجرا کنید.» — این کار آنچه را که می‌تواند کشف کند می‌نویسد؛ افزودن قاعده زبانی بر عهده شماست.
• «دستور /memory فایل‌های CLAUDE.md، CLAUDE.local.md و سایر مکان‌های فایل حافظه را در محدوده‌های کاربر و پروژه فهرست می‌کند» — از آن استفاده کنید تا تأیید کنید فایلی که ویرایش کرده‌اید همان فایلی است که بارگذاری می‌شود.
• «فایل‌های CLAUDE.md می‌توانند با استفاده از نحو @path/to/import فایل‌های بیشتری را وارد کنند.» — زمانی مفید است که قواعد زبانی در فایلی جداگانه قرار دارند که چند مخزن آن را به اشتراک می‌گذارند.

Claude Code همچنین می‌تواند AGENTS.md را بخواند: «Claude Code می‌تواند AGENTS.md را به‌عنوان دستورالعمل‌های پروژه بخواند و به این ترتیب بدون افزودن CLAUDE.md با سایر عامل‌های کدنویسی سازگاری داشته باشد.»، و «CLAUDE.md به‌طور پیش‌فرض بر AGENTS.md اولویت دارد.» پس اگر یک مخزن برای هر دو ابزار استفاده می‌شود، قاعده را یک‌بار در AGENTS.md بنویسید و فقط زمانی CLAUDE.md را اضافه کنید که Claude Code به چیز بیشتری نیاز دارد.

3. آن را با AGENTS.md ماندگار کنید (Codex)¶

«Codex پیش از انجام هر کاری فایل‌های AGENTS.md را می‌خواند.» Codex هنگام راه‌اندازی یک زنجیره دستور می‌سازد، و ترتیب کشف برای یک قاعده زبانی اهمیت دارد:

1. دامنه سراسری — در خانه Codex شما (به‌طور پیش‌فرض ~/.codex، مگر اینکه CODEX_HOME را تنظیم کنید)، «Codex اگر AGENTS.override.md وجود داشته باشد آن را می‌خواند. در غیر این صورت، Codex فایل AGENTS.md را می‌خواند.» فقط اولین فایل غیرخالی در این سطح استفاده می‌شود.
2. دامنه پروژه — «Codex با شروع از ریشه پروژه (معمولاً ریشه Git)، تا پوشه کاری فعلی شما پایین می‌آید.» هر پوشه حداکثر یک فایل ارائه می‌کند: AGENTS.override.md، سپس AGENTS.md، سپس هر نامی در project_doc_fallback_filenames.
3. ترتیب ادغام — «Codex فایل‌ها را از ریشه به پایین به هم می‌چسباند […] فایل‌های نزدیک‌تر به پوشه فعلی شما بر راهنمایی‌های قبلی اولویت دارند زیرا در prompt ترکیبی دیرتر ظاهر می‌شوند.»

## Response language

- Reply in the language of my message unless I say otherwise.
- Keep code, identifiers, file paths, shell commands and log output exactly as they are.
- Refer to files by their real names, including non-ASCII characters.

یک نکته احتیاطی با یک عدد قطعی پشت آن: «Codex از فایل‌های خالی صرف‌نظر می‌کند و به‌محض اینکه اندازه ترکیبی به حد تعیین‌شده توسط project_doc_max_bytes برسد (به‌طور پیش‌فرض 32 KiB)، افزودن فایل‌ها را متوقف می‌کند.» یک قاعده زبانی دو خط است — آن را بالای فایل قرار دهید تا از قطع‌شدن جان سالم به در ببرد، نه در انتهای یک زنجیره طولانی مونورپو.

راهنمای تیم خودمان، از راهنمای پیکربندی AGENTS.md: این فایل را می‌توان به زبان خودتان یا به انگلیسی نوشت؛ برای یک پروژه شخصی از هر زبانی که با آن راحت هستید استفاده کنید، برای یک مخزن مشترک، انگلیسی توصیه می‌شود زیرا با کد هم‌خوان می‌ماند. یک قاعده زبانی که به انگلیسی نوشته شده و پاسخ به زبان دیگر را الزام می‌کند، ترکیب رایج است.

4. کدام فایل را ویرایش کنید¶

5. promptهای غیرانگلیسی: چه انتظاری داشته باشید¶

• promptها توکن مصرف می‌کنند. یک prompt به زبان خودتان نیز مانند هر prompt دیگری صورت‌حساب می‌شود؛ برای چینی «1 نویسه معمولاً معادل 1-2 توکن است» (به توضیحات صورت‌حساب مراجعه کنید)؛ بنابراین یک قاعده پرگو که یک‌بار در فایل حافظه نوشته می‌شود ارزان‌تر از تکرار آن در هر پیام است.
• زبان پاسخ را درخواست کنید، نه زبان کد را. ترجمه شناسه‌ها، گزینه‌های CLI، رشته‌های خطا یا مسیرهای فایل پاسخ‌ها را غیرقابل استفاده می‌کند؛ به همین دلیل بلوک‌های نمونه بالا کد را به شکل اصلی خود نگه می‌دارند.
• اگر پاسخ‌ها به انگلیسی بازمی‌گردند، احتمالاً قاعده دیر خوانده می‌شود یا توسط قاعده دیگری بازنویسی می‌شود — فایل‌های بارگذاری‌شده را با /memory یا /context تأیید کنید و بررسی کنید آیا AGENTS.md عمیق‌تر یا AGENTS.override.md برنده است (ترتیب ادغام را در بخش 3 ببینید).

6. کدگذاری فایل، اکسنت‌ها و مسیرهای غیر ASCII¶

تنظیمات زبان همچنین یک مسئله در سطح بایت است. سه قاعده که همه‌جا برقرار است:

فایل‌ها را UTF-8 نگه دارید. «UTF-8 صفحه‌کد جهانی برای بین‌المللی‌سازی است و می‌تواند کل مجموعه نویسه‌های Unicode را کدگذاری کند. به‌طور گسترده در وب استفاده می‌شود و کدگذاری پیش‌فرض برای هر دو پلتفرم XML و مبتنی بر *nix است.» CLAUDE.md / AGENTS.md را از ویرایشگر خود به‌صورت UTF-8 ذخیره کنید؛ یک فایل حافظه با نویسه‌های به‌هم‌ریخته به‌صورت به‌هم‌ریخته خوانده می‌شود.

Windows یک صفحه‌کد کنسول در مقابل ترمینال دارد. «صفحه‌کد فعال کنسول را تغییر می‌دهد. اگر بدون پارامتر استفاده شود، chcp شماره صفحه‌کد فعال کنسول را نمایش می‌دهد.» — و فهرست شامل 936 برای چینی است. اگر خروجی غیر ASCII در یک کنسول نادرست به نظر می‌رسد، ابتدا همان صفحه را بررسی کنید؛ توصیه خود Microsoft برای اجرای فرایندهای UTF-8، ویژگی activeCodePage است («از Windows Version 1903 (May 2019 Update)، می‌توانید ویژگی activeCodePage را مشخص کنید…»)، یا گزینه سراسری سیستم «Beta: Use Unicode UTF-8 for worldwide language support».

chcp
chcp 936

نام‌های دارای اکسنت و CJK می‌توانند بایت‌هایی برابر اما متفاوت باشند. استاندارد Unicode «هم‌ارزی متعارف» را هم‌ارزی میان «نویسه‌ها یا دنباله‌هایی از نویسه‌ها که یک نویسه انتزاعی یکسان را نمایش می‌دهند […] هنگامی که به‌درستی نمایش داده شوند باید همیشه ظاهر بصری و رفتار یکسانی داشته باشند.» تعریف می‌کند. بنابراین دو نام فایل که روی صفحه یکسان به نظر می‌رسند می‌توانند در بایت‌ها متفاوت باشند؛ پس:

• بگذارید عامل مسیر را از یک فهرست کپی کند نه اینکه آن را دوباره تایپ کند (قاعده‌های نمونه می‌گویند «به فایل‌ها با نام‌های واقعی‌شان، از جمله نویسه‌های غیر ASCII، ارجاع دهید»)؛
• مسیرهایی را که شامل فاصله یا نویسه‌های CJK هستند در هر فرمان shell در گیومه بگذارید؛
• نقل‌قول‌گذاری (escape) مسیرها در Git را خاموش کنید تا git status و git diff نام‌های شما را همان‌گونه که هستند چاپ کنند: «وقتی این گزینه پیکربندی روی false تنظیم شود، git نام‌های مسیر را در خروجی فرمان‌هایی مانند git status و git diff در گیومه نمی‌گذارد […] مقدار پیش‌فرض true است.»

git config --global core.quotepath false

7. فهرست بررسی¶

• [ ] قاعده در فایلی است که ابزار واقعاً بارگذاری می‌کند (/memory، /context، یا بخشی ابتدایی از زنجیره Codex).
• [ ] زبان پاسخ را نام می‌برد و ترجمه کد، مسیرها و فرمان‌ها را ممنوع می‌کند.
• [ ] فایل به‌صورت UTF-8 ذخیره شده است.
• [ ] مسیرهای غیر ASCII از خروجی ابزار کپی شده‌اند، نه دوباره تایپ شده.
• [ ] اگر هر دو ابزار روی یک مخزن استفاده می‌شوند، قاعده در AGENTS.md قرار دارد (یا عمداً تکرار شده است).

صفحات مرتبط¶

• راهنمای پیکربندی CLAUDE.md
• راهنمای پیکربندی AGENTS.md
• آموزش کامل Claude Code
• آموزش کامل Codex
• قالب‌های خروجی: json / text / stream-json
• نکته‌های CLI
• QCode برای کاربران خارج از سرزمین اصلی چین

سازمانی ←