تكامل VS Code

استخدام إضافة Claude Code ونقاط النهاية المخصصة في GitHub Copilot داخل VS Code: تثبيت الإضافة، وإعداد primaryApiKey، وتوصيل QCode عبر chatLanguageModels.json

تحتاج مفتاح API؟ أنشئ حسابًا ←·نقاط النهاية وعناوين Base URL ←

آخر تحقق: 2026-09-18 · 📄 وفقًا للوثائق الرسمية (VS Code 1.138.0، صدر في 2026-09-16)

نظرة سريعة¶

هل تستخدم Trae IDE؟ إن Trae نسخة متفرعة من VS Code، لذا تنطبق معظم الخطوات هنا مباشرة. للتفاصيل الخاصة بـ Trae — اختلافات متجر الإضافات، وتثبيت .vsix دون اتصال، والتعايش مع الذكاء الاصطناعي المدمج في Trae — راجع دليل تكامل Trae.

بالإضافة إلى استخدام Claude Code CLI في الطرفية، يمكنك استخدام إضافة VS Code للوصول إلى Claude Code مباشرةً في المحرر لتجربة تطوير أكثر ملاءمة.

المتطلبات الأساسية¶

قبل إعداد إضافة VS Code، تأكد مما يلي:

1. أن يكون Claude Code CLI مثبتًا ويعمل

2. راجع دليل التثبيت لإكمال التثبيت

3. راجع إعداد البيئة لإكمال الإعداد

4. إصدار VS Code >= 1.98.0

خطوات التثبيت¶

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

إذا لم يكن VS Code مثبتًا، فزر موقع VS Code لتنزيله وتثبيته.

الخطوة 2: تثبيت إضافة Claude Code¶

في VS Code:

1. افتح لوحة الإضافات (Ctrl+Shift+X / Cmd+Shift+X)

2. ابحث عن "Claude Code for VS Code"

3. انقر على تثبيت

أو ثبّت عبر سطر الأوامر:

code --install-extension anthropic.claude-code

الخطوة 3: إعداد primaryApiKey¶

هذه خطوة بالغة الأهمية! تتطلب إضافة Claude Code وجود primaryApiKey في ملف الإعدادات.

{
  "primaryApiKey": "qcode"
}

# Create directory (if it doesn't exist)
mkdir -p ~/.claude

# Create config file
cat > ~/.claude/config.json << 'EOF'
{
  "primaryApiKey": "qcode"
}
EOF

# Create directory (if it doesn't exist)
mkdir -p ~/.claude

# Create config file
cat > ~/.claude/config.json << 'EOF'
{
  "primaryApiKey": "qcode"
}
EOF

ملاحظة: يمكن أن تكون قيمة primaryApiKey أي قيمة (مثل qcode). كل ما تحتاجه هو إعداد هذا الحقل. لا تزال مصادقة API الفعلية تستخدم ANTHROPIC_AUTH_TOKEN الذي أعددته في متغيرات البيئة.

مهم: ملف الإعدادات هو config.json، وليس settings.json. يُرجى التمييز بين هذين الملفين بعناية.

الخطوة 4: إعادة تشغيل VS Code¶

بعد الإعداد، أعد تشغيل VS Code لتسري التغييرات.

الاستخدام¶

اختصارات لوحة المفاتيح¶

الميزات الشائعة¶

1. شرح الكود

2. حدد الكود

3. انقر بزر الفأرة الأيمن واختر «Ask Claude» أو استخدم الاختصار

4. أدخل سؤالك، مثل: «اشرح هذا الكود»

5. توليد الكود

6. افتح لوحة Claude

7. صف الميزة التي تحتاجها

8. سيولّد Claude الكود مع خيارات الإدراج

9. إعادة هيكلة الكود

10. حدد الكود المراد إعادة هيكلته

11. اطلب من Claude المساعدة في إعادة الهيكلة

12. عاين التغييرات وطبّقها

13. إصلاح الأخطاء

14. عندما يحتوي الكود على أخطاء

15. حدد رمز الخطأ أو رسالته
16. اطلب من Claude تحليل المشكلة وتقديم إصلاحات

خيارات التكوين¶

في إعدادات VS Code، يمكنك تكوين سلوك إضافة Claude Code:

1. افتح الإعدادات (Ctrl+, / Cmd+,)

2. ابحث عن «Claude Code»

3. عدّل الخيارات حسب الحاجة

الإعدادات الشائعة¶

{
  "claude-code.autoSuggest": true,
  "claude-code.inlineChat": true
}

الاستخدام مع CLI الطرفي¶

يمكن استخدام إضافة VS Code وCLI الطرفي معًا:

نقاط النهاية المخصصة لـ GitHub Copilot¶

منذ VS Code 1.122، تتيح ميزة Copilot Custom Endpoint المدمجة توصيل بروتوكولات QCode مباشرةً بـ Copilot (Claude فقط عبر messages، ويأخذ url المسار الكامل). الحد الأدنى من التكوين:

[
  { "name": "QCode Claude", "vendor": "customendpoint", "apiKey": "cr_your-QCode-key",
    "apiType": "messages",
    "url": "https://api.qcode.cc/api/v1/messages",
    "toolCalling": true,
    "models": [ { "id": "claude-sonnet-5" } ] }
]

يتوفر التكوين الكامل للبروتوكولات الثلاثة جميعها، وCopilot CLI BYOK، والحدود المعروفة (لا تزال الإكمالات المضمّنة تعمل عبر GitHub) في الصفحة المخصصة: تكامل GitHub Copilot.

استكشاف الأخطاء وإصلاحها¶

الإضافة لا تبدأ¶

1. تأكد من تثبيت Claude Code CLI بشكل صحيح

2. تحقق من تكوين متغيرات البيئة

3. تحقق من صحة تنسيق ملف config.json

خطأ primaryApiKey¶

1. تأكد من صحة مسار الملف:

2. Windows: C:\Users\YourUsername\.claude\config.json

3. macOS/Linux: ~/.claude/config.json

4. تأكد من أنه config.json وليس settings.json

5. تأكد من أن تنسيق JSON صالح

انتهاء مهلة الاتصال¶

1. تحقق من اتصال الشبكة

2. تحقق من متغير البيئة ANTHROPIC_BASE_URL

3. جرّب تشغيل claude في الطرفية للتأكد من أن CLI يعمل

الخطوات التالية¶

• استكشف نصائح CLI لتعزيز الكفاءة

• تعلّم نصائح سير العمل لتحسين مسار التطوير

المؤسسات ←