عادةً يطلب Claude Code كل استدعاء أداة مباشرةً ويقرأ النتيجة قبل أن يقرر الخطوة التالية. أما Code Mode، الذي أُضيف في الإصدار 2.1.323 يوم 12 نوفمبر 2026، فيتيح لـ Claude كتابة مقطع قصير من JavaScript يُجري عدة استدعاءات للأدوات في خطوة واحدة. يشرح لك هذا الدليل كيف تفعّله، وتجرّبه على مهمة حقيقية، وتقرأ الكود الذي كتبه Claude، ثم توقفه مجددًا.
حتى 15 نوفمبر 2026، لا يزال Code Mode تجريبيًا ومُعطّلًا افتراضيًا. وتقول وثائق Anthropic إنه قد يتغير أو يُزال في أي إصدار.
ماذا يفعل Code Mode
في الجلسة العادية، يطلب Claude أدوات مثل Bash أو Read أو Edit مباشرةً ويقرأ كل نتيجة قبل الخطوة التالية. أما في جلسة Code Mode فما زلت تكتب طلبك بلغة عادية، لكن Claude يكتب JavaScript لتنفيذه. ويمكن لمقطع واحد من الكود أن يشغّل أوامر بالتوازي، ويمرّر نتيجة إلى الاستدعاء التالي، ويعيد فقط الجزء الذي يحتاج Claude إلى قراءته من المخرجات.
تقدّم وثائق Code Mode من Anthropic هذا المثال لما قد يكتبه Claude عندما يُطلب منه رفع حدّ إعادة المحاولة. يعثر الكود على الملف ويعدّله ثم يشغّل الاختبارات:
const files = await $`rg -l "function retryPolicy" src`.text();
const target = files.trim().split("\n")[0];
await edit(target, "maxAttempts: 3", "maxAttempts: 5");
({ edited: target, tests: $`npm test -- retryPolicy`.nothrow() });
أنت لا تكتب هذا الكود، ولا تراه افتراضيًا. تعرض المحادثة استدعاءات الأدوات، مثل الفروق (diff) الناتجة عن التعديل.
تقترح الوثائق تجربته في المهام التي تتطلب استدعاءات أدوات كثيرة ومترابطة:
- تغيير يتكرر في ملفات كثيرة؛
- بحث تحتاج نتائجه إلى تصفية قبل أن يقرأها Claude؛
- عدة أوامر مستقلة يمكن تشغيلها في الوقت نفسه.
اقرأ القيود أولًا
يأتي Code Mode مع تنازلات حقيقية. تأكد من أنك تتقبّلها قبل تفعيله:
- الاستئناف: لا يمكن استئناف جلسة Code Mode إلا في الطرفية، ومع تفعيل Code Mode.
- الكود طويل التشغيل: ما لم يكن الكود قادرًا على العمل في الخلفية (انظر الخطوة 6)، فعليك انتظاره، ويتوقف بعد عشر دقائق.
- ميزات غير متوفرة: لا تعمل Remote Control وClaude in Chrome وميزة computer use في جلسة Code Mode، ولا يمكنك نقل الجلسة إلى تطبيق سطح المكتب.
ما الذي تحتاجه
- Claude Code بالإصدار v2.1.323 أو أحدث، مثبّتًا بالإصدار الأصلي (native).
- اشتراك Claude أو حساب Claude Console. لا يعمل Code Mode عبر بوابة (gateway) أو Amazon Bedrock أو Claude Platform on AWS أو Agent Platform من Google Cloud أو Microsoft Foundry.
- أحد هذه النماذج: Claude Opus 5.5 أو Sonnet 5.5 أو Haiku 5.5 أو Fable 5.2.
- جلسة
claudeتفاعلية في الطرفية. لا يعمل مع-pأو Agent SDK أو لوحة VS Code أو تطبيق سطح المكتب أو الجلسات السحابية. - على Windows، يجب تثبيت Git for Windows.
- مؤسسة لا تستخدم إعداد HIPAA ولا الاحتفاظ الصفري بالبيانات (zero data retention).
الخطوة 1: تحقّق من إصدارك
claude --version
إذا كان الرقم أقل من 2.1.323، فحدّث:
claude update
إذا كنت على قناة الإصدار stable ولم يصل التحديث إلى 2.1.323 بعد، تقول الوثائق إن عليك انتظار أن تلحق stable أو الانتقال إلى latest.
الخطوة 2: شغّل Claude Code مع تفعيل Code Mode
يتحكم في Code Mode متغير بيئة واحد هو CLAUDE_CODE_EXPERIMENTAL_CODE_MODE. لتجربته مرة واحدة، اضبط المتغير لتشغيل واحد فقط.
macOS أو Linux أو WSL:
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude
Windows PowerShell:
$env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1"
claude
لتفعيله في كل جلسة جديدة، أضف كتلة env إلى ملف إعدادات المستخدم في ~/.claude/settings.json:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
}
}
يتجاهل Claude Code هذا المتغير في ملفات إعدادات المشروع، لذا لا يمكن لمستودع تنسخه أن يفعّل Code Mode نيابةً عنك.
الخطوة 3: أكّد الرسالة
قبل أول جلسة Code Mode، يطلب منك Claude Code التأكيد. اختر Yes, turn on Code Mode (نعم، فعّل Code Mode). يعيد Claude Code التشغيل ويعرض هذا السطر قرب أعلى الجلسة:
Code Mode (experimental) is on · this session can be resumed only with Code Mode on
إذا ظهر لك سطر مختلف، أو لم يظهر شيء، فانتقل إلى قسم الأخطاء أدناه.
الخطوة 4: أعطِ Claude مهمة فيها استدعاءات أدوات كثيرة
في مشروع تعرفه جيدًا، جرّب الطلب الوارد في الوثائق:
Read every Markdown file in this project and list the links that point to local files that don't exist.
طلب آخر يناسب هذا النمط:
Run the linter, the type checker and the unit tests at the same time, then summarize only the failures.
النتيجة المتوقعة: يجيب Claude كالمعتاد، وترى استدعاءات الأدوات التي أجراها.
الخطوة 5: اقرأ الكود الذي كتبه Claude
اضغط Ctrl+O لفتح عارض سجل المحادثة. يظهر كل مقطع كود كصف مطوي باسم Code. وسّع أحدها لترى JavaScript الذي يقف وراء استدعاءات الأدوات، ثم اضغط Ctrl+O مرة أخرى للعودة إلى المحادثة.
الخطوة 6: تعامل مع الأذونات والمهام الطويلة
تظل إعدادات الأمان الحالية سارية. فكل استدعاء أداة يجريه الكود يمر عبر قواعد الأذونات deny وask وعبر خطافات PreToolUse الخاصة بك، ولا تحتاج إلى تغيير أي قاعدة لأداة مثل Bash.
ما يتغير هو طريقة مراجعة الكود:
- في الوضع التلقائي (auto)، يراجع مصنِّف كل مقطع كود قبل تشغيله، وليس كل استدعاء أداة. ولا يمكنه رؤية القيم التي تُحسب أثناء تشغيل الكود، مثل مسار مأخوذ من نتائج بحث. احتفظ بقواعد أو خطافات لكل ما يجب أن تتحكم فيه.
- في أوضاع الأذونات الأخرى، يبدأ الكود دون مراجعة، وتظهر لك رسالة لكل استدعاء أداة كان سيطلب موافقتك عادةً.
في عمليات البناء أو الاختبارات الطويلة، إما أن ينتظر Claude الكود، الذي يتوقف بعد عشر دقائق، أو يتركه يستمر في الخلفية، حيث يمكن أن يعمل حتى ساعتين بينما تواصل الحديث. يحتاج الكود في الخلفية إلى جلسة بدأت في الوضع التلقائي أو في وضع bypassPermissions. إذا كان الوضع التلقائي متاحًا لك، تقدّم الوثائق هذه الطريقة لإعادة التشغيل فيه:
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude --continue --permission-mode auto
لفحص الكود بنفسك باستخدام سكربت خاص بك، اكتب خطاف PreToolUse يطابق REPL، وهي الأداة التي تشغّل كود Claude، واقرأ JavaScript من tool_input.code.
الخطوة 7: استأنف الجلسة أو أوقف الوضع
للعودة إلى جلسة Code Mode لاحقًا، أبقِ المتغير مضبوطًا عند الاستئناف:
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude --continue
عندما يكون Code Mode معطّلًا، يرفض Claude Code استئناف تلك الجلسة. أما الجلسات التي بدأتها دون Code Mode فتُستأنف دونه، حتى مع ضبط المتغير.
لإيقاف Code Mode، احذف CLAUDE_CODE_EXPERIMENTAL_CODE_MODE من الصدفة (shell) ومن ~/.claude/settings.json، ثم ابدأ جلسة جديدة. ويمكنك أيضًا ضبط قيمته على 0. فوجود 0 في مكان واحد يبقي Code Mode معطّلًا حتى لو كانت القيمة في المكان الآخر 1.
يمكن للمسؤولين حظره على مستوى المؤسسة كلها بوضع كتلة env نفسها، بالقيمة "0"، في الإعدادات المُدارة (managed settings). ولا يمكن للإعدادات المُدارة إلا حظر Code Mode، ولا يمكنها تفعيله للمستخدمين.
الأخطاء الشائعة وحلولها
إذا بدأت الجلسة بالرسالة Code Mode (experimental) isn't available، فإن السبب يظهر في السطر نفسه، ويعرضه /status أيضًا. أصلح السبب وابدأ جلسة جديدة. يغطي الجدول عدة أسباب، وتذكر الوثائق البقية.
| السبب المعروض | الحل |
|---|---|
it isn't open to your account yet | حدّث إذا كان إصدارك أقدم من v2.1.323. وإلا فتحقق من اتصال الشبكة وابدأ من جديد. وإذا استمرت المشكلة، فجرّب في يوم آخر |
it only works with the Anthropic API | احذف الإعدادات التي توجّه الطلبات عبر مزوّد سحابي أو بوابة أو ANTHROPIC_BASE_URL مخصص |
it doesn't work with an API key helper | احذف apiKeyHelper وANTHROPIC_AUTH_TOKEN وأي ترويسة Authorization أو X-Api-Key في ANTHROPIC_CUSTOM_HEADERS، ثم سجّل الدخول أو اضبط ANTHROPIC_API_KEY |
it only works with Opus 5.5, Sonnet 5.5 and later models | ابدأ بنموذج مدعوم، مثل claude --model opus |
it needs settings that Claude Code downloads from Anthropic | ألغِ المتغير الذي يعطّل جلب أعلام الميزات (feature flags)، مثل DISABLE_TELEMETRY |
your organization's settings don't allow it | اسأل مسؤول النظام عن الإعداد المُدار |
مشكلات أخرى:
- لا يظهر أي سطر عن Code Mode: تحقق من الإصدار، وتأكد من أن قيمة المتغير
1في الصدفة أو في إعدادات المستخدم، واحذف أي0. - رسالة أذونات مع عدّ تنازلي: في الوضع التلقائي، عندما يبدأ Claude كودًا جديدًا بينما لا يزال كود سابق قيد التشغيل، قد يُطلب منك الرد بشأن الاستدعاءات المتبقية من الكود السابق. أجب قبل انتهاء العدّ التنازلي، وإلا يُرفض ذلك الاستدعاء.
- يبلّغ Claude عن استدعاء أداة مرفوض: فشل خطاف
PreToolUseأو تجاوز المهلة. أصلح الخطاف أو زد قيمةtimeoutالخاصة به.
الخلاصة
يستحق Code Mode التجربة إذا كانت جلساتك تتضمن الكثير من عمليات البحث والتعديل والاختبار المتكررة. فعّله لجلسة واحدة باستخدام متغير البيئة، وأعطه مهمة متعددة الخطوات، واقرأ الكود باستخدام Ctrl+O. وتوقّع تغييرات ما دام في مرحلته التجريبية.
إذا كنت توسّع إعداد Claude Code لديك، فإن أدلتنا حول مهارات الوكلاء (agent skills) في Claude Code وحول منح وكيلك متصفحًا حقيقيًا باستخدام Chrome DevTools MCP قراءة مناسبة بعد ذلك.
المصادر
آخر تحقق من الروابط في 15 نوفمبر 2026.





اكتب ردًّا