Claude Code دليل التكوين
يستخدم Claude Code بروتوكول Anthropic Messages. عند توصيل ai2save، املأ العنوان بعنوان الجذر للموقع https://ai2save.com، ولا تضف /v1 يدويًا؛ استخدم المفتاح sk-... الذي تم إنشاؤه من خلال لوحة تحكم ai2save.
1. تحضير API Key
- افتح https://ai2save.com/keys.
- انقر على "إنشاء مفتاح"، املأ الاسم واختر المجموعة التي تشمل نموذج Claude.
- بعد الإنشاء، انسخ المفتاح الكامل فورًا. يظهر المفتاح الكامل مرة واحدة فقط.
2. تثبيت Claude Code
أكمل أولاً تثبيت بيئة Node.js، ثم نفذ:
npm install -g @anthropic-ai/claude-code
claude --version
إذا كان الإصدار أقل من متطلبات البوابة، قم بالترقية حسب التعليمات:
npm update -g @anthropic-ai/claude-code
3. تمكين مؤقت للمحطة الحالية
macOS / Linux / WSL:
export ANTHROPIC_BASE_URL="https://ai2save.com"
export ANTHROPIC_AUTH_TOKEN="sk-مفتاحك-الخاص"
claude
ويندوز PowerShell:
$env:ANTHROPIC_BASE_URL="https://ai2save.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-مفتاحك-الخاص"
claude
ANTHROPIC_AUTH_TOKEN هو متغير مخصص لمفتاح محطة الترحيل. لا تقم بتعيين ANTHROPIC_API_KEY لمفتاح رسمي آخر في نفس الوقت، لتجنب قراءة Claude Code بيانات اعتماد خاطئة.
4. كتابة ملف تكوين Claude Code (موصى به)
قم بتحرير ~/.claude/settings.json (عادة على Windows في %USERPROFILE%\.claude\settings.json):
{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"env": {
"ANTHROPIC_BASE_URL": "https://ai2save.com",
"ANTHROPIC_AUTH_TOKEN": "sk-مفتاحك-الخاص"
}
}
بعد الحفظ، أعد فتح الطرفية وقم بتشغيل claude. إذا كنت تريد أن ينطبق ذلك فقط على مشروع معين، اكتب نفس المحتوى في .claude/settings.local.json داخل المشروع، ولا تقم بإرسال المفتاح الحقيقي إلى Git.
5. اختيار النموذج والتحقق
claude --model claude-sonnet-4-6
بعد الدخول إلى واجهة التفاعل:
- أدخل سؤالًا قصيرًا، مثل "مرحبًا، قدم نفسك".
- إذا تم إرجاع محتوى بشكل طبيعي، فهذا يعني أن العنوان والمفتاح ومجموعة النموذج متصلة.
- عند الحاجة لتغيير النموذج، استخدم
/model، ويجب أن يتطابق معرف النموذج مع المعرف المفتوح في وحدة التحكم.
يمكنك أيضًا استخدام Claude Code المدمج للفحص لمعرفة حالة التكوين.
/status
/doctor
6. إعدادات متعددة وتنظيف الإعدادات القديمة
إذا كنت قد قمت بتسجيل الدخول سابقًا إلى Claude الرسمي أو أي محطة وسيطة أخرى:
- استخدم CC Switch لإدارة مورّدين متعددين كأولوية، لتجنب تعديل الإعدادات يدويًا بشكل خاطئ.
- عند التكوين اليدوي، تأكد من عدم وجود
ANTHROPIC_BASE_URLأوANTHROPIC_AUTH_TOKENأوANTHROPIC_API_KEYالقديمة التي قد تغطي القيم الحالية. - WSL و Windows هما بيئتان منفصلتان؛ بعد التكوين على واجهة Windows، لا بد من تهيئة WSL بشكل منفصل.
تنظيف مؤقت لنظام macOS / Linux:
unset ANTHROPIC_API_KEY
الأخطاء الشائعة
- 401 / invalid_api_key: لم يتم نسخ المفتاح بالكامل، تم إلغاؤه، أو المجموعة لا تحتوي على النموذج الحالي.
- 404 / model not found: معرف النموذج غير صحيح، أو المجموعة الخاصة بالمفتاح لم تفتح هذا النموذج.
- فشل الاتصال: كتابة Base URL كـ
https://ai2save.com/v1ستسبب خطأ؛ يجب تعبئة Claude Code كـhttps://ai2save.com. - لا يزال يطلب العنوان الرسمي: تحقق مما إذا كان
~/.claude/settings.json، المشروع.claude/settings.local.json، ومتغيرات بيئة الطرفية تحتوي على العنوان القديم. - Windows لا يعمل بعد الفتح: اغلق الطرفية، VS Code، أو Claude Desktop تمامًا ثم أعد فتحه.