کلاد (Claude) را میتوان یکی از قدرتمندترین هوش مصنوعیهای حال حاضر دانست. توانایی بالا در تحلیل حجم زیادی از داده، کدنویسی پیشرفته و پردازش دقیق تصاویر، فقط چند نمونه از قابلیتهای کلاد هستند که باعث شده بسیاری از افراد، این هوش مصنوعی را به ابزار اصلی کار خود تبدیل کنند.
حالا تصور کنید بتوانید قابلیتهای چنین ابزار قدرتمندی را در اپلیکیشن یا وبسایت شخصی خودتان به کار بگیرید. امروزه بسیاری از برنامهنویسان و کسبوکارها با دریافت ای پی آی کلاد، ابزارها و سرویسهای تخصصی خودشان را با تواناییهای Claude AI ترکیب میکنند.
در این مقاله از زرین پرداخت، بهطور کامل به API کلود ای پی آی میپردازیم و توضیح میدهیم که Claude API دقیقاً چیست و هرکدام از مدلها برای چه پروژههایی مناسبتر هستند.
انتخاب مدل مناسب Claude بر اساس نوع پروژه
| پروژه شما | مدل پیشنهادی | چرا؟ |
| چتبات پشتیبانی مشتری، پاسخ به سوالات متداول، دستهبندی و استخراج داده ساده | Claude Haiku 4.5 | سریعترین و ارزانترین گزینه؛ برای حجم بالای درخواستهای ساده و تکراری مقرونبهصرفه است |
| تولید محتوا (مقاله، ایمیل، خلاصهسازی)، ترجمه، برنامهنویسی روزمره، تحلیل داده معمولی، پردازش تصویر | Claude Sonnet 5 | تعادل خوبی بین سرعت، هزینه و کیفیت دارد |
| کدنویسی پیچیده، رفکتور پروژههای بزرگ، کارهای سازمانی که به استدلال عمیقتر نیاز دارند | Claude Opus 5 | برای کارهای agentic پیچیده و پروژههای سازمانی طراحی شده؛ توان استدلال بالاتری دارد |
| ایجنتهای خودکار، وظایف چندمرحلهای که ساعتها طول میکشند، بالاترین سطح توانایی ممکن | Claude Fable 5 | قویترین مدل در دسترس عموم؛ برای کارهای بسیار پیچیده و طولانی که نیاز به عمیقترین سطح تحلیل دارند |
برای مشاهده کامل در موبایل، جدول را به چپ و راست بکشید.
Claude API چیست و چگونه کار میکند؟
کلاد api به برنامهها و سرویسهای مختلف اجازه میدهد مستقیماً با مدلهای هوش مصنوعی Claude ارتباط برقرار کنند. روند کار هم ساده است:
برای استفاده از Claude API، در قدم اول باید بین دو سطح دسترسی (Developer Surface) یکی را انتخاب کنید:
- Messages: کنترل کامل روی نحوه کار مدل و مدیریت مکالمه با شماست.
- Managed Agents: بخش زیادی از زیرساخت مورد نیاز برای اجرای ایجنتها را Anthropic مدیریت میکند.
در ادامه، تفاوت این دو مسیر و اینکه هر کدام برای چه پروژههایی مناسبتر هستند را بررسی میکنیم.
دو روش اصلی API گرفتن از کلاد؛ Messages و Managed Agents

دریافت API کلود از طریق Messages؛ کنترل کامل با شماست
اگر میخواهید مستقیماً به مدل Claude دسترسی داشته باشید و خودتان نحوه کار آن را مدیریت کنید، باید سراغ Messages API بروید. در این روش، شما هر مرحله را خودتان مینویسید، وضعیت مکالمه را مدیریت میکنید و tool loop را هم خودتان در برنامه پیادهسازی میکنید.
Tool loop چیست؟به رفتوبرگشت بین مدل و ابزارها برای انجام یک کار گفته میشود. مثلاً Claude تشخیص میدهد برای پاسخ به سؤال کاربر باید «اطلاعات سفارش» او را بررسی کند. در این حالت، برنامه ابزار مربوط به بررسی سفارش را اجرا میکند و نتیجه را دوباره به Claude میدهد تا پاسخ نهایی را تولید کند.
مثلاً اگر Claude تشخیص دهد که برای پاسخ به سؤال کاربر باید از یک ابزار استفاده کند، در این صورت، برنامه شما باید آن ابزار را اجرا کند، نتیجه را دوباره برای Claude بفرستد و پاسخ نهایی را دریافت کند. البته این فرایند میتواند کاملاً خودکار باشد؛ اما منطق و نحوه اجرای آن را شما تعیین میکنید.
ویژگیهای اصلی API گرفتن از Messages کلاد
- تولید متن و کد: خلاصهسازی متن، پاسخ به سوالات، استخراج داده، ترجمهی متن، و توضیح یا تولید کد
- پردازش بصری (Vision): پردازش و تحلیل ورودی تصویری و تولید متن یا کد بر اساس تصاویر
دریافت کلید API کلود با ایجنتهای هوش مصنوعی؛ هوشمندتر و کاملاً خودکار
اگر بخواهید یک ایجنت خودکار بسازید که بتواند برای رسیدن به یک هدف، چندین مرحله را پشت سر هم اجرا کند، Managed Agents انتخاب بهتری است. در این روش، لازم نیست agent loop، اجرای ابزارها و محیط اجرای ایجنت را از صفر بسازید. انتروپیک این زیرساخت را در اختیار شما قرار میدهد و شما بیشتر روی تعریف ایجنت، پرامپت، ابزارها و هدف آن تمرکز میکنید.
مثلاً میتوانید از ایجنت بخواهید یک پروژه کدنویسی را بررسی کند، باگها را پیدا کند، فایلها را تغییر دهد و تستها را اجرا کند. ایجنت میتواند برای انجام این کار از ابزارهایی مثل اجرای دستورات، مدیریت فایل، جستجوی وب و MCP استفاده کند و مراحل مختلف کار را خودش پیش ببرد.
این مسیر برای کارهای طولانی و چندمرحلهای مناسبتر است؛ کارهایی که ممکن است چندین دقیقه یا حتی چند ساعت طول بکشند و به اجرای چندین ابزار نیاز داشته باشند.
بخشهای اصلی Claude API

انتروپیک قابلیتهای Claude API را در پنج بخش اصلی دستهبندی کرده است. هر بخش، قسمت متفاوتی از نحوه کار API را مشخص میکند. شما باید بسته به نیازتان، هر بخش را مدیریت کرده و گزینه مناسب را انتخاب کنید.
1. قابلیتهای مدل (Model capabilities)
این بخش مشخص میکند Claude چگونه مسائل را تحلیل و پاسخ خود را تولید کند. قابلیتهایی مثل Extended Thinking و Adaptive Thinking در این دسته قرار میگیرند.
Extended Thinking چیست؟حالت تفکر عمیق که به مدل اجازه میدهد قبل از پاسخ، مسئله را با دقت بیشتری بررسی کند.
Adaptive Thinking چیست؟حالت تفکر تطبیقی که در آن مدل بر اساس پیچیدگی سؤال، میزان زمان و توان پردازشی مورد نیاز برای فکر کردن را تنظیم میکند.
2. ابزارها (Tools)
ابزارها به Claude اجازه میدهند علاوه بر تولید پاسخ، کارهای مختلفی هم انجام دهد؛ مثلاً در وب جستجو کرده یا فایلها را بررسی کند.
3. زیرساخت ابزارها (Tool infrastructure)
این بخش مدیریت و هماهنگی ابزارها را بر عهده دارد. برای زمانی است که Claude باید از چند ابزار مختلف استفاده کند یا تعداد زیادی ایجنت و ابزار بهصورت همزمان درگیر هستند.
4. مدیریت کانتکست (Context management)
مدیریت کانتکست به Claude کمک میکند مکالمهها و Sessionهای طولانی را بهتر مدیریت کند. به این ترتیب، اطلاعات مهم در پروژههای طولانی بهتر مدیریت میشوند و مصرف منابع نیز بهینهتر خواهد بود.
5. فایلها (Files and assets)
این بخش برای مدیریت فایلها و دادههایی استفاده میشود که در اختیار Claude قرار میدهید؛ مثلاً اسناد، تصاویر و سایر اطلاعاتی که مدل برای انجام یک کار به آنها نیاز دارد.
مدلهای Claude API؛ کدام مدل را انتخاب کنیم؟
پیش از این، در مقاله Claude AI چیست؟ درباره خانواده مدلهای کلاد توضیح دادیم. بهطور خلاصه، فهمیدیم که کلاد مدلهای خود را در 4 خانواده Fable، Opus، Sonnet و Haiku معرفی میکند.
اما برای گرفتن API، کدام مدل را انتخاب کنیم؟
اگر به بالاترین توانایی ممکن برای انجام کارهای پیچیده، طولانی و چندمرحلهای نیاز دارید، Claude Fable 5 بهترین انتخاب است.
برای کدنویسی پیچیده، پروژههای سازمانی و کارهای حرفهای، Claude Opus 5 گزینه مناسبی است.
اگه نمیتونید تصمیم بگیرید که کدوم مدل رو انتخاب کنید، خود انتروپیک پیشنهاد میده که با Opus 5 شروع کنید.
Claude Sonnet 5 برای بیشتر پروژهها گزینهای معقول است و سرعت و توانایی بالایی دارد. بنابراین برای کارهایی مثل تولید محتوا، برنامهنویسی، تحلیل داده و پردازش تصویر میتواند انتخاب مناسبی باشد.
در نهایت، اگر سرعت پاسخ و هزینه اهمیت بیشتری دارد و کار شما پیچیدگی زیادی ندارد، Claude Haiku 4.5 گزینه مناسبتری است.
جدول مقایسه آخرین مدلهای ای پی آی کلاد
| ویژگی | Claude Fable 5 | Claude Opus 5 | Claude Sonnet 5 | Claude Haiku 4.5 |
| توضیحات | بالاترین توانایی برای کارهای بسیار پیچیده و طولانی | مناسب برای کدنویسی پیچیده و پروژههای سازمانی | انتخاب منطقی برای بیشتر پروژهها (ترکیبی از سرعت و کیفیت) | سریعترین گزینه برای کارهای سادهتر و پرتعداد |
| قیمتگذاری بر اساس هر 1 میلیون توکن | ورودی: 10 دلار - خروجی: 50 دلار | ورودی: 5 دلار - خروجی: 25 دلار | ورودی: 3 دلار - خروجی: 15 دلار | ورودی: 1 دلار - خروجی: 5 دلار |
| Extended Thinking | خیر | خیر | خیر | بله |
| Adaptive Thinking | بله (همیشه فعال) | بله | بله | خیر |
| سرعت نسبی | کندتر | متوسط | سریع | سریعترین |
| پنجره کانتکست | 1 میلیون توکن | 1 میلیون توکن | 1 میلیون توکن | 200 هزار توکن |
| حداکثر خروجی | 128 هزار توکن | 128 هزار توکن | 128 هزار توکن | 64 هزار توکن |
برای مشاهده کامل در موبایل، جدول را به چپ و راست بکشید.
قیمت Claude API چقدر است؟
برای API گرفتن، لزومی ندارد که حتماً سراغ آخرین مدل هر خانواده بروید. بسته به نیازتان میتوانید از ورژنهای قدیمیتر هم استفاده کنید. جدول زیر، یک مقایسه کامل از تمام مدلهای در دسترس خانوادههای کلاد است:
| مدل | توکنهای ورودی پایه | نوشتن کش 5 دقیقهای | نوشتن کش 1 ساعته | خواندن کش (Cache Hit) | توکنهای خروجی |
| Claude Fable 5 | $10 / MTok | $12.50 / MTok | $20 / MTok | $1 / MTok | $50 / MTok |
| Claude Mythos 5 (دسترسی محدود) | $10 / MTok | $12.50 / MTok | $20 / MTok | $1 / MTok | $50 / MTok |
| Claude Opus 5 | $5 / MTok | $6.25 / MTok | $10 / MTok | $0.50 / MTok | $25 / MTok |
| Claude Opus 4.8 | $5 / MTok | $6.25 / MTok | $10 / MTok | $0.50 / MTok | $25 / MTok |
| Claude Opus 4.7 | $5 / MTok | $6.25 / MTok | $10 / MTok | $0.50 / MTok | $25 / MTok |
| Claude Opus 4.6 | $5 / MTok | $6.25 / MTok | $10 / MTok | $0.50 / MTok | $25 / MTok |
| Claude Opus 4.5 | $5 / MTok | $6.25 / MTok | $10 / MTok | $0.50 / MTok | $25 / MTok |
| Claude Opus 4.1 (منسوخشده) | $15 / MTok | $18.75 / MTok | $30 / MTok | $1.50 / MTok | $75 / MTok |
| Claude Opus 4 (بازنشسته، بهجز روی Google Cloud) | $15 / MTok | $18.75 / MTok | $30 / MTok | $1.50 / MTok | $75 / MTok |
| Claude Sonnet 5 | $3 / MTok | $3.75 / MTok | $6 / MTok | $0.30 / MTok | $15 / MTok |
| Claude Sonnet 4.6 | $3 / MTok | $3.75 / MTok | $6 / MTok | $0.30 / MTok | $15 / MTok |
| Claude Sonnet 4.5 | $3 / MTok | $3.75 / MTok | $6 / MTok | $0.30 / MTok | $15 / MTok |
| Claude Sonnet 4 (بازنشسته، بهجز روی Bedrock و Google Cloud) | $3 / MTok | $3.75 / MTok | $6 / MTok | $0.30 / MTok | $15 / MTok |
| Claude Haiku 4.5 | $1 / MTok | $1.25 / MTok | $2 / MTok | $0.10 / MTok | $5 / MTok |
| Claude Haiku 3.5 (بازنشسته، بهجز روی Bedrock و Google Cloud) | $0.80 / MTok | $1 / MTok | $1.60 / MTok | $0.08 / MTok | $4 / MTok |
برای مشاهده کامل در موبایل، جدول را به چپ و راست بکشید.
* نکته درباره جدول:-منظور از MTok، قیمت بهازای هر 1 میلیون توکن است.
جمعبندی
در نهایت، این نکته را در نظر بگیرید که لزومی ندارد مدل Claude API یک انتخاب ثابت و همیشگی باشد. بسیاری از تیمها ترکیبی از چند مدل را استفاده میکنند. برای مثال، میتوان از Haiku برای بخشبندی اولیه درخواستها یا پاسخگویی سریع استفاده کرد و فقط درخواستهای پیچیدهتر را به Sonnet یا Opus سپرد. این روش میتواند هزینه نهایی را بهطور محسوسی کاهش دهد، بدون اینکه کیفیت پاسخها کاهش پیدا کند.
اگر تازه شروع کردهاید، بهتر است ابتدا پروژه خود را با مدلی مثل Sonnet 5 آزمایش کنید و بعد بر اساس نیاز واقعی، به سراغ مدلهای قدرتمندتری مثل Opus یا Fable بروید.
برای شروع عملی و یادگیری مرحلهبهمرحله نحوه استفاده از کلود ای پی آی Claude API، میتوانید آموزش تصویری و کاملی را که در ابتدای مقاله به آن اشاره کردیم، مطالعه کنید.





