شرح مفصل لكل قرار، وكل خطأ، وكل فكرة تم استيعابها.
قضيتُ فترة ما بعد الظهر أحاول تشغيل برنامج Claude Code دون دفع اشتراك Anthropic. ما بدأ كـ "هذا سيستغرق 20 دقيقة" تحوّل إلى غوص عميق في تفاصيل WSL الداخلية، وتعارضات إصدارات Python، وغرائب ملف تعريف PowerShell، وكوابيس الهروب من مسار bash.
هذه هي المقالة التي كنت أتمنى لو كانت موجودة قبل أن أبدأ.
في النهاية، كان لدي إعداد يعمل بكامل طاقته: Claude Code CLI يعمل في VS Code، مدعومًا بـ Gemini 2.5 Flash كخلفية مجانية، مع طرفية bash نظيفة، .envوملف واحد كمصدر للحقيقة، وإعداد جاهز لبناء أنظمة الذكاء الاصطناعي من الصفر.
إليكم بالضبط كيف تسير الأمور ولماذا تم اتخاذ كل قرار.
أولاً: ما هو كود كلود أصلاً؟
كلود كود هو مساعد برمجة يعمل بالذكاء الاصطناعي من أنثروبيك، وهو أداة سطر أوامر (وإضافة لبرنامج VS Code) تتيح لك إعطاء تعليمات بلغة طبيعية، ليقوم وكيل ذكاء اصطناعي بكتابة وتعديل وشرح التعليمات البرمجية في مشروعك. تخيل أنه مبرمج مساعد يعمل في طرفية سطر الأوامر لديك.
لكن المشكلة تكمن في أنه مصمم للعمل مع اشتراك أنثروبيك أو فوترة واجهة برمجة التطبيقات. سيطلب منك تسجيل الدخول والدفع فورًا.
لكن إليكم الفكرة الأساسية التي تجعل كل شيء ممكناً:
برنامج Claude Code هو مجرد عميل يتواصل مع تنسيق واجهة برمجة التطبيقات Anthropic. يمكنك إعادة توجيهه إلى أي برنامج LLM يدعم هذا التنسيق.
قم بتعيين ثلاثة متغيرات بيئية — ANTHROPIC_API_KEYو ANTHROPIC_BASE_URLو و ANTHROPIC_MODEL— وسيتواصل Claude Code بسعادة مع Gemini أو Ollama أو أي واجهة خلفية متوافقة بدلاً من ذلك.
الخيارات المجانية (وأي منها يعمل فعلاً بدون بطاقة)
قبل الاستقرار على نهج معين، قمت بتحديد كل الخيارات المجانية المتاحة:
أولاما (محلي) - مجاني تمامًا للأبد، يُشغّل النماذج على جهازك. الشرط: تحتاج إلى جهاز قوي. يُنصح بذاكرة وصول عشوائي (RAM) بسعة 32 جيجابايت أو أكثر للحصول على نماذج جيدة بما يكفي لتكون مفيدة حقًا في البرمجة. مع وحدة معالجة رسومات (GPU) بسعة 128 ميجابايت وعدم وجود ذاكرة فيديو مخصصة (VRAM)، كان هذا الخيار غير وارد بالنسبة لي.
OpenRouter عبر claude-code-router — يمكنك الوصول إلى مجموعة متجددة من النماذج المجانية (DeepSeek R1، Qwen، Llama) دون الحاجة إلى بطاقة ائتمان. تتيح الحسابات المجانية 50 طلبًا يوميًا؛ أضف 10 دولارات إلى رصيدك ليرتفع العدد إلى 1000. يتطلب إعداده جهدًا أكبر قليلًا من Google AI Studio، ولكنه يستحق ذلك إذا كنت ترغب في تنويع النماذج. اخترت Gemini لبساطته.
سحابة أولامانماذج يدعم Ollama الآن :cloudإصدارات تعمل على خوادمه بدلاً من جهازك. ولا يزال يتطلب تثبيت Ollama محليًا كعميل/وكيل.
استوديو جوجل للذكاء الاصطناعي (جيميني) - مستوى مجاني، كل ما تحتاجه هو حساب جوجل. لا حاجة لبطاقة ائتمان. لا يوجد حد أدنى للرصيد. ما عليك سوى تسجيل الدخول على aistudio.google.com ، وإنشاء مفتاح API، وانتهى الأمر.
الفائز: استوديو جوجل للذكاء الاصطناعي. يتميز طراز Gemini 2.5 Flash بقدرات عالية، والمستوى المجاني سخي، ولا توجد أي عوائق أمام استخدامه.
التركيب: خطأ ارتكبته
قمت بتثبيت إضافة Claude Code لبرنامج VS Code وافترضت أنني انتهيت. لكنني لم أكن كذلك.
إن إضافة Claude Code لبرنامج VS Code وواجهة سطر الأوامر (CLI) ليستا الشيء نفسه.
إضافة VS Code عبارة عن لوحة واجهة مستخدم - شريط جانبي، اختصارات لوحة المفاتيح، طريقة تفاعل أسهل. لا تقوم بأي شيء بمفردها. المحرك الفعلي هو واجهة سطر الأوامر (CLI)، التي يتم تثبيتها عبر npm.
npm install -g @anthropic-ai/claude-codeيتم تثبيت هذا -gالخيار على مستوى النظام. قم بتشغيله مرة واحدة، من أي مكان، وسيصبح claudeمتاحًا في جميع نوافذ الطرفية على جهازك. لا تقم بتشغيله داخل مجلد مشروعك.
تأكد من نجاح العملية:
كلود --الإصدارملاحظة: قام Claude Code مؤخرًا بالتحويل من npm إلى مُثبِّت أصلي، وسيظهر تحذير بشأن إيقاف دعم npm. وحتى وقت كتابة هذا التقرير، توجد مشكلة معروفة تتمثل في توقف المُثبِّت الأصلي عن العمل في الطرفية المدمجة في VS Code على نظام Windows. لذا، يُنصح بالاستمرار في استخدام npm install في الوقت الحالي.
توجيه كود كلود نحو الجوزاء
بعد تثبيت واجهة سطر الأوامر، تتمثل الخطوة التالية في تحويلها بعيدًا عن واجهة برمجة التطبيقات المدفوعة الخاصة بـ Anthropic. يتم ذلك بالكامل من خلال متغيرات البيئة - دون أي تغييرات في التعليمات البرمجية، ودون الحاجة إلى البحث عن ملفات التكوين.
احصل على قصص الأمير أرورا في بريدك الإلكتروني
انضم إلى منصة Alsadawi مجاناً لتلقي آخر التحديثات من هذا الكاتب.
المتغيرات الثلاثة التي تحتاجها:
ANTHROPIC_API_KEY =AIza-YOUR-GEMINI-KEY-HERE
ANTHROPIC_BASE_URL =https://generativelanguage.googleapis.com/v1beta/openai/
ANTHROPIC_MODEL =gemini -2.5 -flashاحصل على مفتاح Gemini API المجاني الخاص بك من aistudio.google.com — يستغرق الأمر حوالي 30 ثانية.
مشكلة شاشة تسجيل الدخول عند التشغيل الأول
هناك أمرٌ لم تذكره الوثائق بوضوح: عند التشغيل الأول، يعرض برنامج Claude Code شاشة تسجيل الدخول حتى بعد ضبط هذه المتغيرات. إنه يريد المصادقة باستخدام Anthropic.
الحل البديل: إضافة متغير رابع مؤقتًا:
ANTHROPIC_AUTH_TOKEN =AIza-YOUR-GEMINI-KEY-HEREنفس المفتاح، اسم متغير مختلف. هذا يجعل Claude Code يتعرف عليه كـ "مفتاح API مخصص" ويسألك عما إذا كنت ترغب في استخدامه - اختر "نعم". بمجرد إنشاء جلستك، قم بإزالة المفتاحANTHROPIC_AUTH_TOKEN . الاحتفاظ بالمتغيرين معًا سيؤدي إلى ظهور تحذير تعارض في عمليات التشغيل اللاحقة.
ملف .env واحد، غير مضمن في أي مكان
وضع مفاتيح واجهة برمجة التطبيقات (API) مباشرةً في إعدادات سطر الأوامر أو إعدادات VS Code عادة سيئة. الطريقة الصحيحة: .envملف واحد في جذر مشروعك، يتم تحميله تلقائيًا.
ANTHROPIC_API_KEY =AIza-YOUR-GEMINI-KEY-HERE
ANTHROPIC_BASE_URL =https://generativelanguage.googleapis.com/v1beta/openai/
ANTHROPIC_MODEL =gemini -2.5 -flashلتحميله تلقائيًا عند فتح نافذة طرفية، أضف Load-Envدالة إلى ملف تعريف PowerShell الخاص بك. افتحه باستخدام:
ملف تعريف المفكرة $PROFILEثم الصق:
دالة تحميل البيئة {
$envFile = Join-Path (Get-Location) ".env"
إذا (Test-Path $envFile ) {
Get-Content $envFile | ForEach-Object {
إذا ( $_ -match "^\s*([^#][^=]+)=(.+)$" ) {
[System.Environment]::SetEnvironmentVariable( $matches [1].Trim(), $matches [2].Trim(), "Process" )
}
}
Write-Host ".env loaded" -ForegroundColor Green
}
}
تحميل البيئةملاحظة هامة: يحتوي VS Code على ملف تعريف PowerShell خاص به، منفصل عن طرفية PowerShell العادية. قم بتشغيله دائمًا notepad $PROFILEمن داخل الطرفية المدمجة في VS Code، وليس من نافذة PowerShell مستقلة. يشير كل منهما إلى ملفات مختلفة.
أيضًا: أضف دائمًا .envإلى قائمة مشترياتك .gitignore. دائمًا.
echo '.env' >> .gitignoreإعداد وكيل LiteLLM:
لربط كود Claude بـ Gemini، نحتاج إلى طبقة وسيطة بينهما. راجع الخطوات في الرابط أدناه
هذا كل شيء - أنت تركض
بعد .envتحميل الملف، افتح مجلد مشروعك في VS Code، وقم بتنشيط الطرفية، واكتب الأمر التالي:
كلوديجب أن ترى برنامج Claude Code قيد التشغيل مع gemini-2.5-flashظهور اسمه في أسفل اللوحة. قم بتشغيله /statusللتأكد من الطراز ونقطة النهاية المتصلة به.
أهم النقاط
- يعمل برنامج Claude Code مجانًا تمامًا مع Google AI Studio - كل ما تحتاجه هو حساب Google
- إضافة VS Code وواجهة سطر الأوامر (CLI) شيئان منفصلان؛ قم بتثبيت كليهما.
- ثلاثة متغيرات بيئية تكفي لإعادة توجيه كود كلود إلى أي خادم خلفي
ANTHROPIC_AUTH_TOKENهي حيلة تُستخدم لمرة واحدة لتجاوز شاشة تسجيل الدخول عند التشغيل الأول - قم بإزالتها بعد ذلك- ملف واحد
.envيتفوق على بيانات الاعتماد المضمنة في كل مكان
الخطوة التالية: بناء أول وكيل ذكاء اصطناعي باستخدام هذا الإعداد - وكيل Hello الذي يقوم بأول استدعاء لواجهة برمجة التطبيقات (API).
الكلمات المفتاحية: الذكاء الاصطناعي، كلود، ماجستير في القانون، بايثون، أدوات المطورين، فيجوال ستوديو كود، جيميني، أدوات مجانية، الإنتاجية
إرسال تعليق