راهنمای پیکربندی · تا تاریخ 2026-11-22

متغیرهای محیطی زیرعامل و مدل پیش‌فرض در Claude Code: 5 کلید برای کنترل مسیریابی و مصرف توکن

تا 22 نوامبر 2026، ابزار Claude Code مسیریابی مدل جلسه اصلی و زیرعامل‌ها را از طریق 5 متغیر محیطی اصلی کنترل می‌کند: ANTHROPIC_MODEL مدل اصلی را تعیین می‌کند، ANTHROPIC_DEFAULT_OPUS_MODEL و ANTHROPIC_DEFAULT_SONNET_MODEL و ANTHROPIC_DEFAULT_HAIKU_MODEL نام‌های مستعار opus و sonnet و haiku را تثبیت می‌کنند و CLAUDE_CODE_SUBAGENT_MODEL همه زیرعامل‌ها را روی یک مدل قفل می‌کند. هنگام مسیریابی از طریق درگاه سفارشی ANTHROPIC_BASE_URL، ذخیره این 5 کلید در بخش env فایل ~/.claude/settings.json از خطاهای تغییر نام مستعار جلوگیری کرده و زیرعامل‌های موازی را از تعرفه مدل‌های پرچم‌دار دور نگه می‌دارد.

به‌روزرسانی شده 2026-11-22

این ابزار را به نقطه پایانی QCode متصل کنید — یک کلید برای Claude، GPT، DeepSeek و Qwen بدون نیاز به کارت ارزی.

#CLAUDE_CODE_SUBAGENT_MODEL#ANTHROPIC_DEFAULT_*_MODEL#v2.1.330#settings.json env

چهار نکته کلیدی که باید ابتدا بدانید

5 متغیر محیطی اصلی

مدل اصلی، سه نام مستعار رده‌بندی‌شده و بازنویسی سراسری زیرعامل‌ها

ANTHROPIC_MODEL جلسه اصلی را تنظیم می‌کند، ANTHROPIC_DEFAULT_OPUS_MODEL و ANTHROPIC_DEFAULT_SONNET_MODEL و ANTHROPIC_DEFAULT_HAIKU_MODEL تفکیک نام‌های مستعار را کنترل می‌کنند و CLAUDE_CODE_SUBAGENT_MODEL عامل‌های Explore و Plan و هر زیرعامل دیگری را روی یک مدل قفل می‌کند؛ ANTHROPIC_DEFAULT_FABLE_MODEL نیز نام مستعار fable را تثبیت می‌کند.

$0.10 / $4

تفاوت تعرفه ورودی API رسمی Anthropic (به ازای هر 1M توکن)

در صفحه تعرفه رسمی Anthropic (بررسی‌شده در 2026-11-22): Claude Haiku 5.5 برای پرامپت‌های تا 100,000 توکن، $0.10 برای ورودی و $0.50 برای خروجی محاسبه می‌کند؛ Sonnet 5.5 معادل $2 / $10؛ Opus 5.5 معادل $4 / $20 و Fable 5.2 معادل $8 / $40 است. نگه داشتن مدل پرچم‌دار در رشته اصلی و هدایت زیرعامل‌های جست‌وجو به رده‌های سبک‌تر، هزینه جلسه را به‌طور چشمگیری تغییر می‌دهد.

v2.1.330

منتشرشده در 2026-11-20 همراه با رفع باگ‌های زیرعامل و تغییر مدل

نسخه Claude Code v2.1.330 مشکلات بسته شدن سرورهای MCP تعریف‌شده توسط زیرعامل در حالی که زیرعامل‌های دیگر هنوز از آن‌ها استفاده می‌کنند، متوقف نماندن زیرعامل‌های پس‌زمینه متوقف‌شده، باقی ماندن دستورالعمل‌های قدیمی پرامپت سیستم پس از تغییر مدل بعد از /context و از دست رفتن متغیرهای محیطی هوک SessionStart در claude -p --continue را برطرف می‌کند.

~/.claude/settings.json

بخش env سراسری که بر exportهای پوسته اولویت دارد

هنگامی که یک متغیر هم در پوسته و هم در بخش env فایل تنظیمات تعریف شده باشد، فایل تنظیمات در بیشتر جلسات اولویت دارد و به عامل‌های پس‌زمینه نیز می‌رسد. هرگز اطلاعات احراز هویت API را در فایل .claude/settings.json پروژه که کامیت می‌شود قرار ندهید؛ برای بازنویسی‌های تک‌پروژه‌ای از .claude/settings.local.json استفاده کنید.

نقش‌ها، اولویت‌بندی و تفکیک نام مستعار در میان 5 متغیر محیطی

ابزار Claude Code انتخاب مدل را در پنج لایه اولویت انجام می‌دهد: ابتدا دستور /model داخل جلسه، سپس فلگ راه‌اندازی claude --model، متغیر محیطی ANTHROPIC_MODEL، فیلد model در تنظیمات و در نهایت ANTHROPIC_DEFAULT_MODEL برای جلسات جدید (نیازمند v2.1.236 یا جدیدتر). هر زمان نام مستعاری مانند opus، sonnet، haiku، fable یا opusplan را ارسال کنید یا در frontmatter فایل YAML زیرعامل سفارشی خود model: sonnet یا model: haiku را تعریف کنید، Claude Code آن نام مستعار را به شناسه کامل مدل تبدیل می‌کند.

در API رسمی Anthropic، نام‌های opus، sonnet و haiku به ترتیب به Opus 5.5 (v2.1.280+)، Sonnet 5.5 (v2.1.284+) و Haiku 5.5 (v2.1.293+) و نام fable به Fable 5.2 (v2.1.321+) نگاشت می‌شوند. در Amazon Bedrock، Microsoft Foundry یا درگاه‌های سفارشی LLM، نگاشت‌های پیش‌فرض ممکن است به شناسه‌های قدیمی‌تر یا پیکربندی‌نشده برسند؛ بنابراین تثبیت شناسه‌های کامل از طریق ANTHROPIC_DEFAULT_OPUS_MODEL، ANTHROPIC_DEFAULT_SONNET_MODEL، ANTHROPIC_DEFAULT_HAIKU_MODEL و ANTHROPIC_DEFAULT_FABLE_MODEL ضروری است.

برای زیرعامل‌ها، ابزار داخلی Explore از مدل مکالمه والد استفاده می‌کند (و در اشتراک‌ها، Anthropic Console یا درگاه‌های ANTHROPIC_BASE_URL از Fable به نام مستعار opus تنزل می‌یابد)، ابزار Plan از مکالمه والد ارث‌بری می‌کند، statusline-setup روی Sonnet اجرا می‌شود و claude-code-guide و web-fetch روی Haiku اجرا می‌شوند.

تنظیم CLAUDE_CODE_SUBAGENT_MODEL همه زیرعامل‌ها، از جمله Explore و Plan را روی همان یک مدل قفل می‌کند. متغیر قدیمی ANTHROPIC_SMALL_FAST_MODEL منسوخ شده است؛ وظایف پس‌زمینه اکنون از ANTHROPIC_DEFAULT_HAIKU_MODEL استفاده می‌کنند.

به‌روزرسانی 2026-11-20: رفع باگ‌های زیرعامل در v2.1.330 و فشار سهمیه در جامعه کاربران

تا تاریخ 2026-11-22، آخرین نسخه Claude Code یعنی v2.1.330 (منتشرشده در 2026-11-20) چندین اصلاحیه را ارائه می‌دهد که مستقیما بر جریان‌های کاری چندزیرعاملی و مدل‌های تثبیت‌شده اثر می‌گذارد.

  1. 1چرخه حیات MCP زیرعامل: رفع مشکل بسته شدن سرور MCP تعریف‌شده توسط زیرعامل‌ها هنگام پایان کار یک زیرعامل، در حالی که سایر زیرعامل‌ها یا جلسه هنوز از آن استفاده می‌کردند.
  2. 2وضعیت زیرعامل پس‌زمینه: رفع مشکل متوقف نماندن زیرعامل‌های پس‌زمینه متوقف‌شده و همچنین رفع مشکل انتظار ادامه پیدا کردن Claude برای عامل پس‌زمینه‌ای که درست هنگام اتمام در جلسات اپلیکیشن یا SDK متوقف شده بود.
  3. 3تغییر مدل و تنظیمات: رفع مشکل باقی ماندن دستورالعمل‌های مدل قبلی در پرامپت سیستم هنگام تغییر مدل پس از /context و پیش از اولین پیام، و رفع از دست رفتن تغییرات تنظیمات کاربر هنگام ذخیره هم‌زمان توسط چند فرآیند Claude Code.
  4. 4هوک‌ها و بازگشت‌های تثبیت‌شده: رفع مشکل از دست رفتن متغیرهای محیطی نوشته‌شده توسط هوک SessionStart در دستور claude -p --continue و رفع مشکل نادیده گرفته شدن مدل Opus تثبیت‌شده در جلسات ترمینال Amazon Bedrock (Mantle) که بدون انتخاب مدل آغاز شده‌اند. در بخش جامعه کاربران، توسعه‌دهندگانی که بین 2026-11-19 و 2026-11-20 در انجمن‌ها و X پست گذاشتند گزارش دادند که هنگام ترکیب هماهنگ‌کننده‌های پرچم‌دار با زیرعامل‌های موازی، محدودیت‌های اشتراک هفتگی را طی 1 تا 2 روز به پایان رسانده‌اند که این موضوع استفاده از ترکیب سرپرست Opus 5.5 به همراه کارگرهای Sonnet یا مدل‌های کم‌هزینه‌تر را تسریع کرده است.

سه نقطه عطف: فشار سهمیه، اصلاحات v2.1.330 و مبنای فعلی

2026-11-19

بین 2026-11-19 و 2026-11-20، کاربران پرمصرف در بحث‌های انجمن‌ها گزارش دادند که در اجراهای موازی چندعاملی، محدودیت‌های اشتراک هفتگی طی 1 تا 2 روز تمام شده و سقف جلسه حدود 800k توکن پر شده است؛ بحث‌ها به‌سرعت به سمت نظارت در رشته اصلی و واگذاری کارهای روتین به زیرعامل‌های کم‌هزینه‌تر تغییر جهت داد.

2026-11-20

نسخه Claude Code v2.1.330 در 2026-11-20 منتشر شد و مشکلات خاموش شدن زودهنگام سرورهای MCP مشترک زیرعامل‌ها، مدیریت توقف زیرعامل پس‌زمینه، نوشتن هم‌زمان تنظیمات کاربر و از دست رفتن متغیرهای محیطی هوک SessionStart در claude -p --continue را برطرف کرد.

2026-11-22

تا تاریخ 2026-11-22، نام‌های مستعار API رسمی Anthropic یعنی opus، sonnet، haiku و fable به ترتیب به Opus 5.5، Sonnet 5.5، Haiku 5.5 و Fable 5.2 نگاشت می‌شوند؛ پشت یک درگاه سفارشی، تثبیت هر سه متغیر نام مستعار پیش‌فرض به همراه CLAUDE_CODE_SUBAGENT_MODEL در ~/.claude/settings.json، محافظ استاندارد در برابر مسیریابی اشتباه و هزینه‌های پیش‌بینی‌نشده است.

جزئیات مستندات تاییدشده در برابر باورهای نادرست رایج و گزارش‌های جامعه

تاییدشده (مستندات Claude Code، یادداشت‌های انتشار v2.1.330 و صفحات تعرفه ارائه‌دهندگان)

  1. 1تفکیک درگاه از انتخاب مدل: مستندات رسمی تصریح می‌کنند که ANTHROPIC_BASE_URL محل ارسال درخواست‌ها را تغییر می‌دهد نه مدلی که به آن‌ها پاسخ می‌دهد، و از نسخه v2.1.196 به بعد هر زمان به میزبانی غیر از api.anthropic.com اشاره کند، Remote Control غیرفعال می‌شود.
  2. 2محدودیت‌های هم‌زمانی و توضیحات: متغیر CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS (v2.1.217+) حداکثر زیرعامل‌های هم‌زمان در هر جلسه را با مقدار پیش‌فرض 20 محدود می‌کند؛ CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION (پیش‌تر 200) در v2.1.224 حذف شد و اکنون بی‌اثر است؛ مجموع توضیحات زیرعامل‌های سفارشی بیش از 15,000 توکن هنگام راه‌اندازی هشدار ایجاد می‌کند.
  3. 3تنظیم مدل درگاه: برای شناسه‌های مدلی که Claude Code نمی‌تواند تشخیص دهد، CLAUDE_CODE_MAX_OUTPUT_TOKENS به‌صورت پیش‌فرض 32000 با سقف 128000 است؛ CLAUDE_CODE_MAX_CONTEXT_TOKENS پنجره زمینه فرضی را بازنویسی می‌کند، CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 فهرست /model را از /v1/models پر می‌کند و CLAUDE_CODE_PROMPT_CACHE_TTL (v2.1.242+) مقادیر 5m یا 1h را می‌پذیرد.
  4. 4تعرفه رسمی API (به ازای هر 1M توکن ورودی / خروجی): نرخ‌های رسمی Anthropic برای Claude Fable 5.2 معادل $8 / $40، برای Opus 5.5 معادل $4 / $20، برای Sonnet 5.5 معادل $2 / $10 و برای Haiku 5.5 تا 100,000 توکن معادل $0.10 / $0.50 (و بیش از 100,000 توکن معادل $0.50 / $2.50) است. نرخ‌های رسمی Z.AI برای GLM-5.3 معادل $1.4 ورودی، $0.26 ورودی کش‌شده و $4.4 خروجی، و برای GLM-5.3-Flash معادل $0.15 ورودی، $0.03 ورودی کش‌شده و $0.50 خروجی است.

باورهای نادرست رایج و رفتارهای گزارش‌شده توسط جامعه کاربران

  1. 1«تنظیم ANTHROPIC_BASE_URL به‌طور خودکار مدل پیشنهادی درگاه را انتخاب می‌کند» — نادرست است. مستندات رسمی تایید می‌کنند که این متغیر فقط نقطه پایانی را تغییر می‌دهد؛ تثبیت نکردن ANTHROPIC_DEFAULT_*_MODEL باعث می‌شود Claude Code پیش‌فرض‌های نگاشت‌نشده یا شناسه‌های قدیمی‌تر بفرستد که درگاه آن‌ها را رد می‌کند.
  2. 2«exportهای پوسته همیشه بر settings.json اولویت دارند» — نادرست است. مستندات رسمی مشخص می‌کنند که وقتی متغیری هم در پوسته و هم در بخش env فایل تنظیمات وجود دارد، فایل تنظیمات در محیط فرآیند نوشته می‌شود و در بیشتر جلسات برنده است.
  3. 3«ابزار داخلی Explore به‌طور پیش‌فرض همیشه روی Haiku اجرا می‌شود» — نادرست است. Explore روی مدل مکالمه والد اجرا می‌شود (یا هنگام اجرای Fable روی والد از طریق اشتراک، Console یا درگاه ANTHROPIC_BASE_URL، روی نام مستعار opus)؛ برای اجرای آن روی Haiku، متغیر CLAUDE_CODE_SUBAGENT_MODEL را تنظیم کنید یا یک فایل سفارشی Explore در ~/.claude/agents/ با model: haiku بسازید.
  4. 4«تغییر /model به Sonnet سقف اشتراک هفتگی تمام‌شده را بازیابی می‌کند» — گزارش‌های جامعه اشاره می‌کنند که محدودیت‌های 5 ساعته و هفتگی بین مدل‌ها مشترک هستند؛ تغییر خانواده مدل فقط در پیام‌های خاص خانواده مانند "You've hit your Opus limit" کمک می‌کند.
  5. 5«از ANTHROPIC_SMALL_FAST_MODEL برای کارهای پس‌زمینه استفاده کنید» — منسوخ است؛ مستندات رسمی آن را به نفع ANTHROPIC_DEFAULT_HAIKU_MODEL منسوخ اعلام کرده‌اند.

دو الگوی کنترل هزینه زیرعامل: بازنویسی سراسری در برابر مسیریابی هر عامل

A: قفل کردن همه زیرعامل‌ها با CLAUDE_CODE_SUBAGENT_MODEL

مقدار CLAUDE_CODE_SUBAGENT_MODEL=claude-sonnet-5-5 (یا claude-haiku-5-5) را در بخش env فایل settings.json تنظیم کنید تا Explore، Plan و هر زیرعامل سفارشی روی یک رده اجبار شوند. یک خط کد از مصرف تصادفی Opus 5.5 یا Fable 5.2 در واگذاری‌های پس‌زمینه جلوگیری می‌کند، به این بها که رده بالاتر برای زیرعامل‌های بررسی تخصصی حفظ نمی‌شود.

B: تثبیت نام‌های مستعار رده‌بندی‌شده + مسیریابی هر عامل در ~/.claude/agents/

بازنویسی سراسری را تنظیم‌نشده رها کنید، ANTHROPIC_DEFAULT_OPUS_MODEL و ANTHROPIC_DEFAULT_SONNET_MODEL و ANTHROPIC_DEFAULT_HAIKU_MODEL را تثبیت کنید، سپس فایل‌های YAML frontmatter را در مسیر ~/.claude/agents/ تعریف نمایید؛ مانند یک بازنویسی Explore با model: haiku و یک code-reviewer با model: sonnet، در حالی که رشته اصلی را روی opus یا opusplan (Opus برای برنامه‌ریزی، Sonnet برای اجرا) اجرا می‌کنید. ویرایش‌های فایل ظرف چند ثانیه بدون نیاز به راه‌اندازی مجدد به صورت آنی اعمال می‌شوند.

سه گام: پیکربندی درگاه و مسیریابی لایه‌ای زیرایجنت در ~/.claude/settings.json

  1. 1فایل ~/.claude/settings.json در سطح کاربر را باز کنید (در ویندوز: %USERPROFILE%\.claude\settings.json؛ برای یک پروژه واحد از .claude/settings.local.json که در gitignore قرار دارد استفاده کنید و هرگز اطلاعات احراز هویت را در .claude/settings.json ثبت‌شده در مخزن قرار ندهید) و نشانی درگاه و کلید را داخل "env" اضافه کنید: "ANTHROPIC_BASE_URL": "https://api.qcode.cc/api" (سرزمین اصلی چین: https://asia.qcode.cc/api؛ آمریکای شمالی/اروپا: https://us.qcode.cc/api) و "ANTHROPIC_AUTH_TOKEN": "your-cr-api-key".
  2. 2در همان بلوک "env"، مدل اصلی، نام‌های مستعار سطوح و مدل زیرایجنت را تثبیت کنید: "ANTHROPIC_MODEL": "claude-opus-5-5"، "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5"، "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5"، "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"، "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-2" و "CLAUDE_CODE_SUBAGENT_MODEL": "claude-sonnet-5-5" (یا claude-haiku-5-5 برای گردش‌کارهای جست‌وجومحور؛ در صورت تمایل "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1" را برای بارگذاری /v1/models در /model اضافه کنید).
  3. 3یک بررسی سریع در شل اجرا کنید: curl -sS -X POST "$ANTHROPIC_BASE_URL/v1/messages" -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" -H "anthropic-version: 2023-06-01" -H "content-type: application/json" -d '{"model": "claude-sonnet-5-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}' — پاسخ JSON شامل "id":"msg_ و "content" درستی نقطه پایانی و کلید را تایید می‌کند (در صورت خطای 401، متغیر احراز هویت را بررسی کنید یا برای پاک کردن ورود قبلی دستور /logout را اجرا نمایید). claude را اجرا کنید، برای بررسی نشانی پایه Anthropic و Auth token دستور /status را بزنید و هر زمان خواستید با /model claude-fable-5-2 یا /model glm-5.3 یا /model kimi-k3.1-pro مدل را تغییر دهید (برای تغییر فقط در نشست فعلی، کلید s را در انتخابگر فشار دهید).

اجرای گردش‌کار لایه‌ای چندمدلی با یک کلید API از QCode

QCode.cc یک سرویس مستقل دسترسی به API است و هیچ وابستگی به Anthropic، OpenAI یا Z.AI ندارد. تنظیم ANTHROPIC_BASE_URL در Claude Code روی https://api.qcode.cc/api (https://asia.qcode.cc/api برای سرزمین اصلی چین، https://us.qcode.cc/api برای آمریکای شمالی و اروپا) به یک کلید cr_ امکان می‌دهد هر سطح را در یک گردش‌کار هدایت کند: claude-opus-5-5 یا claude-fable-5-2 را روی رشته اصلی برای معماری و اشکال‌زدایی پیچیده اجرا کنید، زیرایجنت‌ها را به claude-sonnet-5-5 یا claude-haiku-5-5 بسپارید و از طریق /model به glm-5.3، glm-5.3-flash، kimi-k3.1-pro یا deepseek-v4.1-flash جابه‌جا شوید، بدون مدیریت حساب‌های متعدد ارائه‌دهندگان یا برخورد به محدودیت‌های 5 ساعته و هفتگی اشتراک.

همین کلید همچنین Codex CLI (https://api.qcode.cc/openai) و کلاینت‌های سازگار با OpenAI (https://api.qcode.cc/openai/v1) را به مدل‌هایی مانند gpt-6.2-sol و qwen3.8-max متصل می‌کند. صورت‌حساب بر اساس توکن با نرخ‌های لحظه‌ای هر مدل در /models محاسبه می‌شود. روش‌های پرداخت پشتیبانی‌شده شامل Visa / Mastercard، Apple Pay، Google Pay، Alipay، WeChat Pay، کارت‌های بانکی محلی روسیه و SBP، کارت‌های بانکی CIS و USDT چندشبکه‌ای در 18 شبکه (کارمزد پلتفرم 0%، معمولا چند دقیقه و حداکثر تا 12 ساعت) است.

آماده پلن ماهانه نیستید؟ بسته‌های پرداخت به‌ازای مصرف با قیمت شروع $4 برای یک سهمیه یک‌باره قابل استفاده ظرف 7 روز در دسترس هستند؛ اگر از قبل پلن شخصی دارید، هنگام نیاز به سهمیه بیشتر یک بسته تقویتی اضافه کنید.

پرسش‌های متداول

تفاوت بین ANTHROPIC_MODEL، ANTHROPIC_DEFAULT_*_MODEL و CLAUDE_CODE_SUBAGENT_MODEL چیست؟

هر گروه یک لایه مجزا را کنترل می‌کند: نشست اصلی، نگاشت نام مستعار و زیرایجنت‌ها. ANTHROPIC_MODEL مدل نشست اصلی را تعیین می‌کند (بالاتر از فیلد model در تنظیمات و ANTHROPIC_DEFAULT_MODEL، و پایین‌تر از --model و /model). متغیرهای ANTHROPIC_DEFAULT_OPUS_MODEL، ANTHROPIC_DEFAULT_SONNET_MODEL، ANTHROPIC_DEFAULT_HAIKU_MODEL و ANTHROPIC_DEFAULT_FABLE_MODEL مشخص می‌کنند هر نام مستعار (opus، sonnet، haiku، fable) به کدام شناسه مدل کامل نگاشت شود، و ANTHROPIC_DEFAULT_HAIKU_MODEL عملکردهای پس‌زمینه را نیز بر عهده دارد. CLAUDE_CODE_SUBAGENT_MODEL نیز Explore، Plan و تمام زیرایجنت‌های سفارشی را روی یک مدل واحد قفل می‌کند.

چرا export متغیرهای محیطی مدل در شل روی Claude Code اعمال نشد؟

در بیشتر موارد، بلوک env در ~/.claude/settings.json (یا تنظیمات مدیریت‌شده) مقدار شل را جایگزین کرده است. مستندات رسمی تصریح می‌کنند که وقتی یک متغیر هم در شل و هم در بلوک env فایل تنظیمات تعریف شود، فایل تنظیمات در محیط پردازش نوشته می‌شود و در اغلب نشست‌ها اولویت دارد. علاوه بر این، دستور /model (فشردن Enter آن را به عنوان پیش‌فرض کاربر ذخیره می‌کند) و پرچم --model مقدار ANTHROPIC_MODEL را بازنویسی می‌کنند. متغیرهای خود را به صورت یکپارچه زیر env در ~/.claude/settings.json نگه دارید و تنظیمات فعال را با /status و /model تایید کنید.

چگونه از مصرف توکن‌های Opus یا Fable توسط زیرایجنت‌های داخلی Explore و Plan جلوگیری کنم؟

دو راهکار مستقیم وجود دارد. نخست، CLAUDE_CODE_SUBAGENT_MODEL=claude-sonnet-5-5 یا claude-haiku-5-5 را داخل بلوک env در ~/.claude/settings.json تنظیم کنید تا Explore، Plan و سایر زیرایجنت‌ها به سطح کم‌هزینه‌تر منتقل شوند. دوم، یک فایل Markdown به نام Explore در ~/.claude/agents/ (سطح کاربر) یا .claude/agents/ (سطح پروژه) با مقدار model: haiku در بخش YAML frontmatter ایجاد کنید تا ایجنت داخلی Explore بازنویسی شود. همچنین می‌توانید اجرای هم‌زمان را با CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS (پیش‌فرض 20) محدود نمایید.

چگونه خطاهای 401 یا unknown-model را پشت یک درگاه سفارشی عیب‌یابی کنم؟

خطای 401 معمولا نشان‌دهنده ناهماهنگی هدر احراز هویت یا نشست ورود قدیمی است، در حالی که خطای unknown-model به معنای نگاشت نام مستعار به یک شناسه مدل تعریف‌نشده است. ANTHROPIC_AUTH_TOKEN هدر Authorization: Bearer را ارسال می‌کند و فورا جایگزین ورود ذخیره‌شده claude.ai می‌شود، در حالی که ANTHROPIC_API_KEY هدر x-api-key را می‌فرستد و در حالت تعاملی یک بار تایید می‌خواهد. در صورت خطای 401، با /status کلید فعال را بررسی کنید، در صورت تداخل با ورود قبلی دستور /logout را اجرا نمایید و با curl روی "$ANTHROPIC_BASE_URL/v1/messages" آزمایش کنید. در خطاهای unknown-model، متغیرهای ANTHROPIC_DEFAULT_OPUS_MODEL، ANTHROPIC_DEFAULT_SONNET_MODEL و ANTHROPIC_DEFAULT_HAIKU_MODEL را به شناسه‌های دقیقی که درگاه شما ارائه می‌دهد مانند claude-sonnet-5-5 تثبیت کنید.

آیا QCode به اشتراک ماهانه نیاز دارد و بسته‌ها و تمدیدها چگونه کار می‌کنند؟

نیازی به پلن ماهانه نیست: QCode بر اساس توکن با نرخ‌های لحظه‌ای هر مدل در /models محاسبه می‌شود. بسته‌های پرداخت به‌ازای مصرف به مدت 7 روز با سقف هم‌زمانی 5 معتبر هستند، هنگام اتمام سهمیه کد HTTP 402 و در زمان انقضا کد HTTP 401 برمی‌گردانند، و خرید بسته دیگر سهمیه را روی همان کلید API بازیابی و انباشته می‌کند (بسته‌ها غیرقابل استرداد هستند). پلن‌های شخصی در چرخه ماهانه اجرا می‌شوند و در طول اعتبار امکان افزودن بسته تقویتی دارند، در حالی که کلیدهای منقضی‌شده پلن شخصی در جای خود تمدید نمی‌شوند و نیاز به ایجاد کلید جدید دارند.

QCode از چه روش‌های پرداخت، حداقل شارژ و زمان تسویه‌ای پشتیبانی می‌کند؟

QCode کارت‌های اعتباری بین‌المللی (Visa / Mastercard)، Apple Pay، Google Pay، Alipay، WeChat Pay، کارت‌های بانکی محلی روسیه و SBP، کارت‌های بانکی CIS و رمزارز چندشبکه‌ای (USDT در 18 شبکه، کارمزد پلتفرم 0%، تایید دستی روی زنجیره، معمولا ظرف چند دقیقه و حداکثر تا 12 ساعت) را می‌پذیرد. صفحه یکپارچه شارژ qcode.cc/recharge موجودی‌های USD و CNY را جدا نگه می‌دارد: شارژ USD از $5 (حداکثر $2,000 در هر تراکنش) و شارژ CNY از ¥30 شروع می‌شود.

منابع

مستندات رسمی Claude Code: پیکربندی مدل (code.claude.com/docs/en/model-config)، متغیرهای محیطی (code.claude.com/docs/en/env-vars)، زیرایجنت‌ها (code.claude.com/docs/en/sub-agents) و اتصال درگاه LLM (code.claude.com/docs/en/llm-gateway-connect)؛ نسخه v2.1.330 از Claude Code (github.com/anthropics/claude-code/releases/tag/v2.1.330، 2026-11-20)؛ تعرفه API در Anthropic (platform.claude.com/docs/en/about-claude/pricing)؛ تعرفه Z.AI (docs.z.ai/guides/overview/pricing)؛ بحث‌های کاربری در Reddit و X (2026-11-19 تا 2026-11-20، صرفا به عنوان پیش‌زمینه تجربه کاربران و نه سیاست رسمی). همه موارد در تاریخ 2026-11-22 بررسی و تایید شده‌اند.

مسیریابی لایه‌ای مدل را در settings.json قرار دهید و همه سطوح را با یک کلید اجرا کنید

بدون نیاز به تعهد ماهانه: یک حساب QCode برای دریافت کلید API با پیشوند cr_ بسازید، آن را ظرف 30 ثانیه در ~/.claude/settings.json قرار دهید و Opus 5.5، Sonnet 5.5، Haiku 5.5 و GLM-5.3 را در یک گردش‌کار ترکیب کنید؛ نرخ‌های لحظه‌ای در /models در دسترس است.

مطالب مرتبط

راهنمای پرداخت با رمزارز

نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.

مستندات پیکربندی مدل، متغیرهای محیطی، زیرایجنت و درگاه LLM در Claude Code، یادداشت‌های انتشار v2.1.330 و صفحات تعرفه Anthropic و Z.AI در تاریخ 2026-11-22 بررسی شده‌اند و مرجع معتبر در code.claude.com، platform.claude.com، github.com/anthropics/claude-code و docs.z.ai قرار دارد. QCode.cc یک سرویس مستقل دسترسی به API است و هیچ وابستگی یا تاییدیه‌ای از سوی Anthropic، OpenAI یا Z.AI ندارد. در دسترس بودن مدل‌ها و نرخ‌های لحظه‌ای QCode تابع qcode.cc/models است.

مطمئن نیستید از کجا شروع کنید؟

یک هفته امتحان کنید

بسته کوچک: $4 برای $30 سهمیه، به مدت 7 روز معتبر

هر روز از آن استفاده کنید

Starter: $9.00/ماه با $5 سهمیه در هر روز — فقط $0.060 به‌ازای هر $1 سهمیه، در برابر حدود $0.113 برای بسته متوسط