ادعُ أصدقاء واحصل على رموز مجانية!اعرف المزيد

🪄 دمج Claude Code مع نماذج CodingPlanX المخصصة

Claude Code هو مساعد برمجة ذكاء اصطناعي قوي أطلقته Anthropic. يتم تضمينه مباشرة في الطرفية (terminal) الخاصة بك، ويفهم قاعدة التعليمات البرمجية الخاصة بك، ويتعاون معك بسلاسة لكتابة الكود وإعادة هيكلته وتصحيح الأخطاء.

سيرشدك هذا البرنامج التعليمي خلال إعداد البيئة، وتثبيت الأداة، والتكوين الحصري لواجهة بروكسي codingplanx.ai.

📋 متطلبات النظام

قبل البدء، يرجى التأكد من أن نظامك يلبي الحد الأدنى من المتطلبات التالية:

  • Node.js: الإصدار >= 18.0
  • نظام التشغيل: macOS، Linux، Windows (يوصى بـ WSL)

🚀 البدء السريع

1. تثبيت Node.js

💡 تلميح: إذا كان لديك بالفعل Node.js الإصدار 18.0 أو أعلى مثبتًا، يرجى تخطي هذه الخطوة مباشرة.

🍎 مستخدمو macOS

يوصى بالتثبيت عبر Homebrew:

# 1. تثبيت أدوات سطر أوامر Xcode
sudo xcode-select --install

# 2. تثبيت Homebrew (إذا لم يكن مثبتًا بالفعل)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 3. تثبيت Node.js عبر Homebrew
brew install node

# 4. التحقق من التثبيت
node --version

🐧 مستخدمو Ubuntu / Debian

استخدم البرنامج النصي الرسمي لـ NodeSource لتثبيت إصدار الدعم طويل الأمد (LTS):

# 1. تنزيل وتشغيل البرنامج النصي للتثبيت
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -

# 2. تثبيت Node.js
sudo apt-get install -y nodejs

# 3. التحقق من التثبيت
node --version

🪟 مستخدمو Windows

يوصى باستخدام سطر أوامر winget للتثبيت، أو الانتقال إلى الموقع الرسمي لـ Node.js لتنزيل المثبت:

# تثبيت إصدار Node.js LTS باستخدام winget
winget install OpenJS.NodeJS.LTS

# التحقق من التثبيت (قد تحتاج إلى إعادة تشغيل الطرفية بعد التثبيت)
node --version

2. تثبيت Claude Code

افتح الطرفية واستخدم npm لتثبيت Claude Code عالميًا (globally):

npm install -g @anthropic-ai/claude-code

# التحقق مما إذا كان التثبيت ناجحًا
claude --version

(ملاحظة: إذا واجهت أخطاء في الصلاحيات، قد يحتاج مستخدمو macOS/Linux إلى استخدام sudo npm install -g @anthropic-ai/claude-code)

3. التكوين وبدء الاستخدام

🔑 الحصول على معلومات التكوين الضرورية

لاستخدام هذه الخدمة، تحتاج إلى إعداد متغيري البيئة التاليين:

الإعدادالوصفكيفية الحصول عليه
ANTHROPIC_AUTH_TOKENرمز مصادقة API (Auth Token)بعد التسجيل، انتقل إلى صفحة API Tokens وانقر على Add Token (يبدأ بـ sk-)
ANTHROPIC_BASE_URLعنوان خدمة APIاملأه تمامًا كالتالي: https://api.codingplanx.ai

📝 اقتراحات عند إنشاء رمز (Token):

  • الاسم (Name): سمه بأي اسم (مثل claude-code-cli)
  • الحصة (Quota): عيّنه على Unlimited Quota (حصة غير محدودة)
  • المجموعة (Group): حدد Claude code exclusive أو Official Claude 3 & above Proxy
  • الخيارات الأخرى: احتفظ بالإعدادات الافتراضية

💻 تشغيل Claude Code

يرجى اختيار أمر بدء التشغيل المقابل بناءً على نظام التشغيل والطرفية الخاصة بك. يرجى الانتقال إلى دليل مشروعك أولاً:

cd your-project-folder

🟢 Linux / macOS (Bash/Zsh)

# تعيين متغيرات البيئة (سارية لجلسة الطرفية الحالية)
export ANTHROPIC_AUTH_TOKEN="sk-YourActualToken"
export ANTHROPIC_BASE_URL="https://api.codingplanx.ai"
export API_TIMEOUT_MS="300000"  # تعيين مهلة 300 ثانية لمنع انقطاع الاتصال في الإجابات الطويلة

# تشغيل Claude Code
claude

🔵 Windows PowerShell

# تعيين متغيرات البيئة (سارية لجلسة الطرفية الحالية)
$env:ANTHROPIC_BASE_URL = "https://api.codingplanx.ai"
$env:ANTHROPIC_AUTH_TOKEN = "sk-YourActualToken"
$env:API_TIMEOUT_MS = "300000"

# تشغيل Claude Code
claude

⚫ Windows CMD

set ANTHROPIC_BASE_URL=https://api.codingplanx.ai
set ANTHROPIC_AUTH_TOKEN=sk-YourActualToken
set API_TIMEOUT_MS=300000

claude

💡 نصيحة احترافية: إذا كنت لا ترغب في إدخال متغيرات البيئة في كل مرة، يمكنك إضافة عبارات export أعلاه إلى ملف ~/.bashrc أو ~/.zshrc (في Mac/Linux)، أو إضافة متغيرات بيئة دائمة في إعدادات نظام Windows.

⚙️ معالج تكوين التشغيل الأول

عند تشغيل claude لأول مرة، سيقوم النظام بإرشادك عبر الإعدادات الأساسية:

  1. السمة (Theme) 👉 حدد نظام الألوان المفضل للطرفية، واضغط Enter للتأكيد.
  2. الأمان (Safety) 👉 اقرأ مطالبات الأمان وأكدها، واضغط Enter.
  3. الطرفية (Terminal) 👉 يوصى بالإعدادات الافتراضية، واضغط Enter.
  4. الثقة (Trust) 👉 أكّد أنك تثق في دليل العمل الحالي، واضغط Enter.

✨ تهانينا! عندما ترى موجه الإدخال، يمكنك بدء الدردشة مع شريكك في البرمجة بالذكاء الاصطناعي! جرب كتابة: "ساعدني في شرح البنية الرئيسية لهذا المشروع".

❓ الأسئلة الشائعة (FAQ)

س: أواجه خطأ Invalid API Key · Please run /login؟

ج: يشير هذا إلى أن Claude Code فشل في قراءة متغيرات البيئة الخاصة بك. يرجى التحقق من:

  1. ما إذا كان قد تم تعيين ANTHROPIC_AUTH_TOKEN و ANTHROPIC_BASE_URL بشكل صحيح.
  2. ما إذا كان تنسيق الرمز (token) صحيحًا (يجب أن يبدأ بـ sk- ولا يحتوي على مسافات أو علامات اقتباس إضافية).
  3. إذا قمت بتكوين متغيرات بيئة دائمة، فتأكد من أنك قمت بـ إعادة تشغيل الطرفية الخاصة بك حتى تصبح سارية المفعول.

س: لماذا تظهر الزاوية اليسرى السفلية من الطرفية حالة offline (غير متصل)؟

ج: يقوم Claude Code افتراضيًا بإجراء اختبار اتصال (ping) لموقع google.com للتحقق من حالة الشبكة. في بيئات الشبكة المقيدة، يُعد إظهار offline أمرًا طبيعيًا ولن يؤثر على استخدامك الطبيعي وإنشاء التعليمات البرمجية على الإطلاق.

س: لماذا يفشل مطالبة Claude بتصفح الويب (Fetch)؟

ج: قبل الوصول إلى صفحات الويب الخارجية، يحتاج Claude Code إلى استدعاء الخدمات الرسمية لإجراء فحوصات أمنية. إذا واجهت فشلًا في عملية الجلب (Fetch):

  1. تأكد من أن جهاز الكمبيوتر الخاص بك لديه اتصال دولي مستقر بالإنترنت.
  2. إذا لزم الأمر، قم بتمكين بروكسي طرفية عالمي (مثل export https_proxy=...).

س: لماذا تطالب الطلبات دائمًا بـ fetch failed (فشل الجلب) أو انتهاء المهلة؟

ج: يحدث هذا عادةً بسبب تقلبات الشبكة أو إعادة توجيه البروكسي. الحلول:

  1. تحقق مما إذا كان متغير بيئة المهلة مضبوطًا بشكل صحيح: API_TIMEOUT_MS=300000.
  2. جرب تغيير عقدة البروكسي المحلية الخاصة بك.
  3. اضغط على Ctrl+C للخروج من الجلسة الحالية وأعد تشغيل أمر claude.

س: خطأ في تسجيل الدخول عبر الويب؟

ج: إذا واجهت حالات شاذة في صفحة الويب عند الحصول على رمز (Token)، فحاول مسح ذاكرة التخزين المؤقت لملفات تعريف الارتباط (Cookie) في متصفحك، أو استخدم وضع التصفح المتخفي لتسجيل الدخول إلى yunwu.ai مرة أخرى.

📌 ملاحظات هامة

  • 🛡️ إشعار الواجهة: يتصل هذا الموقع مباشرة بخدمة إعادة التوجيه الرسمية لـ Claude Code، وهو مكيف تمامًا لأداة CLI.
  • 🚦 حدود المعدل (Rate Limits): يدعم التكوين الحالي فقط حركة مرور واجهة برمجة تطبيقات Claude Code ولا يدعم استدعاءات API القياسية للعملاء الآخرين من جهات خارجية.
  • 🔒 تحذير أمني: يرجى الحفاظ على أمان رمز API الخاص بك (...sk-). لا تقم أبدًا بتضمينه (hardcode) في برامجك النصية أو تحميله إلى مستودعات GitHub العامة.

🔗 روابط ذات صلة