Claude Code مثبّت
ثبّت Claude Code من المصدر الرسمي وتحقق من تشغيله بأمر claude في طرفيتك.
Claude Code
إعداد مفتاح Claude Code API
يقرأ Claude Code متغيّري بيئة لتوجيه الطلبات إلى أي مكان: ANTHROPIC_BASE_URL وـ ANTHROPIC_API_KEY. وجّههما إلى RunAPI وشغّل كل نماذج Claude بنصف السعر الرسمي. يوضح هذا الدليل الأوامر الدقيقة.
تم التحديث في June 18, 2026
فريق تحرير RunAPI
نظرة عامة سريعة
كيف تضبط مفتاح API مخصصًا في Claude Code؟
يستخدم Claude Code متغيّري بيئة لتحديد وجهة الطلبات وكيفية مصادقتها. اضبطهما على قيم RunAPI وسيُوجَّه كل طلب عبر RunAPI بخصم 50%. البطاقات أدناه تغطي الأساسيات قبل الشرح الكامل.
متغيّران
ANTHROPIC_BASE_URL يضبط نقطة النهاية. ANTHROPIC_API_KEY يضبط المفتاح. هذا هو الإعداد بأكمله.
قيمة نقطة النهاية
اضبط ANTHROPIC_BASE_URL على https://api.runapi.ai لتوجيه Claude Code عبر RunAPI.
احفظهما
أضف كلا التصديرين إلى ملف تعريف الشل أو .claude.json لتجنب إعادة ضبطهما في كل جلسة.
خصم 50%
كل نموذج Claude يُفوتر بنصف السعر الرسمي لـ Anthropic. لا اشتراك، لا حد.
قبل البدء
ما الذي تحتاجه قبل ضبط Claude Code؟
يستغرق الإعداد بضع دقائق. تحتاج إلى Claude Code مثبتًا وحساب RunAPI وطرفية. القائمة أدناه تغطي كل المتطلبات قبل الأمر الأول.
حساب RunAPI
سجّل على runapi.ai. يتضمّن المستوى المجاني أرصدة لاختبار أي نموذج Claude قبل تمويل الرصيد.
مفتاح API
أنشئ مفتاحًا من لوحة التحكم ← مفاتيح API. انسخه مرة واحدة — يُعرض كاملًا فقط عند الإنشاء.
الوصول إلى الطرفية
تحتاج إلى شل لضبط متغيرات البيئة. macOS وـ Linux وـ WSL على Windows تعمل بنفس الطريقة.
خطوة بخطوة
كيفية إعداد مفتاح Claude Code API مع RunAPI
شغّل هذه الأوامر بالترتيب. تضبط نقطة النهاية والمفتاح، تحفظهما في ملف تعريف الشل، وتؤكد استلام Claude Code لهما. استبدل العنصر النائب بمفتاح RunAPI الحقيقي.
1
اضبط URL الأساسي
يُخبر هذا Claude Code بإرسال الطلبات إلى RunAPI بدلًا من نقطة نهاية Anthropic الافتراضية.
export ANTHROPIC_BASE_URL=https://api.runapi.ai
2
اضبط مفتاح API
الصق مفتاح RunAPI محل العنصر النائب. يستخدمه Claude Code للمصادقة في كل طلب.
export ANTHROPIC_API_KEY=sk-your-runapi-key
3
احفظ كلا المتغيّرين
أضف كلا التصديرين إلى ~/.zshrc (أو ~/.bashrc) ليظلّا ثابتين في جلسات الطرفية الجديدة. أعد التحميل بـ source ~/.zshrc.
echo 'export ANTHROPIC_BASE_URL=https://api.runapi.ai' >> ~/.zshrc
4
تحقق من الإعداد
تأكد من طباعة المتغير لـ URL الخاص بـ RunAPI. إذا كان فارغًا، أعد تحميل ملف تعريف الشل أو افتح طرفية جديدة.
echo $ANTHROPIC_BASE_URL
5
شغّل Claude Code
شغّل Claude Code في مشروعك. الآن يُوجَّه عبر RunAPI بخصم 50% عن السعر الرسمي.
claudeمتغيرات البيئة
ما متغيرات البيئة التي يقرأها Claude Code؟
يقرأ Claude Code مجموعة صغيرة من المتغيرات للتحكم في نقطة النهاية والمصادقة والنموذج وطول الإخراج. يُدرج الجدول المتغيرات المهمة لإعداد نقطة نهاية مخصصة وما يفعله كل منها.
| المتغيّر | الغرض | مثال على القيمة |
|---|---|---|
| ANTHROPIC_BASE_URL | نقطة النهاية المخصصة التي يُرسل إليها Claude Code الطلبات | https://api.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. اختر حسب المهمة: نموذج سريع رخيص للتحريرات الروتينية، أو نموذج متوازن للبرمجة اليومية، أو الأقوى للمشكلات الصعبة.
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 الخاص بي؟
تنشأ معظم مشكلات الإعداد من متغير غير مضبوط أو شل قديم أو خطأ مطبعي في المفتاح. يُدرج الجدول الأخطاء الشائعة والحل لكل منها.
| الخطأ أو العَرَض | السبب المرجّح | الحل |
|---|---|---|
| 401 Unauthorized | مفتاح API خاطئ أو منتهي الصلاحية | أعد التحقق من ANTHROPIC_API_KEY وأنشئ مفتاحًا جديدًا في لوحة تحكم RunAPI إذا لزم الأمر |
| الطلبات لا تزال تصل إلى Anthropic | ANTHROPIC_BASE_URL غير مضبوط في هذا الشل | شغّل echo $ANTHROPIC_BASE_URL؛ إذا كان فارغًا، أعد تحميل ملف تعريفك أو افتح طرفية جديدة |
| 404 Not Found | شرطة مائلة تابعة أو مسار خاطئ في URL الأساسي | اضبط URL الأساسي على https://api.runapi.ai بالضبط بدون مسار تابع |
| النموذج غير موجود | معرّف نموذج غير صالح أو مكتوب بشكل خاطئ | استخدم معرّفًا صالحًا مثل claude-sonnet-4-6 أو claude-opus-4-7 |
| ضاعت المتغيرات عند إعادة التشغيل | لم تُكتب التصديرات في ملف تعريف الشل | أضف كلا التصديرين إلى ~/.zshrc أو ~/.bashrc وأعد التحميل |
النسخة السريعة
إعداد مفتاح Claude Code API في أربع خطوات
1
اضبط URL الأساسي
صدّر ANTHROPIC_BASE_URL=https://api.runapi.ai لتوجيه الطلبات عبر RunAPI.
2
اضبط مفتاح API
صدّر ANTHROPIC_API_KEY بمفتاح RunAPI من لوحة التحكم ← مفاتيح API.
3
احفظ كلا المتغيّرين
أضف كلا التصديرين إلى ~/.zshrc أو ~/.bashrc وأعد التحميل ليظلّا ثابتين في الجلسات الجديدة.
4
شغّل Claude Code
شغّل claude في مشروعك. الطلبات الآن تُوجَّه عبر RunAPI بخصم 50% عن السعر الرسمي.
أسئلة مطروحة بكثرة
أسئلة شائعة حول مفتاح Claude Code API
كيف أضيف مفتاح API إلى Claude Code؟
اضبط متغيّري بيئة. صدّر ANTHROPIC_BASE_URL إلى https://api.runapi.ai وـ ANTHROPIC_API_KEY إلى مفتاح RunAPI الخاص بك. أضفهما إلى ملف تعريف الشل ليظلّا ثابتين. يقرأهما Claude Code عند البدء ويُوجّه كل طلب عبر RunAPI.
من أين أحصل على مفتاح Claude Code API؟
أنشئ مفتاحًا على runapi.ai. سجّل الدخول، افتح لوحة التحكم ← مفاتيح API، وأنشئ مفتاحًا. انسخه فورًا، إذ يُعرض المفتاح الكامل فقط عند الإنشاء. يتضمّن المستوى المجاني أرصدة لاختبار أي نموذج Claude قبل تمويل الرصيد.
ما فائدة ANTHROPIC_BASE_URL؟
يُخبر Claude Code بنقطة النهاية التي يُرسل إليها الطلبات. افتراضيًا يستدعي Claude Code خدمة Anthropic مباشرةً. ضبطه على https://api.runapi.ai يُوجّه كل طلب عبر RunAPI بدلًا من ذلك، مما يُفوتر نفس النماذج بنسبة 50% من السعر الرسمي.
لماذا لا يزال Claude Code يُفوتر بالسعر الكامل؟
ربما لم يُضبط URL الأساسي في شلك الحالي. شغّل echo $ANTHROPIC_BASE_URL — إذا كان فارغًا، لم يستمر التصدير. أضفه إلى ~/.zshrc أو ~/.bashrc، أعد التحميل بـ source، ثم افتح طرفية جديدة وتحقق مرة أخرى.
هل يمكنني تخزين المفتاح في ملف إعداد بدلًا من ذلك؟
نعم. ضع القيم في ملف .claude.json في مجلد المنزل أو المشروع بدلًا من تصديرها في كل جلسة. كلا الأسلوبين يعمل؛ الملف أكثر ملاءمة للمفاتيح الخاصة بكل مشروع، بينما التصدير أبسط لإعداد عالمي واحد.
كيف أراقب التكلفة بعد الإعداد؟
افتح لوحة تحكم RunAPI. تُعرض الإنفاق لكل مفتاح ولكل طلب في الوقت الفعلي. لتقييد تكلفة الإخراج، اضبط CLAUDE_CODE_MAX_OUTPUT_TOKENS بحيث تُحدد كل استجابة، واختر نموذجًا أرخص مثل Haiku للتحريرات الروتينية.
هل يُغيّر هذا طريقة عمل Claude Code؟
لا. تُوجّه RunAPI الطلبات مباشرةً إلى نماذج Claude الأساسية. المخرجات واستخدام الأدوات والسلوك مطابقة للإعداد الافتراضي. تغيّر فقط وجهة الطلبات وطريقة فوترتها — تجربة البرمجة تبقى كما هي.
أي نموذج يجب أن أضبطه كافتراضي؟
يضبط معظم المطوّرين ANTHROPIC_MODEL على claude-sonnet-4-6 للبرمجة اليومية. استخدم claude-haiku-4-5 للتحريرات السريعة الرخيصة أو claude-opus-4-7 لإعادة الهيكلة الصعبة. يمكنك تبديل النماذج داخل Claude Code في أي وقت، والفوترة تتبع النموذج الذي تستدعيه.
وجّه Claude Code إلى RunAPI بأمرين.
أنشئ حسابًا مجانيًا على RunAPI، اضبط ANTHROPIC_BASE_URL وـ ANTHROPIC_API_KEY، وشغّل كل نماذج Claude في Claude Code بخصم 50% عن الأسعار الرسمية لـ Anthropic.