# executeCode

يُنفِّذ مقتطف شفرة داخل نواة حية أو صندوق رمل يُقدِّمه تكامل IDE (مثل نواة Jupyter المرتبطة بالدفتر المفتوح حالياً). تكون الأداة موجودة فقط عندما يعمل Claude Code جنباً إلى جنب مع جسر IDE متوافق مثل ملحق VS Code مع نواة Jupyter محددة.

## متى يُستخدم

- تشغيل حساب سريع أو فحص بيانات أو رسم مقابل الحالة المحمَّلة بالفعل في نواة Jupyter نشطة.
- التحقق من مقتطف شفرة قبل لصقه في خلية دفتر.
- استكشاف إطار بيانات في الذاكرة أو متغير أو نموذج موجود في النواة لكن غير مُسلسل على القرص.
- إنتاج رسم بياني أو نتيجة عددية يريد المستخدم عرضها داخلياً في IDE.

لا تستخدمه لسكربتات مستقلة تكون أفضل بتشغيل `Bash` لـ `python script.py`، أو لشفرة تحتاج إلى الاستمرار عبر نواة جديدة.

## المعاملات

- `code` (سلسلة، مطلوب): الشفرة المراد تنفيذها في النواة الحالية. تعمل كما لو لُصقت في خلية دفتر — المتغيرات المُعرَّفة تستمر في النواة حتى يُعاد تشغيلها.
- `language` (سلسلة، اختياري): لغة المقتطف عندما يدعم جسر IDE عدة أنوية. غالباً ما يُحذف؛ الافتراضي هو لغة النواة النشطة (Python عادة).

## أمثلة

### مثال 1: فحص إطار بيانات في الذاكرة

```
executeCode(
  code="df.head()\nprint(df.shape)\nprint(df.dtypes)"
)
```

يُعيد الصفوف الأولى والشكل وأنواع الأعمدة لإطار بيانات مُحمَّل بالفعل في النواة.

### مثال 2: فحص عددي سريع

```
executeCode(
  code="import numpy as np\nnp.mean([1, 2, 3, 4, 5])"
)
```

يُشغِّل حساباً لمرة واحدة دون إنشاء خلية دفتر.

## ملاحظات

- `executeCode` أداة جسر IDE. غير متاحة في جلسات Claude Code العادية في الطرفية؛ تظهر فقط عندما تكون الجلسة متصلة بـ IDE يعرض نواة (مثل ملحق Jupyter لـ VS Code).
- الحالة تستمر في النواة. المتغيرات المُعرَّفة باستدعاء `executeCode` تبقى مرئية للاستدعاءات اللاحقة ولخلايا الدفتر وللمستخدم — كن مدركاً للآثار الجانبية.
- ستحجب الشفرة طويلة الأمد أو الحاجبة النواة. أبقِ المقتطفات قصيرة؛ للعمل الذي يستغرق عدة دقائق، اكتب سكربتاً فعلياً وشغِّله عبر `Bash`.
- تُعاد المخرجات (stdout، القيم المُرجعة، الصور) إلى الجلسة. قد يُقتطع جسر IDE المخرجات الكبيرة جداً.
- لتعديلات الملفات، فضِّل `Edit` أو `Write` أو `NotebookEdit` — `executeCode` ليس بديلاً لتأليف ملفات المصدر.
