# تكامل VS Code

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

## نظرة سريعة

| العنصر | التفاصيل |
|---|---|
| النماذج التي يمكنك استخدامها | Claude ✅ (الإضافة عبر بروتوكول Anthropic / Copilot عبر Messages) · GPT ✅ · النماذج الصينية ✅ (نقطة نهاية مخصصة في Copilot) · Gemini ❌ |
| البروتوكول و Base URL | إضافة Claude Code: متغيرات البيئة على `https://api.qcode.cc/api` · Copilot: عناوين URL كاملة في `chatLanguageModels.json` |
| مكان الإعداد | `~/.claude/config.json` + متغيرات البيئة؛ يستخدم Copilot ملف `chatLanguageModels.json` |
| الوثائق الرسمية | [إضافة Claude Code](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code) · [نماذج اللغة](https://code.visualstudio.com/docs/agent-customization/language-models) |

> **هل تستخدم Trae IDE؟** إن Trae نسخة متفرعة من VS Code، لذا تنطبق معظم الخطوات هنا مباشرة. للتفاصيل الخاصة بـ Trae — اختلافات متجر الإضافات، وتثبيت `.vsix` دون اتصال، والتعايش مع الذكاء الاصطناعي المدمج في Trae — راجع [دليل تكامل Trae](/docs/ide/trae).

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

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

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

1. **أن يكون Claude Code CLI مثبتًا ويعمل**
   - راجع [دليل التثبيت](/docs/getting-started/installation) لإكمال التثبيت
   - راجع [إعداد البيئة](/docs/getting-started/environment) لإكمال الإعداد

2. **إصدار VS Code >= 1.98.0**

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

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

إذا لم يكن VS Code مثبتًا، فزر [موقع VS Code](https://code.visualstudio.com/) لتنزيله وتثبيته.

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

في VS Code:

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

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

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

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

```bash
code --install-extension anthropic.claude-code
```

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

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

<div data-os="windows" markdown="1">

#### Windows

حرّر ملف الإعدادات `C:\Users\YourUsername\.claude\config.json` أو أنشئه:

```json
{
  "primaryApiKey": "qcode"
}
```

</div>

<div data-os="macos" markdown="1">

#### macOS

حرّر ملف الإعدادات `~/.claude/config.json` أو أنشئه:

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

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

</div>

<div data-os="linux" markdown="1">

#### Linux

حرّر ملف الإعدادات `~/.claude/config.json` أو أنشئه:

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

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

</div>

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

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

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

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

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

| الاختصار | الوظيفة |
|----------|----------|
| `Cmd+Esc` / `Ctrl+Esc` | فتح/إغلاق لوحة Claude Code |
| `Cmd+Shift+P` / `Ctrl+Shift+P` | فتح لوحة الأوامر، وابحث عن أوامر Claude |

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

1. **شرح الكود**
   - حدد الكود
   - انقر بزر الفأرة الأيمن واختر «Ask Claude» أو استخدم الاختصار
   - أدخل سؤالك، مثل: «اشرح هذا الكود»

2. **توليد الكود**
   - افتح لوحة Claude
   - صف الميزة التي تحتاجها
   - سيولّد Claude الكود مع خيارات الإدراج

3. **إعادة هيكلة الكود**
   - حدد الكود المراد إعادة هيكلته
   - اطلب من Claude المساعدة في إعادة الهيكلة
   - عاين التغييرات وطبّقها

4. **إصلاح الأخطاء**
   - عندما يحتوي الكود على أخطاء
   - حدد رمز الخطأ أو رسالته
   - اطلب من Claude تحليل المشكلة وتقديم إصلاحات

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

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

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

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

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

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

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

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

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

| السيناريو | الأداة الموصى بها |
|----------|-----------------|
| تعديلات الكود السريعة | إضافة VS Code |
| تحليل المشاريع المعقدة | CLI الطرفي |
| مراجعة الكود | أي منهما |
| عمليات Git | CLI الطرفي |
| توليد الملفات | أي منهما |

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

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

```json
[
  { "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](/docs/ide/github-copilot).

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

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

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

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

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

### خطأ primaryApiKey

1. تأكد من صحة مسار الملف:
   - Windows: `C:\Users\YourUsername\.claude\config.json`
   - macOS/Linux: `~/.claude/config.json`

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

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

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

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

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

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

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

- استكشف [نصائح CLI](/docs/usage/cli-tips) لتعزيز الكفاءة

- تعلّم [نصائح سير العمل](/docs/usage/workflow-tips) لتحسين مسار التطوير