كيف تفعّل Code Mode في Claude Code (ومتى يستحق الاستخدام)

يتيح Code Mode التجريبي الجديد في Claude Code لـ Claude كتابة JavaScript ينفّذ استدعاءات أدوات كثيرة في خطوة واحدة. إليك كيف تشغّله وتجرّبه ثم توقفه.

Graphic of a terminal with one code block branching into several tool icons, for a guide to Code Mode in Claude Code

عادةً يطلب 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.

بقلم Mindloop Editorial

The Mindloop Experience editorial team writes clear, carefully sourced explainers and how-tos on tech, science, money and culture, for anyone who likes to know how things actually work.

عن Mindloop Experience

الردود

اكتب ردًّا

المزيد من Mindloop Experience

كل مقالات Mindloop Experience

يمكنك التصفيق حتى 50 مرة.