الأدوات

إضافة Claude Code (VS Code / Cursor / Trae / Antigravity)

نزّل VS Code، وثبّت إضافة Claude Code، واربطها بواجهة LMU AI API — شرح كامل يتشارك ملف settings.json واحد مع الـ CLI.

إضافة VS Code الرسمية Claude Code for VS Code تتيح لك استخدام Claude Code مباشرة في الشريط الجانبي للمحرر، دون التبديل إلى الطرفية. وهي تتشارك ملف إعداد واحد مع Claude Code CLI، لذا فإن المفتاح / Base URL اللذين أعددتهما في الـ CLI يعملان مباشرةً في الإضافة — دون الحاجة إلى إعدادهما من جديد.

يعمل أيضًا مع Cursor / Trae / Antigravity ومحررات أخرى

أي محرر مبني على نواة VS Code (Cursor وTrae وAntigravity، إلخ) يمكنه البحث في متجر الإضافات المدمج فيه عن إضافة Claude Code for VS Code نفسها لتثبيتها وإعدادها — والخطوات مطابقة تمامًا لخطوات VS Code.

جميع لقطات الشاشة والأوامر في هذه الصفحة تستخدم VS Code كمثال؛ ويمكن لمستخدمي Cursor / Trae / Antigravity اتباعها كما هي.


تنزيل وتثبيت VS Code

أتستخدم Cursor / Trae / Antigravity؟

هذه محررات مستقلة — نزّل المثبّت المناسب من الموقع الرسمي لكل منها (وليس VS Code)، وبمجرد التثبيت انتقل مباشرةً إلى القسم التالي، تثبيت الإضافة — فسوق الإضافات وخطوات التثبيت مطابقة لـ VS Code.

اذهب إلى code.visualstudio.com وانقر على زر Download؛ سيكتشف الموقع نظام تشغيلك تلقائيًا. يمكنك أيضًا استخدام الروابط المباشرة الرسمية أدناه (بلا رقم إصدار، وتشير دائمًا إلى أحدث إصدار مستقر، دون الحاجة إلى زيارة الموقع أولًا):

التنزيل: مثبّت المستخدم لـ Windows (x64) — لا يحتاج صلاحيات مسؤول، ويثبّت في دليل المستخدم الحالي، وهو التوصية الرسمية. لأجهزة ARM، استخدم بناء ARM64.

التثبيت:

  1. انقر نقرًا مزدوجًا على VSCodeUserSetup-*.exe الذي نزّلته
  2. انقر "Next" عبر الخطوات، وعند "Select Additional Tasks"، حدّد:
    • "Add to PATH" (محدّد افتراضيًا، أبقِه) — يتيح للطرفية استخدام أمر code
    • "Register Code as an editor for supported file types"
    • "Add 'Open with Code' action to the Windows Explorer context menu" (اختياري، ومريح)
  3. شغّل VS Code عند الانتهاء

التنزيل: بناء macOS Universal — حزمة واحدة تدعم شرائح Apple Silicon وIntel معًا.

التثبيت:

  1. ستحصل على VSCode-darwin-universal.zip؛ انقر نقرًا مزدوجًا لفك ضغطه
  2. اسحب Visual Studio Code.app المستخرَج إلى مجلد Applications في Finder
  3. افتح VS Code من Launchpad
  4. (موصى به) اضغط Cmd+Shift+P لفتح لوحة الأوامر وشغّل Shell Command: Install 'code' command in PATH؛ بعدها يمكنك فتح الدليل الحالي في الطرفية بـ code .

اختر حسب التوزيعة:

  • Debian / Ubuntu: نزّل حزمة .deb، ثم sudo apt install ./code_*.deb
  • RHEL / Fedora / openSUSE: نزّل حزمة .rpm، ثم sudo rpm -i code-*.rpm (أو sudo dnf install code-*.rpm)

يضيف تثبيت .deb / .rpm أمر code إلى PATH تلقائيًا، ويربطه بتحديثات البرمجيات في النظام. وبمجرد التثبيت، شغّل code في الطرفية أو أطلقه من قائمة التطبيقات.

الموقع الرسمي أو التنزيل بطيء؟

يبلغ حجم المثبّت 100–200 ميغابايت، وقد تكون تنزيلات المتصفح أحادية المسار بطيئة أحيانًا في الصين. نسخ الروابط المباشرة الرسمية أعلاه إلى أداة تنزيل تدعم التعدد الخيطي عادةً ما يكون أسرع بكثير — فهذه الروابط المباشرة لا تحتوي على رقم إصدار وتشير دائمًا إلى أحدث إصدار مستقر.


تثبيت الإضافة

  1. افتح VS Code (أو Cursor / Trae / Antigravity) واذهب إلى لوحة الإضافات (الاختصار Cmd+Shift+X / Ctrl+Shift+X)
  2. ابحث عن Claude Code for VS Code، وتأكد أنها إصدار Anthropic الرسمي
  3. انقر Install؛ وبمجرد التثبيت، تظهر أيقونة Claude في الشريط الجانبي

ملاحظة لمستخدمي Cursor / Trae / Antigravity

تستخدم بعض المحررات المشتقة من VS Code متجر إضافات خاصًا (مثل Open VSX). إذا لم تجد Claude Code for VS Code:

  1. اذهب إلى صفحة سوق إضافات VS Code الرسمية ونزّل حزمة .vsix
  2. من قائمة في أعلى يمين لوحة الإضافات في المحرر، اختر Install from VSIX

إعداد واجهة LMU AI API

إذا كنت قد أعددت Claude Code CLI مسبقًا، يمكنك تخطي هذا القسم

تقرأ الإضافة ~/.claude/settings.json، تمامًا مثل الـ CLI. المفتاح وعنوان Base URL اللذان أعددتهما في إعداد Claude Code CLI تعيد الإضافة استخدامهما تلقائيًا — دون خطوات إضافية.

وهذا يعني أيضًا أن VS Code وCursor وTrae وAntigravity جميعها تتشارك الإعداد نفسه — غيّره مرة واحدة في أي محرر، ويسري على المحررات الأخرى وعلى الـ CLI.

إذا كانت هذه أول مرة تعدّه فيها، أنشئ ملف الإعداد كما يلي:

mkdir -p ~/.claude && touch ~/.claude/settings.json
mkdir "$env:USERPROFILE\.claude" -Force
New-Item "$env:USERPROFILE\.claude\settings.json" -Force

أضف ما يلي (استبدل المفتاح بمفتاحك):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.lmuai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-lmu-ai-api-key",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

للتفاصيل (بما في ذلك إعدادات النموذج الصيني الافتراضية، وضبط effortLevel، والمزيد)، راجع إعداد Claude Code CLI؛ جميع خيارات الإعداد تنطبق.


إطلاق الإضافة

  1. في المحرر، اضغط Cmd+Shift+P / Ctrl+Shift+P لفتح لوحة الأوامر
  2. اكتب Claude Code: Open، أو انقر ببساطة على أيقونة Claude في الشريط الجانبي
  3. في لوحة المحادثة التي تُفتح، يمكنك التحدث إلى Claude Code، وتوليد الكود، والسماح له بتحرير الملفات تلقائيًا

إعداد واحد، قابل للاستخدام في كل مكان

  • شغّل claude في الطرفية ← استخدم Claude Code CLI
  • انقر على أيقونة Claude في الشريط الجانبي لـ VS Code / Cursor / Trae / Antigravity ← استخدم الإضافة

كلاهما يقرأ ~/.claude/settings.json نفسه، لذا فإن المفتاح وBase URL والنموذج وإعدادات المهلة جميعها تسري في كل مكان عند تغييرها في مكان واحد.


المشكلات الشائعة

401 / Unauthorized في الإضافة

بالطريقة نفسها المتبعة في الـ CLI — عادةً ما يكون السبب متغيرات البيئة في الصدفة ANTHROPIC_BASE_URL / ANTHROPIC_API_KEY التي تتجاوز settings.json. راجع إعداد Claude Code CLI ← المشكلات الشائعة لمعالجة المشكلة.

استخدام نموذج صيني / تبديل النموذج الافتراضي

أضف "model": "qwen3.8-max-preview" إلى settings.json، وسيستخدم الـ CLI وجميع محررات عائلة VS Code هذا النموذج تلقائيًا. راجع معرض النماذج للاطلاع على قائمة النماذج المتاحة.

لا يمكن العثور على الإضافة في Cursor / Trae / Antigravity

اتبع "ملاحظة لمستخدمي Cursor / Trae / Antigravity" السابقة وثبّتها دون اتصال عبر VSIX.

الإضافة أم الـ CLI — أيهما أختار؟

  • تفضّل البرمجة داخل المحرر ← استخدم الإضافة، حيث يبقى كل سياقك داخل المحرر
  • تعمل عبر محررات متعددة، أو تكتب نصوصًا برمجية، أو تشغّل مهام مجمّعة ← استخدم الـ CLI الأكثر مرونة

لا يتفوق أحدهما وظيفيًا على الآخر — اختر ما يناسبك.

آخر تحديث:

في هذه الصفحة