📋 خطوات تحضيرية
قبل البدء، يرجى التأكد مما يلي:
- إنشاء حساب 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 |
| الطراز غير متوفر | راجع قائمة الطرازات المتوفرة لـ الحزمة الحالية في ردهة عرض نموذج كوزي |
