DEV Community

Cover image for كيفية تثبيت واستخدام واجهة سطر الأوامر Context7
Yusuf Khalidd
Yusuf Khalidd

Posted on • Originally published at apidog.com

كيفية تثبيت واستخدام واجهة سطر الأوامر Context7

كونتكست7 هي منصة متقدمة تتيح لك حقن وثائق أحدث مكتبات البرمجيات مباشرة في سياق مساعدك الذكي، لتجنب مشاكل الكود القديم أو التوثيق غير المتزامن مع إصدارات المكتبات الفعلية. باستخدام واجهة الأوامر ctx7 عبر npx ctx7، يمكنك الربط بسهولة مع Claude Code أو Cursor أو OpenCode من خلال أمر إعداد واحد فقط.

جرّب Apidog اليوم

ما هو Context7 ولماذا تحتاجه؟

المطورون الذين يعتمدون على أدوات البرمجة بالذكاء الاصطناعي غالبًا ما يواجهون مشكلة "هلوسة" الكود: يقترح المساعد كودًا يعتمد على تواقيع أو واجهات APIs لم تعد موجودة أو تغيرت. السبب أن النماذج اللغوية الكبيرة (LLMs) لا تدرك تحديثات المكتبات بعد تاريخ تدريبها.

يحل Context7 هذه المشكلة عن طريق فهرسة وثائق أكثر من 9000 مكتبة ويحقنها في نافذة السياق لوكيلك البرمجي في الوقت الفعلي. عندما تطلب من وكيلك تنفيذ مهمة، يقوم Context7 بجلب التوثيق المناسب للإصدار الذي تعمل عليه ويضيفه للسياق قبل أن يتم توليد الكود.

مع النتيجة: الكود الناتج يعكس الواقع الحالي للمكتبة، وليس ما كان في وثائق قديمة.

مميزات سريعة لـ CLI ctx7

  • جلب وثائق المكتبة مباشرة من الطرفية.
  • إدارة مهارات الذكاء الاصطناعي (ملفات SKILL.md قابلة لإعادة الاستخدام).
  • تكوين خادم MCP لـ Context7 لربطه مع Claude Code أو Cursor أو OpenCode.

💡Apidog هو عميل مجاني لاختبار وتنظيم وأتمتة واجهات برمجة التطبيقات (API). يمكنك استخدامه بجانب Context7 لتوثيق حديث وتحقيق اختبارات API فعلية لتكامل أكثر ثقة.

تثبيت ctx7

المتطلبات: Node.js 18 أو أحدث. تحقق من إصدارك:

node --version
Enter fullscreen mode Exit fullscreen mode

التشغيل بدون تثبيت

ابدأ فورًا باستخدام npx (لا حاجة للتثبيت):

npx ctx7 --help
npx ctx7 library react
Enter fullscreen mode Exit fullscreen mode

كل تشغيل يجلب آخر إصدار. مناسب للاستخدام السريع والمؤقت.

التثبيت عالميًا

للاستخدام اليومي:

npm install -g ctx7
ctx7 --version
Enter fullscreen mode Exit fullscreen mode

الآن كل أوامر ctx7 تعمل محليًا.

إعداد Context7 مع وكيل الذكاء الاصطناعي

اربط Context7 مع وكيلك عبر:

ctx7 setup
Enter fullscreen mode Exit fullscreen mode

سيتم المصادقة عبر OAuth، إنشاء مفتاح API وكتابة التكوين تلقائيًا.

إعداد تفاعلي 

ctx7 setup
Enter fullscreen mode Exit fullscreen mode

اتبع التعليمات لاختيار وكيلك والوضع المناسب. لتخطي المطالبات:

ctx7 setup --yes
Enter fullscreen mode Exit fullscreen mode

استهداف وكيل معيّن 

ctx7 setup --claude     # Claude Code
ctx7 setup --cursor     # Cursor
ctx7 setup --opencode   # OpenCode
Enter fullscreen mode Exit fullscreen mode

استخدام مفتاح API موجود

احصل على مفتاحك من لوحة التحكم:

ctx7 setup --api-key YOUR_API_KEY
Enter fullscreen mode Exit fullscreen mode

إعداد على مستوى المشروع فقط 

ctx7 setup --project
Enter fullscreen mode Exit fullscreen mode

أوضاع CLI + Skills و MCP

وضع CLI + Skills

تثبيت ملف SKILL.md لوكيلك ليقوم تلقائيًا بتشغيل أوامر ctx7 عند الحاجة للوثائق:

ctx7 setup --cli --claude
ctx7 setup --cli --cursor
ctx7 setup --cli --universal
Enter fullscreen mode Exit fullscreen mode

وضع MCP (Model Context Protocol)

يسجل Context7 كخادم MCP. الوكيل يستدعي الأدوات مباشرة دون الحاجة لتشغيل CLI:

{
  "url": "https://mcp.context7.com/mcp",
  "headers": {
    "CONTEXT7_API_KEY": "YOUR_API_KEY"
  }
}
Enter fullscreen mode Exit fullscreen mode

أو لClaude عبر CLI:

claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY
Enter fullscreen mode Exit fullscreen mode

المصادقة 

ctx7 login    # تسجيل دخول OAuth
ctx7 whoami   # تحقق من المستخدم الحالي
ctx7 logout   # تسجيل خروج
Enter fullscreen mode Exit fullscreen mode

أو استخدم متغير البيئة:

export CONTEXT7_API_KEY=your_key_here
Enter fullscreen mode Exit fullscreen mode

ملاحظة: البحث الأساسي للوثائق لا يتطلب تسجيل الدخول.

تعطيل القياس عن بُعد (Telemetry) 

export CTX7_TELEMETRY_DISABLED=1
Enter fullscreen mode Exit fullscreen mode

جلب وثائق المكتبة عبر الطرفية

استخدم ctx7 كأداة بحث وثائق قوية مباشرة من الطرفية.

البحث عن مكتبة 

ctx7 library react
ctx7 library nextjs "app router setup"
ctx7 library prisma "database relations"
ctx7 library express --json
Enter fullscreen mode Exit fullscreen mode

يعرض المعرف الكنسي والبيانات الوصفية:

المكتبة: /vercel/next.js
قصاصات: 4,820
السمعة: high
الإصدار: 15.2.0
Enter fullscreen mode Exit fullscreen mode

جلب الوثائق

بمجرد معرفة معرف المكتبة:

ctx7 docs /facebook/react "useEffect cleanup"
ctx7 docs /vercel/next.js "middleware authentication"
ctx7 docs /prisma/prisma "one-to-many relations"
ctx7 docs /facebook/react "hooks" --json
Enter fullscreen mode Exit fullscreen mode

الإخراج: مقتطفات وثائق حديثة ومناسبة لاستعلامك.

إدارة مهارات الذكاء الاصطناعي

المهارات هي ملفات SKILL.md تضيف معرفة أو سلوك متخصص لوكيلك.

البحث عن مهارات 

ctx7 skills search pdf
ctx7 skills search "stripe payments"
ctx7 skills search "react testing"
Enter fullscreen mode Exit fullscreen mode

تثبيت مهارة 

ctx7 skills install /anthropics/skills pdf
ctx7 skills install /anthropics/skills pdf --cursor
ctx7 skills install /anthropics/skills pdf --claude
ctx7 skills install /anthropics/skills pdf --global
Enter fullscreen mode Exit fullscreen mode

اقتراح مهارات بناءً على مشروعك 

ctx7 skills suggest
Enter fullscreen mode Exit fullscreen mode

عرض المهارات المثبتة 

ctx7 skills list
ctx7 skills list --claude
ctx7 skills list --cursor
Enter fullscreen mode Exit fullscreen mode

إزالة مهارة 

ctx7 skills remove pdf
Enter fullscreen mode Exit fullscreen mode

إنشاء مهارة مخصصة بالذكاء الاصطناعي

تحتاج حساب مدفوع:

ctx7 login
ctx7 skills generate
Enter fullscreen mode Exit fullscreen mode

اتبع التوجيهات لاختيار المكتبة وتحديد المطلوب من المهارة. تنشئ أداة CLI ملف SKILL.md مخصص وحديث.

اختصارات الأوامر

الأمر الكامل الاسم المختصر
ctx7 skills install ctx7 si
ctx7 skills search ctx7 ss
ctx7 skills generate ctx7 skills gen أو ctx7 skills g

استخدام Context7 داخل أوامر الذكاء الاصطناعي

نمط "use context7"

في وضع MCP، ببساطة أضف "use context7" لأمرك ليجلب أحدث الوثائق:

Create a Next.js middleware that checks for a valid JWT in cookies and redirects
unauthenticated users to /login. use context7
Enter fullscreen mode Exit fullscreen mode

استهداف مكتبة بعينها 

Implement Supabase authentication in a Next.js app.
use library /supabase/supabase for Supabase and /vercel/next.js for Next.js routing.
Enter fullscreen mode Exit fullscreen mode

الاستدعاء التلقائي

أضف قاعدة دائمة في إعدادات وكيلك لجلب وثائق مع كل كود مكتبة، مثلاً في Claude Code أضف لـ CLAUDE.md:

استخدم دائمًا أدوات Context7 MCP عند إنشاء كود يستخدم مكتبات طرف ثالث.
قم بحل معرف المكتبة وجلب الوثائق الحالية قبل كتابة أي تنفيذ.
افعل هذا دون انتظار مني أن أطلب.
Enter fullscreen mode Exit fullscreen mode

وفي Cursor، ضمن الإعدادات:

عند كتابة كود يستخدم مكتبات أو أطر عمل خارجية، استدعِ Context7 دائمًا لجلب الوثائق الحالية قبل إنشاء التنفيذ.
Enter fullscreen mode Exit fullscreen mode

اقْرنه مع Apidog لاختبار واجهات API بثقة

Context7 يضمن أن مساعدك البرمجي مطلع على أحدث وثائق المكتبات، لكنك تحتاج أيضًا لاختبار مكالمات HTTP فعليًا.

Apidog يغطي هذا الجانب. هو عميل مجاني لإرسال الطلبات، فحص الاستجابات، إعداد بيئات، وأتمتة الاختبارات.

سير عمل متكامل:

  • Context7 يوفر لوكيلك وثائق حديثة (مثلاً Next.js).
  • Apidog يسمح لك باختبار نقاط نهاية الـ API التي يتعامل معها كودك.
  • يمكنك إعداد متغيرات بيئة، تبديل بين production/dev، والتأكد من صحة كل استجابة.

التسعير وحدود الاستخدام

CLI مجانية. حدود الاستخدام تعتمد على خطتك في Context7:

الخطة السعر استدعاءات API/شهر حد المعدل المستودعات الخاصة
مجاني $0 1,000 60 طلب/ساعة لا
احترافي $7/مقعد/شهر 5,000/مقعد 60/ساعة/مقعد نعم (15$/مليون رمز)
مؤسسي مخصص مخصص مخصص نعم (25$/مليون رمز)

ملاحظات:

  • عند بلوغ الحد الشهري، تحصل على 20 طلب إضافي يوميًا حتى إعادة تعيين الشهر.
  • الوصول إلى المستودعات الخاصة يتطلب خطة Pro أو أعلى.
  • إنشاء المهارات: 6/أسبوع للخطة المجانية، 10/أسبوع للاحترافية.
  • خطة Pro تدعم حتى 20 عضو.
  • لا يوجد وضع أوفلاين. يجب توفر الإنترنت.

احصل على مفتاح API مجاني من context7.com/dashboard.

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

هل يرسل Context7 الكود الخاص بي إلى الخوادم؟

لا. فقط اسم المكتبة ونص الاستفسار يتم إرساله وليس الكود أو المحادثة أو أي بيانات حساسة.

ما المكتبات المدعومة؟

أكثر من 9000 مكتبة وإطار عمل. ابحث عن مكتبتك على context7.com.

ما مدى حداثة الوثائق؟

يتم إعادة الفهرسة باستمرار. الإصدارات الحديثة جدًا قد تتأخر قليلاً.

هل يعمل بدون مفتاح API؟

نعم، لكن مع حد أقل. لمعدل أعلى استخدم مفتاح API.

ما المحررات والوكلاء المدعومة؟

Claude Code، Cursor، OpenCode، VS Code Copilot، Windsurf، Claude Desktop، وأي عميل يدعم MCP أو Agent Skills.

ما الفرق بين CLI + Skills و MCP؟

  • CLI + Skills: يحتاج الوكيل لتشغيل أوامر ctx7 صراحة.
  • MCP: الوكيل يتفاعل مع الأدوات مباشرة دون تدخل المستخدم.

هل يمكن استخدام ctx7 بدون وكيل ذكاء اصطناعي؟

نعم، استخدم ctx7 library و ctx7 docs مباشرة من الطرفية.

مصادر إضافية

Top comments (0)