Claude Code چیست و چگونه کار میکند؟
ابزار Claude Code یک عامل ترمینالی از Anthropic برای ویرایش مستقیم کد و اجرای دستورات است. تفاوت آن با چتباتها، دسترسی به فایلسیستم و اجرای تستهاست.
Claude Code چیست
Claude Code یک عامل برنامهنویسی از شرکت Anthropic است که در ترمینال شما اجرا میشود. این ابزار فایلهای موجود در یک مخزن واقعی را میخواند، آنها را ویرایش میکند، دستوراتی مانند npm test یا git commit را اجرا کرده و خروجی را برای تصمیمگیری در مورد گام بعدی بررسی میکند. شما وظیفه مورد نظر خود را به زبان ساده شرح میدهید و این ابزار کار را در دایرکتوری کاری شما انجام میدهد.
پنجره چت فقط میتواند متن را برای کپی کردن در ویرایشگر به شما تحویل دهد. اما Claude Code به سیستم فایل و شل دسترسی دارد؛ بنابراین کد را تغییر میدهد، تستها را اجرا میکند، خطا را میبیند و بدون نیاز به جابهجایی متن بین دو پنجره، آن را اصلاح میکند.
شروع یک نشست در macOS، Linux یا WSL (زیرسیستم ویندوز برای لینوکس) با سه دستور انجام میشود:
curl -fsSL https://claude.ai/install.sh | bash
cd your-project
claudeاجرای اول، مرورگر شما را برای ورود به سیستم باز میکند. پس از آن، claude --version شماره نسخه را چاپ کرده و به دنبال آن (Claude Code) نمایش داده میشود. اگر شل شما به جای آن claude: command not found را پاسخ داد، بررسی کنید که ~/.local/bin، جایی که نصبکننده بومی فایل اجرایی را قرار میدهد، در PATH شما موجود باشد. نصبکننده راه حل را در بخش Setup notes: چاپ میکند اما خودِ PATH را تغییر نمیدهد. دایرکتوری را به پیکربندی شل خود اضافه کنید، سپس یک ترمینال جدید باز کرده و دوباره آن را اجرا کنید. دستور claude doctor تشخیصهای مربوط به نصب و تنظیمات را بدون شروع یک نشست چاپ میکند، که سریعترین راه برای مشاهده موارد مفقود در یک نصب ناقص است.
Claude Code کجا اجرا میشود؟
ترمینال اصلیترین محیط اجرای آن است. این ابزار از macOS 13.0 و جدیدتر، Windows 10 1809 و جدیدتر، Ubuntu 20.04 و جدیدتر، Debian 10 و جدیدتر، و Alpine 3.19 و جدیدتر، روی سختافزار x64 یا ARM64 با حداقل 4 GB رم پشتیبانی میکند. Bash، Zsh، PowerShell و CMD همگی قابل استفاده هستند.
همان موتور، سایر محیطها را نیز هدایت میکند: افزونههای VS Code و IDEهای JetBrains، یک اپلیکیشن دسکتاپ، مرورگر در claude.ai/code و اپلیکیشن موبایل Claude. نشستهای ترمینال و دسکتاپ محلی، فایل CLAUDE.md، تنظیمات و سرورهای MCP (پروتکل زمینه مدل) مخزن شما را به اشتراک میگذارند؛ نشستهای ابری از پیکربندی موجود در محیط خود استفاده میکنند.
هنگام استفاده از مدلهای Anthropic که روی سرورهای Anthropic یا از طریق یک ارائهدهنده ابری پشتیبانیشده اجرا میشوند، اتصال اینترنت الزامی است. دستگاه شما حلقه عامل (agent loop) را اجرا میکند: خواندن فایلها، ویرایشها و دستورات shell. با راهاندازی مدل محلی Ollama، Claude Code میتواند درخواستهای مدل را به جای آن به http://localhost:11434 ارسال کند و استنتاج را روی دستگاه خودتان نگه دارد. این کار مدلهای متنباز جایگزین را اجرا میکند، نه مدلهای Claude شرکت Anthropic؛ ویژگیهایی که منابع راه دور را فراخوانی میکنند همچنان به اتصال نیاز دارند.
این تفکیک دلیل آن است که یک سرور کوچک، میزبان مناسبی محسوب میشود. یک وظیفه طولانی، ترمینال را تا زمانی که در حال اجراست باز نگه میدارد، بنابراین کاربران عامل را روی یک VPS قرار میدهند، آن را داخل tmux از طریق SSH شروع میکنند و سپس لپتاپ را بدون بستن نشست خاموش میکنند. اجرای Claude Code روی یک VPS داخل tmux این راهاندازی را گامبهگام توضیح میدهد. سیستمی که فضای کافی برای یک نشست دارد معمولاً برای چندین نشست نیز جا دارد و یک نشست میتواند متن را مستقیماً به نشست دیگر منتقل کند، به جای اینکه منتظر بمانید تا دوباره متصل شوید و خودتان نتیجه را منتقل کنید. برای دستگاهی که مستقیماً جلوی شما قرار دارد، Claude روی دسکتاپ لینوکس و CLI نصب محلی را پوشش میدهد.
هزینه Claude Code چقدر است؟
دو روش برای پرداخت هزینه آن وجود دارد که عملکرد متفاوتی دارند.
اشتراک Claude شامل Claude Code میشود. طرحهای Pro، Max، Ultra، Team و Enterprise همگی از آن پشتیبانی میکنند، اما نحوه محاسبه هزینه آنها یکسان نیست. در طرحهای Pro، Max، Ultra و Team، میزان استفاده شما بهجای یک صورتحساب افزایشی، توسط محدودیتهای طرح تعیین میشود. هنگامی که به محدودیت برسید، میتوانید منتظر بمانید تا بازه زمانی بازنشانی شود. در طرحهای Pro، Max و Ultra، میتوانید «اعتبار استفاده» (usage credits) را نیز فعال کنید؛ قابلیتی اختیاری که بهجای مسدود کردن شما، درخواستها را با نرخهای استاندارد API ادامه میدهد. این هزینهها علاوه بر اشتراک، از یک موجودی پیشپرداخت کسر میشوند و دارای سقف ماهانهای هستند که میتوانید تعیین کنید؛ این اعتبار هم Claude Code در ترمینال و هم چت را پوشش میدهد. صفحه قیمتگذاری Anthropic همین استفاده اضافی را برای طرح Team نیز ذکر کرده است. در طرحهای Enterprise فعلی که مبتنی بر میزان استفاده هستند، تا تاریخ 19 November 2026، هزینه هر صندلی (seat fee) فقط دسترسی را پوشش میدهد و هر توکن با نرخ API محاسبه میشود؛ طرحهای قدیمیتر مبتنی بر صندلی، تا زمان مهاجرت، استفاده گنجاندهشده خود را حفظ میکنند. هزینه طرح Max ماهانه 100 دلار و طرح Ultra ماهانه 200 دلار در وب است که هر دو فقط بهصورت ماهانه صورتحساب میشوند؛ قیمتهای موبایل ممکن است متفاوت باشد. طرح Max پنج برابر استفاده طرح Pro را در هر پنج ساعت و هر هفته ارائه میدهد، در حالی که طرح Ultra ده برابر استفاده هفتگی طرح Pro را فراهم میکند. حسابهای تأییدشده Ultra محدودیت پنجساعته ندارند؛ حسابهایی که هنوز تأیید نشدهاند، محدودیت موقت دارند. طرح Ultra دارای یک محدودیت هفتگی برای تمامی مدلها و یک محدودیت هفتگی جداگانه برای Fable است. هر دو طرح به ازای هر سهمیه هفتگی معادل Pro، هزینه 20 دلاری دارند. این طرحها شامل اعتبار ماهانه Console API به مبلغ 100 دلار برای Max و 200 دلار برای Ultra هستند. این اعتبارها Claude Code تعاملی یا استفاده اضافی در برنامههای Claude را پوشش نمیدهند، اما اجرای claude -p که خودتان با یک API key از سازمان لینکشده در Console شروع میکنید را پوشش میدهند. بنابراین انتخاب بین Max و Ultra به این بستگی دارد که چند بار شما کسی هستید که منتظر میمانید یا هزینه اعتبار استفاده را پرداخت میکنید.
حساب Anthropic Console در عوض به ازای هر توکن هزینه دریافت میکند. هیچ بازه زمانی اشتراکی برای انتظار وجود ندارد، اما محدودیتهای نرخ API و سقف هزینه ماهانه سطح Console شما یا محدودیت پایینتری که تعیین کردهاید همچنان اعمال میشود؛ بنابراین یک نشست طولانی عامل (agent session) روی یک مخزن بزرگ، هزینه واقعی و لحظهای دارد. این عامل اصلی هزینه است: عامل برای هر توکنی که میخواند هزینه پرداخت میکند و عاملی که یک پایگاه کد بزرگ را بررسی میکند، بخش زیادی از آن را میخواند. همان کار در یک مخزن کوچک و مرتب، هزینه کمتری نسبت به یک مخزن گسترده دارد.
خرید برای یک گروه، حالت سوم است، زیرا طرحهای Team و Enterprise به ازای هر صندلی فروخته میشوند و نقطهای که در آن صورتحساب به ازای هر توکن، ارزانتر از مجموع صندلیها میشود به این بستگی دارد که چند نفر از آن افراد نشستهای طولانی اجرا میکنند، نه اینکه چند نام در حساب ثبت شده است.
قیمت طرحها تغییر میکند، بنابراین فراتر از قیمتهای Max و Ultra که در بالا ذکر شد و در تاریخ 19 November 2026 بررسی شدند، این صفحه هیچ قیمت دیگری را ارائه نمیدهد. هزینه ماهانه Claude Code شامل اعداد فعلی و محاسبات لازم برای انتخاب بین اشتراک و صورتحساب به ازای هر توکن است. دانستن قیمت تنها نیمی از پاسخ است، زیرا اینکه آیا یک طرح صرفه اقتصادی دارد یا خیر به نرخ ساعتی خود شما و تعداد ساعاتی که عامل واقعاً برای شما صرفهجویی میکند، بستگی دارد.
آیا Claude Code رایگان است؟
با استفاده از مدلهای متنباز که بهصورت محلی از طریق Ollama میزبانی میشوند، میتوانید بدون نیاز به اشتراک Anthropic یا پرداخت هزینه API از Claude Code استفاده کنید. برای مدلهای Claude شرکت Anthropic، تا تاریخ 19 نوامبر 2026، استفاده از آن مستلزم داشتن حساب Pro، Max، Ultra، Team، Enterprise یا Console، یا دسترسی از طریق یک ارائهدهنده API شخصثالثِ پشتیبانیشده است و طرح رایگان Claude.ai شامل آن نمیشود. ورود با یک حساب رایگان، تنها محصول چت را بدون قابلیت agent در اختیار شما قرار میدهد.
یک مسیر رایگان دیگر، استفاده از guest pass است: مشترکین واجد شرایط Pro، Max و Ultra تعداد محدودی از این مجوزها را برای اشتراکگذاری دارند و هر کدام به فردی که کاربر جدید Claude پولی است، هفت روز دسترسی به طرح Pro (شامل Claude Code) میدهد. دریافتکنندگان باید اطلاعات پرداخت خود را وارد کنند و در صورت عدم لغو پیش از پایان دوره، اشتراک آزمایشی به طرح پولی Pro تبدیل میشود. بدون این مجوز، میتوانید یک ماه از طرح پولی پایه استفاده کنید. اینکه آیا Claude Code در طرح Claude Pro گنجانده شده است جزئیات مربوط به پوششهای طرح Pro را بررسی میکند.
Claude Code چیست و چه نیست
این ابزار یک پنجره چت نیست. Claude Code فایلها را ویرایش میکند و دستورات را روی سیستم شما اجرا مینماید؛ به همین دلیل پیش از انجام هر عملی که تغییری ایجاد کند، از شما اجازه میگیرد. به همین علت است که بسیاری از کاربران آن را در یک کانتینر یا سروری اجرا میکنند که امکان بازسازی مجدد آن وجود دارد. این ابزار همچنین پاسخهای طولانی ارائه نمیدهد، زیرا متن خروجی بیشتر به یک گزارش کاری شباهت دارد تا یک گفتگو، و یک سبک خروجی خاص وجود دارد که وقتی میخواهید عامل (agent) در حین انجام کار، استدلال خود را توضیح دهد، prompt سیستم را بازنویسی میکند.
این ابزار یک IDE نیست. در آن خبری از پنل ویرایشگر یا درخت فایل (file tree) نیست. این ابزار به ویرایشگری که هماکنون استفاده میکنید متصل میشود، یا اصلاً به هیچ ویرایشگری متصل نمیشود.
این ابزار یک ابزار تکمیل خودکار (autocomplete) نیست. هنگام تایپ کردن، خط بعدی را به شما پیشنهاد نمیدهد. واحد کاری در اینجا یک «وظیفه کامل» است، مانند «دلیل ناپایدار بودن این تست را پیدا کن و آن را اصلاح کن». واگذاری یک وظیفه کامل به معنای واگذاری دامنه (scope) آن نیز هست؛ بنابراین وقتی عامل بهجای یک تغییر کوچک، مدام سه فایل را بازنویسی میکند، قانونی مانند مهارت Ponytail آن را به سمت کوچکترین تغییرِ کارآمد سوق میدهد.
این ابزار خود یک مدل نیست. این یک عامل (agent) است که یک مدل را فراخوانی میکند: مدلهای Claude شرکت Anthropic بهصورت از راه دور اجرا میشوند، در حالی که مدلهای متنباز جایگزین میتوانند از طریق Ollama روی دیسک شما اجرا شوند.
خوانندگان اغلب در این مرحله درخواست مقایسه با ChatGPT را دارند. این مقایسه از اساس اشتباه است. محصولات چت به سوالات پاسخ میدهند؛ اما Claude Code یک مخزن (repository) را تغییر میدهد. مقایسهای که ارزش خواندن دارد، در برابر سایر عاملهایی است که به سیستم فایل شما دسترسی دارند، و مقایسه Claude Code با Cursor، Codex و Copilot همان مقایسه مورد نظر است.
FAQ
آیا استفاده از Claude Code رایگان است؟
در صورت استفاده از مدلهای متنباز که بهصورت محلی (locally) از طریق Ollama میزبانی میشوند، بله؛ بدون نیاز به اشتراک Anthropic یا پرداخت هزینه API. برای مدلهای Claude شرکت Anthropic، تا تاریخ 19 نوامبر 2026، به یکی از موارد زیر نیاز دارید: اشتراک پولی Claude (شامل Pro، Max، Ultra، Team یا Enterprise)، حساب کاربری Anthropic Console با پرداخت هزینه بر اساس توکن، یا دسترسی از طریق یک ارائهدهنده API شخصثالث پشتیبانیشده. طرح رایگان Claude.ai فقط محصول چت را در اختیار شما میگذارد و شامل عامل (agent) نمیشود. یک «گذرنامه مهمان» (guest pass) از طرف یک مشترک واجد شرایط Pro، Max یا Ultra، به فردی که تازه با Claude پولی آشنا شده، هفت روز دسترسی Pro به همراه Claude Code میدهد. اطلاعات پرداخت الزامی است و در صورت عدم لغو پیش از پایان دوره، اشتراک آزمایشی به Pro پولی تبدیل میشود. استنتاج محلی (local inference) از طریق Ollama نیازی به سرور مدل از راه دور ندارد، اما از مدلهای جایگزین بهجای Claude استفاده میکند و قابلیتهایی که منابع را از راه دور فراخوانی میکنند، همچنان به اتصال اینترنت نیاز دارند.
آیا برای استفاده از Claude Code باید با ترمینال آشنا باشم؟
تا حدی. شما باید یک ترمینال باز کنید، به دایرکتوری پروژه خود بروید و دستور claude را اجرا کنید. پس از آن، دستورات خود را به زبان ساده تایپ میکنید. اگر ترمینال مانع کار شماست، نسخه دسکتاپ و نسخه مرورگر در آدرس claude.ai/code همان عامل را در یک رابط گرافیکی ارائه میدهند، اما هر کدام از آنها همه حسابهایی را که ترمینال میپذیرد، قبول نمیکنند. نسخه مرورگر بهجای کلید API کنسول، به اشتراک Claude نیاز دارد. زبانه Code در نسخه دسکتاپ از اشتراکهای Pro، Max، Ultra، Team و Enterprise پشتیبانی میکند و امکان تنظیمات جداگانه برای ارائهدهندگان شخصثالث پشتیبانیشده نیز وجود دارد. نسخه مرورگر برای طرحهای Pro، Max، Ultra و Team و همچنین کاربران Enterprise با صندلیهای (seats) ویژه premium یا Chat + Claude Code که با حساب claude.ai وارد شدهاند، در دسترس است؛ کاربرانی که تحت نقشهای سفارشی (custom roles) هستند نیز به مجوز cloud sessions نیاز دارند.
آیا Claude Code کد من را برای Anthropic ارسال میکند؟
بله، بخشهایی که توسط عامل خوانده میشود، هنگام استفاده از سرویس Anthropic ارسال میگردد. مدل بهصورت از راه دور اجرا میشود، بنابراین محتوای فایلهایی که عامل میخواند، در درخواستهای ارسالی به ارائهدهنده مدل قرار میگیرد. جلسات ابری (cloud sessions) میزبانیشده توسط Anthropic نیز پیش از خواندن مخزن توسط عامل، آن را در یک ماشین مجازی کپی (clone) میکنند. با پیکربندی Ollama برای استفاده از یک مدل میزبانیشده بهصورت محلی، آن درخواستهای مدل بهجای سرور Anthropic به سرور محلی شما ارسال میشوند. اگر این موضوع برای یک مخزن اهمیت دارد، عامل را در دایرکتوریای اجرا کنید که فقط شامل فایلهایی باشد که مایل به ارسال آنها هستید.
آیا میتوانم Claude Code را در حالی که کامپیوترم خاموش است، فعال نگه دارم؟
خیر، روی دستگاه خودتان نمیتوانید؛ زیرا یک نشست ترمینال با بسته شدن ترمینالی که مالک آن است، از بین میرود. دو راه برای دور زدن این محدودیت وجود دارد. آن را روی یک VPS داخل tmux اجرا کنید که در آن نشست پس از قطع اتصال SSH زنده میماند و بعداً میتوانید دوباره به آن متصل شوید. یا یک وظیفه ابری (cloud task) را از طریق مرورگر یا اپلیکیشن موبایل شروع کنید که بهصورت پیشفرض بهجای زیرساخت شما، روی زیرساخت Anthropic اجرا میشود. این روش به ورود به حساب claude.ai با طرحی که شامل جلسات ابری باشد نیاز دارد، نه کلید API کنسول.