راهنمای انتخاب مدل Claude Code

انتخاب مدل Claude برای Claude Code بر اساس وظیفه، به‌همراه مدل‌های GPT از طریق Codex CLI: شناسه‌های مدل قابل فراخوانی، تغییر مدل با /model، سناریوها؛ qcode.cc/models را ببینید (2026).

به کلید API نیاز دارید؟ ثبت‌نام ←·نقاط پایانی و Base URL ←

آخرین بررسی: 2026-11-12 (بخش Fable 5.2 و فهرست مدل‌های Claude؛ بقیه در 2026-10-20 آخرین بار بررسی شده است) · 📄 بر اساس qcode.cc و مستندات رسمی Anthropic (مدل‌ها و نرخ‌ها در qcode.cc/models؛ صورت‌حساب در docs.qcode.cc)

ابتدا بر اساس پیچیدگی وظیفه و توانمندی انتخاب کنید: Sonnet برای کدنویسی روزمره، Opus برای معماری و بازآرایی در مقیاس بزرگ، Fable 5.2 برای سخت‌ترین مسائل حل‌نشده، و Haiku برای قالب‌بندی و پرسش‌وپاسخ ساده؛ سپس دسترس‌پذیری زنده و نرخ‌های هر مدل را در qcode.cc/models بررسی کنید. تا 2026-10-27، شناسه‌های مدل Claude، GPT و سایر مدل‌های زیر در QCode قابل فراخوانی هستند.

Claude Code از چندین مدل هوش مصنوعی پشتیبانی می‌کند و هر رده توازن متفاوتی میان توانمندی و سرعت برقرار می‌کند. انتخاب رده بر اساس پیچیدگی وظیفه معمولاً کیفیت نتیجه و زمان پاسخ را متوازن می‌کند.

💰 صورت‌حساب بر پایه توکن است؛ نرخ‌های هر مدل در qcode.cc/models فهرست شده‌اند.

مرور کلی خانواده مدل Claude¶

مدل‌های Claude که اکنون از طریق QCode.cc در دسترس هستند، یک نردبان توانمندی را تشکیل می‌دهند.

تا 2026-11-12، این شناسه‌های Claude در QCode قابل فراخوانی هستند: claude-fable-5-2، claude-fable-5-1، claude-fable-5، claude-opus-5-5، claude-opus-5، claude-opus-4-8، claude-sonnet-5، claude-sonnet-5-5، claude-sonnet-4-6، claude-haiku-5-5. برای مدل‌هایی که بعداً اضافه می‌شوند، /models را بررسی کنید.

Claude Fable 5.2 — پرچمدار رده بالا¶

Fable 5.2 (claude-fable-5-2) جدیدترین انتشار Fable است که Anthropic در 2026-11-09 منتشر کرده و توانمندترین رده در دسترس امروز است؛ claude-fable-5-1 قبلی نیز هنوز در دسترس است و می‌توانید آن را با نام کامل مدل انتخاب کنید.

• قوی‌ترین استدلال: ساخته‌شده برای سخت‌ترین مسائل — معماری میان‌سیستمی، باگ‌های هم‌زمانی/توزیع‌شده دشوار، تصمیم‌های حیاتی یک‌باره
• 1M پنجره زمینه / 128K خروجی: درک کل کدبیس برای پروژه‌های بزرگ
• به Claude Code v2.1.321 یا جدیدتر نیاز دارد: مستندات می‌گویند Fable 5.2 به v2.1.321 نیاز دارد (Fable 5.1 به v2.1.257 نیاز دارد)؛ اگر نسخه شما قدیمی‌تر است، claude update را اجرا کنید
• عمدتاً جایگزین مستقیم 5.1: راهنمای مهاجرت رسمی می‌گوید سطح API با Claude Fable 5.1 مطابقت دارد و وقتی Claude Code تاریخچه مکالمه شما را مدیریت می‌کند، چیزی تغییر نمی‌کند
• قیمت رسمی (بررسی‌شده در 2026-11-12): به‌ازای هر یک میلیون توکن، $8 برای ورودی، $40 برای خروجی و $0.20 برای خواندن از کش prompt؛ Fable 5.1 قبلی $10 / $50 / $0.25 است. در QCode، صورت‌حساب بر پایه توکن است و نرخ‌های هر مدل در qcode.cc/models آمده است
• آن را برای مواقعی نگه دارید که اهمیت دارد: وظایف روتین به‌ندرت به این رده نیاز دارند

مناسب برای: تصمیم‌های فنی حیاتی، باگ‌های سرسختی که در برابر اشکال‌زدایی مقاومت کرده‌اند، وظایف یک‌باره‌ای که کیفیت خروجی در آن‌ها بیشترین اهمیت را دارد.

Claude Opus 5.5 / 5 / 4.8 — پرچمدار پرکار¶

Opus پرچمدار پرکار و آزموده‌شده در عمل است:

• استدلال عمیق: استدلال منطقی زنجیره‌ای بلند، مناسب برای طراحی معماری پیچیده
• کیفیت کد: کد تولیدشده کامل‌تر است و حالت‌های مرزی بهتر مدیریت می‌شوند
• 1M پنجره زمینه: در درک کدبیس‌های بزرگ قوی است
• پنجره یکسان: Opus 5 و Opus 4.8 محدودیت‌های زمینه و خروجی یکسانی دارند — آزادانه جابه‌جا کنید
• Opus 5.5 (claude-opus-5-5): جدیدترین انتشار Opus، اکنون در QCode در دسترس است؛ آن را با /model claude-opus-5-5 یا ANTHROPIC_MODEL=claude-opus-5-5 انتخاب کنید (نرخ‌ها در qcode.cc/models)

مناسب برای: طراحی معماری، بازآرایی در مقیاس بزرگ، ارزیابی پیشنهاد فنی، شکار باگ‌های پیچیده.

Claude Sonnet 5 / Sonnet 4.6 — رده متوازن روزمره¶

Sonnet برای بیشتر توسعه‌دهندگان انتخاب روزمره است و توازنی از توانمندی و سرعت دارد:

• Sonnet 5: رده متوازن نسل جدید، 1M پنجره زمینه / 128K خروجی — پیش‌فرض پیشنهادی برای پروژه‌های جدید
• Sonnet 4.6: بالغ و پایدار، 1M پنجره زمینه (با گزینه اختیاری قابل فعال‌سازی)، برای کدنویسی روزمره کاملاً کافی است
• توانمندی متوازن: کیفیت پایدار برای کدنویسی روزمره و بازبینی کد
• سریع‌تر: از Opus سریع‌تر است و برای رفت‌وبرگشت‌های مکرر مناسب است

مناسب برای: کدنویسی روزمره، رفع باگ، بازبینی کد، مستندسازی، نوشتن تست.

Claude Haiku 4.5 — سبک و سریع¶

Haiku کوچک‌ترین و سریع‌ترین رده است:

• بیشترین سرعت: مناسب برای درخواست‌های کوتاه و مکرر
• پایه‌های محکم: در وظایف ساده کاملاً توانمند و در استدلال پیچیده محدود است
• 200K پنجره زمینه

مناسب برای: پرسش‌وپاسخ ساده، قالب‌بندی کد، تولید کدهای قالبی، ترجمه‌های سریع.

Claude Haiku 5.5 — رده سبک برای زیرعامل‌ها¶

Haiku 5.5 (claude-haiku-5-5) در QCode در دسترس است. در Claude Code، این همان رده‌ای است که نام مستعار haiku در API Anthropic به آن تبدیل می‌شود. موارد زیر بازگویی مستندات رسمی Claude Code است (صفحه‌های پیکربندی مدل و زیرعامل‌ها).

• انتخاب آن: مستندات claude-haiku-5-5 را شناسه مدل Haiku 5.5 معرفی می‌کنند — در یک نشست /model claude-haiku-5-5 را اجرا کنید، یا Claude Code را با claude --model claude-haiku-5-5 شروع کنید.
• نام مستعار haiku: haiku یکی از نام‌های مستعار خانواده مدل است، در کنار opus، sonnet و fable؛ مستندات آن را مدل سریع و کارآمد Haiku برای وظایف ساده توصیف می‌کند. از Claude Code v2.1.293 به بعد، haiku در API Anthropic به Haiku 5.5 تبدیل می‌شود.
• ANTHROPIC_DEFAULT_HAIKU_MODEL: بر اساس مستندات، این متغیر مدلی است که برای haiku یا برای عملکردهای پس‌زمینه استفاده می‌شود. متغیرهای هم‌خانواده ANTHROPIC_DEFAULT_SONNET_MODEL، ANTHROPIC_DEFAULT_OPUS_MODEL و ANTHROPIC_DEFAULT_FABLE_MODEL کنترل می‌کنند که نام‌های مستعار sonnet، opus، haiku و fable به چه چیزی تبدیل شوند. هر مقدار باید یک نام کامل مدل یا شناسه معادل برای ارائه‌دهنده API شما باشد. ANTHROPIC_SMALL_FAST_MODEL قدیمی‌تر به نفع ANTHROPIC_DEFAULT_HAIKU_MODEL منسوخ شده است.
• منشأ مدل یک زیرعامل: مستندات آن را به این ترتیب تعیین می‌کنند — نخست پارامتر model هر فراخوانی، سپس فرادادهٔ model در تعریف زیرعامل (که در آن inherit مدل مکالمه اصلی را انتخاب می‌کند)، سپس متغیر محیطی CLAUDE_CODE_SUBAGENT_MODEL، هنگامی که آن را روی یک نام مستعار مدل یا شناسه مدل تنظیم می‌کنید، و در نهایت مدل مکالمه اصلی. فیلد model یک زیرعامل sonnet، opus، haiku، fable، یک شناسه کامل مدل مانند claude-opus-5-5 یا inherit را می‌پذیرد، و یک شناسه کامل مدل همان مقادیر پرچم --model را می‌گیرد — به همین دلیل model: claude-haiku-5-5 یک شکل مستندشده است.
• تثبیت یک مدل برای همه زیرعامل‌ها: CLAUDE_CODE_SUBAGENT_MODEL یک پیش‌فرض است، بنابراین تعریف یک زیرعامل یا مدلی که Claude ارسال می‌کند همچنان اولویت دارد. برای اعمال یک مدل به همه زیرعامل‌ها، مستندات از شما می‌خواهد CLAUDE_CODE_SUBAGENT_MODEL_FORCE را روی 1 تنظیم کنید، که به Claude Code v2.1.257 یا جدیدتر نیاز دارد.
• آنچه مستندات رسمی بیان نمی‌کنند: آن‌ها هیچ مسیریابی خودکار زیرعامل‌ها به مدلی کوچک‌تر را مستند نمی‌کنند. زیرعاملی که مدل خودش را ندارد از مکالمه اصلی ارث می‌برد، و تنظیم CLAUDE_CODE_SUBAGENT_MODEL به‌تنهایی مدلی را که زیرعامل‌های داخلی Explore و Plan روی آن اجرا می‌شوند تغییر نمی‌دهد. روش مستندشده برای انتقال کاوش به این رده، یک زیرعامل کاربر یا پروژه به نام Explore است که فیلد model خودش را حفظ می‌کند — یکی را با model: haiku تعریف کنید.
• پنجره زمینه: در API Anthropic، Haiku 5.5 با پنجره زمینه 1M در همه پلن‌ها اجرا می‌شود، بدون پسوند [1m] برای انتخاب. پشت دروازه‌ای که از طریق ANTHROPIC_BASE_URL پیکربندی شده است، Claude Code به هر مدلی که می‌شناسد همان پنجره زمینه‌ای را می‌دهد که مدل در API Anthropic دارد، و نمی‌تواند حد پایین‌تری را که دروازه یا سرور پشت آن اعمال می‌کند تشخیص دهد.

مثال خود مستندات برای اجرای همه زیرعامل‌ها روی Haiku، هر دو متغیر را در بلوک env یک فایل تنظیمات تنظیم می‌کند:

{
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
    "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"
  }
}

در QCode، claude-haiku-5-5 روی نقطه پایانی با پروتکل Anthropic ارائه می‌شود، بنابراین Claude Code را به https://api.qcode.cc/api اشاره دهید (به نقاط پایانی و مسیرهای API مراجعه کنید). آن متغیر تغییر می‌دهد که درخواست‌ها کجا ارسال می‌شوند، نه اینکه کدام مدل به آن‌ها پاسخ می‌دهد:

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5"
export CLAUDE_CODE_SUBAGENT_MODEL="claude-haiku-5-5"

صورت‌حساب بر پایه توکن است؛ نرخ‌های هر مدل در qcode.cc/models فهرست شده‌اند. برای اینکه کدام کلاینت‌ها با پروتکل Anthropic صحبت می‌کنند، به سازگاری ابزارها مراجعه کنید.

مقایسه دقیق مدل‌ها¶

صورت‌حساب به‌ازای هر توکن است؛ نرخ هر مدل در qcode.cc/models آمده است.

راهنمای انتخاب بر اساس سناریو¶

کدنویسی روزمره → Sonnet 5 / Sonnet 4.6¶

برای توابع، کامپوننت‌ها، APIها و مواردی از این دست در کار روزمره، Sonnet بیش از کافی است:

/model claude-sonnet-5

> "Add a deleteUser method to @src/services/user-service.ts"
> "Create a Pagination component with previous/next buttons and jump-to-page support"
> "Add pagination parameter support to @src/app/api/orders/route.ts"

طراحی معماری / بازآرایی در مقیاس بزرگ → Opus 5¶

وقتی طراحی سیستم و تصمیم‌های کلان در میان باشد، استدلال عمیق Opus مناسب این نوع کار است:

/model opus

> "Analyze the overall architecture under @src/. I plan to split this monolith into microservices.
Evaluate which modules are good candidates for extraction and propose a split plan."

تصمیم‌های حساس / باگ‌های سرسخت → Fable 5.2¶

برای باگ‌هایی که مدت‌هاست بدون سرنخ دنبالشان می‌کنید، یا تصمیم‌های فنی یک‌باره و دوربرد، رده برتر انتخاب درست است:

/model claude-fable-5-2

> "I've spent three days on this intermittent data inconsistency issue. Symptoms, logs, and repro steps below...
Systematically analyze all possible root causes and propose a verification plan."

قالب‌بندی کد / پرسش و پاسخ ساده → Haiku 4.5¶

برای کار مکانیکی که به تفکر عمیق نیاز ندارد، Haiku کافی است:

/model haiku

> "Add JSDoc comments to all interfaces in @src/types/index.ts"
> "What does this ESLint error mean: no-unused-vars"

بازبینی PRهای بزرگ → Opus 5¶

هنگام بازبینی تغییرات بزرگ که چندین فایل را در بر می‌گیرد، Opus مشکلات عمیق‌تری را می‌یابد.

رفع باگ → Sonnet 5 / 4.6¶

Sonnet از عهده بیشتر رفع باگ‌ها به‌خوبی برمی‌آید؛ برای باگ‌های به‌ویژه پیچیده که به هم‌زمانی یا سیستم‌های توزیع‌شده مربوط می‌شوند، به Opus یا Fable ارتقا دهید.

مرجع سریع بر اساس سناریو¶

نحوه تغییر مدل‌ها¶

روش 1: فرمان /model (توصیه‌شده)¶

هر زمان داخل Claude Code تغییر دهید؛ بلافاصله اعمال می‌شود:

/model                    # Show the current model and available options
/model sonnet             # Switch to Sonnet
/model opus               # Switch to Opus
/model haiku              # Switch to Haiku
/model claude-sonnet-5    # Switch by full model name
/model claude-fable-5-2

روش 2: متغیر محیطی¶

یک مدل پیش‌فرض در پروفایل پوسته خود (مثلاً ~/.bashrc یا ~/.zshrc) تنظیم کنید:

export ANTHROPIC_MODEL=claude-sonnet-5

# Or specify it one-off at launch
ANTHROPIC_MODEL=claude-opus-5-5 claude

روش 3: پیکربندی در CLAUDE.md¶

در فایل CLAUDE.md پروژه خود کمی راهنمایی درباره مصرف مدل به Claude بدهید (توجه: این‌ها پیشنهاد هستند، نه پیکربندی اجباری):

## Model Usage Suggestions

- Use Sonnet for everyday development
- Switch to Opus to evaluate the design before architecture changes
- Use Haiku for bulk comment additions

روش 4: پرچم‌های اجرا¶

claude --model claude-fable-5-2
claude --model claude-sonnet-5
claude --model claude-haiku-5-5

مدل‌های GPT و Codex (از طریق QCode.cc)¶

از طریق سرویس رله QCode.cc، همان کلید API دسترسی به مدل‌های سری GPT را نیز به شما می‌دهد.

تا 2026-10-27، این شناسه‌های GPT در QCode قابل فراخوانی هستند: gpt-6.1-sol، gpt-6.1-terra، gpt-6-sol، gpt-6-astra، gpt-5.6-terra، gpt-5.6-sol.

مدل‌های موجود¶

GPT-6 Luna (gpt-6-luna / gpt-5.6-luna) در حال حاضر پشتیبانی نمی‌شود. لطفاً از مدل GPT دیگری استفاده کنید.

دسترس‌پذیری زنده در qcode.cc/models نشان داده می‌شود.

همین حساب کاربری از 2026-11-11 می‌تواند این شناسه‌ها را نیز فراخوانی کند: deepseek-v4.1-flash، deepseek-v4-flash، deepseek-v4-pro، glm-5.3، glm-5.3-flash، glm-5.2، qwen3.8-flash، qwen3.8-max، qwen3.7-plus، kimi-k3.1-pro، kimi-k3. برای دسترس‌پذیری این مدل‌ها، /models را بررسی کنید.

نکات برجسته سری GPT¶

• gpt-6.1-sol توصیه پیش‌فرض کنونی است (به‌روزرسانی GPT-6 Sol)، با پنجره زمینه 1.05M؛ gpt-6-sol همچنان در دسترس است
• gpt-6.1-terra گزینه رده میانی GPT-6.1 است، با قیمت واحدی حدود نصف gpt-6.1-sol؛ مناسب کدنویسی روزمره و کارهای دسته‌ای (نرخ‌ها در qcode.cc/models)
• gpt-6-astra قوی‌ترین رده است
• gpt-5.6-terra همچنان گزینه‌ای قوی و پرکار برای کدنویسی و سناریوهای Codex CLI است
• gpt-5.6-sol گونه‌ای هم‌رده از GPT-5.6 با توانایی قابل‌مقایسه است

چه زمانی مدل‌های غیر Claude را در نظر بگیرید¶

در بیشتر موارد، مدل‌های Claude بهترین انتخاب برای Claude Code هستند (تناسب بومی). مدل‌های GPT در Codex CLI اجرا می‌شوند، نه در Claude Code؛ سری GPT زمانی ارزش امتحان کردن دارد که:

• می‌خواهید آزمون مقایسه‌ای انجام دهید: همان کار را با مدل‌های مختلف اجرا کنید و ببینید کدام نتایج بهتری تولید می‌کند
• گردش‌کارهای Codex: کاربران Codex CLI طبیعتاً از سری GPT استفاده می‌کنند
• تناسب کار: مدل‌های سبک GPT مناسب کارهای ساده هستند

# GPT models are not on the Anthropic protocol: /model gpt-* is rejected inside Claude Code
# To use GPT, go through Codex CLI (the OpenAI Responses / Chat protocols)
codex --model gpt-6.1-sol "Refactor this module"

توجه: مدل‌های غیر Claude ممکن است از برخی ویژگی‌های Claude Code پشتیبانی نکنند (مانند بخش‌هایی از Extended Thinking). ما مدل‌های Claude را به‌عنوان انتخاب اصلی شما توصیه می‌کنیم و مدل‌های دیگر را به‌عنوان مکمل.

تخصیص مدل‌ها بر اساس پیچیدگی کار¶

رویکرد ترکیبی چندسطحی¶

یک تقسیم‌بندی رایج بر اساس پیچیدگی کار است:

Task allocation (reference):
├── Sonnet 5 / 4.6 (~70%) — everyday development, bug fixes, writing tests, reviews
├── Opus 5 / 4.8   (~13%) — architecture decisions, complex problems, large refactors
├── Fable 5.2      (~2%)  — critical decisions, long-unresolved stubborn bugs
└── Haiku 4.5      (~15%) — formatting, simple Q&A, bulk operations

این کار، کارهای روزمره را روی سطح متعادل نگه می‌دارد و وقتی اهمیت دارد، به سطح بالاتر می‌رود.

چه زمانی به سطح بالاتر بروید¶

وقتی یک کار هر یک از این شرایط را دارد، به Opus یا حتی Fable سوئیچ کنید:

1. دامنه تأثیر گسترده: تغییر به چندین ماژول، سیستم یا تیم دست می‌زند
2. تصمیم‌های یک‌باره: انتخاب معماری، مهاجرت پشته فناوری و سایر تصمیم‌هایی که بازگشت از آن‌ها دشوار است
3. بررسی طولانی: باگ مدت‌ها در برابر بررسی مقاومت کرده و نیاز به تحلیل عمیق‌تر دارد
4. کیفیت کد حیاتی است: کد از جاهای زیادی فراخوانی می‌شود و باید مقاوم باشد

در مقابل، برای ابزارهای داخلی، اصلاحات ظاهری یا افزودن کامنت، Sonnet یا حتی Haiku کافی است.

نکات کاربردی¶

تغییر مدل در میانه گفتگو¶

می‌توانید در میانه یک گفتگو مدل را تغییر دهید: ابتدا طرح را با Opus/Fable بنویسید، سپس پس از تأیید به Sonnet سوئیچ کنید تا اجرا انجام شود — استدلال سطح بالا برای تصمیم‌های حیاتی و سطح متعادل برای اجرا.

/model opus
> "Analyze the existing code architecture and draft an implementation plan for the permissions system"

/model claude-sonnet-5
> "Following the plan above, start on step one: create the permission model"

بررسی مصرف کار با /cost¶

پس از پایان یک کار، با /cost مصرف توکن آن اجرا را ببینید. بار بعد که کار مشابهی را انجام می‌دهید، مدل دیگری را امتحان کنید و نتیجه و مصرف را مقایسه کنید؛ بعد از چند دور، شهود پیدا می‌کنید که کدام سطح برای کدام نوع کار مناسب است.

توانمندی‌های مدل‌ها مدام در حال تحول است¶

توصیف‌های توانمندی در این صفحه بازتاب جایگاه نسبی نسخه‌های کنونی است. انتشار مدل‌های جدید و بازنشستگی آن‌ها همیشه در qcode.cc/models بازتاب می‌یابد؛ در صورت تردید، آزمون در دنیای واقعی را داور قرار دهید.

سازمانی ←