DEV Community

Cover image for إضافة Postman لـ Claude Code مقابل Apidog CLI: أيهما يجب أن يستخدم وكيلك الذكي؟
Yusuf Khalidd
Yusuf Khalidd

Posted on Originally published at apidog.com

إضافة Postman لـ Claude Code مقابل Apidog CLI: أيهما يجب أن يستخدم وكيلك الذكي؟

تحلّ إضافة Postman لـ Claude Code وأداة Apidog CLI المشكلة نفسها: فهي تزوّد وكيل البرمجة لديك بأدوات API حقيقية حتى يتوقف عن التخمين في نقاط النهاية (endpoints). اختر إضافة Postman إذا كان فريقك يعمل بالفعل داخل مساحات عمل Postman ويريد تفعيل Context Graph أو Secret Scanner في سير العمل. اختر Apidog CLI إذا أردت أداة سطر أوامر واحدة جاهزة للوكلاء تعمل مع مختلف الوكلاء، وتتحقق من صحة كل عملية كتابة قبل وصولها إلى الخادم، وتمنح فريقًا يصل إلى 4 أفراد خطة مجانية.

جرّب Apidog اليوم

ما هي إضافة Postman لـ Claude Code؟

إضافة Postman لـ Claude Code هي مجموعة من المهارات (skills) تجعل Claude Code يشغّل واجهة Postman CLI الحقيقية في كل مرحلة من مراحل العمل على API: الاستكشاف، التصميم، المحاكاة (mock)، الاختبار، التوثيق، ووضع الحواجز (gating). تُوزَّع عبر متجر الإضافات الرسمي من Anthropic، وتوجّه مهارة api-engineer كل طلب إلى المهارة المتخصصة المناسبة.

وفقًا لـالدليل العملي من Postman، المنشور في 9 نوفمبر 2026، يتم تثبيتها بأمرين:

claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install postman@claude-plugins-official
Enter fullscreen mode Exit fullscreen mode

تثبّت مهارة bootstrap واجهة Postman CLI في المرة الأولى التي يحتاجها فيها Claude. تحتاج إلى Claude Code وNode.js 18 أو أحدث وحساب على Postman؛ ويذكر الدليل أن الخطة المجانية تكفي، وأن الأوامر المحلية مثل الفحص (linting) والمحاكاة وتشغيل المجموعات لا تتطلب تسجيل الدخول.

قائمة المهارات واسعة:

المهارة ماذا تفعل
bootstrap تبحث عن واجهة CLI، وتصادق، وتربط المستودع بمساحة عمل
api-discovery تبحث في مساحات العمل، وتجد واجهات API عامة عبر Orbit، وتستعلم من Context Graph
api-mocking تنشئ وتشغّل محاكاة (mocks) من مواصفة أو مجموعة
api-testing تشغّل الطلبات والمجموعات مع تأكيدات pm.test
api-documentation تنشئ توثيقًا مناسبًا للوكلاء
ai-readiness تقيّم مدى صلاحية المواصفة للاستخدام من قِبل الوكلاء
ci-integration تضيف حواجز فحص واختبار وجاهزية إلى CI

يذكّر خطاف SessionStart كلود عند كل تشغيل، بشكل واضح ومختصر، بإرسال أعمال API عبر api-engineer، حتى لا ينسى الوكل الأدوات في منتصف الجلسة.

كيف توجّه إضافة Postman عمل الوكيل لديك

تفضّل الإضافة واجهة CLI المحلية. يوضح شرح تسريب بيانات الاعتماد من Postman (بتاريخ 10 نوفمبر 2026) ذلك بجلاء: ترسل الإضافة الطلبات إلى Postman CLI متى كانت الواجهة قادرة على تنفيذها، وتعود إلى خادم Postman MCP المستضاف على mcp.postman.com فقط للمهام التي لا تدعمها الواجهة. في الإصدارات التي تم اختبارها، كانت تلك المهام هي Secret Scanner وسجلات التدقيق وأدوار المجموعات.

Diagram of how the Postman plugin for Claude Code routes work

ثلاثة أمثلة من منشورات Postman:

  1. الاستجابة للحوادث دون فتح التطبيق. حدّد الوكيل رمز Bearer مسرّبًا، ووجد 32 مستخدمًا لاحقًا له عبر Context Graph، ونقل الرمز إلى سرّ مخزن (vault secret)، وأعاد تشغيل المجموعة، وأغلق النتائج فقط بعد أن أكّد الإنسان إلغاء الرمز. وأصدر الكاتب الرمز الجديد من جهة الخدمة.
  2. محاكاة مشتركة عبر جلسات الوكلاء. شغّل منشور المحاكاة (بتاريخ 12 نوفمبر 2026) جلستي Claude Code على مساحة عمل واحدة. نشر الوكيل A أربع محاكيات، منها حالة رفض دفع 402 ومهلة دفع مدتها 8 ثوانٍ. سحبها الوكيل B عبر postman simulation list وpostman simulation run <simulation-id> --port 4000، وكشفت المهلة عن خطأ حقيقي: مهلة العميل البالغة 3 ثوانٍ في الدفع انتهت أولًا، تاركة حالة العملية غير معروفة.
  3. Context Graph لأسئلة الأثر. يجيب postman context-graph ask "..." --wait عن سؤال "ما الذي قد يتعطل إذا غيّرنا هذا الـ API؟" اعتمادًا على خريطة مبنية من بيانات Postman وGitHub وNew Relic.

توضح Postman التفاصيل الدقيقة بصراحة. يتطلب Secret Scanner وسجلات التدقيق خطة Enterprise، كما يتطلب فحص مساحات العمل الداخلية إضافة Advanced Security Administration. المحاكيات لا تُحدَّث تلقائيًا (hot reload). بعض أوامر CLI ترسل نتائج التشغيل والتحليلات إلى Postman افتراضيًا؛ ويشير الدليل إلى --no-report-events للاستبعاد من ذلك.

ما هي Apidog CLI لوكلاء البرمجة؟

Apidog CLI هي أداة سطر أوامر تتيح لأي وكيل برمجة تصميم ومحاكاة واختبار وتوثيق واجهات API داخل مشروع Apidog. وهي غير مرتبطة بوكيل واحد: تثبّتها مرة واحدة، وتضيف مهارة Apidog إلى أي وكيل تستخدمه (Claude Code وCodex وCursor وغيرها)، فيقود الوكيل أوامر apidog نفسها.

تغطي الإصدار 2.2.12 نقاط النهاية، والمخططات (schemas)، والمحاكيات، والبيئات، وحالات الاختبار، والسيناريوهات، والمجموعات الاختبارية، والاستيراد، والتصدير، ومواقع التوثيق، والفروع. خياران يجعلانها صديقة للوكلاء:

  • التحقق قبل الكتابة. يوجّه كل أمر يقبل JSON الوكيل إلى تشغيل apidog cli-schema get <key> لمعرفة شكل الحمولة (payload) وapidog cli-schema validate <key> --file <path> قبل الكتابة. وبذلك تفشل الحمولات غير الصحيحة محليًا بدلًا من أن تظهر كخطأ من الخادم يتطلب إعادة محاولة.
  • فروع AI. يمنح apidog branch create --type ai --from <sourceBranchName> الوكيل فرعًا خاصًا به. يذكر نص المساعدة أن تغييرات فروع AI لا تُكتب تلقائيًا في الفرع الأصلي؛ بل يطلب الوكيل موافقتك قبل الدمج.

أطلقت Apidog هذه الأداة بعد بناء خادم MCP أولًا. كتب الفريق الأسباب في We Built 126 MCP Tools، وأظهرت مقارنتهم الداخلية بين MCP مقابل CLI مع المهارة انخفاضًا يقارب 30% في نداءات الأدوات و25% في التوكنات في المهام النموذجية.

إضافة Postman مقابل Apidog CLI: مقارنة مباشرة

إليك كيف تقارن الأداتان في الأمور التي يتعامل معها وكيلك، بناءً على منشورات Postman وapidog --help حتى 16 نوفمبر 2026:

إضافة Postman لـ Claude Code Apidog CLI + المهارة
التثبيت أمران من claude plugin؛ تُثبَّت واجهة CLI تلقائيًا npm install -g apidog-cli@latest + تثبيت المهارة
الوكلاء Claude Code (متجر الإضافات) أي وكيل يشغّل أوامر الصدفة (shell)
مسار التنفيذ Postman CLI أولًا، وخادم MCP المستضاف كاحتياطي CLI فقط
أمان الحمولات المهارات ترشد الوكيل بوابة cli-schema validate قبل كل كتابة JSON
المحاكاة postman mock generate/run، ومحاكيات مشتركة توقعات apidog mock داخل المشروع
الاختبار مجموعات مع pm.test وcollection run حالات اختبار وسيناريوهات ومجموعات عبر apidog run
تحليل الأثر استعلامات Context Graph ليست ميزة مدمجة
سير عمل الأمان Secret Scanner ومخزن الأسرار (Enterprise للماسح وسجلات التدقيق) غير مدعوم في الواجهة
حاجز أمان للوكيل ينصح الدليل الوكيل بعدم تشغيل workspace push أبدًا فروع AI مع دمج بعد موافقة بشرية
الخطة المجانية الخطة المجانية لفرد واحد الخطة المجانية تشمل حتى 4 مستخدمين

تتعمق Postman أكثر في رسم خرائط الاعتماديات والاستجابة للحوادث. أما Apidog فتتوسع أكثر في دعم الوكلاء وتضيف حاجز تحقق قبل كل عملية كتابة.

أيهما يستهلك توكنات أقل؟

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

يُفيد معيار Context Graph من Postman (بتاريخ 4 نوفمبر 2026) بانخفاض 43% في توكنات الإدخال و42% في وقت العمل. كان النموذج هو GPT 6.1 Terra، وليس Claude Code، على 17 سؤالًا عن منظمة GitHub واحدة تضم 802 مستودعًا. كل مقارنة أُجريت مرة واحدة، واستُبعدت رسوم استعلامات الرسم البياني، وتحسّن الوقت الكلي شامل انتظار الرسم البياني بنسبة 26%. أي أنها تقيس Context Graph في البحث عن الأكواد، وليس الإضافة في أعمال API اليومية.

أما أرقام Apidog فتقارن خادم MCP الخاص بها مع CLI والمهارة معًا في مهام مثل إضافة حالة اختبار. وهذا اختيار معماري داخل منتج واحد، وليس Apidog ضد Postman.

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

الأسعار: ما الذي تكلّفه كل أداة فريقك

الأسعار، بحسب ما تم التحقق منه في 16 نوفمبر 2026:

  • Postman. وفقًا لصفحة أسعار Postman، فإن الخطتين Free وSolo مخصصتان لفرد واحد. تكلف Solo 9 دولارات شهريًا بفوترة سنوية، وTeam تكلف 19 دولارًا لكل مستخدم شهريًا بفوترة سنوية (23 دولارًا شهريًا)، وEnterprise تتطلب التواصل مع قسم المبيعات. تشمل استعلامات Context Graph 1,000 استعلام شهريًا في الخطة المجانية و5,000 في الخطط المدفوعة، ثم 0.01 دولار لكل استعلام. يتطلب سير عمل Secret Scanner في الإضافة خطة Enterprise.
  • Apidog. تشمل الخطة المجانية حتى 4 مستخدمين.

بالنسبة لفريق من مطوّرَين إلى أربعة يتقاسمون مشروع API واحد على خطة مجانية، فهذا الفارق يحسم القرار. أما إذا كانت شركتك تعتمد Postman بنظام Enterprise، فتضيف الإضافة للوكيل إمكانية الوصول إلى أدوات تدفع ثمنها أصلًا.

دع Claude Code يقود Apidog CLI

لا تبِنِ حالات الاختبار يدويًا بينما يجلس الوكيل دون عمل في النافذة المجاورة. ثبّت الواجهة مرة واحدة وامنحه طلبًا واحدًا.

Diagram of the Apidog CLI agent loop

يستغرق الإعداد ثلاثة أوامر:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com   # اختر Claude Code عند الطلب
Enter fullscreen mode Exit fullscreen mode

يثبّت apidog skill install المهارة أيضًا أو يحدّثها. أو اطلب من وكيلك قراءة دليل التثبيت وإجراء الإعداد.

ثم امنح Claude Code طلبًا واحدًا، باستخدام نفس Orders API الموجود في دليل Postman حتى تتمكن من تشغيل الأداتين على مواصفة واحدة:

Import ./openapi.yaml into Apidog project <projectId>. Then create a test case
for POST /orders that asserts a 201 status and an "id" field in the response,
run it against environment <envId>, and summarize any failures.
Enter fullscreen mode Exit fullscreen mode

يقرأ الوكيل المهارة، ثم يشغّل أوامر مثل هذه:

apidog import --project <projectId> --format openapi --file ./openapi.yaml
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json
Enter fullscreen mode Exit fullscreen mode

تتوقف الحمولة غير الصحيحة عند cli-schema validate. وأضف --upload-report ليظهر التشغيل في تطبيق Apidog لفريقك. ويدخل نفس نداء apidog run مع -r junit إلى مسار CI/CD؛ انظر Apidog CLI in CI/CD ودليل إعداد Claude Code الكامل.

أي أداة ينبغي أن يستخدم وكيلك؟

اختر إضافة Postman لـ Claude Code إذا:

  • كانت واجهات API ومجموعاتك ومواصفاتك موجودة بالفعل في مساحات عمل Postman.
  • أردت استعلامات أثر من Context Graph قبل تعديل API مشترك.
  • كنت على خطة Enterprise وتريد تفعيل Secret Scanner وسجلات التدقيق داخل حلقة الوكيل.

اختر Apidog CLI إذا:

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

للعَدّاءات CI تحديدًا، انظر Apidog CLI vs Postman CLI ومراجعتنا لمهارات Postman Claude.

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

هل إضافة Postman لـ Claude Code مجانية؟ تُثبَّت الإضافة من متجر Anthropic الرسمي، ويذكر دليل Postman أن الخطة المجانية تكفي لسير العمل الأساسي. أما Secret Scanner وسجلات التدقيق فيتطلبان Enterprise، وتتجاوز استعلامات Context Graph الحد الشهري البالغ 1,000 استعلام في الخطة المجانية بتكلفة 0.01 دولار لكل استعلام.

هل تستخدم إضافة Postman بروتوكول MCP أم واجهة CLI؟ كلاهما. توجّه الإضافة العمل إلى Postman CLI متى كانت الواجهة قادرة على تنفيذه، وتعود إلى خادم Postman MCP المستضاف للمهام التي لا تغطيها الواجهة، مثل Secret Scanner وسجلات التدقيق.

هل تعمل Apidog CLI مع Claude Code؟ نعم. ثبّت الواجهة، وأضف مهارة Apidog عبر npx -y skills add https://apidog.com أو apidog skill install، وسيشغّل Claude Code أوامر apidog بناءً على طلبك. يعمل الإعداد نفسه في Codex وCursor وغيرها من الوكلاء.

هل يمكنني نقل مجموعات Postman إلى Apidog عبر الواجهة؟ نعم. يستورد apidog import --project <projectId> --format postman --file <path> مجموعة Postman المُصدَّرة إلى مشروع Apidog.

هل توفير التوكنات بنسبة 43% يخص إضافة Claude Code؟ لا. يأتي رقم 43% من Postman من معيار Context Graph شُغّل مع GPT 6.1 Terra على 17 سؤال بحث في الأكواد، مرة واحدة لكل سؤال. ولا يقيس أداء إضافة Claude Code في مهام API اليومية.

Top comments (0)