Claude Code مثبّت
ثبت Claude Code من المصدر الرسمي وتأكد أنه يعمل عبر claude --version في الطرفية. إذا ظهر خطأ، أصلح التثبيت قبل ضبط أي مفاتيح API.
Claude Code
إعداد مفتاح Claude Code API
يقرأ Claude Code متغيرين بيئيين لتوجيه الطلبات لأي وجهة: ANTHROPIC_BASE_URL وANTHROPIC_API_KEY. وجههما إلى RunAPI لتشغيل جميع نماذج Claude بنصف السعر الرسمي. يوضح هذا الدليل الأوامر الدقيقة لأنظمة mac وLinux وWindows.
تم التحديث في June 18, 2026
فريق تحرير RunAPI
نظرة عامة سريعة
كيف تضبط مفتاح API مخصصًا في Claude Code؟
يعتمد Claude Code على متغيرين بيئيين لتحديد وجهة الطلبات وطريقة المصادقة. عيّن ANTHROPIC_BASE_URL وANTHROPIC_API_KEY إلى قيم RunAPI لتتم كل الطلبات عبر RunAPI بخصم 50%. وإذا أردت استخدام مزود آخر بالكامل، يمكن لـ RunAPI أيضًا العمل كـ drop-in gateway لتشغيل نماذج Claude دون حساب Anthropic مباشر.
متغيّران
ANTHROPIC_BASE_URL يحدد نقطة النهاية. ANTHROPIC_API_KEY يحدد المفتاح. هذا كامل الإعداد: متغيران فقط، دون تغييرات أخرى.
قيمة نقطة النهاية
اضبط ANTHROPIC_BASE_URL على https://runapi.ai لتوجيه Claude Code عبر RunAPI.
احفظهما
أضف كلا التصديرين إلى ملف إعدادات shell (.zshrc أو .bashrc) حتى لا تعيد ضبطهما في كل جلسة. يستخدم مستخدمو Windows PowerShell لفتح نافذة جديدة.
خصم 50%
كل نموذج Claude يُفوتر بنصف السعر الرسمي لـ Anthropic. لا اشتراك، لا حد.
قبل البدء
ما الذي تحتاجه قبل ضبط Claude Code؟
الإعداد يستغرق بضع دقائق. تحتاج إلى Claude Code مثبتًا، وحساب RunAPI، وطرفية تشغيل. شغّل claude --version أولًا للتأكد أن Claude Code يعمل قبل لمس أي إعدادات مفتاح API.
حساب RunAPI
سجّل على runapi.ai. يتضمّن المستوى المجاني أرصدة لاختبار أي نموذج Claude قبل تمويل الرصيد.
مفتاح API
أنشئ المفتاح من Dashboard → API Keys. انسخه مرة واحدة — يظهر كامل المفتاح فقط عند الإنشاء. لا تلصقه في مستودعات عامة ولا تشاركه في لقطات الشاشة.
الوصول إلى الطرفية
تحتاج طرفية لضبط متغيرات البيئة. يستخدم macOS وLinux ملفات .zshrc أو .bashrc. يستطيع مستخدمو Windows استخدام PowerShell — عيّن المتغير ثم افتح نافذة طرفية جديدة ليبدأ السريان.
خطوة بخطوة
كيفية إعداد مفتاح Claude Code API مع RunAPI
نفّذ هذه الأوامر بالتسلسل. تُعّين نقطة النهاية والمفتاح وتُخزنهما في shell profile وتتحقق من التقاط Claude Code لها. استبدل القيمة الوهمية بمفتاح RunAPI الحقيقي. استخدم ANTHROPIC_API_KEY (وليس CLAUDE_API_KEY) — هذا هو المتغير الذي يقرأه Claude Code فعليًا.
1
اضبط URL الأساسي
يُخبر هذا Claude Code بإرسال الطلبات إلى RunAPI بدلًا من نقطة نهاية Anthropic الافتراضية.
export ANTHROPIC_BASE_URL=https://runapi.ai
2
اضبط مفتاح API
الصق مفتاح RunAPI محل العنصر النائب. يستخدمه Claude Code للمصادقة في كل طلب.
export ANTHROPIC_API_KEY=sk-your-runapi-key
3
احفظ كلا المتغيّرين
أضف كلا التصديرين إلى ~/.zshrc (أو ~/.bashrc) ليستمروا عبر جلسات الطرفية الجديدة. أعد التحميل عبر source ~/.zshrc. في Windows، عيّنها في PowerShell وافتح نافذة طرفية جديدة حتى يصبح التغيير فعالًا.
echo 'export ANTHROPIC_BASE_URL=https://runapi.ai' >> ~/.zshrc
4
تحقق من الإعداد
تأكد أن المتغير يطبع URL الخاص بـRunAPI. إذا كان فارغًا، أعد تحميل ملف إعدادات shell أو افتح طرفية جديدة، لأن المتغيرات في جلسة واحدة لا تنتقل تلقائيًا.
echo $ANTHROPIC_BASE_URL
5
شغّل Claude Code
شغّل Claude Code في مشروعك. الآن يُوجَّه عبر RunAPI بخصم 50% عن السعر الرسمي.
claudeمتغيرات البيئة
ما متغيرات البيئة التي يقرأها Claude Code؟
يقرأ Claude Code مجموعة صغيرة من المتغيرات للتحكم في نقطة النهاية، المصادقة، النموذج، وطول الإخراج. الجدول يذكر العناصر المهمة لإعداد نقطة نهاية مخصصة وما يفعله كل منها. ملاحظة: استخدم ANTHROPIC_API_KEY (وليس CLAUDE_API_KEY) — هذا هو المتغير الذي يقرأه Claude Code فعليًا.
| المتغيّر | الغرض | مثال على القيمة |
|---|---|---|
| ANTHROPIC_BASE_URL | نقطة النهاية المخصصة التي يُرسل إليها Claude Code الطلبات | https://runapi.ai |
| ANTHROPIC_API_KEY | المفتاح المستخدم لمصادقة الطلبات | sk-your-runapi-key |
| ANTHROPIC_MODEL | النموذج الافتراضي للجلسات الجديدة | claude-sonnet-4-6 |
| CLAUDE_CODE_MAX_OUTPUT_TOKENS | الحد الأقصى للرموز التي يُعيدها كل استجابة | 8192 |
يمكنك أيضًا تخزين هذه المتغيرات في ملف إعداد .claude.json في مجلد المنزل أو مجلد المشروع بدلًا من تصديرها في كل جلسة.
اختيار النموذج
أي نموذج Claude يجب تشغيله في Claude Code؟
يقبل Claude Code أي معرف نموذج Claude عبر RunAPI. اختر حسب المهمة: نموذج سريع اقتصادي للتحرير الروتيني، أو متوازن للبرمجة اليومية، أو الأقوى للمشكلات الصعبة. عدّل ANTHROPIC_MODEL لتغيير الإعداد الافتراضي، أو بدّل النماذج داخل Claude Code — والفوترة تتبع النموذج المستخدم فعليًا، مع خصم 50%.
claude-haiku-4-5
الأسرع والأرخص بسعر $1/M إدخال و$5/M إخراج عبر RunAPI. الأفضل للتحريرات الروتينية والبحث السريع.
claude-sonnet-4-6
الافتراضي المتوازن للبرمجة اليومية بسعر $3/M إدخال و$15/M إخراج عبر RunAPI. معظم المطوّرين يستخدمون هذا.
claude-opus-4-7
الأقوى للمشكلات الصعبة بسعر $5/M إدخال و$25/M إخراج عبر RunAPI. استخدمه لإعادة الهيكلة المعقدة والمراجعات.
بدّل في أي وقت
اضبط ANTHROPIC_MODEL أو غيّر النموذج داخل Claude Code في أي وقت. الفوترة تتبع النموذج الذي استدعيت فعليًا، وكلها عند خصم 50%.
إصلاح الأخطاء الشائعة
لماذا لا يعمل مفتاح Claude Code API الخاص بي؟
ترجع غالبية مشاكل الإعداد إلى واحدة من ثلاث حالات: اسم env var خاطئ (استخدم ANTHROPIC_API_KEY بدل CLAUDE_API_KEY)، أو جلسة طرفية قديمة لم تلتقط تغييرات الإعداد، أو خطأ مطبعي في المفتاح. الجدول يبين الأخطاء الشائعة وحل كل واحد منها.
| الخطأ أو العَرَض | السبب المرجّح | الحل |
|---|---|---|
| 401 Unauthorized | مفتاح API خاطئ أو منتهي الصلاحية | أعد التحقق من ANTHROPIC_API_KEY وأنشئ مفتاحًا جديدًا في لوحة تحكم RunAPI إذا لزم الأمر |
| الطلبات لا تزال تصل إلى Anthropic | ANTHROPIC_BASE_URL غير مضبوط في هذا الشل | شغّل echo $ANTHROPIC_BASE_URL؛ إذا كان فارغًا، أعد تحميل ملف تعريفك أو افتح طرفية جديدة |
| 404 Not Found | شرطة مائلة تابعة أو مسار خاطئ في URL الأساسي | اضبط URL الأساسي على https://runapi.ai بالضبط بدون مسار تابع |
| النموذج غير موجود | معرّف نموذج غير صالح أو مكتوب بشكل خاطئ | استخدم معرّفًا صالحًا مثل claude-sonnet-4-6 أو claude-opus-4-7 |
| ضاعت المتغيرات عند إعادة التشغيل | لم تُكتب التصديرات في ملف تعريف الشل | أضف كلا التصديرين إلى ~/.zshrc أو ~/.bashrc وأعد التحميل |
النسخة السريعة
إعداد مفتاح Claude Code API في أربع خطوات
1
اضبط URL الأساسي
صدّر ANTHROPIC_BASE_URL=https://runapi.ai لتوجيه الطلبات عبر RunAPI.
2
اضبط مفتاح API
صدّر ANTHROPIC_API_KEY بمفتاح RunAPI من لوحة التحكم ← مفاتيح API.
3
احفظ كلا المتغيّرين
أضف كلا التصديرين إلى ~/.zshrc أو ~/.bashrc وأعد التحميل عبر source ~/.zshrc حتى تبقى عبر الجلسات الجديدة. على Windows، اضبطهما في PowerShell وافتح نافذة طرفية جديدة.
4
شغّل Claude Code
شغّل claude --version للتحقق من التثبيت، ثم افتح claude داخل مشروعك. تصبح الطلبات الآن موجهة عبر RunAPI بخصم 50% عن الرسم الرسمي.
أسئلة مطروحة بكثرة
أسئلة شائعة حول مفتاح Claude Code API
كيف أضيف مفتاح API إلى Claude Code؟
اضبط متغيري بيئة. صدّر ANTHROPIC_BASE_URL إلى https://runapi.ai وANTHROPIC_API_KEY إلى مفتاح RunAPI الخاص بك. أضف الإثنين إلى ملف إعدادات shell (.zshrc أو .bashrc) بحيث يبقيان عبر الجلسات. يقرأ Claude Code المتغيرين عند الإقلاع ويوجه كل الطلبات عبر RunAPI.
من أين أحصل على مفتاح Claude Code API؟
أنشئ حسابًا في runapi.ai. سجّل دخولك، ثم افتح Dashboard → API Keys وأنشئ مفتاحًا. انسخه فورًا — يظهر كامل المفتاح مرة واحدة فقط وقت الإنشاء. المستوى المجاني يشمل رصيدًا لاختبار أي نموذج Claude قبل شحن الرصيد.
ما فائدة ANTHROPIC_BASE_URL؟
يُخبر Claude Code بنقطة النهاية التي يُرسل إليها الطلبات. افتراضيًا يستدعي Claude Code خدمة Anthropic مباشرةً. ضبطه على https://runapi.ai يُوجّه كل طلب عبر RunAPI بدلًا من ذلك، مما يُفوتر نفس النماذج بنسبة 50% من السعر الرسمي.
هل يمكنني استخدام Claude Code مع مزود API آخر مثل OpenAI؟
هل يمكن استخدام Claude Code مع مزودين API آخرين مثل OpenAI؟ نعم — Claude Code يدعم أي endpoint متوافق مع OpenAI عبر ANTHropic_BASE_URL. تعرض RunAPI بوابة متوافقة بحيث يمكنك تبديل المزوّدات دون تغيير الكود، باستخدام نفس المفتاح عبر Claude وGPT وغيرها.
لماذا لا تزال الفوترة في Claude Code على السعر الكامل؟
شغّل الأمر echo $ANTHROPIC_BASE_URL في الطرفية. إذا لم يطبع شيئًا، فالإعداد لم يستمر. أضف التصديرين إلى ~/.zshrc أو ~/.bashrc ثم نفذ source ~/.zshrc وافتح طرفية جديدة للتحقق مرة أخرى. يحتاج مستخدمو Windows لفتح نافذة PowerShell جديدة بعد ضبط متغيرات البيئة.
هل يمكنني تخزين المفتاح في ملف الإعداد بدل البيئة؟
نعم. ضع القيم في ملف .claude.json ضمن المجلد المنزلي أو المشروع بدل تصديرها في كل جلسة. كلا الطريقتين يعملان — الملف مناسب للمفاتيح لكل مشروع، والتصدير أبسط لإعداد عالمي واحد.
كيف أراقب التكلفة بعد الإعداد؟
افتح لوحة تحكم RunAPI. تعرض إنفاقًا لكل مفتاح ولكل طلب في الوقت الفعلي. لحدّ من كلفة الإخراج، اضبط CLAUDE_CODE_MAX_OUTPUT_TOKENS بحيث يُقيد كل استجابة، واستخدم claude-haiku-4-5 للتحرير الروتيني.
هل يغيّر هذا سلوك Claude Code؟
لا. RunAPI تُمرّر الطلبات مباشرة إلى نماذج Claude الأساسية. الإخراج واستخدام الأدوات وسلوك النموذج يبقى مطابقًا لاستدعاء Anthropic مباشرة. التغيير الوحيد هو مسار الطلب وكيفية الفوترة — التجربة البرمجية نفسها لا تتغير.
ذات صلة
استكشف المزيد
وجّه Claude Code إلى RunAPI بأمرين.
أنشئ حساب RunAPI مجانيًا، واضبط ANTHROPIC_BASE_URL وANTHROPIC_API_KEY في إعدادات shell، وشغّل جميع نماذج Claude داخل Claude Code بخصم 50% من أسعار Anthropic الرسمية.