إدخال الصور (الرؤية)

أعطِ Claude Code صورًا باللصق أو السحب والإفلات أو عبر مسار ملف لقراءة لقطات الشاشة والنماذج التصميمية والمخططات والرسوم البيانية — مفتاح API واحد من QCode.cc يعمل على كل نقطة نهاية.

تحتاج مفتاح API؟ أنشئ حسابًا ←·نقاط النهاية وعناوين Base URL ←

لا يقرأ Claude Code الشيفرة فحسب — بل يمكنه رؤية الصور. أعطِه لقطة شاشة أو نموذجًا تصميميًا أو شاشة خطأ أو مخططًا معماريًا، وسيقرأ نموذج يدعم الرؤية ما في الصورة حرفيًا، ثم يتصرّف بناءً عليه مع الـ prompt الخاص بك — فيحوّل نموذجًا تصميميًا إلى واجهة استخدام، أو يحدّد موضع خطأ من لقطة شاشة لخطأ، أو يشرح مخططًا معماريًا أو رسمًا بيانيًا للبيانات.

تتناول هذه الصفحة إدخال الصور: أنت تقدّم الصورة والنموذج يفهمها. وهذا أمر مختلف عن «توليد الصور».

⚠️ لا تخلط بين هذا وبين توليد الصور تتناول هذه الصفحة تقديم الصور إلى النموذج ليفهمها (إدخال الرؤية). أما إذا أردت أن يولّد الذكاء الاصطناعي الصور أو يحرّرها (ملصقات، رسوم توضيحية، نماذج واجهات استخدام، قصّ الخلفية أو تبديلها)، فتلك قدرة منفصلة — استخدم gpt-image-2. راجع توليد الصور عبر gpt-image-2. باختصار: قراءة الصور = هذه الصفحة؛ رسم الصور = image-2.

ثلاث طرق لتقديم صورة¶

داخل جلسة Claude Code، هناك ثلاث طرق لإعطاء صورة إلى النموذج:

على macOS، تُحفظ لقطة الشاشة في الحافظة افتراضيًا، لذا يعمل Ctrl+V مباشرةً؛ وإذا حُفظت اللقطة كملف، فالسحب والإفلات أو المسار أكثر موثوقية. يختلف دعم اللصق والسحب بحسب الطرفية ونظام التشغيل — وإذا لم يُتعرّف عليه، فارجع إلى «الإشارة إلى مسار ملف»، فهو الخيار الأكثر موثوقية.

أمثلة على الإشارة إلى مسار¶

> Look at the mockup ./design/dashboard.png and implement it with React + Tailwind
> What's causing this error screenshot @screenshots/build-error.png, and how do I fix it?
> Explain the system architecture in docs/architecture.png — how do the components interact?

الإشارة إلى مسار قابلة للتكرار: ضعها في سكربت أو في قالب prompt فتشير إلى الصورة نفسها في كل مرة، دون لصق يدوي.

حالات الاستخدام النموذجية¶

1. نموذج أولي / لقطة شاشة → كود واجهة المستخدم¶

أعطِ Claude Code نموذجًا أوليًا أو لقطة شاشة لصفحة موجودة واطلب منه إعادة إنتاج كود واجهة أمامية قابل للتشغيل.

> Here's the mockup @mockups/pricing-page.png. Implement it with Next.js + Tailwind.
  Match the layout, spacing, and colors as closely as possible, with sensible component splits.

يقرأ النموذج التخطيط والنصوص والألوان من الصورة ويولّد كود المكوّنات المطابق. تعتمد الدقة على مدى وضوح الصورة وعلى القيود الواردة في prompt الخاص بك (إطار العمل، نظام التنسيق، اصطلاحات التسمية، إلخ).

2. لقطة شاشة لخطأ → تحديد الخطأ وإصلاحه¶

تلك الأخطاء الحمراء في IDE أو وحدة تحكم المتصفح أو الطرفية — التقط لها لقطة شاشة بدلًا من إعادة كتابة تتبّع مكدس طويل.

> @screenshots/ts-error.png How do I fix this TypeScript error? The relevant code is in src/api/client.ts

يقرأ النموذج رسالة الخطأ وتتبّع المكدس من لقطة الشاشة، وبالاستعانة بملف الشيفرة الذي تشير إليه، يقترح إصلاحًا.

3. مخطط معماري / رسم بياني للبيانات → الفهم والشرح¶

أعطِه مخططًا معماريًا أو مخطط تسلسل أو مخططًا انسيابيًا أو لوحة تحكم للمراقبة أو رسمًا بيانيًا للبيانات، واطلب منه أن يشرح أو يستخرج البيانات أو يكتب كودًا / وثائق انطلاقًا منه.

> Explain the data-flow diagram @diagrams/data-flow.png and draft an API doc based on it
> Read this monitoring screenshot @screenshots/latency.png — what's the p95 latency range? Any abnormal spikes?

أي النماذج يمكنها رؤية الصور¶

الرؤية خاصية في النموذج — وليست كل النماذج قادرة على قراءة الصور. النماذج القادرة على الرؤية المتاحة عبر QCode.cc:

قد لا تدعم النماذج الخفيفة المختصة بالنصوص / الشيفرة فقط إدخال الصور. إذا أرسلت صورة إلى نموذج غير قادر على الرؤية، فسيتم تجاهل الصورة أو سيحدث خطأ — اختر أحد النماذج أعلاه. لا تزال معرّفات الرؤية 4.x مثل claude-sonnet-4-6 وclaude-opus-4-8 معروضة للبيع. لتبديل النماذج، راجع اختيار النموذج.

ميزة QCode.cc: مفتاح API واحد بالبادئة cr_ يغطي كل البروتوكولات والنماذج. يعمل المفتاح نفسه مع نماذج رؤية Claude وGPT-5.x على حد سواء، مع إمكانية التبديل عند الطلب دون تغيير الحسابات. للاطلاع على نقاط النهاية ومسارات البروتوكول، راجع نقاط النهاية وصيغ API (على المستخدمين في الصين تفضيل asia.qcode.cc).

نصائح عملية¶

• حافظ على وضوح الصور: يؤدي انخفاض الدقة أو ضبابية النص إلى عدم قدرة النموذج على قراءته بدقة. استخدم النسخ الأصلية لنماذج التصميم ولقطات شاشة الأخطاء؛ ولا تبالغ في الضغط.
• لا تُكدّس عددًا كبيرًا من الصور دفعة واحدة: فالصور الأكثر والأكبر تستهلك مزيدًا من tokens وتجعل الالتزام بالموضوع أصعب. ركّز على صورة أو صورتين أساسيتين في المرة.
• وضّح مقصودك نصًا: اذكر بجانب الصورة ما تريد من النموذج أن يفعله («أعد إنتاجه في React»، «حدد سبب الخطأ»، «استخرج بيانات الجدول») — وهذا أفضل بكثير من إدراج صورة وحدها.
• احجب المعلومات الحساسة أولاً: أخفِ المفاتيح وtokens والعناوين الداخلية وبيانات المستخدمين وما إلى ذلك في لقطة الشاشة قبل إرسالها.
• استخدم المسارات في سيناريوهات الدُفعات: لمعالجة الصور في النصوص البرمجية / الأتمتة، تُعدّ «الإشارة إلى مسار ملف» هي النهج الأكثر قابلية للتحكم؛ وبالاقتران مع وضع headless في الأتمتة و CI/CD، يمكنك المعالجة على دفعات.

صيغ الصور وأحجامها وتكلفة token¶

حتى 2026-10-15، ووفقًا لوثائق الرؤية الرسمية من Anthropic (مرجع مفيد عند استخدامك Claude عبر QCode):

عمليًا: لا تلتقط لقطات شاشة أكبر من الحاجة. تُصغَّر لقطة الشاشة الكاملة بدقة 4K، لذا تضيف البكسلات الإضافية حجمًا إلى الرفع من دون تحسين الوضوح. والاقتصاص إلى المنطقة المهمة فعلاً أكثر دقة وأقل استهلاكًا لـ tokens من التقاط الشاشة كاملة.

إرفاق الصور في Claude Code¶

وفقًا لوثائق Claude Code، يمكنك سحب صورة إلى النافذة أو نسخها ولصقها باستخدام Ctrl+V (Alt+V على Windows وWSL، وCmd+V في iTerm2). تظهر علامة مثل [Image #1] في مربع الإدخال، ويمكنك الإشارة إليها برقمها في prompt.

الأخطاء الشائعة وكيفية استكشافها¶

الأسئلة الشائعة¶

هل يجب أن تكون لقطات الشاشة بصيغة PNG؟¶

لا. الصيغ JPEG وPNG وGIF وWebP مدعومة جميعها. أما لقطات شاشة الواجهات المكتظة بالنصوص فيُفضّل أن تكون بصيغة PNG حتى لا يطمس الضغطُ مع فقدان البيانات وضوحَ النص.

هل تُحتسب الصور برسوم إضافية؟¶

تُحتسب الصور ضمن tokens الإدخال ويُحاسَب عليها لكل token مع النص؛ وأسعار كل نموذج مدرجة في qcode.cc/models. وكلما كبرت الصورة زاد عدد tokens الرؤية التي تستهلكها، لذا اقتطعها قبل الإرسال.

هل يستطيع النموذج تحديد هوية من في الصورة؟¶

لا. تنص وثائق Anthropic على أنه لا يجوز استخدام Claude لتسمية الأشخاص في الصور، وأنه يرفض ذلك. أما وصف المشهد وقراءة النص وشرح المخططات فكلها تعمل.

كم عدد الصور التي يمكنني إرسالها في المرة الواحدة؟¶

تذكر وثائق Anthropic حدًّا في API قدره 100 صورة لكل طلب للنماذج ذات نافذة سياق بسعة 200K token و600 لسائر النماذج، لكن فوق 20 صورة يصبح حد الأبعاد أكثر صرامة، وقد يُبلَغ حد حجم الطلب أولًا. في الاستخدام اليومي، ركّز على صورة أو صورتين أساسيتين في المرة الواحدة.

الوثائق ذات الصلة¶

• توليد الصور بـ gpt-image-2 — توليد الصور / تعديلها (عكس «قراءة الصور» هنا)
• اختيار النموذج — اختر نموذجًا يدعم الرؤية
• نقاط النهاية وصيغ API — نقاط النهاية ومسارات البروتوكول وطرق الاختبار الذاتي
• الأتمتة وCI/CD — تغذية الصور على دفعات في النصوص البرمجية

باستخدام مفتاح API واحد من QCode.cc، استفد من نماذج الرؤية لدى Claude وقدرات GPT-5.x متعددة الوسائط، مع حصة مشتركة عبر كل نقطة نهاية. اطلع على الخطط والأسعار →

المؤسسات ←