# إعداد مفتاح Claude Code API

يقرأ Claude Code متغيرين بيئيين لتوجيه الطلبات لأي وجهة: ANTHROPIC_BASE_URL وANTHROPIC_API_KEY. وجههما إلى RunAPI لتشغيل جميع نماذج Claude بنصف السعر الرسمي. يوضح هذا الدليل الأوامر الدقيقة لأنظمة mac وLinux وWindows.

*Updated 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.

### Claude Code مثبّت

ثبت Claude Code من المصدر الرسمي وتأكد أنه يعمل عبر claude --version في الطرفية. إذا ظهر خطأ، أصلح التثبيت قبل ضبط أي مفاتيح 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 فعليًا.

## ما متغيرات البيئة التي يقرأها 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 يجب تشغيله في 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 مع RunAPI

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 مباشرة. التغيير الوحيد هو مسار الطلب وكيفية الفوترة — التجربة البرمجية نفسها لا تتغير.