Claude Code — Anthropic CLI کدنویسی

Claude Code یه ابزار خط‌فرمانه که Anthropic در اوایل ۲۰۲۵ معرفی کرد — نه یه افزونهٔ IDE، نه یه چت‌بات ساده. یه agent کدنویسی که مستقیم توی ترمینالت اجرا می‌شه، فایل‌های پروژه‌ات رو می‌خونه، تغییر می‌ده، تست می‌گیره، و با git کار می‌کنه.

Claude Code چطور کار می‌کنه؟

وقتی claude رو توی ترمینال اجرا می‌کنی، یه REPL (حلقهٔ خواندن-اجرا-چاپ) باز می‌شه که با مدل‌های Claude — معمولاً claude-sonnet یا claude-opus — صحبت می‌کنه. اما فرق اصلیش اینه که به‌جای اینکه فقط کد برات بنویسه و منتظر بمونه کپی کنی، می‌تونه مستقیم:

• فایل‌ها بخونه و ویرایش کنه — با دسترسی به ساختار واقعی کدبیس
• دستورات shell اجرا کنه — تست بگیره، build کنه، git commit بزنه
• چند فایل رو هماهنگ ویرایش کنه — refactoring‌های بزرگ در یه پاس
• Web search بزنه (در نسخه‌های جدیدتر) — مستندات به‌روز بگیره

مدل اصلی توی حلقه‌های agentic کار می‌کنه — می‌تونه خروجی یه دستور رو بخونه، اشکال رو ببینه، و تلاش بعدی رو اصلاح کنه.

نصب و راه‌اندازی

نیاز به Node.js نسخهٔ ۱۸ به بالا داری:

npm install -g @anthropic-ai/claude-code

بعد یه API key از console.anthropic.com می‌گیری و توی متغیر محیطی تنظیم می‌کنی:

export ANTHROPIC_API_KEY=sk-ant-...

دایرکتوری پروژه‌ات رو باز کن و claude بنویس. همین.

کجا واقعاً قوی‌ست؟

Refactoring گسترده: بگو «تمام components این پروژه رو از class-based به functional refactor کن» — Claude Code خودش فایل‌ها رو می‌گرده، تغییرات رو اعمال می‌کنه، و تایپ ارورها رو برمی‌گردونه.

Debug تست‌های شکسته: یه پروژه داری که CI قرمزه؟ بگو «تست‌های شکسته رو fix کن» — لاگ خطاها رو می‌خونه، کد مربوطه رو پیدا می‌کنه، و اصلاح می‌کنه.

Documentation: «برای همهٔ توابع public این ماژول JSDoc بنویس» — خروجی واقعی می‌ده، نه الگوی خالی.

Migration: از یه کتابخانه به کتابخانهٔ دیگه move کردن — مثلاً از axios به fetch — توی کل پروژه.

محدودیت‌های واقعی

هزینه: Claude Code با API پرداختی کار می‌کنه. یه task متوسط ممکنه چند صد هزار token مصرف کنه. برای استفادهٔ سنگین، هزینهٔ ماهانه‌ات می‌تونه قابل توجه بشه — خصوصاً با مدل Opus.

Context window: حتی با ۲۰۰k token context کلاد، پروژه‌های خیلی بزرگ یه چالش می‌شن. Claude Code از تکنیک‌هایی مثل indexing استفاده می‌کنه ولی هنوز روی codebase‌های enterprise کامل نیست.

اشتباهات ظریف: روی task‌هایی که نیاز به درک معنایی عمیق از business logic دارن، گاهی تغییراتی می‌ده که syntactically درسته ولی semantically مشکل داره. review الزامیه.

کاراکترهای فارسی در کامنت: با کامنت‌های فارسی در کد معمولاً خوب کار می‌کنه، ولی اگه string literals فارسی داری با encoding حساسیت به خرج بده.

Claude Code در مقابل Cursor و Copilot

Cursor یه IDE کامله که AI داخلش جا داده. GitHub Copilot یه autocomplete هوشمنده. Claude Code یه agent ترمینالیه — هیچ‌کدام از این‌ها جایگزین هم نیستن، برای کارهای متفاوتی ساخته شدن.

برای کسی که Vim یا Neovim استفاده می‌کنه، یا اصلاً نمی‌خواد IDE عوض کنه، Claude Code جذاب‌ترین گزینه‌ست. برای کسی که تازه شروع کرده، شاید Cursor راحت‌تر باشه.

مقایسهٔ دقیق‌تر در AiraCode در مقابل Cursor و بهترین ابزار AI برای کدنویسی هست.

Claude Code Plan — Max

آنتروپیک اواخر ۲۰۲۴ اشتراک «Max» رو اضافه کرد — ماهانه ۱۰۰ دلار — که شامل استفادهٔ بیشتر از Claude Code می‌شه. برای توسعه‌دهنده‌هایی که روزانه از این ابزار استفاده می‌کنن، نسبت به پرداخت صرفاً بر اساس token ممکنه صرفه‌جویی داشته باشه.

دسترسی از ایران

Claude Code از طریق API کار می‌کنه و مثل همهٔ سرویس‌های Anthropic، مستقیماً از ایران در دسترس نیست. نیاز به VPN و اغلب یه روش پرداخت ارزی داری.

گزینهٔ بومی اینه که AiraCode رو نگاه کنی — یه agent کدنویسی ترمینالی فارسی که بدون تحریم‌ها در دسترسه و شناخت پیوستهٔ پروژه رو بین جلسه‌ها نگه می‌داره — یه مشکلی که هر agent کدنویسی از جمله Claude Code باهاش دست‌وپنجه نرم می‌کنه.

همچنین بخوان

• کدنویسی با هوش مصنوعی چیست؟
• Multi-file edit با AI
• AiraCode — agent کدنویسی فارسی
• بهترین ابزار AI برای کدنویسی
• شناخت پیوسته در هوش مصنوعی