هزینه Claude API در مقایسه با اشتراک ماهانه

آیا استفاده از Claude API ارزان‌تر از اشتراک ماهانه است؟

استفاده از Claude API تا حجم مشخصی از مصرف، ارزان‌تر از اشتراک است و پس از آن گران‌تر تمام می‌شود. برای یک توسعه‌دهنده که در تمام طول روز به‌صورت تعاملی کدنویسی می‌کند، طرح اشتراک ثابت معمولاً به‌صرفه‌تر است. برای برنامه‌ای که خودش درخواست‌ها را ارسال می‌کند، API تنها گزینه موجود است و بنابراین هزینه عامل تعیین‌کننده نیست. بقیه موارد محاسبات ساده‌ای هستند که در 10 دقیقه قابل انجام‌اند.

هیچ عدد رسمی برای نقطه سربه‌سر (break-even) وجود ندارد که بتوان به آن استناد کرد. اشتراک‌ها به‌جای سهمیه توکن، بر اساس پنجره‌های استفاده (usage windows) فروخته می‌شوند، بنابراین هیچ عدد منتشرشده‌ای نمی‌تواند به شما بگوید که این دو نمودار هزینه کجا یکدیگر را قطع می‌کنند. آنچه در ادامه می‌آید فرمولی است که بر اساس نرخ‌های فعلی به ازای هر توکن محاسبه شده، به‌علاوه بخش‌هایی از رفتار خودتان که تأثیر بسیار بیشتری نسبت به هزینه طرح اشتراک بر نتیجه نهایی دارد. هر عدد سربه‌سر که در ادامه آمده، حاصل محاسبات شخصی من بر اساس نرخ‌های منتشرشده و فرضیات بیان‌شده است و یک عدد مستند رسمی نیست.

اگر هنوز در حال تصمیم‌گیری برای انتخاب طرح هستید، کدام طرح Claude با نحوه کار شما متناسب است پاسخ این پرسش را می‌دهد. این مطلب فرض را بر این می‌گذارد که می‌دانید کدام طرح را می‌خواهید بخرید و تنها می‌خواهید بدانید که آیا اصلاً خرید آن منطقی است یا خیر.

دو مدل پرداخت که ساختار یکسانی ندارند

اشتراک، ظرفیتی است که ممکن است از آن استفاده نکنید. شما مبلغ ثابتی می‌پردازید و سهمیه‌ای دریافت می‌کنید که طبق یک زمان‌بندی مشخص بازنشانی می‌شود. مستندات Claude Code شرکت Anthropic ساختار سهمیه برای پلن‌های Team و Enterprise را این‌گونه بیان می‌کند: میزان استفاده «از سهمیه هر کاربر کسر می‌شود که در یک بازه زمانی متغیر 5 ساعته و یک بازه هفتگی بازنشانی می‌گردد»؛ این سهمیه با چت Claude و Cowork مشترک است. مشترک، همین ساختار را از طریق پیام‌هایی که هنگام رسیدن به محدودیت دریافت می‌کند، تجربه می‌کند؛ پیام‌هایی با مضمون «شما به محدودیت نشست خود رسیده‌اید» و «شما به محدودیت هفتگی خود رسیده‌اید». ظرفیتی که استفاده نمی‌کنید، پولی است که در هر صورت پرداخت کرده‌اید. ظرفیتی که از آن فراتر می‌روید، کار شما را تا زمان بازنشانی بازه متوقف می‌کند و تغییر مدل با /model دسترسی را بازیابی نمی‌کند، زیرا این بازه‌های زمانی بین مدل‌ها مشترک هستند. اگر همین حالا با یکی از این پیام‌ها مواجه هستید، تشخیص اینکه منتظر باز شدن کدام بازه زمانی هستید پیش از هرگونه محاسبه‌ای اهمیت دارد، زیرا دیوارهای 5 ساعته و هفتگی نیازمند واکنش‌های متفاوتی هستند.

API یک کنتور است، نه یک بازه زمانی. هیچ سهمیه 5 ساعته یا هفتگی برای تمام شدن وجود ندارد. قیمت هر درخواست موفق بر اساس تعداد توکن محاسبه می‌شود، اما هر درخواستی مشمول هزینه نیست: راهنمای پرداخت Anthropic بیان می‌کند که «درخواست‌های ناموفق شامل هزینه نمی‌شوند.» این قانون در جهت عکس نیز صادق است، زیرا اگر کلاینت شما در میانه راه قطع شود یا زمان آن به پایان برسد، درخواستی که «در مسیر موفقیت بود» همچنان مشمول هزینه می‌شود. برخی موارد خارج از سیستم توکن قیمت‌گذاری می‌شوند: جستجوی وب «در API Claude با قیمت 10 دلار به ازای هر 1,000 جستجو در دسترس است». این کنتور محدودیت‌هایی دارد، اما این محدودیت‌ها به‌جای میزان استفاده، سرعت و مجموع هزینه را کنترل می‌کنند. محدودیت‌های نرخ (Rate limits)، تعداد درخواست‌ها و توکن‌ها در دقیقه را محدود می‌کنند و «جهش‌های ناگهانی در تعداد درخواست‌ها می‌تواند از حد مجاز فراتر رفته و خطاهای rate limit را ایجاد کند.» هر یک از سطوح استفاده Start، Build و Scale دارای سقف هزینه ماهانه به ترتیب 500، 1,000 و 200,000 دلار هستند و شما می‌توانید سقف پایین‌تری را در صفحه Billing در کنسول Claude تنظیم کنید. در سقف تعیین‌شده برای سطح شما، «استفاده از API تا ساعت 00:00 UTC در اولین روز ماه بعد متوقف می‌شود، مگر اینکه زودتر درخواست افزایش سقف بدهید.» زیر این محدودیت‌ها، اتفاق بعدی به نحوه پرداخت شما بستگی دارد. «بیشتر سازمان‌ها با اعتبار استفاده پیش‌پرداخت (prepaid) هزینه را می‌پردازند» و «اگر اعتبار شما تمام شود، دیگر نمی‌توانید API را فراخوانی کنید یا از playground استفاده کنید تا زمانی که اعتبار بیشتری اضافه کنید»، حتی اگر فاصله زیادی با سقف هزینه داشته باشید؛ مگر اینکه قابلیت auto-reload زمانی که موجودی به زیر حد نصاب تعیین‌شده توسط شما می‌رسد، اعتبار بیشتری خریداری کند. تنها «سازمان‌هایی که قرارداد صدور فاکتور دارند، به‌صورت ماهانه صورت‌حساب دریافت می‌کنند» و فقط برای آن‌ها است که مبلغ فاکتور به‌سادگی افزایش می‌یابد. هیچ سطح رایگانی در زیر این مدل وجود ندارد، اگرچه یک اعتبار ثبت‌نام و بخش‌هایی که هزینه‌ای ندارند اجازه می‌دهند اولین آزمایش خود را پیش از آنکه این محاسبات اهمیت پیدا کنند، انجام دهید.

هزینه‌های پلن‌ها تا تاریخ 18 اکتبر 2026، طبق صفحه قیمت‌گذاری Claude: پلن Pro «ماهانه 17 دلار با تخفیف اشتراک سالانه (200 دلار پیش‌پرداخت). 20 دلار در صورت پرداخت ماهانه» است و شامل Claude Code می‌شود. پلن Max «از 100 دلار در ماه» ذکر شده است. قیمت صندلی‌های Team از «20 دلار به ازای هر صندلی / ماه در صورت پرداخت سالانه» شروع می‌شود. پلن Enterprise جالب‌ترین مورد است، زیرا هر دو مدل را همزمان اجرا می‌کند: «قیمت صندلی + هزینه استفاده با نرخ API»، که قیمت صندلی «20 دلار آمریکا/صندلی/ماه، با صورت‌حساب سالانه» ذکر شده است. اگر این مدل ترکیبی همان چیزی است که در حال بررسی آن هستید، اینکه هزینه صندلی Enterprise واقعاً چه مواردی را پوشش می‌دهد حداقل‌های صندلی و بخش‌هایی که فقط در یک استعلام قیمت توافقی ارائه می‌شوند را بررسی می‌کند. اگر به‌طور خاص قیمت‌گذاری ابزار کدنویسی را مد نظر دارید و نه کل Claude را، هزینه Claude Code در هر پلن همان هزینه‌ها را در برابر یک برآورد ماهانه کاری قرار می‌دهد. اگر هنوز در مورد بخش ثابت این مقایسه در Claude به نتیجه نرسیده‌اید، مقایسه این سطوح با قیمت‌گذاری Go، Plus و Pro در ChatGPT نیمه دیگر این تصمیم‌گیری است. هزینه‌ها مرتباً تغییر می‌کنند و سهمیه پشت هر کدام هرگز به توکن منتشر نمی‌شود، بنابراین در روز تصمیم‌گیری، صفحه قیمت‌گذاری را مطالعه کنید.

آنچه از طریق API در دسترس نیست

سهمیه طرح اشتراکی و رابط کاربری مبتنی بر آن. دستور /usage-credits در Claude Code اعتبار مصرف اشتراک را مدیریت می‌کند و شما باید آن را «پس از ورود به سیستم با اشتراک claude.ai از طریق /login اجرا کنید؛ این دستور با احراز هویت از طریق API key در دسترس نیست.» صفحه /usage نیز بسته به حالت صورت‌حساب متفاوت است. بلوک Session در این صفحه «میزان مصرف توکن API را نشان می‌دهد و برای کاربران API در نظر گرفته شده است»، در حالی که برای مشترکین «عدد هزینه نشست (session cost) برای اهداف صورت‌حساب مرتبط نیست». یک مشترک همچنان آن بلوک را می‌بیند، به علاوه موارد بیشتر: «مشترکین نوارهای میزان مصرف طرح، آمار فعالیت و تفکیک مصرف را در همان صفحه مشاهده می‌کنند.» هر دوی این موارد فرض را بر این می‌گذارند که طرح شما از ابتدا شامل Claude Code باشد، که موضوع کدام طرح‌ها شامل Claude Code هستند و چه چیزی در پنجره مصرف آن مشترک است به آن می‌پردازد، از جمله حالتی که یک API key سرگردان به‌طور بی‌سروصدا هزینه را از حساب شما کسر می‌کند. آن‌ها همچنین فرض می‌کنند که شما می‌توانید آن رابط کاربری را روی ماشینی که واقعاً با آن کار می‌کنید باز کنید. در لینوکس، این محدودیت کمتر از آن چیزی است که انتظار دارید: نسخه دسکتاپ که در حالت بتا روی Ubuntu 22.04 یا جدیدتر و Debian 12 یا جدیدتر ارائه شده، «همان تجربه Chat، Cowork و Claude Code موجود در macOS و ویندوز» را به شما می‌دهد و در سایر توزیع‌ها، CLI «همان موتور Claude Code را اجرا کرده و از طیف وسیع‌تری از توزیع‌های لینوکس پشتیبانی می‌کند». یک جزئیات برای این مقایسه اهمیت دارد: نسخه دسکتاپ با اشتراک claude.ai یا SSO سازمان شما وارد سیستم می‌شود و «مستقیماً API key کنسول Claude را نمی‌پذیرد»، بنابراین در سمت API، این CLI است که رابط کاربری شما محسوب می‌شود. بررسی اینکه کدام سطوح به‌صورت بومی در آنجا اجرا می‌شوند و هر کدام به چه طرحی نیاز دارند پیش از پرداخت هزینه برای هر یک از طرفین، ارزشمند است.

کش پرامپت طولانی‌تر در Claude Code. این مورد هزینه واقعی دارد و به‌راحتی ممکن است نادیده گرفته شود. مستندات می‌گوید: «طول عمر کش در حالت اشتراکی یک ساعت است و به محض اینکه از اعتبار مصرف استفاده کنید به پنج دقیقه کاهش می‌یابد؛ در حالت استفاده از API key یا ارائه‌دهنده ابری، این زمان به‌صورت پیش‌فرض پنج دقیقه است». اولین پیام شما پس از وقفه‌ای طولانی‌تر از طول عمر کش، از کش استفاده نمی‌کند، بنابراین کل کانتکست شما دوباره پردازش شده و با قیمت‌های نوشتن محاسبه می‌شود. در حالت اشتراکی، می‌توانید یک جلسه پنجاه دقیقه‌ای داشته باشید و پس از بازگشت، کش همچنان گرم باشد. در حالت استفاده از API key، همان وقفه هزینه بازنویسی کامل پیشوند نشست را به همراه دارد.

آنچه با اشتراک دریافت نمی‌کنید

دسترسی برنامه‌نویسی. یک cron job یا هندلر webhook که Claude را فراخوانی می‌کند به یک API key نیاز دارد؛ بنابراین اگر حجم کاری شما این‌گونه است، مقایسه به پایان می‌رسد. ساخت اولین اپلیکیشن Claude API روی یک VPS به مدیریت کلید و اولین اسکریپت عملی می‌پردازد.

تخفیف Batch API. صفحه قیمت‌گذاری به‌صراحت بیان می‌کند: «Batch API امکان پردازش ناهمگام حجم بالایی از درخواست‌ها را با 50٪ تخفیف در توکن‌های ورودی و خروجی فراهم می‌کند.» این موضوع هزینه‌های توکن را برای هر کاری که انسان منتظر آن نیست به نصف کاهش می‌دهد، هرچند شامل تمام ردیف‌های صورت‌حساب نمی‌شود: «فراخوانی‌های ابزار جستجوی وب از طریق Messages Batches API با همان قیمت درخواست‌های معمولی Messages API محاسبه می‌شوند»، بنابراین یک batch job که در وب جستجو می‌کند، کمتر از نصف هزینه کل خود را صرفه‌جویی می‌کند. نرخ‌های Batch به ازای هر میلیون توکن برای Opus 4.8 برابر با $2.50 ورودی و $12.50 خروجی، برای Sonnet 5 برابر با $1 و $5، و برای Haiku 4.5 برابر با $0.50 و $2.50 است. معامله بر سر تأخیر (latency) است: اکثر batchها در کمتر از یک ساعت تمام می‌شوند، batchای که در 24 ساعت تکمیل نشود منقضی می‌گردد و streaming قابل دسته‌بندی (batch) نیست. Batch و prompt caching با هم ترکیب می‌شوند و از آنجا که یک batch می‌تواند بیش از پنج دقیقه اجرا شود، از کش 1 ساعته در داخل آن استفاده کنید.

تخصیص هزینه به ازای هر پروژه. هر پاسخ API یک بلوک usage برمی‌گرداند، بنابراین می‌توانید هزینه یک درخواست واحد را ثبت کرده و آن را به یک پروژه یا مشتری خاص نسبت دهید. یک اشتراک فقط یک مجموعه نمودار برای شخصی که صاحب صندلی است گزارش می‌دهد. این را در یک تیم ضرب کنید تا انتخاب دیگر یک تصمیم شخصی نباشد؛ به همین دلیل است که مقایسه قیمت Claude Code به ازای هر صندلی در برابر همان کار با صورت‌حساب توکنی نسخه‌ای از این مقایسه است که باید هنگام خرید صندلی برای دیگران اجرا کنید.

یک نکته را با دقت بیان می‌کنیم، زیرا فرض اشتباه در هر دو جهت آسان است: این‌ها همچنان سطوح صورت‌حساب جداگانه‌ای هستند، اما در برخی طرح‌ها اکنون هم‌پوشانی دارند. مستندات Anthropic صورت‌حساب اشتراک را به پشتیبانی claude.ai و صورت‌حساب Console را به پلتفرم API هدایت می‌کند و /usage-credits تحت یک API key کار نمی‌کند. آنچه تغییر کرده این است که «طرح‌های Max و Team شامل اعتبار ماهانه برای پلتفرم Claude هستند»: $100 در ماه برای Max 5x، $200 برای Max 20x، و در طرح Team مبلغ $20 برای هر صندلی Standard و $100 برای هر صندلی Premium، که در «یک موجودی ماهانه، با سقف $500» تجمیع می‌شوند. طرح‌های Free، Pro و Enterprise واجد شرایط نیستند. برای دریافت اعتبار، باید یک سازمان Claude Console را به طرح خود متصل کنید. این اعتبار شامل Messages API و Message Batches API، محیط Console Playground، Claude Managed Agents و Claude Agent SDK می‌شود، اما شامل Claude Code تعاملی نیست. این اعتبار «منتقل نمی‌شود» و هنگامی که تمام شود و اعتبار خریداری‌شده‌ای پشت آن نباشد، «درخواست‌های API تا زمان دریافت اعتبارات ماهانه بعدی متوقف می‌شوند»؛ استفاده «هرگز از طرح Claude شما کسر نمی‌شود.» بنابراین یک مشترک Max یا Team همچنان دو حساب دارد، اما لزوماً دو صورت‌حساب ندارد، و آنچه اعتبارات ماهانه API در Max و Team پوشش می‌دهند مراحل اتصال را توضیح می‌دهد. این استثنا برای مثال کاری زیر اهمیت دارد: اعتبار، هزینه یک جلسه کدنویسی تعاملی را پرداخت نمی‌کند، بنابراین نقطه سر‌به‌سر را تغییر نمی‌دهد. اما هزینه اسکریپت‌ها و batch jobهایی که در کنار آن اجرا می‌کنید را پوشش می‌دهد. در طرح Pro، انتظار دو حساب و دو صورت‌حساب را داشته باشید.

فرمول نقطه سر‌به‌سر

ابتدا قیمت یک دور (turn) را محاسبه کنید و سپس آن را مقیاس‌بندی کنید.

turn cost = uncached_input_tokens x base_input_price
          + cache_write_tokens    x 1.25 x base_input_price
          + cache_read_tokens     x 0.10 x base_input_price
          + output_tokens         x output_price

monthly API cost = turn cost x turns_per_active_day x active_days_per_month

break even when: monthly API cost = flat plan fee

ضرایب منتشر شده‌اند و تخمینی نیستند. هزینه نوشتن در کش با ماندگاری 5 دقیقه برابر با "1.25 برابر قیمت ورودی پایه"، ماندگاری 1 ساعت برابر با "2 برابر قیمت ورودی پایه" و خواندن از کش برابر با "0.1 برابر قیمت ورودی پایه" برای تمام مدل‌های موجود در لیست نرخ‌های زیر است. ضریب 0.1 برابر، یک ضریب استاندارد است و نه جهانی: صفحه قیمت‌گذاری، هزینه خواندن از کش را برای Opus 5.5 و Sonnet 5.5 برابر با 0.05 برابر و برای Fable 5.1 برابر با 0.025 برابر تعیین کرده است که مدل‌های جدیدتر در ادامه به آن پرداخته‌اند. توکن‌های تفکر (Thinking tokens) به عنوان توکن‌های خروجی محاسبه می‌شوند، بنابراین حتی در مدل‌هایی که خلاصه استدلال را نمایش نمی‌دهند، باید در output_tokens لحاظ شوند.

نرخ‌های پایه به ازای هر میلیون توکن (MTok)، به‌روز شده در تاریخ 18 اکتبر 2026:

• claude-fable-5: 10 دلار ورودی، 50 دلار خروجی. خواندن از کش 1 دلار. نوشتن در کش 5 دقیقه‌ای 12.50 دلار. کانتکست 1 میلیون توکن.
• claude-opus-4-8 و claude-opus-4-7: 5 دلار ورودی، 25 دلار خروجی. خواندن از کش 0.50 دلار. نوشتن در کش 5 دقیقه‌ای 6.25 دلار. کانتکست 1 میلیون توکن.
• claude-sonnet-5: 2 دلار ورودی، 10 دلار خروجی. در زمان عرضه به عنوان قیمت‌گذاری مقدماتی تا 31 اوت 2026 اعلام شد، اما اکنون قیمت استاندارد است و افزایش برنامه‌ریزی‌شده به 3 دلار و 15 دلار در تاریخ 1 سپتامبر 2026 اعمال نشد. خواندن از کش 0.20 دلار. نوشتن در کش 5 دقیقه‌ای 2.50 دلار. کانتکست 1 میلیون توکن.
• claude-haiku-4-5: 1 دلار ورودی، 5 دلار خروجی. خواندن از کش 0.10 دلار. نوشتن در کش 5 دقیقه‌ای 1.25 دلار. کانتکست 200 هزار توکن.

از زمان عرضه این مدل‌ها، سری جدیدی وارد شده است: claude-opus-5-5 با 4 دلار ورودی و 20 دلار خروجی، claude-sonnet-5-5 با 2 دلار و 10 دلار، claude-fable-5-1 با 10 دلار و 50 دلار، و claude-haiku-5-5 از 0.10 دلار و 0.50 دلار. در مدل‌های Opus 5.5 و Sonnet 5.5 هزینه خواندن از کش برابر با 0.05 برابر ورودی پایه (0.20 دلار و 0.10 دلار به ازای هر MTok) و در Fable 5.1 برابر با 0.025 برابر (0.25 دلار به ازای هر MTok) است، بنابراین اگر قیمت‌گذاری یکی از آن‌ها را انجام می‌دهید، این ضریب را در فرمول جایگزین کنید. مدل‌های لیست بالا اکنون قدیمی (legacy) محسوب می‌شوند اما همچنان در دسترس هستند. اولین تاریخ ممکن برای بازنشستگی Haiku 4.5 یعنی 15 اکتبر 2026 بدون اعلامیه توقف پشتیبانی سپری شده است: در تاریخ 18 اکتبر 2026، Anthropic همچنان آن را به عنوان فعال فهرست کرده است و متعهد شده که حداقل 60 روز پیش از بازنشستگی یک مدل عمومی، اطلاع‌رسانی کند.

در مدل‌هایی که در اینجا قیمت‌گذاری شده‌اند، برای context طولانی surcharge دریافت نمی‌شود: «هزینهٔ یک درخواست 900k-token با نرخ هر token، با هزینهٔ یک درخواست 9k-token یکسان است.» استثنا در lineup جدیدتر، Haiku 5.5 است که پس از عبور prompt از 100,000 token، نرخ‌های بالاتری دریافت می‌کند. این آستانه برای کارهای agentic اهمیت دارد، زیرا context با هر نوبت بزرگ‌تر می‌شود؛ بنابراین پیش از انتقال کارهای ارزان و پرتعداد به آن، خواندن هزینهٔ سه کار واقعی در Haiku 5.5 در مقایسه با Haiku 4.5 مفید است.

یک مثال عملی با فرض‌های مشخص‌شده

یک نوبت میانی Claude Code را روی مدل Sonnet 5 با 60,000 توکن محتوا در نظر بگیرید: 55,000 توکن از حافظه موقت (cache) خوانده شده، 3,000 توکن جدید در حافظه موقت نوشته شده، 2,000 توکن ورودی تازه بدون کش، و 1,200 توکن خروجی شامل بخش تفکر (thinking).

• خواندن از کش: 55,000 ضرب‌در $0.20/MTok = $0.0110
• نوشتن در کش: 3,000 ضرب‌در $2.50/MTok = $0.0075
• ورودی بدون کش: 2,000 ضرب‌در $2.00/MTok = $0.0040
• خروجی: 1,200 ضرب‌در $10.00/MTok = $0.0120

این هزینه تقریباً $0.035 برای هر نوبت است. با 120 نوبت در یک روز کاری، هزینه تقریباً $4.14 در روز می‌شود. در 20 روز کاری در ماه، این مبلغ تقریباً $83 در ماه خواهد بود.

این رقم را در برابر هزینه‌های ثابت بالا قرار دهید؛ این مقایسه دو نکته را همزمان نشان می‌دهد. این مبلغ حدود چهار برابر هزینه اشتراک Pro است، بنابراین روی کاغذ اشتراک Pro ارزان‌تر است، به شرطی که سهمیه آن شامل 120 نوبت Sonnet در روز باشد. این شرط همان چیزی است که هیچ عدد منتشرشده‌ای نمی‌تواند برای شما مشخص کند. نزدیک‌ترین پاسخ به این پرسش، نگاهی دقیق‌تر به آنچه Pro شامل می‌شود و محدودیت‌های آن است که پیش از فرض اینکه هزینه کمتر همیشه برنده است، ارزش خواندن دارد. همان مبلغ $83 پایین‌تر از هزینه پایه Max قرار می‌گیرد، بنابراین در اینجا مدل پرداخت بر اساس مصرف (metered)، از Max ارزان‌تر است. کلمه «پایه» در جمله آخر نقش مهمی دارد، زیرا Max با دو قیمت عرضه می‌شود و اینکه کدام‌یک از دو سطح Max را واقعاً خریداری می‌کنید، خط مقیاسی که با آن اندازه‌گیری می‌کنید را تا $100 در ماه جابه‌جا می‌کند.

حالا فرض‌ها را یکی‌یکی تغییر دهید و ببینید که چگونه هزینه طرح دیگر عدد تعیین‌کننده نخواهد بود.

سه عامل بیش از قیمت طرح، نقطه سر‌به‌سر را تغییر می‌دهند

کش کردن پرامپت (Prompt caching). اگر همان تبادل 60,000 توکنی را بدون کش کردن اجرا کنید، کل پرامپت به عنوان ورودی جدید محاسبه می‌شود: 60,000 ضرب‌در 2.00 دلار برای هر میلیون توکن برابر است با 0.12 دلار، به اضافه 0.012 دلار برای خروجی، که مجموعاً 0.132 دلار برای هر تبادل می‌شود. این مبلغ تقریباً چهار برابر حالت کش‌شده است و هزینه ماهانه 83 دلاری را به حدود 317 دلار می‌رساند. این تنها نقطه سر‌به‌سری است که Anthropic منتشر کرده، زیرا به حجم کاری شما بستگی ندارد: «یک cache hit هزینه‌ای معادل 10 درصد قیمت استاندارد ورودی دارد؛ این یعنی کش کردن پس از یک بار خواندن برای بازه 5 دقیقه‌ای (1.25 برابر هزینه نوشتن)، یا پس از دو بار خواندن برای بازه 1 ساعته (2 برابر هزینه نوشتن) صرفه اقتصادی پیدا می‌کند.»

دو حالت شکست وجود دارد که بدون اطلاع شما، کش کردن را غیرفعال می‌کنند. اولی، پیشوندی کوتاه‌تر از حداقل طول قابل کش مدل است: 512 توکن برای Fable 5، 1,024 توکن برای Opus 4.8 و Sonnet 5، 2,048 توکن برای Opus 4.7 و 4,096 توکن برای Haiku 4.5. پیشوند کوتاه‌تر کش نمی‌شود و هیچ خطایی هم صادر نمی‌شود. دومی، درخواست‌های موازی است، زیرا «یک ورودی کش تنها پس از شروع اولین پاسخ در دسترس قرار می‌گیرد.» ده درخواست مشابه که همزمان ارسال شوند، همگی هزینه کامل ورودی را پرداخت می‌کنند. نشانه هر دو حالت، صفر بودن cache_read_input_tokens است.

انتخاب مدل. همان تبادل را با Opus 4.8 قیمت‌گذاری کنید؛ با 5 دلار برای ورودی و 25 دلار برای خروجی، هزینه خواندن از کش 0.50 دلار و نوشتن در بازه 5 دقیقه‌ای 6.25 دلار برای هر میلیون توکن است: هزینه خواندن 0.0275 دلار، نوشتن 0.0188 دلار، ورودی بدون کش 0.0100 دلار و خروجی 0.0300 دلار. این مبلغ حدود 0.086 دلار برای هر تبادل است که 2.5 برابر تبادل با Sonnet و در همان حجم کاری، حدود 207 دلار در ماه هزینه دارد. یک انتخاب مدل، همان کار را از زیر سقف هزینه Max به بیش از دو برابر آن رساند. Haiku 4.5 با قیمت 1 دلار برای ورودی و 5 دلار برای خروجی، برای کارهای مکانیکی مانند بررسی لاگ‌ها، هزینه را در جهت عکس تغییر می‌دهد. Fable 5 با قیمت 10 دلار برای ورودی و 50 دلار برای خروجی، هزینه را باز هم در جهت گران‌تر تغییر می‌دهد؛ بنابراین پیش از آنکه آن را به مدل پیش‌فرض خود تبدیل کنید، ارزش دارد که چه کارهایی واقعاً هزینه Fable 5 را جبران می‌کنند را مطالعه کنید.

سطح تلاش به انتخاب مدل بستگی دارد، زیرا توکن‌های تفکر (thinking tokens) با نرخ خروجی محاسبه می‌شوند. در Opus 4.8 مقدار پیش‌فرض API برابر با high است و نقطه شروع مستند برای کدنویسی و کارهای عاملی (agentic)، مقدار گران‌تر xhigh است. آن را با /effort در Claude Code یا با output_config.effort در API کاهش دهید. یک نکته دیگر برآوردهای قدیمی را تغییر می‌دهد: مدل‌های جدیدتر از توکنایزر جدیدتری استفاده می‌کنند که «برای متن یکسان، تقریباً 30 درصد توکن بیشتری تولید می‌کند»؛ بنابراین شمارشی که با مدل قدیمی‌تر انجام شده، متن مشابه را امروز کمتر از واقعیت نشان می‌دهد.

بهداشت نشست (Session hygiene). این API بدون وضعیت (stateless) است، بنابراین هر تبادل، کل گفتگو را به عنوان ورودیِ مشمول هزینه دوباره ارسال می‌کند. در نتیجه، یک نشست طولانی به ازای هر پیام هزینه بیشتری نسبت به یک نشست تازه دارد؛ این همان مکانیزمی است که پشت اکثر صورت‌حساب‌های غافلگیرکننده قرار دارد و در چه چیزی واقعاً توکن‌ها را در یک نشست Claude Code مصرف می‌کند به تفصیل بررسی شده است. بین کارهای نامرتبط، /clear را اجرا کنید، زیرا کانتکست قدیمی در هر پیام بعدی دوباره ارسال و دوباره محاسبه می‌شود. در یک کار طولانی، /compact را اجرا کنید تا تاریخچه به جای انتقال کامل، خلاصه‌سازی شود. در بازه‌های زمانی پیوسته کار کنید، زیرا کش پیش‌فرض «عمر 5 دقیقه‌ای دارد» و «هر بار که محتوای کش‌شده استفاده می‌شود، بدون هزینه اضافی تمدید می‌شود.» نشستی که هر ده دقیقه یک بار به آن دسترسی دارید، هر بار هزینه نوشتن مجدد را پرداخت می‌کند. یک نشست Claude Code در حال اجرا در tmux روی یک VPS در زمان بیکاری تقریباً هیچ هزینه‌ای ندارد، اما بیکار ماندن بیش از عمر کش، باعث از دست رفتن پیشوند گرم (warm prefix) می‌شود.

میزان مصرف خود را پیش از تصمیم‌گیری بسنجید

بر اساس مثال من تصمیم نگیرید. بر اساس یک هفته از عملکرد خودتان تصمیم بگیرید.

در Claude Code، به مدت یک هفته در پایان هر نشست دستور /usage را اجرا کنید (/cost یک نام مستعار برای همان صفحه است). این دستور تعداد توکن‌های نشست و برآورد هزینه را گزارش می‌دهد، با یک نکته از مستندات: رقم دلاری به‌صورت محلی از تعداد توکن‌ها با قیمت لیست محاسبه می‌شود و «این رقم یک برآورد است، بنابراین برای صورت‌حساب قطعی به صفحه Usage در Claude Console مراجعه کنید.» مجموع‌ها با اجرای /clear بازنشانی می‌شوند، پس ابتدا صفحه را بخوانید. در یک اشتراک، آن رقم دلاری صورت‌حساب شما نیست، اما تعداد توکن‌های پشت آن همان چیزی است که این فرمول به آن نیاز دارد. /context نشان می‌دهد چه چیزی در حال پر کردن پنجره است.

در یک حساب API، صفحه usage در Claude Console مرجع قطعی است. برای قیمت‌گذاری یک پرامپت پیش از ارسال آن، client.messages.count_tokens() «رایگان است اما مشمول محدودیت تعداد درخواست در دقیقه بر اساس سطح مصرف شماست» و تنها شمارنده‌ای است که از توکن‌ساز (tokenizer) واقعی که برای آن صورت‌حساب دریافت می‌کنید، استفاده می‌کند.

پس از یک فراخوانی، بلوک usage را بخوانید و آن را به‌درستی تفسیر کنید:

u = response.usage
total_input = u.input_tokens + u.cache_creation_input_tokens + u.cache_read_input_tokens

input_tokens فقط باقی‌ماندهٔ کش‌نشده را می‌شمارد که در مستندات به عنوان «توکن‌های پس از آخرین نقطه شکست کش» ثبت شده است. یک نوبت که input_tokens: 4000 را گزارش می‌کند، یک نوبت 4000 توکنی نیست و مجموع این سه فیلد، همان اندازهٔ پرامپتی است که این فرمول به آن نیاز دارد.

سپس مقایسه کنید. اگر ماهِ اندازه‌گیری‌شدهٔ شما به‌وضوح کمتر از هزینهٔ طرح (plan) است، مدل پرداخت بر اساس مصرف (meter) را انتخاب کنید. اگر به‌وضوح بیشتر است، طرح را انتخاب کنید، به شرطی که سهمیهٔ آن یک روز کاری عادی شما را پوشش دهد. اگر نزدیک به مرز است، طرح را انتخاب کنید، زیرا یک طرح نمی‌تواند شما را غافلگیر کند اما مدل مصرفی می‌تواند. اگر بسیار پایین‌تر از هزینهٔ Pro است، پیش از خرید هر یک از دو طرف، بررسی کنید که آیا یک طرح پولی برای نحوهٔ کار شما بهتر از سطح رایگان است یا خیر، زیرا مصرفی به آن سبکی ممکن است آن‌قدر کم به محدودیت رایگان برخورد کند که اصلاً توجیهی برای پرداخت هزینه نداشته باشد. هیچ‌کدام از این‌ها یک مسیر یک‌طرفه نیست، زیرا لغو یا کاهش سطح اشتراک ماهی را که قبلاً برای آن پرداخت کرده‌اید دست‌نخورده باقی می‌گذارد، اگر چند هفته مصرف واقعی دیگر، برآورد شما را نقض کرد. در هر سمتی که قرار بگیرید، این محاسبات فقط تعیین می‌کند کدام مدل صورت‌حساب ارزان‌تر است و اینکه آیا هزینه با ساعات بازیابی‌شده جبران می‌شود یا خیر، محاسبهٔ جداگانه‌ای است که باید در برابر نرخ ساعتی خودتان انجام دهید.

FAQ

آیا Claude API از Claude Pro یا Max ارزان‌تر است؟

این موضوع به حجم استفاده بستگی دارد و هیچ نقطه سر‌به‌سریِ اعلام‌شده‌ای برای آن وجود ندارد، زیرا اشتراک‌ها به‌جای سهمیه توکن، به‌عنوان بازه‌های زمانی استفاده فروخته می‌شوند. هزینه یک تعامل معمول را بر اساس نرخ‌های اعلام‌شده به ازای هر توکن محاسبه کنید، آن را در تعداد تعاملات در هر روز فعال و تعداد روزهای فعال در ماه ضرب کنید، سپس این رقم را با هزینه اشتراک مقایسه کنید. در یک نمونه محاسباتی، یک تعامل 60,000 توکنی با Sonnet 5 حدود 0.035 دلار هزینه دارد؛ یعنی با فرض 120 تعامل در روز طی 20 روز، هزینه ماهانه حدود 83 دلار خواهد بود: رقمی بالاتر از هزینه Pro و پایین‌تر از هزینه پایه Max.

چگونه هزینه ماهانه Claude API خود را محاسبه کنم؟

برای جمع‌آوری تعداد واقعی توکن‌ها، /usage را به مدت یک هفته در Claude Code اجرا کنید یا اگر از قبل حساب API دارید، صفحه میزان استفاده (usage) را در Claude Console بخوانید. سپس هزینه یک تعامل را محاسبه کنید: ورودی بدون کش با نرخ پایه، نوشتن در کش با 1.25 برابر نرخ ورودی پایه، خواندن از کش با 0.1 برابر نرخ ورودی پایه (0.05 برابر در Opus 5.5 و Sonnet 5.5، و 0.025 برابر در Fable 5.1)، و خروجی با نرخ خروجی، با احتساب توکن‌های تفکر (thinking tokens) به‌عنوان خروجی. این مقدار را در تعداد تعاملات در هر روز فعال و تعداد روزهای فعال در ماه ضرب کنید.

چه چیزی بیشترین تأثیر را بر صورت‌حساب Claude API دارد؟

بیش از هر چیز، Prompt caching. یک تعامل 60,000 توکنی با Sonnet 5 زمانی که پیشوند (prefix) از کش خوانده شود حدود 0.035 دلار و زمانی که از کش خوانده نشود حدود 0.132 دلار هزینه دارد. انتخاب مدل در رتبه بعدی قرار دارد: همان تعامل با Opus 4.8 حدود 0.086 دلار هزینه دارد. طول نشست (session) در رتبه سوم است، زیرا API بدون وضعیت (stateless) است و در هر تعامل، کل گفتگو به‌عنوان ورودیِ مشمول هزینه، دوباره ارسال می‌شود.

آیا اشتراک Claude شامل دسترسی به API می‌شود؟

در طرح‌های Max و Team، تا حدی. این طرح‌ها اکنون شامل اعتبار ماهانه Claude Platform هستند: 100 دلار در Max 5x، 200 دلار در Max 20x، و یک استخر اشتراکی Team به مبلغ 20 دلار به ازای هر صندلی Standard و 100 دلار به ازای هر صندلی Premium، با سقف 500 دلار. شما با متصل کردن یک سازمان در Claude Console این اعتبار را دریافت می‌کنید؛ این اعتبار شامل Messages API و Message Batches API می‌شود اما Claude Code تعاملی را پوشش نمی‌دهد و "اعتبار استفاده‌نشده در پایان هر دوره صورت‌حساب منقضی می‌شود." طرح‌های Free، Pro و Enterprise چنین اعتباری دریافت نمی‌کنند، بنابراین در این طرح‌ها، API را به‌عنوان یک حساب دوم با صورت‌حساب جداگانه در نظر بگیرید. در هر صورت، این دو محیط جدا از هم باقی می‌مانند و واضح‌ترین نشانه آن دستور /usage-credits در Claude Code است که "با احراز هویت از طریق API key در دسترس نیست". بسیاری از توسعه‌دهندگان هر دو را دارند: یک اشتراک برای کدنویسی تعاملی و یک کلید برای ابزارهایی که می‌سازند.