Claude Code هو وكيل البرمجة الرسمي من Anthropic — بيفتح في الطرفية عندك، بيقرا مشروعك، بيعدّل الكود، وبيشغّل commands لوحده. هنشرح في المقال ده إزاي تشغّله على مفتاح بوابة النماذج الاصطناعية بالجنيه المصري بدون اشتراك Claude Pro.

ملخص سريع

Claude Code = CLI رسمي من Anthropic، مبني على Claude Opus / Sonnet / Haiku.
بيقدر: يقرا ملفات، يعدّلها، يشغّل commands، يعمل git commits، يشتغل مع MCP servers.
السعر الرسمي: يبدأ من $20/شهر (Claude Pro) — 1000 ج.م.
البديل المصري: soal.help بيدفع بالجنيه واستخدام حسب الاستهلاك.

متطلبات التشغيل

Node.js 18 أو أعلى.
Terminal (Linux, macOS, Windows PowerShell, أو WSL).
مفتاح API من soal.help.

الخطوة 1: تثبيت Claude Code

npm install -g @anthropic-ai/claude-code

للتأكد إنه اتثبت:

claude --version

الخطوة 2: توصيله بـ soal.help

على Linux / macOS

export ANTHROPIC_BASE_URL=https://soal.help/api
export ANTHROPIC_AUTH_TOKEN=sk-...   # مفتاحك من soal.help

عشان يفضل شغّال بعد ما تقفل الـ Terminal، ضيف السطرين دول في ملف ~/.bashrc أو ~/.zshrc:

echo 'export ANTHROPIC_BASE_URL=https://soal.help/api' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-...' >> ~/.zshrc
source ~/.zshrc

على Windows (PowerShell)

$env:ANTHROPIC_BASE_URL="https://soal.help/api"
$env:ANTHROPIC_AUTH_TOKEN="sk-..."

عشان يفضل شغّال دائمًا:

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://soal.help/api', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'sk-...', 'User')

الخطوة 3: أول جلسة

روح لمجلد مشروعك، وشغّل:

cd /path/to/your/project
claude

هيفتح interactive session. جرّب اكتب:

اقرا الملف README.md ولخّصه بالعربي

أو:

أضف endpoint جديد في main.py يستقبل POST request ويرجع JSON

الاختصارات المفيدة

الأمر داخل Claude	إيه بيعمل
`/help`	قائمة الأوامر
`/clear`	مسح الـ context
`/model`	تغيير الموديل
`/exit`	خروج
`Ctrl+C`	إلغاء العملية الحالية

الموديلات المتاحة من soal.help

Claude Code بيدور تلقائيًا على أفضل موديل، لكن تقدر تختار يدويًا:

export ANTHROPIC_MODEL="claude-opus-4-8"      # الأقوى
export ANTHROPIC_MODEL="claude-sonnet-4-6"    # متوازن (موصى به)
export ANTHROPIC_MODEL="claude-haiku-4-5-20251001"  # الأسرع والأرخص
export ANTHROPIC_MODEL="claude-fable-5"       # الأحدث — سياق 1M

نصيحة: ابدأ بـ claude-sonnet-4-6 — أفضل توازن سعر/جودة.

استخدامات عملية

1. Refactor مشروع كامل

claude "refactor كل الـ functions اللي بتستخدم requests للـ httpx"

2. كتابة tests

claude "اكتب pytest tests لكل الـ endpoints في api/users.py"

3. debug bug

claude "لما بشغّل python main.py بيقولي KeyError: 'user_id'. حل المشكلة"

4. مراجعة كود قبل الـ commit

claude "راجع الملفات اللي اتغيّرت في git diff وقولي لو في bugs محتملة"

Function Calling — بيشتغل تلقائيًا

Claude Code بيدير الأدوات دي بنفسه:

Read/Write: قراءة وكتابة الملفات.
Bash: تشغيل commands (بيسألك قبل ما ينفّذ حاجة خطيرة).
Grep/Glob: بحث في الكود.
Git: commits و branches.
Web: بحث في الإنترنت.

كل ده شغّال على soal.help لأننا بندعم Function Calling كامل.

كم بيكلّف؟

جلسة Claude Code متوسطة بتقرا 20 ملف وتعدّل 5 = ~40K توكن input + 5K output:

Claude Sonnet 4.6: 40K × 240 + 5K × 1200 = ~15 ج.م.
Claude Haiku 4.5: 40K × 80 + 5K × 400 = ~5 ج.م.
Claude Opus 4.8: 40K × 400 + 5K × 2000 = ~26 ج.م.

يعني بـ 200 جنيه رصيد تقدر تعمل 10-30 جلسة كاملة — أرخص بكتير من اشتراك Claude Pro الشهري.

أخطاء شائعة وحلولها

"Invalid API key" — تأكد إن ANTHROPIC_AUTH_TOKEN مضبوط صح ومن غير مسافات.

"Model not found" — استخدم موديل موجود عندنا (شوف صفحة النماذج).

"Rate limit exceeded" — طلبات كتير في نفس الوقت. اصبر ثانية.

ابدأ الآن

سجّل حسابك على soal.help (10 ج.م هدية ترحيبية).
أنشئ مفتاح API.
اتبع الخطوات فوق.
جرّب Claude Code في مشروعك.

للمزيد، شوف مقارنة Claude Code vs Codex CLI.

شرح Claude Code بالعربي — دليل كامل لتشغيل وكيل البرمجة من Anthropic