RTK Claude Code: نصب، راه‌اندازی و اندازه‌گیری صرفه‌جویی توکن

RTK Claude Code (RTK برای کلاد کد) یعنی استفاده از ابزار متن‌بازی به نام RTK (مخفف «Rust Token Killer») که خروجی دستورهای ترمینال را پیش از رسیدن به Claude فشرده می‌کند. نصب آن یک باینری است و بعد از یک دستور راه‌اندازی، بدون تغییر عادت‌های شما کار می‌کند؛ Claude همان دستورهای همیشگی مثل git status را اجرا می‌کند و خروجی کوتاه‌شده را می‌بیند.

این مقاله مراحل را از README رسمی rtk-ai/rtk گام‌به‌گام می‌آورد: نصب، فعال‌سازی برای Claude Code، اندازه‌گیری صرفه‌جویی، محدودیت‌های واقعی ابزار، تفاوت دو نسخه و لایسنس و عیب‌یابی. ستارهٔ ریپو در ۴ نوامبر ۲۰۲۶ (۱۳ آبان ۱۴۰۵) حدود ۸۵٫۵ هزار بود؛ این عدد فقط محبوبیت را نشان می‌دهد، نه کیفیت. این راهنما بخشی از مجموعهٔ آموزش Claude Code نقطه است.

RTK را کنار Claude Code متصل به نقطه اجرا کنید

با کلید اختصاصی نقطه، Claude Code از ایران بدون فیلترشکن و کارت خارجی و با پرداخت ریالی کار می‌کند؛ راه‌اندازی حدود ۵ دقیقه است.

آموزش اتصال Claude Code به نقطه

دربارهٔ بن شدن اکانت Claude در ایران و راه جایگزین امن هم مطلب جدا داریم.

RTK Claude Code چیست و چه کار می‌کند؟

عامل کدنویسی دستورهایی مثل git status یا pytest را اجرا می‌کند و کل خروجی آن وارد context می‌شود، حتی اگر نود درصدش فقط نویز باشد. RTK یک hook نصب می‌کند که این دستور را به‌طور خودکار به نسخهٔ فشردهٔ آن (مثلاً rtk git status) بازنویسی می‌کند. عامل بدون اینکه rtk را صدا بزند، خروجی کوتاه‌تر می‌گیرد. چند نمونه از README:

RTK در پشت صحنه چه می‌کند؟

README چهار راهکار را بسته به نوع دستور نام می‌برد: فیلتر هوشمند (حذف نویزی مثل کامنت و فاصلهٔ اضافه)، گروه‌بندی (فایل‌ها بر اساس پوشه، خطاها بر اساس نوع)، برش (نگه‌داشتن زمینهٔ مرتبط و حذف تکرار) و حذف تکراری‌ها (جمع‌کردن خطوط تکراری لاگ با شمارنده). فهرست پشتیبانی بیش از ۱۰۰ دستور است: git و GitHub CLI، Cargo، ابزارهای جاوااسکریپت مثل npm و vitest، ابزارهای پایتون مثل ruff و pytest، Go، Docker، Kubernetes و چند دستهٔ دیگر.

پرسش رایج این است که آیا فشرده‌سازی کش prompt را خراب نمی‌کند. README صریح پاسخ می‌دهد که نه: RTK خروجی هر دستور را یک‌بار فیلتر می‌کند، نتیجه در تاریخچه ذخیره می‌شود و در فراخوانی‌های بعدی به‌طور عادی کش می‌شود. خروجی کوچک‌تر یعنی نوشتن و خواندن کش هم ارزان‌تر. این مقاله فقط دربارهٔ خود RTK است؛ اگر هنوز نمی‌دانید مصرف شما از کجا می‌آید (گفتگوی طولانی، فایل بزرگ یا خروجی دستور)، اول راهنمای کاهش مصرف توکن Claude Code را بخوانید.

قبل از نصب RTK، Claude Code را وصل کنید

RTK روی سیستم خودتان نصب می‌شود و به اتصال مدل کاری ندارد؛ اگر Claude Code هنوز راه نیفتاده، اول با کلید نقطه وصلش کنید.

راه‌اندازی Claude Code با نقطه

نصب RTK برای Claude Code

README سه روش اصلی می‌دهد:

brew install rtk                  # macOS / Linux
winget install rtk-ai.rtk         # Windows
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh

اگر از روش curl | sh استفاده می‌کنید، پیشنهاد ما این است که ابتدا اسکریپت را دانلود و بخوانید و بعد اجرا کنید؛ دلیلش همان اصلی است که در راهنمای نصب امن پلاگین و MCP گفته‌ایم. README راه‌های دیگر مثل Cargo، باینری آماده، ویندوز بومی و WSL را به راهنمای نصب رسمی ارجاع می‌دهد.

بعد از نصب مطمئن شوید بستهٔ درست را دارید؛ README هشدار می‌دهد پروژهٔ دیگری هم با نام «rtk» در crates.io هست:

rtk --version
rtk gain        # باید داشبورد صرفه‌جویی را نشان بدهد، نه "command not found"

پیش از نصب سه چیز را بررسی کنید: سیستم‌عامل‌تان (macOS، Linux یا Windows) یکی از روش‌های بالا را پشتیبانی کند؛ از قبل باینری دیگری به نام rtk روی سیستم نداشته باشید؛ و بدانید نصب سراسری است و روی همهٔ پروژه‌هایی که با Claude Code باز می‌کنید اثر می‌گذارد. اگر روی ماشین مشترک یا سرور کار می‌کنید، با مدیر سیستم هماهنگ کنید، چون hook دستورهای Bash را بازنویسی می‌کند.

فعال‌سازی RTK برای Claude Code و آزمایش آن

rtk init -g

این همان حالت پیش‌فرض (Claude Code / Copilot) است و طبق README از یک hook از نوع PreToolUse استفاده می‌کند. بعد Claude Code را ببندید و دوباره باز کنید و آزمایش کنید: از Claude بخواهید git status را اجرا کند. طبق README این دستور خودکار به rtk git status بازنویسی می‌شود. برای عامل‌های دیگر پرچم‌های جدا هست؛ برای نمونه --gemini، --codex یا --agent cursor (README در مجموع از ۱۸ ابزار کدنویسی پشتیبانی می‌کند).

اگر قبل از اعمال می‌خواهید ببینید چه چیزی تغییر می‌کند، README به پرچم --dry-run اشاره می‌کند؛ جزئیات هر عامل در Quick Start رسمی (rtk-ai.app) است. بعد از فعال‌سازی لازم نیست دستورها را با rtk پیشوند بزنید؛ بازنویسی خودکار است. اگر اجرای تکی لازم شد، rtk bypass <cmd> همان دستور را بدون فیلتر اجرا می‌کند و طبق README همچنان در آمار ثبت می‌شود.

سه سناریوی روزمره که فرقش را می‌بینید

برای اینکه حس کنید RTK دقیقاً کجا اثر می‌گذارد، سه موقعیت رایج را در نظر بگیرید. در اولی Claude تست‌های یک پروژه را اجرا می‌کند و از دویست تست فقط سه تا شکست خورده است. بدون RTK هر خط «PASSED» وارد context می‌شود؛ با RTK طبق جدول بالا فقط شکست‌ها و traceback کوتاه‌شده می‌ماند و موفق‌ها به یک عدد تبدیل می‌شوند. در دومی Claude برای فهمیدن تاریخچهٔ یک فایل git log می‌گیرد؛ RTK فقط هش، نویسنده و عنوان را نگه می‌دارد و متن کامل هر commit را حذف می‌کند. در سومی بعد از چند ویرایش git add، commit و push اجرا می‌شود و به‌جای خروجی کامل پیشرفت، یک خط تأیید می‌بینید.

در هر سه حالت اطلاعات تصمیم‌ساز (کدام تست شکست خورده، کدام commit، موفق‌شدن push) حفظ می‌شود و فقط تکرار و نویز کم می‌شود. این همان نقطه‌ای است که RTK بیشترین ارزش را دارد و همان نقطه‌ای که باید مراقب باشید: اگر دقیقاً به آن نویز نیاز داشتید، مثلاً می‌خواهید ببینید یک تست موفق چه warningی چاپ کرده، از rtk bypass استفاده کنید.

اندازه‌گیری صرفه‌جویی RTK Claude Code با rtk gain

RTK ابزار اندازه‌گیری خودش را دارد و لازم نیست به حدس تکیه کنید. دستورهایی که README نام می‌برد:

rtk gain                 # خلاصهٔ آمار
rtk gain --graph         # نمودار متنی ۳۰ روز اخیر
rtk gain --history       # تاریخچهٔ دستورهای اخیر
rtk gain --daily         # تفکیک روزانه
rtk discover             # پیدا کردن فرصت‌های از دست‌رفته
rtk session              # میزان استفاده از RTK در sessionهای اخیر

دو نکته دربارهٔ خواندن این اعداد. اول، RTK توکن‌شمار ندارد و توکن را با bytes / 4 تخمین می‌زند؛ پس درصدها قابل اتکا هستند اما عدد مطلق توکن تقریبی است. دوم، README توضیح می‌دهد کاهش خروجی bash روی صورت‌حساب رقیق می‌شود: خروجی bash فقط یکی از اجزای ورودی است و ورودی هم فقط بخشی از هزینه است. برای مقایسهٔ کلی مصرف قبل و بعد، ccusage را کنار rtk gain بگذارید.

محدودیت‌های RTK و زمانی که مناسب نیست

• فقط ابزار Bash: README صریح می‌گوید hook فقط روی فراخوانی‌های Bash اجرا می‌شود. ابزارهای داخلی Read، Grep و Glob از آن عبور نمی‌کنند. برای فشرده‌شدن، از دستورهای shell (cat، rg، find) یا خود rtk read، rtk grep، rtk find استفاده کنید.
• درصدها قابل اتکا، عددهای مطلق تقریبی: همان تخمین bytes / 4.
• صرفه‌جویی صورت‌حساب ≠ صرفه‌جویی خروجی bash. README توضیح می‌دهد که کاهش خروجی bash در دو لایه (کل ورودی، بعد کل هزینه) رقیق می‌شود.
• خلاصه ممکن است جزئیات را حذف کند. برای دیباگ فرمت دقیق خروجی، همان دستور را یک بار بدون RTK اجرا کنید.

اگر بیشتر کارتان گفتگو و نوشتن متن است و دستور shell کم اجرا می‌شود، اثر RTK ناچیز است. اگر دستورهای سنگین (تست، build، git روی ریپوی بزرگ) زیاد دارید، بیشترین فایده را می‌برید. برای همین پیش از نصب، چند روز با ccusage مصرف خودتان را ببینید. اگر مشکل اصلی‌تان خواندن فایل‌های بزرگ است، RTK جای ابزار فهم کد را نمی‌گیرد؛ CodeGraph برای آن مناسب‌تر است.

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

README دو نسخه معرفی می‌کند که هر دو یک باینری به نام rtk نصب می‌کنند و نمی‌توان هم‌زمان نصب کرد؛ باید یکی را پاک کنید و دیگری را نصب کنید:

• rtk: لایسنس Apache-2.0 + BUSL-1.1، شامل hookها، فیلترها و موتور فشرده‌سازی.
• rtk-oss: فقط Apache-2.0، بدون موتور (نصب با brew install rtk-ai/tap/rtk-oss یا متغیر RTK_EDITION=oss در اسکریپت نصب).

طبق README استفادهٔ تولیدی رایگان است؛ آنچه شامل مجوز نمی‌شود عرضهٔ RTK یا مشتق آن به‌عنوان محصول یا سرویس تجاری به دیگران است. اگر شرکت‌تان قصد چنین کاری دارد، متن لایسنس را بخوانید. برای یک توسعه‌دهنده که فقط روی پروژهٔ خودش استفاده می‌کند، مشکلی نیست.

README یک جزء اختیاری سوم هم دارد: rtk-proxy، سرویسی پس‌زمینه که فشرده‌سازی را به ترافیک API میان عامل و ارائه‌دهنده هم تعمیم می‌دهد. این جزء باینری جدا، لایسنس جدا (BUSL-1.1) و راه‌اندازی جدا دارد و برای شروع لازم نیست؛ پیشنهاد ما این است که اول فقط hook ساده را امتحان کنید. دربارهٔ حریم خصوصی هم README می‌گوید RTK محتوای دستورها و فایل‌ها را جمع نمی‌کند و تله‌متری ناشناس به‌صورت پیش‌فرض خاموش است و فقط با رضایت صریح (rtk telemetry enable) روشن می‌شود.

تنظیمات پیشرفته با pipeline.toml

README موتور RTK را به‌صورت یک فایل ترکیب‌پذیر به نام pipeline.toml توصیف می‌کند که تعیین می‌کند کدام دستورها بازنویسی شوند و چه بر سر خروجی ابزارها بیاید. نکتهٔ مهم برای کاربر تازه این است که بدون این فایل شما روی تنظیم پیش‌فرض (rtk:default) هستید و به‌روزرسانی چیزی را عوض نمی‌کند؛ هر چیز بیشتر اختیاری و خط‌به‌خط است. پس لازم نیست در روز اول درگیر آن شوید. وقتی با رفتار پایه راحت شدید، بخش Pipelines مستندات رسمی نقطهٔ ورود مناسبی است.

یک آزمایش یک‌هفته‌ای برای تصمیم‌گیری

اگر مطمئن نیستید RTK برای شما می‌ارزد، یک آزمایش ساده بکنید. پیش از نصب، چند روز با npx ccusage@latest مصرف روزانه‌تان را یادداشت کنید. بعد RTK را نصب و با rtk init -g فعال کنید و یک هفته به همان شیوهٔ همیشگی کار کنید. در پایان rtk gain --daily را ببینید تا بدانید کدام روزها بیشترین فشرده‌سازی را داشته‌اند، و rtk discover را اجرا کنید تا دستورهایی که از فیلتر عبور نکرده‌اند را پیدا کنید. اگر درصد صرفه‌جویی خروجی bash پایین بود، یعنی کار شما بیشتر از جنس خواندن فایل و گفتگوست و باید سراغ ابزارهای فهم کد و عادت‌های مدیریت context بروید.

این آزمایش تضمینی نیست؛ پروژه‌ها و نوع کار متفاوت‌اند. اما به شما می‌گوید ابزار برای کار خودتان مفید است یا فقط روی کاغذ جذاب به نظر می‌رسد. همین روش را برای هر ابزار دیگری که نصب می‌کنید هم می‌شود به کار برد.

عیب‌یابی سریع RTK

• rtk gain پیدا نشد: احتمالاً بستهٔ اشتباه (crates.io) نصب شده؛ طبق README بستهٔ درست را با rtk --version و rtk gain تأیید کنید.
• بازنویسی انجام نمی‌شود: بعد از rtk init -g Claude Code را کامل ببندید و دوباره باز کنید (README همین را می‌گوید).
• عامل از Read/Grep داخلی استفاده می‌کند: این ابزارها از hook نمی‌گذرند؛ در CLAUDE.md بنویسید برای خواندن فایل‌ها از دستورهای shell یا rtk read استفاده کند.
• خروجی ناقص برای دیباگ: همان دستور را یک بار بدون RTK یا با rtk bypass اجرا کنید.
• دو نسخه با هم نصب شده: چون هر دو باینری rtk دارند، یکی را حذف کنید. راهنمای حذف و Windows/WSL در Quick Start رسمی است.

جمع‌بندی

RTK Claude Code یک ابزار ساده و هدفمند است: خروجی دستورهای shell را کوتاه می‌کند و با rtk init -g بدون تغییر عادت کار می‌کند. اثرش را با rtk gain بسنجید، محدودیت Bash-only را به یاد داشته باشید و «تا ۹۰٪» را ادعای سازنده برای خروجی bash بدانید، نه وعدهٔ صورت‌حساب.

کمتر توکن، با یک کلید برای همهٔ مدل‌ها

کلید API نقطه فقط با پلن پرو باز می‌شود؛ پرداخت ریالی است و صرفه‌جویی RTK را در داشبورد مصرف زندهٔ نقطه هم می‌بینید.

دیدن پلن‌های پرو

این مقاله چگونه بررسی شد؟

دستورهای نصب و ویژگی‌ها از README رسمی rtk-ai/rtk برداشته شد و در ۱۳ آبان ۱۴۰۵ (۴ نوامبر ۲۰۲۶) دوباره با نسخهٔ فعلی ریپو مقایسه شد. ستاره‌ها و لایسنس از صفحهٔ ریپو همان روز آمده است. هر جا ادعایی از خود سازنده است («تا ۹۰٪» کوچک‌تر) همین را نوشته‌ایم و آن را اندازه‌گیری مستقل نمی‌دانیم. اگر دستوری در نسخهٔ شما فرق داشت، README همان نسخه معتبرتر است.

---

منبع: README رسمی github.com/rtk-ai/rtk (بررسی ۱۳ آبان ۱۴۰۵ / ۴ نوامبر ۲۰۲۶).