KozeKoze
العودة إلى المدونة
درس تعليمي2026年3月23日·管理员

برنامج تعليمي لتكوين كود كلود

برنامج تعليمي لتكوين كود كلود

📋 خطوات تحضيرية

قبل البدء، يرجى التأكد مما يلي:

  • إنشاء حساب Koze وتسجيل الدخول
  • إنشاء مفتاح API في صفحة إدارة API
  • تثبيت Claude Code (npm install -g @anthropic-ai/claude-code)

🚀 الخطوة 1: ضبط متغيرات البيئة

نفّذ الأوامر التالية في سطر الأوامر لضبط عنوان API ومفتاحه كمتغيرات بيئة:

# ضبط عنوان وكيل Koze إلى عنوان URL الأساسي
export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1'

# ضبط مفتاح API الذي أنشأته في لوحة تحكم Koze
export ANTHROPIC_AUTH_TOKEN="مفتاح API الخاص بك"

💡 نصيحة: استبدل https://api.kozeai.com بنطاق الخدمة الخاص بك. يمكنك عرض مفاتيح API أو إنشاؤها من صفحة "إدارة API ← المفاتيح الموجودة".

🔧 الخطوة الثانية: تهيئة إضافة VSCode (اختياري)

إذا كنت تستخدم إضافة Claude لـ VSCode، فيجب عليك تهيئتها في `~/.claude/config.json`:

{

"primaryApiKey": "مفتاح API الخاص بك",

"apiBaseUrl": "https://api.kozeai.com/v1"

}

إذا لم يكن الملف موجودًا، فيُرجى إنشاؤه يدويًا.

  • macOS / لينكس: ~/.claude/config.json
  • ويندوز: C:\Users\Your Username\.claude\config.json

🎯 الخطوة 3: تشغيل Claude Code

بعد ضبط متغيرات البيئة، شغّله مباشرةً من سطر الأوامر:

claude

سيستخدم Claude Code تلقائيًا عنوان وكيل Koze الذي قمتَ بضبطه لإرسال الطلبات.

📌 متغيرات البيئة الدائمة

لتجنب إعادة ضبط المتغيرات في كل مرة تفتح فيها سطر الأوامر، يُنصح بكتابة المتغيرات في ملف إعدادات الصدفة:

# مستخدم Bash

echo 'export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1' >>> ~/.bashrc

echo 'export ANTHROPIC_AUTH_TOKEN='your API key' >>> ~/.bashrc

source ~/.bashrc

# مستخدم Zsh

echo 'export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1' >>> ~/.zshrc

echo 'export ANTHROPIC_AUTH_TOKEN='your API key' >> ~/.zshrc

source ~/.zshrc

✅ التحقق من الاتصال

بعد تشغيل Claude Code، إذا ظهرت لك واجهة حوار عادية، فهذا يعني أن الإعداد قد تم بنجاح.

يمكنك الاطلاع على سجلات المكالمات في الوقت الفعلي على صفحة "إحصائيات الاستخدام" في Koze.

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

المشكلة الحل
نصيحة: مفتاح API غير صالح تأكد من نسخ مفتاح API بشكل صحيح، مع التأكد من عدم وجود مسافات زائدة
انقطاع الاتصال تأكد من صحة عنوان URL الأساسي واحتوائه على اللاحقة /v1
الطراز غير متوفر راجع قائمة الطرازات المتوفرة لـ الحزمة الحالية في ردهة عرض نموذج كوزي

 

برنامج تعليمي لتكوين كود كلود | Koze AI