استخدام Claude Code: الفاعلية غير المتوقعة لـ HTML

أصبح Markdown صيغة الملفات السائدة التي تستخدمها الوكلاء للتواصل معنا. إنه بسيط، خفيف على التوكنات، ومنتشر في كل مكان.

منذ حقبة GPT-4 مع حدّ التوكنات البالغ 8,192، اعتدتُ أن أطلب معظم المخرجات بصيغة Markdown بسبب كفاءتها العالية في استهلاك التوكنات مقارنةً بـ HTML.

لكن لا تزال هناك مشكلة: أنا لا أقرأ Markdown طويل السطور بعد الآن. — Thariq Shihipar

لماذا HTML؟

أذهب إلى حدّ القول بأنه لا توجد مجموعة من المعلومات يمكن لـ Claude قراءتها إلا ويمكنك تمثيلها بكفاءة معقولة باستخدام HTML.

هذا يجعل HTML طريقةً بالغة الكفاءة لنقل المعلومات المعمّقة من النموذج إليك وللمراجعة.

وجدتُ أنه في غياب هذه القدرة، قد يلجأ النموذج إلى أشياء أقل كفاءة في Markdown مثل مخططات ASCII، أو المفضلة لديّ: تقدير الألوان باستخدام أحرف Unicode.

حالات الاستخدام

١. التوثيق والتقارير

مستندات HTML أسهل بكثير في القراءة؛ يمكن لـ Claude تنظيم البنية بصرياً بشكل مثالي للتنقل، مع تبويبات وصور توضيحية وروابط وما إلى ذلك. كما يمكنها أن تكون متجاوبة مع الأجهزة المحمولة حتى تتمكن من قراءتها بطريقة مختلفة بحسب حجم الشاشة.

٢. الكود ومراجعات PR

الكود صعب القراءة في ملفات Markdown، لكن مع HTML يمكننا عرض الـ diffs والتعليقات التوضيحية ومخططات التدفق والوحدات البرمجية وما إلى ذلك. استخدم هذا لفهم الكود الذي كتبه الوكيل، أو للحصول على مراجعة كود، أو لشرح طلب PR لشخص يراجع كودك.

أجد هذا يعمل في الغالب بشكل أفضل من عرض الـ diff الافتراضي في GitHub، وأنا الآن أرفق شارحاً للكود بصيغة HTML مع كل PR أصنعه.

مثال على Prompt ساعدني في مراجعة هذا الـ PR عبر إنشاء HTML artifact يصفه. لستُ على دراية كبيرة بمنطق streaming/backpressure لذا ركّز على ذلك. اعرض الـ diff الفعلي مع تعليقات توضيحية هامشية مضمّنة، ولوّن النتائج حسب مستوى الخطورة وأي شيء آخر قد يكون ضرورياً لتوصيل المفهوم جيداً.

حالات الاستخدام:

إنشاء PR
مراجعة PR
فهم موضوع في الكود

٣. التحقيق في الحوادث والأعطال

اطلب من Claude إنشاء HTML artifact ينظّم بيانات السجلات أو تتبعات المكدس أو رسائل الخطأ، بدلاً من قذفها كنص خام في Markdown.

٤. البيانات والتصورات

بدلاً من جداول Markdown التي تصبح فوضوية مع البيانات المعقدة، يمكن لـ HTML إنشاء جداول تفاعلية مع إمكانية الفرز والتصفية والتنسيق الشرطي.

٥. التخطيط والتنظيم

بدلاً من قوائم Markdown المتداخلة لخطط المشاريع، يمكن لـ HTML إنشاء تسلسلات هرمية بصرية واضحة.

تحفظات وإشكاليات

توليد HTML يستغرق ضعفين إلى أربعة أضعاف الوقت مقارنةً بـ Markdown.
مراجعة التغييرات في ملفات HTML أمر شبه مستحيل عبر git diff.
لا يزال Markdown هو الأنسب للمخرجات القصيرة والبسيطة التي تحتاج إلى المعالجة لاحقاً.

الخلاصة

            HTML هو Markdown الجديد.

            لقد توقفتُ عن كتابة ملفات Markdown لكل شيء تقريباً،

            وتحوّلتُ إلى استخدام Claude Code لتوليد HTML بدلاً منها.

المعيار لم يعد "كم توكن استهلكتُ؟" — بل "هل المخرَج قابل للقراءة فعلاً؟". HTML يفوز في السؤال الثاني بفارق واسع، ومع نوافذ السياق التي تتسع كل شهر، أصبحت تكلفة التوكنات مبررة بشكل متزايد.

المصدر: مقالة بقلم Thariq Shihipar (@trq212)، عضو فريق Claude Code في شركة Anthropic — نُشرت على منصة X بتاريخ ٨ مايو ٢٠٢٦.