ملاحظة المؤلف: الحل الكامل لخطأ "النموذج غير موجود" عند ربط Claude Code بوكيل API خارجي: الطريقة الصحيحة لكتابة Base URL، طريقة إعداد settings.json، وجدول مقارنة لأحدث أسماء النماذج.
عند استخدام Claude Code، فإن الخطأ الأكثر شيوعاً الذي قد يواجهك هو:
There's an issue with the selected model (claude-sonnet-4-6). It may not exist or you may not have access to it. Run /model to pick a different model.
يظهر هذا الخطأ عادةً في حالتين:
- استخدام مفتاح API رسمي، ولكن مع خطأ في كتابة اسم النموذج (ببساطة نفذ
/modelواختر نموذجاً آخر). - استخدام خدمة وكيل API خارجية، حيث يكون إعداد Base URL غير صحيح، مما يؤدي إلى فشل توجيه النموذج.
يركز هذا المقال على الحل الكامل للحالة الثانية، باستخدام APIYI (apiyi.com) كمثال، ويغطي طرق الإعداد عبر متغيرات البيئة وملف settings.json، بالإضافة إلى جدول مقارنة لأحدث أسماء نماذج Claude.
القيمة الأساسية: بنهاية هذا المقال، ستتمكن من إعداد Claude Code بشكل صحيح للاتصال بوكيل API خارجي، والتخلص من خطأ "النموذج غير موجود"، واستخدام كافة ميزات Claude Code باستقرار.
أولاً: تحديد المشكلة بسرعة: هل هي اسم النموذج أم Base URL؟
قبل البدء بالإعداد، خذ 30 ثانية لتحديد نوع المشكلة التي تواجهها:
| العرض | السبب المحتمل | اتجاه الحل |
|---|---|---|
رسالة الخطأ Run /model to pick a different model |
النموذج غير موجود أو لا تملك صلاحية الوصول إليه | نفذ /model لإعادة الاختيار |
| إدخال اسم نموذج صحيح ومع ذلك يستمر الخطأ | مشكلة في إعداد Base URL | تحقق من ANTHROPIC_BASE_URL |
| فشل التحقق من مفتاح API | المفتاح غير صالح أو لم يتم ضبطه | أعد إعداد ANTHROPIC_API_KEY |
| انتهاء مهلة الشبكة / رفض الاتصال | عنوان الوكيل مكتوب بشكل خاطئ | تحقق من صيغة Base URL |
| جميع النماذج تعطي خطأ | الوكيل غير متوافق مع صيغة Anthropic | تأكد من دعم الوكيل لبروتوكول Anthropic الأصلي |
إذا كنت تستخدم مفتاح API رسمي من Anthropic وتستطيع الوصول إلى موقع anthropic.com بشكل طبيعي، فما عليك سوى تنفيذ أمر /model داخل Claude Code لتبديل النموذج، ولا حاجة لأي إعدادات إضافية.
أما إذا كنت تستخدم خدمة وكيل API خارجية (مثل apiyi.com)، فيرجى متابعة حلول الإعداد التالية.
🎯 نصيحة: نوصي باستخدام منصة APIYI (apiyi.com) لربط Claude Code، حيث تتوافق المنصة مع صيغة Anthropic الأصلية، وتدعم أحدث النماذج مثل claude-opus-4-6 وclaude-sonnet-4-6 وغيرها، مع استقرار تام في الاتصال.
2. التهيئة الأساسية لربط Claude Code عبر خدمة وكيل API خارجية
2.1 التنسيق الصحيح لـ Base URL: احذف /v1
هذه هي الخطوة الأكثر أهمية، وهي المكان الذي يقع فيه معظم المستخدمين في الخطأ.
لدى Claude Code منطق معالجة خاص لـ Base URL: فهو يقوم تلقائيًا بإضافة /v1/messages بعد الـ Base URL الذي قمت بإعداده. لذلك:
-
❌ الطريقة الخاطئة:
ANTHROPIC_BASE_URL=https://api.apiyi.com/v1- يصبح مسار الطلب الفعلي:
https://api.apiyi.com/v1/v1/messages(تكرار لـ /v1) - النتيجة: لا يمكن للتوجيه العثور على نقطة النهاية، ويظهر خطأ في النموذج.
- يصبح مسار الطلب الفعلي:
-
✅ الطريقة الصحيحة:
ANTHROPIC_BASE_URL=https://api.apiyi.com- يصبح مسار الطلب الفعلي:
https://api.apiyi.com/v1/messages - النتيجة: الوصول بنجاح إلى واجهة Anthropic الأصلية.
- يصبح مسار الطلب الفعلي:
📌 ملخص القاعدة: عند إعداد
ANTHROPIC_BASE_URL، يكفي إدخال المسار الجذري للنطاق فقط، ولا تضف لاحقة/v1. سيقوم Claude Code بإكمال المسار بالكامل تلقائيًا.
2.2 الحصول على مفتاح API
قم بتسجيل الدخول إلى لوحة تحكم APIYI للحصول على الرمز (Token): صفحة إدارة الرموز في APIYI api.apiyi.com/token
توصيات اختيار الرمز:
| نوع الرمز | سيناريو الاستخدام | الخصم |
|---|---|---|
| الرمز الافتراضي | سيناريوهات عامة، متاح مباشرة | السعر القياسي |
| رمز مجموعة ClaudeCode | مخصص لـ Claude Code | خصم 12% (بسعر 0.88) |
عند إنشاء رمز جديد، اختر مجموعة ClaudeCode للحصول على خصم 12%، مما يقلل تكلفة الاستخدام على المدى الطويل.
3. شرح طريقتي التكوين بالتفصيل
الطريقة الأولى: تكوين متغيرات البيئة (موصى بها للاختبار المؤقت)
نفذ الأوامر التالية في الجهاز الطرفي (Terminal)، وسيدخل التكوين حيز التنفيذ فوراً (صالح للجلسة الحالية):
# إعداد رابط Base URL لخدمة الوكيل (ملاحظة: لا تضف /v1)
export ANTHROPIC_BASE_URL="https://api.apiyi.com"
# إعداد مفتاح API (استبدله بمفتاحك الفعلي)
export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"
# تشغيل Claude Code
claude
التحقق من تفعيل التكوين:
# عرض متغيرات البيئة الحالية
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY
# يجب أن تكون المخرجات:
# https://api.apiyi.com
# sk-xxxxxx...
المميزات والعيوب:
- ✅ بسيطة وسريعة، لا تتطلب تعديل ملفات.
- ✅ لا تؤثر على تكوينات الجلسات الأخرى.
- ❌ تحتاج إلى إعادة الإعداد في كل مرة تفتح فيها جهازاً طرفياً جديداً (إلا إذا تمت كتابتها في
.zshrc/.bashrc).
حل التفعيل الدائم (الكتابة في ملف تكوين Shell):
# لمستخدمي zsh (الافتراضي في macOS)
echo 'export ANTHROPIC_BASE_URL="https://api.apiyi.com"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-your-key"' >> ~/.zshrc
source ~/.zshrc
# لمستخدمي bash
echo 'export ANTHROPIC_BASE_URL="https://api.apiyi.com"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-your-key"' >> ~/.bashrc
source ~/.bashrc
الطريقة الثانية: تكوين settings.json (موصى بها للاستخدام طويل الأمد)
قم بتحرير ملف ~/.claude/settings.json (تكوين عام، ينطبق على جميع المشاريع):
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-your-API-Key"
}
}
🎯 الممارسة الموصى بها: استخدم
~/.claude/settings.jsonللتكوين العام، حيث يتم ضبطه مرة واحدة ليعمل بشكل دائم دون الحاجة لتكرار إعداد متغيرات البيئة. قم بزيارة APIYI (apiyi.com) للحصول على مفتاح API، واختر مجموعة رموز ClaudeCode للحصول على خصم 12%.
إذا لم يكن الملف موجوداً، فقم بإنشائه يدوياً:
# إنشاء دليل .claude (إذا لم يكن موجوداً)
mkdir -p ~/.claude
# إنشاء ملف settings.json
cat > ~/.claude/settings.json << 'EOF'
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-replace-with-your-key"
}
}
EOF
أولوية التكوين (من الأعلى إلى الأقل):
| الأولوية | مصدر التكوين | الوصف |
|---|---|---|
| 1 (الأعلى) | متغيرات البيئة | يتم عمل export لها مباشرة في الجهاز الطرفي |
| 2 | .claude/settings.local.json |
تكوين محلي للمشروع (لا يتم رفعه إلى git) |
| 3 | .claude/settings.json |
تكوين مشترك للمشروع |
| 4 (الأدنى) | ~/.claude/settings.json |
تكوين المستخدم العام |
بالنسبة لنفس عنصر التكوين، ستغطي الأولوية الأعلى الأولوية الأدنى. إذا كان لديك ملف settings.json في دليل المشروع أيضاً، فتذكر علاقة الأولوية هذه.
4. أحدث أسماء النماذج التي يدعمها Claude Code
هذه هي أحدث أسماء نماذج Claude لعام 2026، ويجب كتابتها بدقة، مع مراعاة حالة الأحرف والأرقام:
نماذج الاستدلال القياسية
| اسم النموذج | السلسلة | تحديد القدرات | سيناريوهات الاستخدام |
|---|---|---|---|
claude-opus-4-6 |
Claude 4.6 | أقوى القدرات | الأكواد المعقدة، التحليل العميق، معالجة المستندات الطويلة |
claude-sonnet-4-6 |
Claude 4.6 | توازن بين القدرة والسرعة | البرمجة اليومية، مراجعة الكود، كتابة المستندات |
claude-haiku-4-5-20251001 |
Claude 4.5 | استجابة فائقة السرعة | الأسئلة والأجوبة البسيطة، إكمال الكود، المهام السريعة |
نماذج الاستدلال المعززة (وضع التفكير)
من خلال إضافة اللاحقة -thinking بعد اسم النموذج، يمكنك تفعيل وضع التفكير الموسع، حيث سيقوم النموذج بالاستدلال العميق قبل الإجابة:
| اسم النموذج | النموذج الأساسي | المميزات |
|---|---|---|
claude-opus-4-6-thinking |
claude-opus-4-6 | أقوى استدلال، مناسب للرياضيات/المنطق/القرارات المعقدة |
claude-sonnet-4-6-thinking |
claude-sonnet-4-6 | توازن بين الاستدلال والسرعة، الخيار الأول للاستخدام اليومي |
claude-haiku-4-5-20251001-thinking |
claude-haiku-4-5-20251001 | استدلال خفيف الوزن |
💡 نصيحة اختيار النموذج: للاستخدام اليومي لـ Claude Code، نوصي بـ
claude-sonnet-4-6؛ فهو يوفر أفضل توازن بين جودة البرمجة وسرعة الاستجابة. عند تصميم معماريات معقدة أو تصحيح أخطاء (Bugs) يصعب حلها، يمكنك التبديل إلىclaude-opus-4-6أوclaude-sonnet-4-6-thinking.
خامساً: تبديل النماذج في Claude Code
بعد تكوين Base URL ومفتاح API، هناك طريقتان لتبديل النماذج:
5.1 استخدام أمر /model (الطريقة الأسهل)
أثناء المحادثة في Claude Code، اكتب مباشرة:
/model
ستظهر لك قائمة لاختيار النماذج. إذا كنت تستخدم خدمة وكيل API خارجية، فقد لا تظهر جميع النماذج تلقائياً في القائمة؛ في هذه الحالة، ستحتاج إلى إدخال اسم النموذج يدوياً.
5.2 تحديد النموذج الافتراضي في ملف settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-مفتاح_API_الخاص_بك",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6"
}
}
من خلال متغيرات البيئة ANTHROPIC_DEFAULT_*_MODEL، يمكنك تحديد اسم النموذج الدقيق لكل فئة، مما يمنع Claude Code من استخدام الأسماء الافتراضية المدمجة (والتي قد لا تتوافق مع خدمة الوكيل).
🎯 مثال على التكوين الكامل: يُنصح بحفظ الإعدادات أعلاه في المسار
~/.claude/settings.jsonواستخدام رمز مجموعة ClaudeCode من APIYI (apiyi.com) كقيمة لـ ANTHROPIC_API_KEY.
سادساً: الأسئلة الشائعة والحلول (FAQ)
س1: بعد ضبط ANTHROPIC_BASE_URL، لا يعمل Claude Code على الإطلاق؟
تأكد من صحة تنسيق ملف JSON، الأخطاء الشائعة تشمل:
- وجود فاصلة زائدة بعد آخر زوج من القيم (JSON لا يسمح بفاصلة في النهاية).
- استخدام علامات تنصيص غير إنجليزية (مثل
""بدلاً من"").
# للتحقق من صحة تنسيق JSON
cat ~/.claude/settings.json | python3 -m json.tool
إذا كانت المخرجات طبيعية، فالتنسيق صحيح؛ أما إذا ظهر خطأ، فهناك مشكلة في القواعد النحوية للملف.
س2: يظهر خطأ Invalid API key رغم أن مفتاحي صحيح؟
الأسباب المحتملة:
- وجود مسافات قبل أو بعد المفتاح ← تأكد من عدم نسخ مسافات إضافية.
- المفتاح منتهي الصلاحية أو معطل ← سجل الدخول إلى
api.apiyi.com/tokenلإنشاء مفتاح جديد. - تداخل في متغيرات البيئة ← قد يكون هناك متغير
ANTHROPIC_API_KEYقديم محفوظ في النظام.
# تحقق مما إذا كان هناك متغيرات بيئة من مصادر متعددة
env | grep ANTHROPIC
س3: يمكن استدعاء النموذج، لكن جودة النتائج سيئة أو التنسيق غير طبيعي؟
السبب المحتمل: خدمة الوكيل لا تدعم تنسيق Anthropic بشكل كامل، خاصة فيما يتعلق بمعالجة "موجه النظام" (system prompt).
طريقة التحقق: اختبر خدمة الوكيل مباشرة باستخدام curl لمعرفة ما إذا كانت تعيد النتائج بشكل صحيح:
curl https://api.apiyi.com/v1/messages \
-H "Content-Type: application/json" \
-H "x-api-key: sk-مفتاحك" \
-H "anthropic-version: 2023-06-01" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 100,
"messages": [{"role": "user", "content": "Say hello"}]
}'
يجب أن تحتوي الاستجابة الصحيحة على حقل content والنص المخرج الفعلي. إذا كانت الاستجابة غير طبيعية، فهذا يعني وجود مشكلة في خدمة الوكيل.
🎯 فحص سريع: منصة APIYI (apiyi.com) متوافقة تماماً مع تنسيق Anthropic الأصلي، واختبار curl أعلاه سيعمل عليها بشكل مثالي. إذا كنت تختبر خدمات وكيل أخرى، يمكنك استخدام هذا الأمر للتحقق من التوافق بسرعة.
س4: كيف يتم ضبط متغيرات البيئة في نظام ويندوز؟
لمستخدمي ويندوز، نوصي باستخدام طريقة settings.json لأنها أسهل وأكثر موثوقية:
// C:\Users\اسم_المستخدم_الخاص_بك\.claude\settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-مفتاح_API_الخاص_بك"
}
}
إذا كنت تستخدم PowerShell لضبط متغيرات بيئة مؤقتة:
$env:ANTHROPIC_BASE_URL = "https://api.apiyi.com"
$env:ANTHROPIC_API_KEY = "sk-مفتاح_API_الخاص_بك"
claude
س5: كيف يمكن استخدام إعدادات API مختلفة لمشاريع مختلفة؟
قم بإنشاء ملف settings.json داخل مجلد .claude في المجلد الرئيسي للمشروع (هذا الملف له أولوية أعلى من الإعدادات العامة):
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-مفتاح_خاص_بالمشروع"
}
}
ملاحظة: إذا كان هذا الملف يحتوي على مفتاح API، يُنصح بإضافته إلى ملف .gitignore لتجنب رفعه إلى مستودع الكود. استخدام .claude/settings.local.json (إعدادات محلية خاصة) يعد خياراً أكثر أماناً، حيث لا يتم تتبعه بواسطة git افتراضياً.
7. قائمة التحقق من التكوين
بعد الانتهاء من التكوين، اتبع الخطوات التالية للتحقق:
# الخطوة 1: التأكد من تفعيل متغيرات البيئة
echo "Base URL: $ANTHROPIC_BASE_URL"
echo "API Key: ${ANTHROPIC_API_KEY:0:10}..."
# الخطوة 2: اختبار اتصال API
curl -s https://api.apiyi.com/v1/models \
-H "x-api-key: $ANTHROPIC_API_KEY" | head -c 200
# الخطوة 3: تشغيل Claude Code واختباره
claude --version
claude
في مربع حوار Claude Code، أدخل /status لعرض حالة الاتصال الحالية، وتأكد من صحة تكوين Base URL والنموذج.
🎯 بعد الانتهاء من التكوين: نوصي باختبار إرسال رسالة بسيطة للتأكد من استجابة Claude Code بشكل طبيعي. تدعم منصة APIYI (apiyi.com) الاستعلام عن الرصيد، حيث يمكنك مراقبة استهلاك الـ Tokens لـ Claude Code في الوقت الفعلي من لوحة التحكم، مما يسهل التحكم في التكاليف.
الخلاصة
يرجع 90% من أسباب ظهور خطأ "النموذج غير موجود" عند ربط Claude Code بخدمة وكيل API خارجية إلى تنسيق Base URL غير الصحيح. المبادئ الأساسية هي:
- عدم إضافة
/v1إلى Base URL: أدخلhttps://api.apiyi.comفقط، وسيقوم Claude Code تلقائيًا بإضافة/v1/messages. - مطابقة اسم النموذج بدقة: استخدم الأسماء الكاملة مثل
claude-sonnet-4-6أوclaude-opus-4-6أوclaude-haiku-4-5-20251001. - تكوين settings.json الموصى به: الكتابة في
~/.claude/settings.jsonتجعل الإعدادات دائمة، دون الحاجة لضبط متغيرات البيئة في كل مرة. - رمز (Token) مخصص لـ ClaudeCode: اختر مجموعة ClaudeCode في لوحة تحكم APIYI للاستمتاع بخصم 12% (سعر 88%).
إذا كنت تستخدم مفتاح API الرسمي من Anthropic فقط وكان اتصالك بالإنترنت مباشرًا، فيمكنك ببساطة تنفيذ أمر /model داخل Claude Code لاختيار النموذج، دون الحاجة إلى أي تكوينات إضافية.
🎯 الحصول على مفتاح API: قم بزيارة APIYI (apiyi.com) لتسجيل حساب، وأنشئ رمزًا لمجموعة ClaudeCode في صفحة إدارة الرموز
api.apiyi.com/token. تدعم المنصة الدفع حسب الاستخدام، بدون حد أدنى للاستهلاك، وتتم المحاسبة بناءً على الاستخدام الفعلي للـ Tokens، مما يجعلها مناسبة للأفراد والفرق.
تم إعداد هذا المقال بواسطة الفريق التقني لـ APIYI، بناءً على اختبارات فعلية لنسخة Claude Code v2.x. إذا واجهت أي مشاكل في التكوين، فنحن نرحب بزيارتك لمركز مساعدة APIYI (help.apiyi.com) للحصول على الدعم.
