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

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

ما هو Context7 ولماذا هو مهم؟

إليك مشكلة واجهها كل مطور يستخدم أدوات البرمجة بالذكاء الاصطناعي: تطلب من مساعدك كتابة كود باستخدام مكتبة تعرفها جيدًا، فيعطيك شيئًا يبدو صحيحًا ولكنه يستخدم واجهات برمجة تطبيقات لم تعد موجودة. تواقيع الوظائف خاطئة. تغيرت مسارات الاستيراد منذ إصدارين رئيسيين. المثال يعمل في الوثائق للإصدار 12، ولكنك تستخدم الإصدار 15.

يحدث هذا لأن نماذج اللغة الكبيرة (LLMs) يتم تدريبها على بيانات لها تاريخ قطع. إنها لا تعرف ما الذي تغير الشهر الماضي. إنها لا تعرف أن Next.js 15 أعاد تصميم طريقة عمل التخطيطات، أو أن مكتبة تعتمد عليها ألغت نصف واجهة برمجة تطبيقاتها منذ لقطة التدريب.

Context7 يحل هذه المشكلة. إنها منصة بناها Upstash تقوم بفهرسة وثائق أكثر من 9,000 مكتبة وتقديمها لمساعدك الذكاء الاصطناعي في الوقت الفعلي. عندما تسأل وكيل البرمجة الخاص بك سؤالاً، يقوم Context7 بجلب الوثائق الحالية والمحددة للإصدار ويضعها في نافذة السياق قبل أن يقوم النموذج بإنشاء استجابته.

النتيجة: تتوقف أداة البرمجة بالذكاء الاصطناعي عن هلوسة واجهات برمجة التطبيقات وتبدأ في إنتاج تعليمات برمجية تتوافق مع ما تقوم به المكتبة بالفعل اليوم.

ctx7 CLI هي واجهة سطر الأوامر لـ Context7. تقوم بثلاثة أمور:

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

تثبيت ctx7

المتطلب الوحيد هو Node.js 18 أو أحدث. تحقق من إصدارك باستخدام node --version.

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

أسرع طريقة لتجربة ctx7 هي باستخدام npx:

npx ctx7 --help
npx ctx7 library react

يسحب هذا أحدث إصدار في كل مرة تقوم بتشغيله. وهو جيد للاستخدام العرضي.

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

للاستخدام المنتظم، قم بالتثبيت عالميًا:

npm install -g ctx7
ctx7 --version

بعد ذلك، يتم تشغيل كل أمر ctx7 محليًا دون عبء npx الزائد.

إعداد Context7 لوكيل البرمجة بالذكاء الاصطناعي الخاص بك

يربط الأمر ctx7 setup Context7 ببيئة البرمجة بالذكاء الاصطناعي الخاصة بك. يقوم بالمصادقة عبر OAuth، وينشئ مفتاح API، ويكتب التكوين في المكان الصحيح.

إعداد تفاعلي

ctx7 setup

يطالبك هذا باختيار وكيلك ووضعك المفضل (CLI + Skills مقابل MCP). إذا كنت ترغب في تخطي المطالبات:

ctx7 setup --yes

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

ctx7 setup --claude     # Claude Code (~/.claude/skills أو تكوين MCP)
ctx7 setup --cursor     # Cursor (~/.cursor/skills أو تكوين MCP)
ctx7 setup --opencode   # OpenCode

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

إذا كان لديك بالفعل مفتاح API لـ Context7 من context7.com/dashboard:

ctx7 setup --api-key YOUR_API_KEY

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

افتراضيًا، يقوم ctx7 setup بالتثبيت عالميًا. للتكوين للمشروع الحالي فقط:

ctx7 setup --project

وضعَان: واجهة سطر الأوامر (CLI) + المهارات مقابل بروتوكول سياق النموذج (MCP)

وضع واجهة سطر الأوامر (CLI) + المهارات يقوم بتثبيت ملف SKILL.md يخبر وكيل الذكاء الاصطناعي الخاص بك بجلب الوثائق عن طريق تشغيل أوامر ctx7 CLI. يقرأ وكيلك تعليمات المهارة ويقوم بتشغيل ctx7 library و ctx7 docs تلقائيًا عندما يحتاج إلى وثائق المكتبة. لا يلزم وجود خادم MCP.

ctx7 setup --cli --claude    # يثبت المهارة في ~/.claude/skills
ctx7 setup --cli --cursor    # يثبت المهارة في ~/.cursor/skills
ctx7 setup --cli --universal # يثبت في ~/.config/agents/skills

وضع خادم بروتوكول سياق النموذج (MCP) يسجل Context7 كخادم بروتوكول سياق النموذج. يقوم وكيلك باستدعاء أدوات resolve-library-id و query-docs بشكل أصلي دون تشغيل أي أوامر CLI. جلب الوثائق يكون غير مرئي.

لوضع MCP، يبدو التكوين كالتالي (أضفه إلى إعدادات MCP في محرر نصوصك):

{
  "url": "https://mcp.context7.com/mcp",
  "headers": {
    "CONTEXT7_API_KEY": "YOUR_API_KEY"
  }
}

أو أضفه إلى Claude Code عبر واجهة سطر الأوامر (CLI):

claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

المصادقة

ctx7 login    # تسجيل دخول متصفح OAuth
ctx7 whoami   # تأكيد هوية المستخدم الذي قمت بتسجيل الدخول به
ctx7 logout   # إزالة بيانات الاعتماد المخزنة

يمكنك أيضًا تعيين مفتاح API كمتغير بيئة:

export CONTEXT7_API_KEY=your_key_here

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

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

يجمع Context7 بيانات الاستخدام المجهولة افتراضيًا. لتعطيلها:

export CTX7_TELEMETRY_DISABLED=1

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

حتى بدون وكيل ذكاء اصطناعي في العملية، فإن ctx7 مفيد كأداة بحث عن الوثائق قائمة بذاتها. يقوم أمران بالعمل الشاق.

حل اسم مكتبة

ctx7 library react
ctx7 library nextjs "app router setup"
ctx7 library prisma "database relations"
ctx7 library express --json   # مخرجات JSON

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

مثال على الإخراج لـ ctx7 library nextjs:

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

جلب الوثائق

بمجرد حصولك على معرف المكتبة، قم بتمريره إلى ctx7 docs جنبًا إلى جنب مع استعلام موضوع:

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

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

إذا كنت تعرف معرف المكتبة بالفعل، يمكنك تخطي ctx7 library والذهاب مباشرة إلى ctx7 docs.

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

المهارات هي ملفات SKILL.md تمنح وكيل الذكاء الاصطناعي الخاص بك معرفة أو سلوكًا متخصصًا. فكر فيها كأدلة تعليمات صغيرة يقرأها وكيلك قبل معالجة نوع معين من المهام.

يستضيف Context7 سجلًا للمهارات التي يساهم بها المجتمع. يمكنك البحث فيه، وتثبيت المهارات في بيئة وكيلك، وإنشاء مهارات مخصصة، وإزالة ما لا تحتاجه.

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

ctx7 skills search pdf
ctx7 skills search "stripe payments"
ctx7 skills search "react testing"

تثبيت مهارة

ctx7 skills install /anthropics/skills pdf
ctx7 skills install /anthropics/skills pdf --cursor   # التثبيت لـ Cursor على وجه التحديد
ctx7 skills install /anthropics/skills pdf --claude   # التثبيت لـ Claude Code

عند التثبيت عالميًا (--global)، تكون المهارة متاحة عبر جميع مشاريعك:

ctx7 skills install /anthropics/skills pdf --global

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

يقوم ctx7 skills suggest بفحص دليل مشروعك، ويكتشف المكتبات والأطر التي تستخدمها، ويوصي بالمهارات ذات الصلة:

ctx7 skills suggest

يعمل هذا جيدًا عندما تبدأ مشروعًا جديدًا وترغب في تزويد وكيلك بالمعرفة ذات الصلة مقدمًا.

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

ctx7 skills list              # جميع المهارات المثبتة
ctx7 skills list --claude     # المهارات المثبتة لـ Claude Code فقط
ctx7 skills list --cursor     # مهارات Cursor فقط

إزالة مهارة

ctx7 skills remove pdf

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

هذه هي أقوى ميزة. باستخدام حساب مدفوع، يمكنك إنشاء مهارة مخصصة من أي مكتبة في فهرس Context7:

ctx7 login
ctx7 skills generate

توجهك واجهة سطر الأوامر (CLI) عبر مطالبة تفاعلية: اختر مكتبة، صف ما تريد أن تعلمه المهارة لوكيلك، ويقوم Context7 بإنشاء ملف SKILL.md مخصص لوثائق تلك المكتبة الحالية.

المهارات التي تم إنشاؤها قابلة للنقل. يتوافق تنسيق SKILL.md مع معيار مهارات الوكيل، مما يعني أن المهارة التي تنشئها لـ Claude Code تعمل دون تغيير في Cursor، VS Code Copilot، OpenCode، وأي أداة أخرى متوافقة مع مهارات الوكيل.

تحصل الحسابات المجانية على 6 عمليات إنشاء مهارات أسبوعيًا. تحصل الحسابات الاحترافية على 10.

اختصارات الأوامر (Aliases) للكتابة الأسرع:

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

بمجرد إعداد 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

Set up a Prisma schema with user and post models and a one-to-many relation. use context7

How do I configure the App Router layout in Next.js 15? use context7

يستدعي الوكيل أدوات Context7 resolve-library-id و query-docs تلقائيًا، ويجلب الوثائق الحالية، ويستخدمها كأساس لاستجابته.

الإشارة إلى مكتبة معينة

إذا كان أمرك يتضمن مكتبات متعددة وتريد أن يركز Context7 على واحدة:

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

هذا يتخطى خطوة مطابقة المكتبة وينتقل مباشرة إلى الوثائق.

الاستدعاء التلقائي بدون كتابة "use context7"

أضف قاعدة إلى وكيل الذكاء الاصطناعي الخاص بك بحيث يجلب الوثائق تلقائيًا كلما تعامل مع كود مكتبة. في Claude Code، أضف إلى ملف CLAUDE.md الخاص بك:

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

في Cursor، أضف إلى الإعدادات > قواعد للذكاء الاصطناعي:

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

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

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

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

إليك كيف يكملان بعضهما البعض في سير عمل حقيقي:

أنت تبني تطبيق Next.js يستدعي واجهة برمجة تطبيقات (API) لطرف ثالث. يوفر Context7 لوكيل الذكاء الاصطناعي الخاص بك وثائق Next.js الحالية لتكون اقتراحات التعليمات البرمجية صحيحة. يتيح لك Apidog اختبار واجهة برمجة التطبيقات التابعة لجهة خارجية مباشرة، والتحقق من هيكل الاستجابة، والتأكد من أن البيانات التي يرسلها رمزك تتطابق مع ما تتوقعه واجهة برمجة التطبيقات.

أنت تدمج مكتبة جديدة لها واجهة برمجة تطبيقات HTTP خاصة بها. يوفر Context7 لوكيلك وثائق SDK الحالية للمكتبة. يتيح لك Apidog اختبار نقاط نهاية واجهة برمجة التطبيقات الخام لفهم السلوك على مستوى HTTP قبل كتابة أي رمز للتطبيق.

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

قم بإعداد بيئة في Apidog مع تخزين مفاتيح API الخاصة بك كمتغيرات، والتبديل بين التطوير والإنتاج بنقرة واحدة، وتشغيل تأكيدات الاختبار على كل استجابة. Context7 + Apidog يمنحك كل من الوثائق الحالية وسلوك API المتحقق منه.

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

ctx7 CLI مجاني للاستخدام. تعتمد حدود المعدل والوصول إلى الميزات على خطة Context7 الخاصة بك:

ملاحظات الطبقة المجانية:

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

قيود هامة: يقوم Context7 بتوجيه جميع الاستعلامات عبر خوادم Upstash. لا يوجد وضع عدم اتصال بالإنترنت. إذا كنت في بيئة لا تتوفر فيها خدمة الإنترنت، فلن تعمل الأداة. يمكن أن تكون استجابات الوثائق كبيرة أيضًا، مما يستهلك جزءًا من نافذة سياق نموذج اللغة الكبير (LLM) الخاص بك. في المشاريع المعقدة التي تحتوي على العديد من استعلامات المكتبة، يتراكم هذا.

احصل على مفتاح API مجاني من context7.com/dashboard. يمنحك مفتاح API حدود معدل أعلى من الطلبات غير المصادق عليها.

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

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

لا. يتم إرسال اسم المكتبة ونص الاستعلام فقط إلى خوادم Context7، وليس الكود الخاص بك، أو سجل المحادثات، أو أي بيانات حساسة. يبقى الكود الخاص بك مع مزود LLM الخاص بك.

ما هي المكتبات التي يدعمها Context7؟

يغطي الفهرس أكثر من 9,000 مكتبة وإطار عمل عام. يمكنك البحث في الفهرس على context7.com للتحقق مما إذا كانت مكتبة معينة متاحة. يمكن تقديم مكتبات جديدة عبر /add-library في واجهة Context7.

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

يتم إعادة فهرسة المكتبات بشكل دوري. قد لا تكون الإصدارات الحديثة جدًا (خلال الأيام القليلة الماضية) متاحة بعد. بالنسبة للمكتبات المستقرة، تكون الوثائق عادة محدثة بأحدث إصدار.

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

يعمل الاستخدام الأساسي بدون مفتاح API ولكن بحدود معدل أقل. للاستخدام المنتظم، سجل في context7.com وقم بتعيين CONTEXT7_API_KEY للحصول على إنتاجية أفضل.

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

يعمل Context7 مع Claude Code و Cursor و OpenCode و VS Code Copilot و Windsurf و Claude Desktop وأي عميل آخر يدعم MCP أو معيار Agent Skills.

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

في وضع CLI + Skills، يخبر ملف مهارة وكيلك بتشغيل أوامر ctx7 صراحةً عندما يحتاج إلى وثائق. في وضع MCP، يستدعي وكيلك أدوات Context7 بشكل أصلي عبر بروتوكول MCP. وضع MCP أكثر شفافية للمستخدم ولا يتطلب أي مطالبة صريحة بـ "use context7" بمجرد التكوين.

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

نعم. تعمل ctx7 library و ctx7 docs كأوامر طرفية مستقلة. يمكنك البحث عن وثائق المكتبة مباشرة دون أي وكيل ذكاء اصطناعي.

مصادر إضافية

• مستودع Context7 على GitHub
• وثائق Context7
• وثائق واجهة سطر الأوامر (CLI)
• الخطط والتسعير
• لوحة تحكم مفتاح API
• عميل Apidog المجاني لواجهة برمجة التطبيقات