هزینه token در Claude Code: یک session واقعاً چقدر مصرف میکند
Updated 2026-07-15
یک session جدی در Claude Code میلیونها token input میسوزاند چون agent در هر فراخوانی مدل context در حال رشد را دوباره ارسال میکند، پس یک ساعت کار روی Sonnet 4.6 معمولاً با نرخهای مستقیم API بین چند دلار تا چند ده دلار قرار میگیرد. prompt caching، مسیردهی مدل و نرخ پایینتر به ازای هر token سه اهرمی هستند که آن را پایین میآورند.
پاسخ سریع: انتظار دلار در هر session را داشته باشید، نه سنت.
Claude Code یک ابزار agentic است، نه یک پنجره چت. یک درخواست از شما میتواند دهها فراخوانی مدل را trigger کند و هر فراخوانی کل مکالمه در حال رشد را بهعنوان tokenهای input دوباره ارسال میکند. این باعث میشود حجم input، نه output، محرک هزینه باشد. tokenهای output معمولاً در کنار input یک خطای گرد کردن هستند. اعداد تقریبی گزارششده توسط community یک session جدی یکساعته روی یک repo متوسط را حدود 5 تا 20 میلیون token قرار میدهند. با نرخهای مستقیم Anthropic برای Sonnet 4.6 ($3 به ازای هر میلیون input، $15 به ازای هر میلیون output)، بیشتر sessionها جایی بین حدود $2 تا $40 قبل از تخفیفهای caching قرار میگیرند، و روزهای سنگین با Opus خیلی فراتر از آن میروند. prompt caching صورتحسابهای واقعی را زیر محاسبه ساده میآورد، اما الگو پابرجاست: sessionهای طولانی روی repoهای بزرگ پول واقعی هزینه دارند. شما سه اهرم دارید. آنچه را وارد پنجره context میشود کاهش دهید، کار روتین را به مدلهای ارزانتر مسیردهی کنید و نرخ به ازای هر token را با تغییر جایی که درخواستها صورتحساب میشوند پایین بیاورید. باقی این صفحه هر کدام را با اعداد مشخص بررسی میکند.
tokenها واقعاً کجا میروند.
دو مکانیزم این را نرم میکنند. اول، prompt caching در Anthropic: Claude Code prefixهای پایدار را بهعنوان قابل کش علامتگذاری میکند، writeهای کش یک premium هزینه دارند و readهای کش حدود یکدهم نرخ عادی input صورتحساب میشوند. دوم، context compaction: دستور /compact تاریخچه را خلاصه میکند و رونوشت خام را حذف میکند. هر دو خیلی کمک میکنند و هیچکدام قاعده اصلی را تغییر نمیدهند: هر چیزی که در پنجره نشسته در هر فراخوانی که آن را شامل شود پرداخت میشود. به همین دلیل همان prompt در repoهای مختلف مبالغ بهشدت متفاوتی هزینه دارد. یک سؤال پرسیدهشده در یک session تازه با یک CLAUDE.md ساده ارزان است. همان سؤال پرسیدهشده 30 turn داخل یک session که دهها فایل بزرگ را خوانده روی یک پنجره token ششرقمی سوار میشود.
- system prompt و تعریف ابزارها: حدود 15 تا 20K token، که با هر فراخوانی مدل دوباره ارسال میشود.
- CLAUDE.md، فایلهای rules و schemaهای ابزار MCP: در شروع session بارگذاری میشوند و در هر فراخوانی بعدی حمل میشوند.
- خواندن فایلها: یک فایل منبع 500 خطی حدود 5 تا 7K token است و بعد از یک بار خوانده شدن در پنجره باقی میماند.
- نتایج ابزار: خروجی تست، نتایج grep و لاگهای ترمینال به مکالمه اضافه میشوند و در هر turn بعدی بهعنوان input دوباره صورتحساب میشوند.
- خود حلقه agentic: یک «این تست ناموفق را رفع کن» میتواند قبل از اینکه Claude Code گزارش بدهد 10 تا 40 فراخوانی مدل تولید کند.
محاسبات واقعبینانه هزینه session.
آن را turn به turn مدل کنید نه با حدس زدن. یک session معمولی با اندازه متوسط حدود 40 فراخوانی مدل اجرا میکند. وقتی چند فایل و مقداری خروجی تست انباشته شده باشد، پنجره کامل بهطور میانگین حدود 90K token در هر فراخوانی است. چهل فراخوانی با 90K برابر 3.6M token input میشود. output کوچک میماند: 40 فراخوانی با حدود 1,000 token هرکدام تقریباً 40K token output است. جدول زیر سه پروفایل session را با نرخهای لیست مستقیم Anthropic قیمتگذاری میکند. اینها را بهعنوان سقف در نظر بگیرید: prompt caching prefix تکراری را بهشدت تخفیف میدهد، پس sessionهای کششده معمولاً پایینتر میآیند. الگو همچنان با آنچه توسعهدهندگان گزارش میکنند مطابقت دارد. بعدازظهرهای گاهبهگاه چند دلار هزینه دارند؛ اجرای Opus بهعنوان driver روزانه روی API میتواند چند صد دلار در ماه پاک کند.
| پروفایل session | tokenهای input | tokenهای output | Sonnet 4.6 مستقیم ($3/$15) | Opus 4.7 مستقیم ($5/$25) |
|---|---|---|---|---|
| سبک (10 فراخوانی، repo کوچک) | ~0.6M | ~12K | $1.98 | $3.30 |
| معمولی (40 فراخوانی، repo متوسط) | ~3.6M | ~40K | $11.40 | $19.00 |
| روز سنگین (3 session طولانی) | ~12M | ~120K | $37.80 | $63.00 |
Plan در برابر API: کدام مسیر Claude Code را ارزانتر میکند؟
Anthropic، Claude Code را به دو شکل میفروشد: در قالب planهای اشتراکی flat-rate با سقف مصرف اجراشده در بازههای چرخشی، یا به ازای هر token روی API. قیمتگذاری API برای Claude Code بهسادگی همان نرخهای مدل بالا است که روی هر چیزی که sessionهای شما میسوزانند اعمال میشود، بدون سقف و بدون قطع. نقطه سربهسر یک محاسبه ساده است. اگر session معمولی شما با نرخهای مستقیم روی Sonnet حدود $11 هزینه دارد، یک plan $20 با حدود دو session در ماه هزینهاش را جبران میکند، به شرطی که زیر سقفهایش بمانید. مشکل خود سقفهاست: استفاده سنگین agentic دقیقاً همان الگویی است که محدودیتهای چرخشی را trip میکند، و یک نرخ ثابت درست همان لحظهای که وسط session قفل میشوید دیگر ارزان نیست. صورتحساب API این معامله را برعکس میکند. شما هرگز قطع نمیشوید و دقیقاً برای آنچه میسوزانید پرداخت میکنید. بسیاری از کاربران سنگین به یک حالت ترکیبی میرسند: یک plan برای کار تعاملی، یک API key برای jobهای CI و سرریز.
| گزینه | قیمت | محدودیتها | مناسب برای |
|---|---|---|---|
| plan Claude Pro | $20/ماه (تقریبی) | بازههای مصرف چرخشی، سقف هفتگی، سهمیه متوسط Claude Code | sessionهای گاهبهگاه، repoهای کوچک |
| planهای Claude Max | $100 تا $200/ماه (تقریبی) | سقفهای بالاتر، همچنان rate-limited تحت بار agentic پایدار | کاربران روزانهای که میتوانند با سقفها کنار بیایند |
| Anthropic API، پرداخت به ازای مصرف | به ازای هر token با نرخهای لیست | بدون سقف مصرف، هر token شمارش میشود | استفاده پرنوسان یا تیمی، CI، کنترل کامل |
| API از طریق یک gateway | به ازای هر token، زیر لیست | همان شمارش، قیمت واحد پایینتر | مثل API، حساس به هزینه |
چطور هزینه token در Claude Code را کاهش دهیم.
دو اهرم آخر با هم ترکیب میشوند. مسیردهی یک مدل ارزان از طریق یک endpoint تخفیفدار میتواند یک session $10 را برای کار روتین به مقداری کاملاً زیر یک دلار تبدیل کند. یک گزینه gateway، APIsRouter است، یک API سازگار با OpenAI با صورتحساب pay-as-you-go و بدون اشتراک: مدلهای global 20% پایینتر از لیست رسمی قیمتگذاری شدهاند، مدلهای چینی زیر نرخهای رسمی خودشان قرار دارند، اولین شارژ +100% موجودی اضافه میکند و checkout بدون ثبتنام در /topup ابتدا پرداخت را میگیرد و بعد کلید را ایمیل میکند. کاتالوگ زیر نشان میدهد یک نردبان مسیردهی در عمل چه شکلی است. Kimi K2.6 (kimi-k2.6) هم در دسترس است اگر آن را بهعنوان tier اقتصادی ترجیح دهید.
- CLAUDE.md را ساده نگه دارید. هر خط یک هزینه تکرارشونده در هر فراخوانی مدل در هر session است.
- برای هر task یک session تازه شروع کنید و وقتی یک session طولانی منحرف شد /compact را اجرا کنید. یک پنجره 150K token در هر فراخوانی 150K صورتحساب میشود.
- دامنه خواندنها را محدود کنید. Claude Code را به فایلهای مشخص اشاره دهید بهجای اینکه اجازه دهید crawl کند، و خروجی build و دایرکتوریهای vendored را حذف کنید.
- سرورهای MCP که استفاده نمیکنید را غیرفعال کنید. schemaهای ابزار آنها در هر فراخوانی همراه system prompt سوار میشود.
- بر اساس مدل مسیردهی کنید. Opus را برای معماری و اشکالزدایی پیچیده نگه دارید، Sonnet را بهعنوان پیشفرض اجرا کنید و boilerplate، scaffolding تست و پیامهای commit را به مدلهای ارزانتر بفرستید.
- خود نرخ به ازای هر token را با اشاره دادن base URL به یک gateway بهجای صورتحساب با قیمتهای لیست مستقیم پایین بیاورید.
| Model ID | ورودی $/1M | خروجی $/1M | مناسب برای |
|---|---|---|---|
| claude-opus-4-7 | $4.00 | $20.00 | معماری، اشکالزدایی سخت |
| claude-sonnet-4-6 | $2.40 | $12.00 | driver پیشفرض کدنویسی |
| glm-5 | $0.514 | $2.314 | ویرایشهای روتین، sub-taskهای agentic |
| deepseek-v4-pro | $0.3915 | $0.783 | boilerplate، تستها، پیامهای commit |
| deepseek-v4-flash | $0.126 | $0.252 | خلاصهسازی، جستجوهای سریع |
مثال config: Claude Code را دوباره مسیردهی کنید و تأیید کنید.
Claude Code در startup مقدار ANTHROPIC_BASE_URL را میخواند، پس تغییر جایی که tokenها صورتحساب میشوند یک تغییر settings است، نه تغییر workflow. endpoint و کلید را در ~/.claude/settings.json قرار دهید و هر session آنها را میگیرد. Model IDها همان میمانند، اجرای ابزار روی دستگاه شما محلی میماند و rollback فقط کامنت کردن یک خط است. برای ابزارها و اسکریپتهای سازگار با OpenAI، base URL به /v1 ختم میشود (https://api.apisrouter.com/v1). قبل از اینکه driver روزانه خود را به آن اشاره دهید، کلید را با یک curl یکباره تأیید کنید:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apisrouter.com",
"ANTHROPIC_AUTH_TOKEN": "sk-APIsRouter-...",
"ANTHROPIC_MODEL": "claude-sonnet-4-6",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-7",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6"
}
}پرسشهای پرتکرار
هزینه Claude Code در هر ساعت چقدر است؟
اعداد تقریبی گزارششده community برای یک ساعت فعال روی یک repo متوسط 5 تا 20 میلیون token هستند، که با نرخهای مستقیم روی Sonnet 4.6 قبل از caching بین حدود $2 تا $40 قیمتگذاری میشود. prompt caching معمولاً صورتحسابهای واقعی را زیر آن میآورد، و Opus تقریباً نرخهای به ازای هر token را دو برابر میکند.
چرا Claude Code اینقدر token مصرف میکند؟
هر فراخوانی مدل کل پنجره context را دوباره ارسال میکند: system prompt، CLAUDE.md، هر فایلی که خوانده و همه خروجیهای قبلی ابزار. یک درخواست کاربر میتواند دهها فراخوانی را trigger کند، پس همان tokenها بارها و بارها با رشد پنجره بهعنوان input صورتحساب میشوند.
آیا Claude Code در اشتراک Claude Pro گنجانده شده است؟
بله، planهای اشتراکی مصرف Claude Code را تحت بازههای نرخ چرخشی و سقفهای هفتگی شامل میشوند. کاربران سبک اغلب داخل یک plan جا میشوند. sessionهای agentic پایدار دقیقاً همان الگویی هستند که به سقفها میخورند، به همین دلیل کاربران سنگین یک API key برای سرریز یا CI اضافه میکنند.
چطور بررسی کنم Claude Code چند token استفاده کرده؟
دستور /cost را داخل یک session اجرا کنید تا هزینه فعلی session را ببینید وقتی روی صورتحساب API هستید. برای تاریخچه سطح حساب، کنسول صورتحساب هر endpointای که ANTHROPIC_BASE_URL را به آن اشاره دادهاید بررسی کنید؛ gatewayها معمولاً تفکیک مدل، token و دلار هر درخواست را به ازای هر کلید نشان میدهند.
آیا Claude Code میتواند از یک مدل ارزانتر برای صرفهجویی در هزینه استفاده کند؟
بله. ANTHROPIC_MODEL پیشفرض را تنظیم میکند و overrideهای ANTHROPIC_DEFAULT_OPUS_MODEL، SONNET و HAIKU انتخابهای tier را دوباره نگاشت میکنند. یک تنظیم رایج Sonnet را بهعنوان driver نگه میدارد، Opus را برای taskهای سخت صریح رزرو میکند و jobهای اسکریپتشده یا تکراری را از طریق یک endpoint سازگار با OpenAI به یک مدل اقتصادی مثل deepseek-v4-pro میفرستد.
آیا prompt caching بهطور خودکار Claude Code را ارزانتر میکند؟
تا حد زیادی، بله. Claude Code بدون هیچ تنظیمی prompt caching را اعمال میکند، پس prefix پایدار context شما در فراخوانیهای تکراری با کسری از نرخ input صورتحساب میشود. شما همچنان برای محتوای جدیدی که وارد پنجره میشود قیمت کامل میپردازید و پاک کردن یک session کش گرم را دور میریزد، پس هر جا منطقی است کارهای مرتبط را در یک session batch کنید.