ai2saveai2save

Claude Code دليل التكوين

يستخدم Claude Code بروتوكول Anthropic Messages. عند توصيل ai2save، املأ العنوان بعنوان الجذر للموقع https://ai2save.com، ولا تضف /v1 يدويًا؛ استخدم المفتاح sk-... الذي تم إنشاؤه من خلال لوحة تحكم ai2save.

1. تحضير API Key

  1. افتح https://ai2save.com/keys.
  2. انقر على "إنشاء مفتاح"، املأ الاسم واختر المجموعة التي تشمل نموذج Claude.
  3. بعد الإنشاء، انسخ المفتاح الكامل فورًا. يظهر المفتاح الكامل مرة واحدة فقط.

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

بعد الدخول إلى واجهة التفاعل:

  1. أدخل سؤالًا قصيرًا، مثل "مرحبًا، قدم نفسك".
  2. إذا تم إرجاع محتوى بشكل طبيعي، فهذا يعني أن العنوان والمفتاح ومجموعة النموذج متصلة.
  3. عند الحاجة لتغيير النموذج، استخدم /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 تمامًا ثم أعد فتحه.