DEV Community

Cover image for كيف تستخدم كلود سونيت 5 في كرسور
Yusuf Khalidd
Yusuf Khalidd

Posted on • Originally published at apidog.com

كيف تستخدم كلود سونيت 5 في كرسور

وصل Claude Sonnet 5 في 30 يونيو 2026، وهو مناسب جدًا لاستخدام Cursor اليومي: قراءة الملفات، تعديل التعليمات البرمجية، تشغيل الأوامر، ثم تكرار الدورة. تصفه Anthropic بأنه أقوى نموذج Sonnet لديها للعمل كوكيل حتى الآن، مع أداء قريب من Opus 4.8 في استخدام الأدوات وبسعر أقل. في هذا الدليل ستفعّل Sonnet 5 داخل Cursor، تختار بين نموذج Cursor المدمج أو مفتاح Anthropic API الخاص بك، وتستخدمه عمليًا في وضع الوكيل. للمزيد عن النموذج نفسه، اقرأ ما هو Claude Sonnet 5، وراجع الإعلان الرسمي من Anthropic.

جرّب Apidog اليوم

سترى أيضًا أين يتناسب Apidog: عندما يستخدم Cursor و Sonnet 5 لبناء API، يمكنك استخدام Apidog لإرسال الطلبات، حفظها، محاكاة الاستجابات، وتشغيل اختبارات آلية ضد نقاط النهاية.

لماذا يُعد Sonnet 5 خيارًا افتراضيًا جيدًا في Cursor

يعتمد وكيل Cursor على خطوات صغيرة متكررة:

  1. قراءة الملفات.
  2. فهم البنية الحالية.
  3. تعديل ملف أو أكثر.
  4. تشغيل أوامر الطرفية.
  5. مراجعة الأخطاء وإصلاحها.

هذا النوع من العمل هو بالضبط ما صُمم Sonnet 5 ليكون قويًا فيه.

Claude Sonnet 5 benchmarks

وفقًا لأرقام Anthropic عند الإطلاق:

المعيار Sonnet 5 Opus 4.8 Sonnet 4.6
SWE-bench Pro 63.2% 69.2% 58.1%
Terminal-Bench 2.1 80.4% 82.7% غير مذكور هنا
OSWorld-Verified 81.2% 83.4% غير مذكور هنا

هذه أرقام Anthropic المعلنة وليست اختبارات مستقلة. للتفاصيل الكاملة، راجع معايير Claude Sonnet 5.

الخلاصة العملية: في المهام التي تستخدم أدوات، يقترب Sonnet 5 كثيرًا من Opus 4.8. وبما أن Cursor يعمل غالبًا مع أدوات مثل قراءة الملفات وتشغيل الطرفية، تحصل على أداء قوي بتكلفة أقل.

من ناحية السعر، تكلفته القياسية هي:

  • 3 دولارات لكل مليون رمز إدخال.
  • 15 دولارًا لكل مليون رمز إخراج.

وتقدم Anthropic سعرًا تعريفيًا حتى 31 أغسطس 2026:

  • 2 دولار لكل مليون رمز إدخال.
  • 10 دولارات لكل مليون رمز إخراج.

مقارنةً بـ Opus 4.8:

  • 5 دولارات لكل مليون رمز إدخال.
  • 25 دولارًا لكل مليون رمز إخراج.

في جلسات Cursor الطويلة، هذا الفرق يظهر بسرعة.

طريقتان لاستخدام Sonnet 5 في Cursor

يدعم Cursor نماذج Claude مباشرة، كما يدعم BYOK، أي استخدام مفتاح API خاص بك من Anthropic. قد تختلف أسماء القوائم حسب إصدار Cursor، لكن التدفق العام واحد.

الخيار 1: اختيار Sonnet 5 من داخل Cursor

استخدم هذا الخيار إذا كانت خطة Cursor الخاصة بك تتضمن نماذج Claude.

الخطوات:

  1. افتح Cursor.
  2. افتح محدد النموذج من نافذة الدردشة أو Composer أو الإعدادات.
  3. ابحث عن Claude Sonnet 5.
  4. حدده كنموذج نشط.
  5. استخدمه في الدردشة، التحرير، أو وضع الوكيل.

إذا لم يظهر النموذج:

  1. حدّث Cursor إلى أحدث إصدار.
  2. أعد فتح التطبيق.
  3. تحقق من قائمة النماذج مرة أخرى.

لإعداد Cursor من البداية، راجع دليل إعداد Cursor.

الخيار 2: استخدام مفتاح Anthropic API الخاص بك

استخدم BYOK عندما تريد:

  • الفوترة عبر حساب Anthropic الخاص بك.
  • حدود استخدام مرتبطة بحسابك.
  • الوصول إلى نموذج غير موجود في خطة Cursor الخاصة بك.

الخطوات:

  1. افتح وحدة تحكم Claude.
  2. أنشئ مفتاح API من إعدادات مؤسستك.
  3. افتح إعدادات Cursor.
  4. ابحث عن قسم النماذج أو مفاتيح API.
  5. الصق مفتاح Anthropic في حقل المزود.
  6. احفظ الإعدادات.
  7. اختر Claude Sonnet 5 كنموذج نشط.

معرف النموذج في Anthropic API هو:

claude-sonnet-5
Enter fullscreen mode Exit fullscreen mode

عادةً لن تحتاج إلى كتابة هذا المعرف داخل واجهة Cursor، لكنه مهم إذا كنت تستدعي Anthropic API مباشرة من تطبيقك. راجع دليل API الخاص بـ Claude Sonnet 5 لمعرفة شكل الطلب والاستجابة.

نصيحة أمان مهمة: لا تضع مفتاح API داخل الكود أو Git. استخدم متغيرات البيئة:

export ANTHROPIC_API_KEY="your_api_key_here"
Enter fullscreen mode Exit fullscreen mode

أو استخدم مدير أسرار في بيئة التشغيل الخاصة بك.

ما الذي تغير داخليًا ولماذا يهم داخل Cursor

Sonnet 5 بديل مباشر لـ Sonnet 4.6 على مستوى API، لكن هناك تغييرات سلوكية يجب الانتباه لها.

1. التفكير التكيفي مفعّل افتراضيًا

في Sonnet 4.6، إذا لم ترسل الحقل thinking، كان الطلب يعمل بدون تفكير ممتد.

في Sonnet 5، يعمل الطلب نفسه مع التفكير التكيفي افتراضيًا.

داخل Cursor، هذا مفيد للمهام مثل:

  • إعادة هيكلة عدة ملفات.
  • فهم مشروع غير مألوف.
  • تتبع خطأ عبر طبقات متعددة.
  • التخطيط قبل تنفيذ تغييرات كبيرة.

لكن النتيجة العملية هي أن بعض الطلبات المعقدة قد تستغرق وقتًا أطول قليلًا وقد تستهلك رموز إخراج أكثر.

2. tokenizer جديد

يستخدم Sonnet 5 موزع رموز جديدًا. النص نفسه قد ينتج تقريبًا 30% رموزًا أكثر مقارنةً بـ Sonnet 4.6.

هذا لا يكسر شكل الطلبات أو الاستجابات، لكنه يؤثر على:

  • تقدير التكلفة.
  • طول السياق الفعلي.
  • حسابات الميزانية في جلسات Cursor الطويلة.

إذا كنت تقيس تكلفة استخدام Cursor أو BYOK، لا تعتمد على أرقام Sonnet 4.6 القديمة. أعد القياس باستخدام Sonnet 5.

3. قيود مهمة عند استخدام API مباشرة

إذا كنت تستدعي Anthropic API بنفسك، انتبه إلى أن:

  • التفكير الممتد اليدوي باستخدام budget_tokens يعيد خطأ 400.
  • تعيين temperature أو top_p أو top_k لقيم غير افتراضية يعيد خطأ 400.

بدلًا من ذلك، وجّه سلوك النموذج من خلال صياغة الطلب نفسه.

داخل Cursor، تُدار هذه التفاصيل عادةً من طرف Cursor، لذلك لن تواجه هذه الأخطاء إلا إذا كنت تبني تكاملًا مباشرًا مع API.

استخدام Sonnet 5 في وضع الوكيل داخل Cursor

وضع الوكيل هو أفضل حالة استخدام لـ Sonnet 5 في Cursor. يسمح للنموذج بقراءة المشروع، التخطيط، تعديل الملفات، تشغيل الأوامر، ثم التحقق من النتيجة.

للحصول على نتائج أفضل، استخدم هذا النمط:

1. اطلب النتيجة، لا الخطوات الدقيقة

بدلًا من:

افتح الملف X، ثم عدّل الدالة Y، ثم أضف هذا السطر...
Enter fullscreen mode Exit fullscreen mode

اكتب:

أضف endpoint لإنشاء طلب جديد في API. يجب أن يستقبل customerId و items، يتحقق من صحة البيانات، ويعيد JSON يحتوي على id و status. الملفات ذات الصلة موجودة في مجلد routes و app.js.
Enter fullscreen mode Exit fullscreen mode

هذا يعطي Sonnet 5 مساحة لقراءة البنية الحالية واختيار التعديل المناسب.

2. اجعله يخطط أولًا

استخدم طلبًا مثل:

اقرأ الملفات ذات الصلة أولًا، ثم اعرض خطة قصيرة قبل تعديل أي ملف.
Enter fullscreen mode Exit fullscreen mode

بعد الخطة، راجعها. إذا كانت خاطئة، صححها قبل أن يبدأ التعديل.

3. قسّم المهام الكبيرة

بدلًا من طلب واحد ضخم مثل:

ابنِ نظام الطلبات كاملًا مع المصادقة والاختبارات والتوثيق.
Enter fullscreen mode Exit fullscreen mode

قسّمه إلى مهام:

  1. إنشاء endpoint.
  2. إضافة validation.
  3. إضافة اختبارات.
  4. تحديث التوثيق.
  5. تشغيل الاختبارات وإصلاح الفشل.

المهام الأصغر تعطي diffs أوضح وتكلفة أقل.

4. راجع كل diff

حتى مع نموذج قوي، لا تدمج التغييرات تلقائيًا. راجع:

  • الملفات المعدلة.
  • أسماء الدوال.
  • معالجة الأخطاء.
  • الاختبارات.
  • أي تغيير غير مطلوب في النطاق.

مثال واقعي: بناء API ثم اختبارها

لنفترض أنك تريد من Cursor و Sonnet 5 إنشاء endpoint في Express لإنشاء طلب جديد.

مثال للكود الناتج:

// routes/orders.js
const express = require('express');
const router = express.Router();

router.post('/orders', (req, res) => {
  const { customerId, items } = req.body;

  if (!customerId || !Array.isArray(items) || items.length === 0) {
    return res.status(400).json({
      error: 'customerId and items are required',
    });
  }

  const order = {
    id: `order_${Date.now()}`,
    customerId,
    items,
    status: 'created',
  };

  return res.status(201).json(order);
});

module.exports = router;
Enter fullscreen mode Exit fullscreen mode

قد يربطه Cursor أيضًا داخل التطبيق:

const express = require('express');
const ordersRouter = require('./routes/orders');

const app = express();

app.use(express.json());
app.use('/api', ordersRouter);

module.exports = app;
Enter fullscreen mode Exit fullscreen mode

الآن لا يكفي أن يكون الكود موجودًا. تحتاج إلى اختبار endpoint بطلب حقيقي. هنا يأتي دور Apidog.

اختبار API في Apidog

داخل Apidog يمكنك تنفيذ الخطوات التالية:

  1. أنشئ طلبًا جديدًا.
  2. اختر method: POST.
  3. أدخل المسار: 
/api/orders
Enter fullscreen mode Exit fullscreen mode
  1. أضف جسم JSON: 
{
  "customerId": "cust_123",
  "items": [
    {
      "sku": "book_001",
      "quantity": 2
    }
  ]
}
Enter fullscreen mode Exit fullscreen mode
  1. أرسل الطلب.
  2. تحقق من أن الاستجابة ترجع 201.
  3. تحقق من شكل الاستجابة: 
{
  "id": "order_...",
  "customerId": "cust_123",
  "items": [
    {
      "sku": "book_001",
      "quantity": 2
    }
  ],
  "status": "created"
}
Enter fullscreen mode Exit fullscreen mode

يمكنك أيضًا إضافة assertions مثل:

  • status code يساوي 201.
  • الحقل status يساوي created.
  • الحقل id موجود.
  • الحقل items مصفوفة.

ثم احفظ الطلب داخل مجموعة ليعيد الفريق استخدامه، أو شغّل المجموعة في CI.

إذا كنت تنتقل من أدوات أخرى، راجع دليل اختبار واجهات برمجة التطبيقات بدون Postman. ويمكنك تنزيل Apidog لتجربة ذلك على endpoints الخاصة بك.

ملاحظات التكلفة والاستخدام

تتغير حدود Cursor وخططه بمرور الوقت، لذلك تحقق دائمًا من تفاصيل خطتك الحالية. لكن هذه القواعد مفيدة غالبًا:

  • استخدم Sonnet 5 كخيار افتراضي للترميز اليومي.
  • انتبه إلى أن التفكير التكيفي قد يزيد رموز الإخراج في المهام الصعبة.
  • لا تستخدم تقديرات Sonnet 4.6 القديمة كما هي، لأن tokenizer في Sonnet 5 ينتج رموزًا أكثر لنفس النص.
  • إذا كنت تستخدم BYOK، ففاتورة Anthropic ستعكس الاستخدام الفعلي حسب أسعار Anthropic.
  • للمهام الصغيرة، قسّم العمل بدلًا من إرسال سياق ضخم غير ضروري.

لاختيار نموذج مناسب داخل Cursor، راجع مقارنة أفضل نموذج Cursor.

متى تستخدم Sonnet 5 ومتى تنتقل إلى Opus 4.8

استخدم Sonnet 5 لمعظم أعمال Cursor:

  • بناء features.
  • إعادة الهيكلة.
  • كتابة الاختبارات.
  • إصلاح أخطاء واضحة.
  • قراءة وتعديل عدة ملفات.
  • تشغيل الأوامر والتحقق من النتائج.

انتقل إلى Opus 4.8 عندما تكون المهمة أصعب من المعتاد، مثل:

  • قرار معماري معقد.
  • تصحيح خطأ يحتاج استدلالًا عميقًا.
  • تحليل قاعدة كود كبيرة جدًا.
  • مهمة طويلة حيث الجودة أهم من التكلفة.
  • عندما يفشل Sonnet 5 بعد محاولة أو محاولتين واضحتين.

في الاستدلال الخالص بدون أدوات، يتفوق Opus 4.8 على Sonnet 5 بحوالي ست نقاط في المعايير المعلنة. لكن داخل Cursor، لأن الأدوات جزء أساسي من التدفق، يكون Sonnet 5 عادةً الخيار الأفضل من حيث القيمة.

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

هل Claude Sonnet 5 متاح في Cursor؟

يدعم Cursor نماذج Claude من Anthropic، ومن المفترض أن يظهر Sonnet 5 في محدد النموذج عندما يدعمه إصدار Cursor الخاص بك. إذا لم يظهر، حدّث Cursor. يمكنك أيضًا استخدامه عبر BYOK بمفتاح Anthropic API.

هل أحتاج إلى مفتاح API لاستخدام Sonnet 5 في Cursor؟

ليس دائمًا. إذا كانت خطة Cursor الخاصة بك تتضمن نماذج Claude، يمكنك تحديد Sonnet 5 مباشرة. استخدم BYOK إذا أردت الفوترة عبر حساب Anthropic الخاص بك أو تحكمًا مباشرًا في الحدود. راجع دليل API الخاص بـ Claude Sonnet 5.

هل Sonnet 5 أم Opus 4.8 أفضل للترميز في Cursor؟

لمعظم أعمال Cursor، يقدم Sonnet 5 قيمة أفضل لأنه يقترب من Opus 4.8 في الترميز الوكيلي بسعر أقل. استخدم Opus 4.8 للمهام الاستدلالية الأصعب. راجع مقارنة Sonnet 5 vs Opus 4.8.

لماذا يبدو أن Sonnet 5 يستخدم رموزًا أكثر من Sonnet 4.6؟

لأنه يستخدم tokenizer جديدًا ينتج تقريبًا 30% رموزًا أكثر لنفس النص. السعر لكل رمز لم يتغير مقارنةً بـ Sonnet 4.6، لكن الطلبات المكافئة قد تكلف أكثر بسبب عدد الرموز الأكبر.

هل يمكنني استخدام Sonnet 5 في Cursor مجانًا؟

يعتمد ذلك على خطة Cursor، وليس فقط على توفر Sonnet 5 في Claude. تحقق من تفاصيل خطة Cursor الحالية لمعرفة النماذج والحدود المتاحة لك.

Top comments (0)