VS Code
افزونهٔ Claude Code در VS Code با OneProvider: افزودن نقطهٔ پایانی و کلید در settings.json، راهاندازی مجدد، رد کردن درخواست ورود و آزمایش اتصال.
افزونهٔ Claude Code برای VS Code متغیرهای محیطی را از یک settings.json کنار پوشهٔ خانگی شما میخواند. endpoint و کلید OneProvider را بگذارید و دوباره راهاندازی کنید.
همهٔ مدلها، قابلیتها و قیمتها فهرست مستندات برای عاملهای هوش مصنوعی:https://oneprovider.dev/docs/llms.txt سیستمعامل پیش از شروع: یک کلید از حساب کاربری حساب کاربری خود را باز کنید: ربات Telegram به نام @oneprovider_robot (بخش «حساب کاربری») یا app.oneprovider.dev . «صدور کلید» را بزنید، یک نام (مثلاً نام همین کلاینت) و سقف مصرف بدهید و کلید را کپی کنید. شارژ موجودی هم همانجاست. اطلاعات بیشتر دربارهٔ حساب کاربری و کلیدها . نصب
در VS Code Marketplace عبارت «Claude Code» را جستوجو کنید (ناشر anthropic.claude-code) و نصب کنید. افزونه محیط اجرای خودش را همراه دارد — برای محیط ویرایشگر به نصب CLI جداگانه نیازی نیست.
پیکربندی
یک settings.json در مسیر مخصوص سیستمعامل خود (در زیر) بسازید. افزونه این فایل را هنگام شروع میخواند و بلوک env را برای هر درخواست خروجی به کار میبرد.
مسیر: ~/.claude/settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.oneprovider.dev",
"ANTHROPIC_AUTH_TOKEN": "sk-your-key-here",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
}
} اگر فایل وجود ندارد آن را بسازید، سپس VS Code را کامل ببندید و دوباره باز کنید تا بلوک env جدید بارگذاری شود.
اگر افزونه از شما ورود خواست
افزونه پیش از شروع اعتبارنامهها را بررسی میکند و اگر حساب Claude ندارید ممکن است صفحهٔ ورود نشان دهد. راهحل مطمئن این است که آدرس و کلید را در تنظیمات کاربر خود VS Code تنظیم کنید: Command Palette ( ⌘⇧P / Ctrl+Shift+P ) را باز کنید ← Preferences: Open User Settings (JSON) و این را اضافه کنید (در macOS، Linux و Windows یکسان است):
{
"claudeCode.disableLoginPrompt": true,
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://api.oneprovider.dev" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-your-key-here" }
]
} VS Code را دوباره راهاندازی کنید. کلید OneProvider هم بهعنوان ANTHROPIC_AUTH_TOKEN (Bearer) و هم بهعنوان ANTHROPIC_API_KEY کار میکند.
بررسی
پنل Claude Code را باز کنید ( ⌘⇧P / Ctrl+Shift+P ← Claude Code: Focus)، ping را تایپ و ارسال کنید. پاسخ ظرف چند ثانیه نشان میدهد بازنویسی endpoint اعمال شده است.
کدام مدل را انتخاب کنیم
افزونه همان موتور Claude Code را اجرا میکند، پس مدلها را به همان شیوه انتخاب کنید. claude-sonnet-5-5 را برای ویرایشهای روزانه پیشفرض نگه دارید، برای بازسازیهای بزرگ به claude-opus-5-5 بروید و claude-haiku-5-5 را برای پرسشهای ارزان و سریع به کار ببرید. مدل را با /model در پنل عوض کنید. شناسهها و نرخها در صفحهٔ مدلها و صفحهٔ قیمتها است؛ سقف مصرف روی کلید هزینه را قابل پیشبینی نگه میدارد.
خطاهای رایج و راهحلها
افزونه صفحهٔ ورود نشان میدهد
افزونه پیش از شروع اعتبارنامهها را بررسی میکند. claudeCode.disableLoginPrompt و بلوک claudeCode.environmentVariables بخش بالا را به تنظیمات کاربر (JSON) در VS Code اضافه کنید، سپس VS Code را کامل دوباره راهاندازی کنید.
401 Invalid API key
مقدار یک نقلقول یا فاصلهٔ اضافی دارد، یا یک ANTHROPIC_AUTH_TOKEN بیگانه از سرویس دیگری بر کلید شما اولویت پیدا میکند. کل کلید OneProvider را بدون نقلقول و فقط در یک جا تنظیم کنید.
404 یا endpoint اشتباه
base URL برابر https://api.oneprovider.dev و بدون /v1 است. افزونه مسیر را خودش اضافه میکند.
بعد از ویرایش تنظیمات چیزی تغییر نکرد
VS Code را کامل ببندید (فقط بارگذاری مجدد پنجره کافی نیست) تا بلوک env جدید بارگذاری شود. در پنجرهٔ Remote-SSH، WSL یا dev-container، افزونه معمولاً تنظیمات را سمت راه دور میخواند، پس آنها را همانجا بگذارید.
استریمها قطع میشوند
VPN یا پروکسیهای VLESS را روی ماشینی که افزونه را اجرا میکند خاموش کنید: SSE را بافر میکنند و HTTP/2 را خراب میکنند.
بلوک را در settings.json جایگذاری کردم و چیزی تغییر نکرد
این دو فایل متفاوتاند. بلوک env به ~/.claude/settings.json میرود؛ تنظیمات کاربر خود VS Code (JSON) فقط کلیدهای claudeCode.disableLoginPrompt و claudeCode.environmentVariables از بخش بالا را میپذیرد. مطمئن شوید در ~/.claude/settings.json بعد از آخرین مورد ویرگول نیست و سپس VS Code را کامل ببندید.
پرسشهای متداول
به Claude Code CLI هم نیاز دارم؟
نه. افزونه محیط اجرای خودش را همراه دارد. اگر از CLI هم استفاده میکنید، هر دو همان ~/.claude/settings.json را میخوانند، به Claude Code نگاه کنید.
به اشتراک Claude نیاز دارم؟
نه، کلید OneProvider کافی است.
چه قالب کلیدی را میپذیرد؟
کلید خام sk-… بهعنوان ANTHROPIC_AUTH_TOKEN (Bearer) یا ANTHROPIC_API_KEY.
هزینه را کجا میبینم؟
در صفحهٔ «مصرف» داشبورد کلید. هنگام صدور کلید سقف مصرف اضافه کنید.
آیا در افزونه میتوانم از شناسهٔ GPT یا شناسهٔ دیگری از کاتالوگ استفاده کنم؟
بله، یک شناسهٔ متنی از کاتالوگ : نقطهٔ پایانی Anthropic ما به آنها هم پاسخ میدهد. "model": "gpt-6.1-terra" را در ~/.claude/settings.json بگذارید؛ فراخوانی ابزار به مدل بستگی دارد.
آیا میتوانم بهجای آن از GitHub Copilot Chat یا Continue استفاده کنم؟
بله، هر دو نقطهٔ پایانی به سبک OpenAI را میپذیرند. Copilot Chat: پالت دستورها → Chat: Manage Language Models → Add Models → Custom Endpoint، سپس در chatLanguageModels.json مقدار "apiType": "chat-completions"، id برابر gpt-6.1-terra، url برابر https://api.oneprovider.dev/v1/chat/completions و "toolCalling": true را بگذارید (مدل بدون فراخوانی ابزار پنهان میشود) و maxInputTokens و maxOutputTokens را از ردیف کاتالوگ بردارید. در نشستهای harness مربوط به Copilot chat.agentHost.byokModels.enabled را هم روشن کنید. این روش گفتوگو و عامل را پوشش میدهد، نه پیشنهادهای درونخطی را. Continue: در config.yaml مدلی با provider: openai، apiBase: https://api.oneprovider.dev/v1، کلید شما و شناسهٔ مدل اضافه کنید.
پاسخهای سریع
از کدام base URL استفاده کنم؟
Claude Code و SDKهای Anthropic از https://api.oneprovider.dev استفاده میکنند. SDKهای OpenAI و کلاینتهای سازگار با OpenAI از https://api.oneprovider.dev/v1 استفاده میکنند. یک کلید پشت هر دو آدرس کار میکند؛ فهرست مدلها در صفحهٔ مدلها و نرخها در صفحهٔ قیمتها است.
چگونه احراز هویت کنم؟
کلید خام sk-… را در x-api-key یا Authorization: Bearer بفرستید: یکی از این دو، نه هر دو. کلید را در یک متغیر محیطی نگه دارید، نه در فایلی که commit میشود. اطلاعات بیشتر دربارهٔ احراز هویت .
کلید را از کجا بگیرم؟
حساب کاربری خود را در ربات Telegram به نام @oneprovider_robot یا در app.oneprovider.dev باز کنید، موجودی را شارژ کنید و «صدور کلید» را بزنید. هر کلید میتواند سقف مصرف مخصوص خودش را داشته باشد. حساب کاربری و کلیدهای API .
کدهای 401، 404 و 429 یعنی چه؟
401: کلید ارسال نشده، اشتباه تایپ شده یا در هدر نادرست فرستاده شده است؛ کلید را کامل و بدون گیومه و فاصله جایگذاری کنید. 404: معمولاً base URL نادرست است، مثلاً /v1 جا افتاده یا دوبار آمده است. 429 با پیام «Insufficient balance»: موجودی حساب کاربری یا سقف مصرف کلید تمام شده است؛ بهجای تلاش دوباره، شارژ کنید. هر 429 دیگری محدودیت نرخ است؛ تا پایان زمان Retry-After صبر کنید. جزئیات: کدهای خطا و رفع اشکال .
چرا استریمها قطع یا ریست میشوند؟
VPN و پروکسیهای VLESS اغلب SSE را بافر میکنند یا مذاکرهٔ HTTP/2 را مختل میکنند. OneProvider هیچ محدودیت منطقهای ندارد و استریمها را بافر نمیکند؛ پروکسی را خاموش کنید و دوباره امتحان کنید.
اگر اینها کافی نبود از کجا بپرسم؟
در Telegram به @Oneproviderhelpbot پیام بدهید یا در حساب کاربری وب «پشتیبانی» را باز کنید و کد وضعیت HTTP و متن دقیق خطا را بفرستید. پشتیبانی چگونه کار میکند .
آخرین بهروزرسانی: 2026-11-17 باگی پیدا کردید؟ @Oneproviderhelpbot