دليل تثبيت واستخدام Claude Code - إعداد مساعد البرمجة بالذكاء الاصطناعي

Claude Code هو مساعد برمجة قوي بالذكاء الاصطناعي يتيح لك التعاون مع الذكاء الاصطناعي مباشرة من خلال الطرفية (terminal). سيرشدك هذا الدليل خلال خطوات التثبيت وإعداد التهيئة.

متطلبات النظام#

قبل تثبيت Claude Code، تأكّد من أن نظامك يستوفي المتطلبات التالية:

• Node.js: الإصدار 18.0 أو أعلى
• نظام التشغيل: ‏macOS أو Linux أو Windows (يُفضَّل استخدام WSL)

البدء السريع#

الخطوة 1: تثبيت Node.js#

إذا كان لديك بالفعل Node.js الإصدار 18.0 أو أعلى مثبتًا، يمكنك تخطّي هذه الخطوة.

Ubuntu / Debian#

# Install Node.js LTS version
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs

# Verify installation
node --version

macOS#

# Install Xcode command line tools
sudo xcode-select --install

# Install Homebrew (if not already installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Node.js via Homebrew
brew install node

# Verify installation
node --version

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

قم بتثبيت Claude Code بشكل عام (global) باستخدام npm:

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

# Verify installation
claude --version

الخطوة 3: تهيئة الوصول إلى واجهة برمجة التطبيقات (API)#

تحتاج إلى عنصرين من عناصر التهيئة لاستخدام Claude Code مع Crazyrouter API:

إعدادات الرمز الموصى بها:

• الاسم: أي اسم وصفي
• الحصة (Quota): عيّنها على غير محدود لغرض التطوير
• المجموعة (Group): اختر "Claude Code" أو "Official Claude 3+"
• الخيارات الأخرى: اتركها على الإعدادات الافتراضية

الخطوة 4: تشغيل Claude Code#

Linux / macOS#

# Navigate to your project directory
cd your-project-folder

# Set environment variables
export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000

# Launch Claude Code
claude

Windows PowerShell#

# Navigate to your project directory
cd your-project-folder

# Set environment variables
$env:ANTHROPIC_BASE_URL = "https://crazyrouter.com/"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-token-here"
$env:API_TIMEOUT_MS = "300000"

# Launch Claude Code
claude

Windows CMD#

# Navigate to your project directory
cd your-project-folder

# Set environment variables
set ANTHROPIC_BASE_URL=https://crazyrouter.com/
set ANTHROPIC_AUTH_TOKEN=sk-your-token-here
set API_TIMEOUT_MS=300000

# Launch Claude Code
claude

الخطوة 5: إعداد التشغيل الأول#

بعد تشغيل Claude Code للمرة الأولى، سترى خطوات الإعداد التالية:

1. Select Theme - اختر نمط الألوان (Theme) المفضّل لديك واضغط Enter
2. Safety Notice - راجع إشعار السلامة ووافق عليه
3. Terminal Configuration - استخدم الإعداد الافتراضي للطرفية أو قم بتخصيصه
4. Working Directory Trust - امنح الثقة لمجلد العمل الحالي للسماح بالوصول إلى الملفات

تهانينا! أصبحت الآن جاهزًا لبدء البرمجة مع شريكك في البرمجة بالذكاء الاصطناعي.

التهيئة الدائمة (اختياري)#

لتجنّب ضبط متغيرات البيئة في كل مرة، أضِفها إلى ملف إعداد الصدفة (shell profile):

Bash ‏(/.bashrc أو ‎/.bash_profile)#

export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000

Zsh ‏(~/.zshrc)#

export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000

بعد الإضافة، أعد تحميل الصدفة:

source ~/.bashrc  # or source ~/.zshrc

الأسئلة المتكررة (FAQ)#

خطأ "Invalid API Key"#

إذا ظهر لك "Invalid API Key - Please run /login" فتحقق من:

• أن ANTHROPIC_AUTH_TOKEN مضبوط بشكل صحيح (يبدأ بـ sk-)
• أن ANTHROPIC_BASE_URL مضبوط على https://crazyrouter.com/
• أعد تشغيل الطرفية بعد ضبط متغيرات البيئة

حالة "Offline"#

يقوم Claude Code بالتحقق من حالة الشبكة عن طريق الاتصال بـ Google. ظهور حالة "offline" لا يؤثر في الاستخدام العادي، بل يشير فقط إلى عدم القدرة على الاتصال بخوادم Google.

فشل Web Fetch#

يقوم Claude Code بإجراء فحوصات أمنية قبل الوصول إلى صفحات الويب. تأكّد من:

• وجود اتصال إنترنت مستقر
• استخدام بروكسي عام (global proxy) إذا لزم الأمر

أخطاء "Fetch Failed" المستمرة#

قد تكون هذه الأخطاء ناتجة عن مشاكل في الشبكة. جرّب ما يلي:

1. أغلق Claude Code (Ctrl+C)
2. أعد تشغيل أمر claude
3. إذا استمرت المشكلة، حاول مرة أخرى لاحقًا

أخطاء واجهة برمجة التطبيقات (API)#

إذا واجهت أخطاء في واجهة برمجة التطبيقات:

• أغلق Claude Code (Ctrl+C)
• انتظر قليلًا ثم أعد التشغيل
• تحقّق من حصة الرمز (token quota) من لوحة التحكم (dashboard)

ملاحظات مهمّة#

• يقوم Crazyrouter بتوفير توجيه مباشر إلى خدمات Claude Code الرسمية
• احتفظ برمز واجهة برمجة التطبيقات (API token) بشكل آمن ولا تشاركه علنًا أبدًا
• راقب استخدامك من خلال لوحة التحكم لتجنّب الرسوم غير المتوقعة

التسعير#

يستخدم Claude Code نماذج Claude بالتسعير التالي على Crazyrouter:

جميع الأسعار تتضمن خصمًا بنسبة 45% مقارنة بالأسعار الرسمية.

موارد ذات صلة#

• صفحة تسعير Crazyrouter
• الوثائق الرسمية لـ Claude Code
• الموقع الرسمي لـ Node.js

هل تحتاج إلى مساعدة؟ تواصل مع الدعم أو اطّلع على توثيق Crazyrouter لمزيد من المعلومات.