Skip to main content
استخدم هذا الدليل لربط وكلاء البرمجة بـPhaseo. اختر Phaseo CLI لبيانات اعتماد وإعدادات مُدارة، أو قيم المزوّد اليدوية للإعداد داخل الوكيل.

اختيار الإعداد

الإعداد باستخدام CLI الخاص بـPhaseo

سجّل الدخول مرة واحدة، ثم هيّئ بيئة البرمجة:
يتحقق هذا الأمر من تثبيت البيئة. إذا لم تكن مثبتة في طرفية تفاعلية، يعرض Phaseo أمر التثبيت المدعوم ويطلب التأكيد قبل تشغيله. ثم ينشئ Phaseo مفتاحًا مخصصًا للبيئة ويكتب إعداداتها. تعرض عمليات التشغيل غير التفاعلية إرشادات تثبيت قابلة للتنفيذ دون إجراء تغييرات على النظام دون إشراف. ويحصل OpenCode وDeepSeek Harness وPi وPrime Agent وOpenClaw أيضًا على جميع نماذج النص النشطة المتوافقة مع Chat Completions. استخدم --skip-install أو --catalog default أو --dry-run لتضييق نطاق السلوك. استخدم الأمر المسمّى باسم المنتج لأي تكامل دائم:
Supported integration names are codex, claude-code, opencode, deepseek-harness, pi, openclaw, hermes, aider, cline, roo-code, kilo-code, continue, cursor, and zed. مشغّلات CLI المعزولة هي cline وkilo وomp وmuse وminimax. تنشئ CLI مفتاح API مستقلًا غير منتهي الصلاحية باسم كل مساعد. وتضبط Aider وContinue تلقائيًا في التثبيتات النظيفة، كما تكتب إعدادات مزود/نموذج Zed تلقائيًا. أما المساعدون الذين يحتفظون بالأسرار حصريًا في واجهة المحرر، فتعرض CLI الحقول المتبقية، وتربط بالدليل المخصص، وتتيح نسخ مفتاح ذلك المساعد فقط:
عاين تغييرات الملفات قبل الإعداد، ثم افصل التكامل بسلاسة لاحقًا:
يزيل الحذف الإعدادات التي يديرها Phaseo ويلغي مفتاح ذلك المساعد، دون حذف الإعدادات الأخرى.

إعدادات المزوّد اليدوية

استخدم هذه القيم ما لم تطلب الأداة اسم حقل مختلفًا: للأدوات المتوافقة مع Anthropic، استخدم:

Cursor

يدعم Cursor نقاط النهاية المخصصة المتوافقة مع OpenAI من خلال إعدادات مفتاح OpenAI API.
  1. افتح Cursor Settings.
  2. انتقل إلى Models.
  3. فعّل خيار OpenAI API Key أو أضفه.
  4. ألصق مفتاح API الخاص بك من Phaseo.
  5. فعّل Override OpenAI Base URL.
  6. عيّن عنوان URL الأساسي إلى https://api.phaseo.app/v1.
  7. أضف نموذجًا مخصصًا باستخدام معرّف نموذج Phaseo، مثل openai/gpt-5-nano.
  8. فعّل النموذج وتحقق منه في منتقي النماذج في Cursor.
إذا رفض Cursor معرّف نموذج يحتوي على /، فأنشئ أقرب اسم مستعار محلي تسمح به الواجهة، ووجّهه إلى نموذج Phaseo في إعدادك إن كان العميل يدعم الأسماء المستعارة.

VS Code

يمكن إضافة النماذج من محرر Language Models في VS Code إذا كان المزوّد المتوافق مع OpenAI متاحًا في إصدار VS Code أو Insiders لديك.
  1. افتح لوحة الأوامر.
  2. شغّل Chat: Manage Language Models.
  3. اختر OpenAI Compatible أو OAI Compatible.
  4. أدخل مفتاح API الخاص بك من Phaseo.
  5. عيّن نقطة النهاية أو عنوان URL الأساسي إلى https://api.phaseo.app/v1.
  6. أضف معرّف نموذج Phaseo، مثل openai/gpt-5-nano.
  7. اختر النموذج الجديد من قائمة نماذج المحادثة.
إذا لم يعرض إصدار VS Code لديك مزودًا متوافقًا مع OpenAI، فاستخدم إضافة تدعم المزودين المخصصين مثل Continue أو Cline أو Roo Code أو Kilo Code.

Continue

يمكن لـContinue استخدام Phaseo عبر مزود OpenAI وعنوان API أساسي مخصص.
إذا كان Continue يستخدم Responses افتراضيًا بينما يتطلب سير العمل التوافق مع Chat Completions، فعيّن useResponsesApi: false.

Cline وRoo Code وKilo Code

تعرض هذه الأدوات إعدادات متشابهة لمزودي الخدمة.
  1. افتح إعدادات الإضافة.
  2. اختر OpenAI Compatible كمزود للخدمة.
  3. عيّن عنوان URL الأساسي إلى https://api.phaseo.app/v1.
  4. ألصق مفتاح API الخاص بك من Phaseo.
  5. أدخل معرّف نموذج Phaseo.
  6. احفظ الإعدادات ونفّذ طلب محادثة قصيرًا قبل استخدام أدوات تحرير الملفات.

Aider

عيّن متغيرات البيئة المتوافقة مع OpenAI وحدد النموذج عند التشغيل:
غالبًا ما يتطلب Aider إضافة البادئة openai/ إلى النماذج المخصصة المتوافقة مع OpenAI. بما أن معرّفات نماذج Phaseo تتضمن بادئة مزود الخدمة، فقد تبدو سلسلة نموذج Aider كاملة مثل openai/openai/gpt-5-nano.

Pi وPrime Agent وOpenClaw وHermes Agent

يضيف phaseo pi إضافة مزود مخصصة تستخرج مفتاحها من CLI الخاص بـPhaseo أثناء التشغيل. ويكتب phaseo prime-agent مزودًا مدعومًا بالأوامر إلى ~/.prime/agent/models.json. ويحصل كلاهما على كتالوج نماذج Phaseo المتوافقة. ويسجل phaseo openclaw الكتالوج المتوافق ومرجع SecretRef مدعومًا بالتنفيذ، دون وضع مفتاح API في openclaw.json. يعرض phaseo hermes تشغيل مثبت Nous Research الرسمي عند غياب Hermes، ثم يهيئ الوكيل المثبت. ويحفظ إعدادات نموذج Hermes السابقة، ويضبط Phaseo كنقطة نهاية مخصصة، ويستخدم الأمر الرسمي hermes config set لوضع المفتاح المخصص في ~/.hermes/.env باسم OPENAI_API_KEY. يستخدم Hermes هذا الملف النصي عمدًا لبيانات اعتماد المزود؛ فاحمه كما تحمي أي ملف لمفاتيح API. وعند الإزالة، يستعيد إعدادات النموذج السابقة، ويحذف OPENAI_API_KEY وحالة استعادة Phaseo، ويلغي المفتاح.

MiniMax Code

استخدم دليل MiniMax Code لواجهة mcode CLI. ينشئ phaseo minimax مزوّد MiniMax مؤقتًا بنقطة نهاية Phaseo المتوافقة مع OpenAI، ويشغّل CLI ويحذف مجلد البيانات المؤقت عند انتهاء الجلسة. يدعم MiniMax Code أيضًا ACP عبر mcode acp إذا كان المحرر أو المضيف يستخدم ACP مباشرةً.

Zed

شغّل phaseo zed، ثم اتبع الخطوات الظاهرة لإضافة مزود متوافق مع OpenAI في إعدادات Zed. استخدم المفتاح الذي تم إنشاؤه في حقل بيانات اعتماد Zed فقط.

Codex

استخدم دليل Codex المخصص لـCodex CLI وتطبيق Codex وإضافة IDE. والخلاصة:
تستخدم مزودات Codex المخصصة بروتوكول Responses wire.

OpenCode

استخدم دليل OpenCode المخصص إذا أردت أن يستدعي OpenCode Phaseo عبر مزود مخصص متوافق مع OpenAI.

Claude Code

استخدم دليل Claude Code المخصص. يستخدم Claude Code متغيرات بيئة البوابة المتوافقة مع Anthropic:
ثم شغّل Claude Code من الصدفة نفسها:

Claude Desktop

يدعم Claude Desktop خوادم MCP، لكنه لا يوفر إعداد مزود نماذج مخصصًا مثل وكلاء البرمجة كـCursor وCodex وClaude Code. استخدم Docs MCP لإضافة سياق وثائق Phaseo إلى Claude Desktop. استخدم Claude Code عندما تحتاج إلى Phaseo كبوابة للنماذج.

CLI الخاص بـDeep Agents وأدوات LangChain

استخدم عنوان URL الأساسي ومفتاح API نفسيهما كما في LangChain. إذا قرأت الأداة متغيرات بيئة OpenAI، فعيّن:
ثم أدخل معرّف نموذج Phaseo في حقل النموذج بالأداة.

ملاحظات

  • تختلف طريقة تعامل وكلاء البرمجة مع الشرطات المائلة في معرّفات النماذج. إذا رفضت الواجهة openai/gpt-5-nano، فأنشئ اسمًا مستعارًا محليًا إذا كانت الأداة تدعم ذلك.
  • اختبر مسارات تحرير الملفات بعناية. لا يعمل phaseo:apply_patch إلا مع Responses.
  • أضف Docs MCP إذا أردت من المساعد قراءة وثائق Phaseo أثناء الجلسة.
  • فضّل Chat Completions في أدوات البرمجة الأقدم، إلا إذا كانت الأداة تدعم أحداث Responses وأدوات الخادم صراحةً.

ذات صلة

آخر تعديل في ٢ أكتوبر ٢٠٢٦