افزونه VS Code برای Claude Code: کلید API و راهاندازی گیتوی سفارشی
در 2026-10-07، مستندات رسمی Claude Code یک روش قابل‌اعتماد برای اتصال افزونه VS Code به یک گیتوی سفارشی ارائه می‌دهند: ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN را در claudeCode.environmentVariables در تنظیمات کاربری VS Code خود قرار دهید، چون افزونه پیش از اجرا اعتبارنامه‌ها را از آن تنظیمات بررسی می‌کند. همان دو مقدار را به بلوک env در ~/.claude/settings.json اضافه کنید تا CLI ترمینال نیز آنها را به اشتراک بگذارد. برای QCode، مقادیر عبارت‌اند از https://api.qcode.cc/api و کلیدی که با cr_ شروع میشود. این صفحه مراحل، نحوه ارتباط افزونه با CLI، و سه مشکل رایج را پوشش میدهد: کلیدی که پیدا نمی‌شود، اعلان ورود که مدام ظاهر میشود، و انتخاب مدل.
بهروزرسانی شده 2026-11-14
این ابزار را به نقطه پایانی QCode متصل کنید — یک کلید برای Claude، GPT و مدل‌های چینی.
- صورت‌حساب به‌ازای توکن — نرخ‌های زنده در /models
- پرداخت با کارت (Visa / Mastercard)، Apple Pay، Google Pay یا رمزارز
- به‌صورت خودخدمت: شارژ حساب و فعال‌سازی فوری
چهار نکته که ابتدا باید بدانید
همه آنچه QCode نیاز دارد
ANTHROPIC_BASE_URL برابر با https://api.qcode.cc/api (تا /api، بدون اسلش انتهایی) و ANTHROPIC_AUTH_TOKEN برابر با کلید cr_ که در داشبورد می‌سازید.
جایگاه قابل‌اعتماد برای اعتبارنامه گیتوی
بر اساس مستندات رسمی، افزونه پیش از اجرا اعتبارنامه‌ها را در claudeCode.environmentVariables بررسی می‌کند؛ مقادیر موجود در ~/.claude/settings.json به فرایند ایجادشده میرسند، اما به بررسی ورود خود افزونه نمیرسند.
پیکربندی مشترک با CLI ترمینال
~/.claude/settings.json بین افزونه و CLI به اشتراک گذاشته میشود. همان دو مقدار را در بلوک env آن قرار دهید تا claude در ترمینال از همان گیتوی استفاده کند. آنها را از .claude/settings.json پروژه که کامیت میشود، بیرون نگه دارید.
پنجره زمینه پشت یک Base URL سفارشی
از نسخه 2.1.285، نشست‌های پشت یک ANTHROPIC_BASE_URL سفارشی، Opus 4.7+، Sonnet 5+ و Fable را مستقیماً با 1M اجرا می‌کنند؛ اگر گیتوی شما در 200K متوقف میشود، فهرست تغییرات رسمی میگوید /autocompact 200k را اجرا کنید.
افزونه VS Code چگونه پیکربندی خود را می‌خواند
در 2026-10-07، پاسخ کوتاه این است که افزونه دو نوع تنظیمات دارد. بر اساس مستندات رسمی، تنظیمات افزونه در VS Code رفتار افزونه را کنترل می‌کنند، در حالی که ~/.claude/settings.json بین افزونه و CLI به اشتراک گذاشته میشود و متغیرهای محیطی، فرمان‌های مجاز، هوک‌ها و سرورهای MCP را نگه می‌دارد. برای یک گیتوی سفارشی، مستندات رسمی گیتوی اعتبارنامه را در claudeCode.environmentVariables در تنظیمات کاربری VS Code شما قرار می‌دهند، چون افزونه پیش از اجرا اعتبارنامه‌ها را همان‌جا بررسی می‌کند. افزونه نسخه خودش از CLI را برای پنل چت همراه دارد، اما claude را به PATH شما اضافه نمیکند؛ برای اجرای claude در ترمینال یکپارچه، به نصب CLI مستقل نیاز دارید. به VS Code 1.94.0 یا جدیدتر نیاز دارد. ورود با اشتراک پرداختی Claude یا حساب Console به کلید API نیازی ندارد؛ با یک گیتوی، متغیر اعتبارنامه جایگزین ورود claude.ai شما میشود.
تغییرات اخیر مرتبط با VS Code (در 2026-10-07)
تا تاریخ 2026-10-07، جدیدترین انتشار در GitHub Releases نسخه 2.1.292 است که در 2026-10-06 (UTC) منتشر شده است. موارد مرتبط با گیتوی: از 2.1.285 به بعد، نشست‌هایی که پشت یک ANTHROPIC_BASE_URL سفارشی قرار دارند از پنجره زمینه 1M مدل‌هایی که چنین پنجره‌ای دارند (Opus 4.7+، Sonnet 5+، Fable) استفاده می‌کنند و گزارش تغییرات رسمی میگوید اگر گیتوی شما روی 200K متوقف میشود، دستور /autocompact 200k را اجرا کنید؛ 2.1.280 یک دیالوگ Status به VS Code اضافه کرد که با تایپ /status باز میشود و نسخه، حساب کاربری، مدل و جزئیات سرور نشست را نشان میدهد؛ از 2.1.277، در جایی که محدودیت‌های پلن اعمال نمی‌شوند (گزارش تغییرات موارد Vertex، Bedrock، Foundry و کلید API را فهرست می‌کند)، دیالوگ Account & usage هزینه و مصرف توکن نشست را نشان میدهد؛ 2.1.290 مشکل ورود و نشست‌های جدید را که در آنها وقتی Claude Code نمی‌تواند برنامه خود را پیدا یا اجرا کند دلیل روشنی ارائه نمی‌شد، برطرف کرد.
جدول زمانی انتشار
2.1.261 منتشر شد (UTC): مشکل ظاهر شدن صفحه ورود VS Code با وجود تنظیم Disable Login Prompt، زمانی که Claude Code ورود نداشتن را گزارش میدهد یا درخواستی به دلیل نداشتن ورود شکست می‌خورد، برطرف شد.
2.1.280 منتشر شد (UTC): VS Code یک دیالوگ Status به دست آورد. در پنل عبارت /status را تایپ کنید تا نسخه، حساب کاربری، مدل و جزئیات سرور نشست را ببینید؛ این کار بررسی اینکه پیکربندی شما اعمال شده است را آسان‌تر می‌کند.
2.1.285 منتشر شد (UTC): نشست‌هایی که پشت یک ANTHROPIC_BASE_URL سفارشی قرار دارند اکنون مدل‌هایی با پنجره 1M (Opus 4.7+، Sonnet 5+، Fable) را مستقیماً با 1M اجرا می‌کنند.
تأییدشده در برابر مستندنشده
تأییدشده (به‌صورت عین عبارت در مستندات)
هر یک از این موارد را می‌توان کلمه به کلمه در مستندات رسمی Claude Code، گزارش تغییرات یا مستندات QCode بررسی کرد: VS Code نسخه 1.94.0 یا بالاتر؛ افزونه CLI را همراه خود دارد اما آن را به PATH اضافه نمیکند؛ ~/.claude/settings.json بین افزونه و CLI مشترک است؛ متغیرهای گیتوی در claudeCode.environmentVariables قرار می‌گیرند و افزونه پیش از اجرا اعتبارنامه‌های آن را بررسی می‌کند؛ Disable Login Prompt اعلان‌های احراز هویت را نادیده می‌گیرد؛ ANTHROPIC_AUTH_TOKEN به‌صورت Authorization: Bearer و ANTHROPIC_API_KEY به‌صورت x-api-key ارسال میشود؛ یک متغیر اعتبارنامه بر ورود ذخیرهشده claude.ai اولویت دارد؛ تنظیم تنها ANTHROPIC_BASE_URL بدون اعتبارنامه، ورود اشتراک را جایگزین نمیکند؛ افزونه و CLI تاریخچه گفتگو را به اشتراک میگذارند؛ تغییر به پنجره پیش‌فرض 1M در 2.1.285؛ و مقادیر QCode یعنی https://api.qcode.cc/api و یک کلید cr_.
مستندنشده یا تأییدنشده
این صفحه درباره سه نکته نتیجه‌گیری نمیکند. نخست، تا تاریخ 2026-10-07 جدول تنظیمات رسمی افزونه، تنظیم جداگانه‌ای برای کلید API یا Base URL فهرست نمیکند؛ این صفحه تنها مکان‌های پیکربندی را که مستندات رسمی فهرست کرده‌اند پوشش میدهد و رویکردهای دیگر مبتنی بر فایل پیکربندی خارج از محدوده آن هستند. دوم، مستندات رسمی می‌گویند Claude Code نمی‌تواند سقف پایین‌تری را که گیتوی اعمال می‌کند تشخیص دهد، بنابراین اینکه گیتوی شما 1M را می‌پذیرد یا نه را باید مستندات خودش یا آزمون خودتان نشان دهد. سوم، نام تنظیمات و دکمه‌های افزونه بین نسخه‌ها تغییر می‌کنند؛ این صفحه از مستندات رسمی دریافت‌شده در 2026-10-07 پیروی می‌کند بدون آنکه هر نسخه را آزموده باشد، پس ملاک شما نسخه‌ای است که در اختیار دارید.
کجا قرار می‌گیرد و چه نسبتی با CLI دارد
environmentVariables در برابر settings.json
نوشتن هر دو ساده‌ترین کار است. claudeCode.environmentVariables یک تنظیم کاربری VS Code است که متغیرهای محیطی را برای فرایند Claude تعیین می‌کند؛ افزونه پیش از اجرا اعتبارنامه‌های آن را بررسی می‌کند و به همین دلیل مستندات رسمی گیتوی اعتبارنامه را همان‌جا قرار می‌دهند. بلوک env در ~/.claude/settings.json بین افزونه و CLI ترمینال مشترک است و مستندات رسمی VS Code آن را برای پیکربندی مشترک توصیه می‌کنند. اگر فقط دومی را بنویسید، مقادیر به فرایند میرسند اما به بررسی ورود خود افزونه نمیرسند؛ اگر فقط اولی را بنویسید، پیکربندی با CLI ترمینال مشترک نیست.
افزونه VS Code در برابر CLI ترمینال
هر دو همان فایلهای تنظیمات را میخوانند و تاریخچه گفتگو را به اشتراک میگذارند: برای ادامه یک گفتگوی افزونه، در ترمینال دستور claude --resume را اجرا کنید. تفاوت در قابلیت‌هاست. جدول مقایسه رسمی میگوید CLI همه فرمان‌ها و مهارت‌ها را دارد در حالی که افزونه زیرمجموعه‌ای از آنها را دارد (برای دیدن آنها / را تایپ کنید)؛ میان‌بر ! Bash و تکمیل خودکار با Tab فقط مخصوص CLI هستند. افزونه claude را به PATH شما اضافه نمیکند، بنابراین CLI به نصب جداگانه خود نیاز دارد؛ وقتی افزونه نشان نمی‌دهد چرا چیزی شکست خورده است، توصیه رسمی این است که برای پیام‌های خطای دقیق‌تر، claude را در ترمینال اجرا کنید.
پنج گام تا اتصال به یک گیتوی سفارشی
① نصب افزونه: نمای Extensions را باز کنید (Cmd+Shift+X / Ctrl+Shift+X)، عبارت Claude Code را جستوجو کنید و روی Install کلیک کنید، یا در ترمینال دستور code --install-extension anthropic.claude-code را اجرا کنید؛ VS Code نسخه 1.94.0 یا بالاتر لازم است. ② از Command Palette گزینه Preferences: Open User Settings (JSON) را اجرا کنید و claudeCode.environmentVariables را با دو ورودی اضافه کنید: name با مقدار ANTHROPIC_BASE_URL و value برابر https://api.qcode.cc/api، و name با مقدار ANTHROPIC_AUTH_TOKEN و value برابر کلید cr_ شما. ③ اگر هنوز صفحه ورود نمایش داده میشود، تنظیمات را باز کنید، عبارت Claude Code login را جستوجو کنید و Disable Login Prompt را تیک بزنید (مستندات رسمی آن را رد کردن اعلان‌های احراز هویت برای راه‌اندازی‌های شخص ثالث توصیف می‌کند). ④ برای اشتراک‌گذاری این پیکربندی با CLI ترمینال، همان دو مقدار را به بلوک env در ~/.claude/settings.json اضافه کنید (در Windows: %USERPROFILE%\.claude\settings.json)؛ آنها را در .claude/settings.json یک پروژه قرار ندهید. ⑤ دستور Developer: Reload Window را اجرا کنید، در پنل عبارت /status را تایپ کنید تا نسخه، حساب کاربری، مدل و جزئیات سرور را بررسی کنید، سپس یک پیام آزمایشی بفرستید.
در QCode
در QCode، این دو مقدار از مستندات QCode می‌آیند: ANTHROPIC_BASE_URL=https://api.qcode.cc/api (تا /api، بدون اسلش انتهایی) و ANTHROPIC_AUTH_TOKEN برابر با کلیدی که با cr_ شروع میشود (ساخته‌شده در داشبورد)، که Claude Code آن را به‌صورت توکن Bearer ارسال می‌کند. مدل‌های Claude فقط از طریق نقطه پایانی پروتکل Anthropic کار می‌کنند و افزونه VS Code نیز از همین پروتکل استفاده می‌کند. مدل‌های Claude که می‌توانید در QCode فراخوانی کنید شامل claude-sonnet-5-5، claude-opus-5-5 و claude-sonnet-5 هستند؛ صورت‌حساب بر اساس توکن است، قیمت هر مدل در /models آمده و خانواده Claude رده جداگانه‌ای برای زمینه بلند ندارد. در آمریکای شمالی و اروپا می‌توانید از us.qcode.cc (لس‌آنجلس) استفاده کنید؛ برای شبکه‌های سرزمین اصلی چین، مستندات asia.qcode.cc را پیشنهاد میدهد، با همان مسیر و همان کلید. هر درخواست را می‌توان در probe.qcode.cc با وارد کردن کلید خود بررسی کرد.
پرسش‌های متداول
کلید API و Base URL سفارشی Claude Code را در VS Code کجا وارد می‌کنید؟
در claudeCode.environmentVariables در تنظیمات کاربری VS Code. از Command Palette گزینه Preferences: Open User Settings (JSON) را اجرا کنید و دو ورودی ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN را اضافه کنید؛ برای QCode از https://api.qcode.cc/api و کلید cr_ خود استفاده کنید. تا تاریخ 2026-10-07، جدول تنظیمات افزونه رسمی هیچ تنظیم جداگانه‌ای برای کلید API یا Base URL فهرست نمیکند و مستندات رسمی درگاه میگوید افزونه پیش از راهاندازی، اعتبارنامه را از همین تنظیم بررسی می‌کند؛ بنابراین این مکان قابل‌اعتمادترین جای قرار دادن اعتبارنامه درگاه است.
متغیرها را در ترمینال export کردم، اما افزونه هنوز کلید را پیدا نمیکند. چرا؟
به احتمال زیاد متغیرها هرگز به VS Code نرسیدهاند. مستندات رسمی میگوید exportهای شل فقط بر همان نشست ترمینال و برنامههایی که از آن اجرا میشوند اثر میگذارد و ویرایشگری که از dock یا منوی Start اجرا شود آنها را نمیبیند. قرار دادن آنها فقط در بلوک env فایل ~/.claude/settings.json هم کافی نیست: آن مقادیر به فرایند ایجادشده میرسند اما به بررسی ورود خود افزونه نمیرسند. هر دو را به claudeCode.environmentVariables اضافه کنید، دستور Developer: Reload Window را اجرا کنید و در پنل /status را تایپ کنید تا بررسی شود.
چرا پس از پیکربندی همهچیز، هنوز از شما میخواهد وارد شوید؟
معمولاً بررسی ورود افزونه اعتبارنامهای نمیبیند. ابتدا مطمئن شوید که اعتبارنامه در claudeCode.environmentVariables قرار دارد و فقط ANTHROPIC_BASE_URL را تنظیم نکردهاید: مستندات رسمی میگوید تنظیم Base URL بدون متغیر اعتبارنامه، اشتراک را جایگزین نمیکند و ورود ذخیرهشده claude.ai اعتبارنامه فعال باقی میماند. اگر صفحه ورود هنوز نمایش داده میشود، در تنظیمات عبارت Claude Code login را جستوجو کنید و Disable Login Prompt را تیک بزنید؛ نسخه 2.1.261 نمایش این صفحه را با وجود آن تنظیم برطرف کرد، پس ابتدا نسخههای قدیمیتر را بهروزرسانی کنید. اگر هنگام راهاندازی هشداری نمایش داده میشود که دو منبع اعتبارنامه را نام میبرد و با auth may not work as expected پایان مییابد، راهحل رسمی اجرای /logout است تا فقط اعتبارنامه درگاه باقی بماند.
آیا افزونه VS Code و CLI ترمینال میتوانند از یک پیکربندی مشترک استفاده کنند؟
بله، از طریق ~/.claude/settings.json. مستندات رسمی میگوید ترمینال، افزونههای VS Code و JetBrains و اپ دسکتاپ همگی همان فایلهای تنظیمات را میخوانند؛ ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN را در بلوک env آن قرار دهید تا claude در ترمینال از همان گیتوی استفاده کند. وقتی یک export شل و بلوک env فایل تنظیمات یک متغیر را مقداردهی کنند، مقدار فایل تنظیمات اعمال میشود. این دو تاریخچه گفتگو را نیز به اشتراک میگذارند، بنابراین claude --resume در ترمینال گفتگوی یک افزونه را ادامه میدهد. توجه کنید که افزونه claude را به PATH شما اضافه نمیکند؛ CLI به نصب جداگانه خود نیاز دارد.
چگونه یک مدل را انتخاب کنم و اگر مدل مورد نظرم در انتخاب‌گر نباشد چه؟
روی دکمه مدل زیر جعبه prompt کلیک کنید یا /model را تایپ کنید؛ همچنین می‌توانید متغیر محیطی ANTHROPIC_MODEL یا فیلد model را در یک فایل تنظیمات تنظیم کنید. مستندات رسمی میگوید /model انتخاب شما را به‌عنوان پیش‌فرض نشست‌های جدید در فیلد model تنظیمات کاربر ذخیره می‌کند، بنابراین افزونه و CLI همان پیش‌فرض را میخوانند. اگر نام‌های مدل گیتوی شما در فهرست داخلی Claude Code نیستند، راهحل رسمی CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 است که انتخاب‌گر را از فهرست مدل‌های گیتوی پر می‌کند. در QCode، مدل می‌تواند claude-sonnet-5-5، claude-opus-5-5 یا claude-sonnet-5 باشد؛ فهرست فعلی در /models است.
آیا باید از ANTHROPIC_AUTH_TOKEN استفاده کنم یا از ANTHROPIC_API_KEY؟
برای QCode از ANTHROPIC_AUTH_TOKEN استفاده کنید. مستندات رسمی میگوید این مقدار در هدر Authorization: Bearer ارسال میشود، در حالی که ANTHROPIC_API_KEY در x-api-key قرار می‌گیرد؛ اعتبارنامهای که در متغیر اشتباه باشد، در هدری به گیتوی می‌رسد که آن را نمی‌خواند و با 401 شکست می‌خورد، بنابراین به متغیر دیگر تغییر دهید و دوباره تلاش کنید. مستندات QCode طبق قرارداد کلید را در ANTHROPIC_AUTH_TOKEN قرار می‌دهند، و ابزاری که فقط ANTHROPIC_API_KEY را می‌خواند نیز با همان کلید cr_ کار می‌کند. یک تفاوت دیگر: ANTHROPIC_API_KEY پیش از آنکه جای ورود ذخیرهشده را بگیرد، در حالت تعاملی به تأیید یک‌باره نیاز دارد، در حالی که ANTHROPIC_AUTH_TOKEN بلافاصله بر ورود ذخیرهشده اولویت می‌گیرد.
منابع
مکان‌های پیکربندی و رفتار افزونه: صفحه مستندات رسمی Claude Code برای VS Code (code.claude.com: پیش‌نیازها، جدول تنظیمات افزونه، مراحل راهاندازی شخص ثالث، مقایسه با CLI و رفع اشکال‌های رایج)، به‌همراه صفحه‌های اتصال به گیتوی LLM، نمای کلی گیتوی LLM، احراز هویت، تنظیمات، متغیرهای محیطی و پیکربندی مدل، که همه در 2026-10-07 واکشی شده‌اند. تغییرات نسخه: زمان‌های انتشار (UTC) در CHANGELOG و GitHub Releases مخزن anthropics/claude-code، که همان روز واکشی شده‌اند. مقادیر QCode: صفحه‌های مستندات QCode درباره متغیرهای محیطی (به‌روزرسانی‌شده در 2026-09-25)، نقاط پایانی و قالب‌های API، و یکپارچه‌سازی با VS Code (به‌روزرسانی‌شده در 2026-09-18)، به‌همراه صفحه /models، که همان روز واکشی شده‌اند.
اتصال VS Code به QCode
دو متغیر و یک کلید cr_، مشترک بین افزونه و CLI ترمینال. صورت‌حساب بر اساس توکن است؛ برای قیمت هر مدل /models را ببینید.
مطالب مرتبط
توکن OAuth در Claude Code منقضی شد: بازیابی اجراهای بدون‌نظارت claude -p، cron و CI
بررسی‌شده در 2026-10-26: خطای رسمی انقضای ورود در Claude Code، توکن یک‌ساله claude setup-token، ANTHROPIC_API_KEY و ANTHROPIC_AUTH_TOKEN، و هشدار --bare.
Claude Code بدون اشتراک Claude: مسیرهای ورود
مسیرهای ورود که مستند رسمی فهرست می‌کند، قواعد اعتبار در سمت Console، به‌همراه دو متغیر محیطی QCode و اسکریپت تک‌کلیکی.
Claude Code در چین: راهنمای کامل
یادداشت‌های راهاندازی برای توسعه‌دهندگان در سرزمین اصلی چین که از Claude Code و Codex API استفاده می‌کنند، با پرداخت از طریق Alipay.
راهنمای پرداخت با رمزارز
نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.
مراحل و نقل‌قول‌های این صفحه در 2026-10-07 با مستندات رسمی Claude Code، تغییرات نسخه و مستندات QCode بررسی شده‌اند؛ ممکن است تغییرات بدون اطلاع قبلی رخ دهند. صفحه‌های افزونه و نام تنظیمات بین نسخه‌ها تغییر می‌کنند، بنابراین بر اساس نسخه‌ای که دارید عمل کنید؛ دسترس‌پذیری مدل همان چیزی است که /models نشان میدهد.