إعدادات اللغة: جعل 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.

ثلاث أدوات مساعدة، بالصياغة الرسمية:

• «شغّل /init لإنشاء ملف CLAUDE.md ابتدائي تلقائيًا.» — يكتب ما يستطيع اكتشافه؛ وقاعدة اللغة عليك إضافتها.

• «يسرد الأمر /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. نطاق المشروع — «بدءًا من جذر المشروع (عادةً جذر Git)، ينتقل Codex نزولًا إلى دليل العمل الحالي لديك.» يسهم كل دليل بملف واحد على الأكثر: 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. prompts بغير الإنجليزية: ما الذي تتوقعه¶

• الـ prompts تستهلك tokens. يُحتسب prompt المكتوب بلغتك مثل أي prompt آخر؛ فبالنسبة إلى الصينية «الحرف الواحد يقابل عادةً 1-2 tokens» (انظر وصف الفوترة)، لذا فإن قاعدة مسهبة تُكتب مرة واحدة في ملف ذاكرة أقل تكلفة من تكرارها في كل رسالة.

• اطلب لغة الإجابة، لا لغة الشيفرة. إن ترجمة المعرّفات أو أعلام 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 صفحة ترميز للـ console أمام الطرفية. «يغيّر صفحة ترميز الـ console النشطة. وإذا استُخدم دون معاملات، يعرض chcp رقم صفحة ترميز الـ console النشطة.» — وتضم القائمة 936 للصينية. إذا ظهرت المخرجات غير ASCII خاطئة في الـ console، فافحص تلك الصفحة أولًا؛ وتوصية Microsoft نفسها لتشغيل عمليات UTF-8 هي خاصية activeCodePage («اعتبارًا من إصدار Windows 1903 (تحديث مايو 2019)، يمكنك تحديد خاصية activeCodePage…»)، أو الخيار على مستوى النظام «Beta: Use Unicode UTF-8 for worldwide language support».

chcp
chcp 936

الأسماء ذات الحركات والأسماء CJK قد تكون بايتات متساوية لكن مختلفة. يعرّف معيار Unicode «التكافؤ القانوني» بأنه تكافؤ بين «محارف أو تسلسلات من المحارف تمثّل المحرف المجرّد نفسه […] ويجب أن يكون لها دائمًا، عند عرضها بشكل صحيح، المظهر والسلوك البصريان نفساهما.» لذا فإن اسمَي ملف يبدوان متطابقين على الشاشة قد يختلفان في البايتات، لذلك:

• دع الوكيل ينسخ المسار من قائمة الملفات بدلًا من إعادة كتابته (تقول قواعد المثال «أشِر إلى الملفات بأسمائها الحقيقية، بما في ذلك المحارف غير ASCII»)؛
• ضع بين علامات اقتباس المسارات التي تحتوي على مسافات أو محارف CJK في أي أمر shell؛
• أوقف تهريب 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 للمستخدمين خارج البر الرئيسي للصين

المؤسسات ←