یکپارچه‌سازی 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. پنل Extensions را باز کنید (Ctrl+Shift+X / Cmd+Shift+X)

2. عبارت «Claude Code for VS Code» را جستجو کنید

3. روی Install کلیک کنید

یا از طریق خط فرمان نصب کنید:

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" } ] }
]

راه‌اندازی کامل هر سه پروتکل، BYOK در Copilot CLI و محدودیت‌های شناخته‌شده (تکمیل‌های درون‌خطی همچنان از طریق 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 را بررسی کنید تا بهره‌وری را افزایش دهید

• نکات جریان کار را بیاموزید تا جریان توسعه را بهینه کنید

سازمانی ←