پرش به مطلب اصلی

اتصال افزونه‌های Claude Code و Codex در VS Code

افزونه‌های رسمی از تنظیمات ابزار خط فرمان همان محصول استفاده می‌کنند. ابتدا راهنمای CLI را کامل کنید و بعد افزونه را نصب کنید.

افزونه هوش مصنوعی VS Code چه کاری انجام می‌دهد؟​

افزونه coding agent امکانات مدل را داخل محیط ویرایش کد می‌آورد؛ بنابراین عامل می‌تواند با آگاهی از فایل‌های پروژه درباره کد گفت‌وگو کند، تغییر پیشنهادی بسازد و در محدوده مجوزهایی که شما تأیید می‌کنید با ابزارهای توسعه کار کند. مزیت اصلی نسبت به چت عمومی، حفظ جریان کار در همان editor و دسترسی ساختاریافته‌تر به repository است.

Claude Code و Codex علاوه بر CLI، افزونه رسمی VS Code دارند. تنظیم provider و کلید میان CLI و افزونه مشترک است؛ پس می‌توانید اتصال را ابتدا در ترمینال آزمایش کنید و بعد همان پیکربندی را در محیط گرافیکی به کار ببرید. اگر افزونه بسته به‌روز محیط shell را نمی‌بیند، بخش «رساندن کلید به افزونه» را دنبال کنید.

برای افزونه‌هایی که provider عمومی OpenAI-compatible دارند، راهنمای Cline، Continue و Roo Code را ببینید.

Claude Code در VS Code​

۱. نصب​

  1. VS Code را باز کنید.
  2. با Ctrl/Cmd + Shift + X وارد Extensions شوید.
  3. Claude Code را جست‌وجو کنید.
  4. افزونه‌ای را انتخاب کنید که ناشر آن Anthropic است.
  5. افزونه را نصب و پنل Claude Code را باز کنید.

۲. تنظیم مشترک CLI و افزونه​

فایل زیر را بسازید:

سیستم‌عاملمسیر
Windows%USERPROFILE%\.claude\settings.json
macOS و Linux~/.claude/settings.json

محتوا:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.chabokan.net",
    "ANTHROPIC_AUTH_TOKEN": "sk-chbk-کلید-واقعی-شما",
    "ANTHROPIC_MODEL": "anthropic/شناسه-مدل-اصلی",
    "ANTHROPIC_SMALL_FAST_MODEL": "anthropic/شناسه-مدل-سریع"
  }
}

هر دو شناسه باید عیناً در فهرست مدل‌های پلن وجود داشته باشند. اگر فقط یک مدل مناسب دارید، همان شناسه را برای هر دو مقدار قرار دهید.

۳. آزمایش​

  1. پنجره VS Code را Reload کنید.
  2. یک پروژه را باز کنید.
  3. در پنل Claude Code بنویسید: فقط نام پوشه جاری را بگو و هیچ فایلی را تغییر نده.
  4. در پنل چابکان، گزارش درخواست با endpoint نوع messages را بررسی کنید.

Codex در VS Code​

۱. نصب​

  1. در Extensions عبارت Codex را جست‌وجو کنید.
  2. افزونه‌ای را انتخاب کنید که ناشر آن OpenAI است.
  3. افزونه را نصب و پنل Codex را باز کنید.

۲. تنظیم provider​

فایل زیر بین CLI و افزونه مشترک است:

سیستم‌عاملمسیر
Windows%USERPROFILE%\.codex\config.toml
macOS و Linux~/.codex/config.toml
model = "openai/gpt-4o-mini"
model_provider = "chabokan"

[model_providers.chabokan]
name = "Chabokan AI"
base_url = "https://ai.chabokan.net/v1"
env_key = "CHABOKAN_AI_API_KEY"
wire_api = "responses"

مقدار model را با شناسه واقعی پنل جایگزین کنید.

۳. رساندن کلید به افزونه​

افزونه‌ای که از محیط گرافیکی اجرا شده ممکن است متغیر shell را نبیند. یکی از این روش‌ها را انتخاب کنید:

  1. VS Code را از ترمینالی اجرا کنید که CHABOKAN_AI_API_KEY در آن export شده است.
  2. متغیر را در سطح کاربر سیستم‌عامل تعریف و سپس VS Code را کامل ببندید و دوباره باز کنید.
  3. در محیط سازمانی، متغیر را با secret manager یا سیاست مدیریت‌شده سیستم توزیع کنید.

کلید را به‌صورت متن مستقیم در config.toml قرار ندهید.

۴. آزمایش​

  1. پنجره VS Code را Reload کنید.
  2. در پنل Codex درخواست کوتاهی ارسال کنید.
  3. در گزارش درخواست‌های چابکان endpoint نوع responses را بررسی کنید.

تشخیص سریع خطا​

خطابررسی
401کلید به process افزونه نرسیده یا اشتباه است
مدل پیدا نشدمدل‌های اصلی و سریع در Claude یا مقدار model در Codex را از پنل کپی کنید
مسیر نامعتبر در ClaudeANTHROPIC_BASE_URL باید بدون /v1 باشد
مسیر نامعتبر در Codexbase_url باید با /v1 و wire_api = "responses" باشد

راهنمای کامل‌تر: Claude Code، Codex CLI، عیب‌یابی