موارد المطورين

Claude Code

ثبّت Claude Code، وصّله بـ RunAPI، واختر نموذجاً، وتحقق من الإعداد.

نظرة عامة

Claude Code هو أداة برمجة وكيلة للطرفية. يثبّت هذا الدليل CLI، ويوجّه طلباته المتوافقة مع Anthropic إلى RunAPI، ويختار نموذج RunAPI، ويتحقق من الاتصال.

قبل البدء

استخدم منصة مدعومة من دليل إعداد Claude Code الرسمي.
أنشئ مفتاح API قياسياً لـ RunAPI وفق دليل المصادقة. لا تلتزم بحفظه في مستودع.
انسخ معرّف نموذج يدعم Anthropic Messages من كتالوج النماذج.

التثبيت

استخدم المثبّت الأصلي الرسمي على macOS أو Linux أو WSL، ثم تحقق من توفر الأمر:

SHELL

curl -fsSL https://claude.ai/install.sh | bash
claude --version

للتثبيت عبر Homebrew أو WinGet أو المتطلبات الخاصة بالمنصة، استخدم دليل التثبيت الرسمي.

إعداد RunAPI

للاختبار الأول، صدّر Base URL ومفتاح API والنموذج في الصدفة الحالية:

SHELL

export ANTHROPIC_BASE_URL=https://runapi.ai
export ANTHROPIC_API_KEY=YOUR_RUNAPI_API_KEY
export ANTHROPIC_MODEL=YOUR_RUNAPI_MODEL_ID

لتطبيق القيم على كل جلسة Claude Code الخاصة بمستخدمك، ضعها في كائن env في ~/.claude/settings.json:

JSON

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://runapi.ai",
    "ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_RUNAPI_MODEL_ID"
  }
}

احتفظ بالمفتاح الحقيقي خارج .claude/settings.json، المخصص لإعدادات المشروع التي قد تُرفع إلى المستودع. للاطلاع على نطاقات الإعداد والأولوية، استخدم مرجع إعدادات Claude Code.

اختر نموذجاً

استبدل YOUR_RUNAPI_MODEL_ID بالمعرّف الدقيق من كتالوج النماذج. يُغيّر ANTHROPIC_BASE_URL وجهة إرسال الطلبات؛ ولا يختار النموذج. يمكنك أيضاً بدء جلسة واحدة باستخدام claude --model YOUR_RUNAPI_MODEL_ID أو تشغيل /model أثناء الجلسة.

تحقق

شغِّل فحصَي التثبيت والتهيئة، ثم أرسل موجهاً قصيراً واحداً:

SHELL

claude --version
claude doctor
claude

داخل Claude Code، شغّل /status للتأكد من الإعدادات المحملة والنموذج النشط. الاستجابة الطبيعية لـ Describe this repository in one sentence. تؤكد أن اتصال RunAPI يعمل بشكل صحيح.

استكشاف الأخطاء وإصلاحها

claude غير موجود: أعد فتح الطرفية واتبع استكشاف أخطاء التثبيت الرسمي.
لا تُحمَّل الإعدادات: تحقق من صحة ~/.claude/settings.json بـ claude doctor، ثم استخدم /status لفحص المصادر المُحمَّلة.
فشل المصادقة: تأكد من أن ANTHROPIC_API_KEY يحتوي على مفتاح RunAPI نشط. أنشئ المفاتيح أو استبدلها عبر دليل المصادقة.
النموذج غير متاح: انسخ المعرّف الدقيق من كتالوج النماذج، ثم ابدأ جلسة جديدة. قد تحتفظ الجلسات المستأنفة بنموذجها السابق.
تستخدم الطلبات نقطة نهاية أخرى: ابدأ طرفية جديدة بعد تغيير متغيرات البيئة وتحقق من وجود إعداد Claude Code ذي أولوية أعلى.

الخطوات التالية

استخدم البدء السريع لـ LLM API للاطلاع على سلوك البروتوكول ومرجع Anthropic Messages API لحقول الطلب. لإضافة أدوات RunAPI إلى Claude Code، تابع مع نظرة عامة على MCP.