Claude SDK در ایران: نصب و اولین API

از ایران که بخواهید به Claude API وصل شوید، مشکل اول کارت بانکی خارجی است و مشکل دوم فیلترینگ Anthropic، نه کیفیت مدل. راه‌حل عملی این نیست که دنبال شماره مجازی رایگان یا اکانت اشتراکی claude pro بگردید؛ کافی‌ست با SDK رسمی (anthropic یا @anthropic-ai/sdk) از طریق یک درگاه داخلی مثل 1xAi با base_url و کلید API مناسب وصل شوید و صورت‌حساب را به تومان و بدون VPN پرداخت کنید. در ادامه، از نصب SDK تا اولین درخواست واقعی به claude-3-haiku یا claude-opus-4 را قدم‌به‌قدم با کد Python و curl می‌بینید.

بخش‌های H2 (ساختار اصلی)

۱. چرا Claude API بهتر از اکانت وب است برای توسعه‌دهندگان

برای ساخت اپلیکیشن یا خدمت تولیدی، Claude API انتخاب درستی است چون درخواست‌ها را می‌توان برنامه‌ریزی و خودکار کرد، در حالی که اکانت وب فقط برای چت دستی در مرورگر طراحی شده. کاربر ایرانی که به‌دنبال خرید اکانت claude اشتراکی یا خرید اکانت claude pro اشتراکی می‌گردد، در عمل با محدودیت اتصال مستقیم کارت اعتباری خارجی به Claude.ai روبه‌رو می‌شود؛ این محدودیت جغرافیایی است، نه فنی.

استفاده از claude در ایران از مسیر API این مشکل را دور می‌زند. ما در 1xAi یک دروازه API اداره می‌کنیم که Claude را از طریق اندپوینت‌های اختصاصی در دسترس توسعه‌دهندگان ایرانی قرار می‌دهد و صورت‌حساب را به‌جای دلار، به تومان و از طریق درگاه داخلی تسویه می‌کند.

نکتهٔ کلیدی: برای محصول تولیدی، API با اندپوینت اختصاصی جای اکانت وب یا خرید اکانت claude max را می‌گیرد، نه برعکس.

۲. نصب SDK Claude و تنظیم کلید API در محیط توسعه

نصب SDK رسمی Anthropic در پایتون با pip install anthropic و در Node.js با npm install @anthropic-ai/sdk انجام می‌شود. کلید API را می‌توان از داشبورد 1xai.ir/pricing بدون نیاز به VPN یا کارت بانکی خارجی صادر کرد.

curl https://1xai.ir/v1/chat/completions \
  -H "Authorization: Bearer 1xai-XXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-3-haiku", "messages": [{"role": "user", "content": "سلام"}]}'

کافی است base_url را در SDK به https://1xai.ir/v1 تغییر دهید و کلید را جایگزین کنید؛ هیچ تغییری در ساختار کد لازم نیست.

بخش FAQ (سؤالات متداول)

آیا باید VPN استفاده کنم؟

خیر، برای استفاده از claude در ایران از طریق 1xAi نیازی به VPN نیست. ما در 1xAi این درگاه را از داخل ایران اداره می‌کنیم و شما مستقیماً و بدون فیلترشکن به https://1xai.ir وصل می‌شوید.

کلید API 1xAi چقدر امن است؟

کلید API را باید دقیقاً مثل یک رمز عبور محرمانه نگه دارید و هرگز آن را در کد عمومی، مخزن Git یا فرانت‌اند منتشر نکنید. اگر کلید لو رفت، سریع از پنل خودتان آن را غیرفعال و کلید جدید صادر کنید.

اگر اکانت Claude من بن شود، چه؟

API 1xAi کاملاً مستقل از اکانت وب Claude است، بنابراین بن‌شدن اکانت وب هیچ تأثیری روی دسترسی API شما ندارد. این یعنی اگر برای کارهای دیگر به دنبال خرید اکانت claude اشتراکی یا خرید اکانت claude pro اشتراکی بوده‌اید، ریسک قطع دسترسی به شکلی که در اکانت‌های اشتراکی وجود دارد، در مسیر API معنا ندارد.

آیا می‌توانم مدل را در حین اجرا تغییر دهم؟

بله، فقط کافی‌ست نام مدل را در درخواست عوض کنید، مثلاً model="claude-3-haiku" یا model="claude-3-sonnet" بدون نیاز به تغییر کلید یا endpoint.

چگونه می‌توانم هزینه‌ام را کاهش دهم؟

برای کارهای ساده از claude-3-haiku استفاده کنید که طبق جدول قیمت زنده 1xai.ir/models به‌مراتب ارزان‌تر از مدل‌های سونت و اوپوس است. راه دوم کوتاه‌کردن context ورودی است، چون هزینه بر اساس تعداد توکن ورودی و خروجی محاسبه می‌شود.

آیا 1xAi داده‌های من را ذخیره می‌کند؟

خیر، درخواست‌ها مستقیماً به Anthropic ارسال می‌شوند و 1xAi صرفاً نقش درگاه پرداخت و مسیریابی توکن‌ها را دارد. برای جزئیات نرخ‌ها و به‌روزرسانی روزانه قیمت‌ها https://1xai.ir/pricing را ببینید.

یادداشت‌های ویرایشی

این یادداشت را تیم مهندسی 1xAi می‌نویسد و افشا می‌کند که 1xAi همان گیت‌وی Claude API است که در این راهنما معرفی شده — یعنی منافع تجاری ما در معرفی این سرویس آشکار است، نه پنهان.

هر رقم تومانی که در متن آمده از جدول زنده قیمت‌گذاری در 1xai.ir/pricing و فهرست مدل‌ها در 1xai.ir/models گرفته شده، نه یک برآورد دستی. این قیمت‌ها بر پایه نرخ روزانهٔ بازار دلار محاسبه می‌شوند و بخش ثابت آن‌ها فقط مارک‌آپ ۲۰ درصدی ماست، نه نرخ ارز — یعنی با نوسان بازار به‌روز می‌شوند، نه با یک عدد ثابت.

نمونه‌کدهای پایتون و curl در این مقاله واقعاً قابل اجرا هستند: کافی است base_url را روی https://1xai.ir/v1 بگذارید و کلید خودتان را جایگزین کنید تا بدون تغییر دیگری کار کنند. جدول مقایسه مدل‌ها فقط شامل مدل‌هایی است که داده کامل قیمت ورودی و خروجی برایشان در دسترس ماست؛ مدل‌های بدون داده تأییدشده عمداً حذف شده‌اند.

تأکید روی «بدون VPN» و «بدون کارت خارجی» بازتاب همان شیوهٔ عملیاتی 1xAi است: پرداخت پیش‌پرداخت تومانی از طریق زرین‌پال و اتصال مستقیم API، بدون نیاز به شماره مجازی یا حساب واسط. محتوای این مقاله در مرداد ۱۴۰۵ (اوت ۲۰۲۶) بازبینی شده و با تغییر نرخ‌ها یا فهرست مدل‌ها به‌روزرسانی می‌شود.

سوالات متداول

آیا Claude در ایران بدون فیلترشکن قابل استفاده است؟

بله، از طریق درگاه API مثل 1xAi می‌توانید بدون VPN و بدون کارت بانکی خارجی به مدل‌های Claude متصل شوید؛ کافیست کلید API از داشبورد 1xAi بگیرید و در SDK یا curl از آدرس `https://1xai.ir/v1` استفاده کنید. صورت‌حساب هم به‌صورت پیش‌پرداخت و به تومان از طریق زرین‌پال محاسبه می‌شود.

چرا باید از Claude API استفاده کنم نه اکانت وب claude.ai؟

اکانت وب فقط برای استفاده دستی از رابط چت مناسب است و امکان اتصال کارت اعتباری خارجی برای کاربران ایرانی هم وجود ندارد. API امکان درخواست‌های خودکار، برنامه‌ریزی‌شده و یکپارچه‌سازی در اپلیکیشن‌های تولیدی را می‌دهد که برای توسعه‌دهندگان و استارتاپ‌ها ضروری است.

هزینه استفاده از مدل‌های Claude در ایران چقدر است؟

قیمت بسته به مدل متفاوت است؛ مثلاً claude-3-haiku حدود ۵۵.۷۴ تومان به ازای هر ۱۰۰۰ توکن ورودی و ۲۷۹ تومان برای خروجی است، درحالی‌که claude-3-opus و claude-opus-4 هرکدام ۳,۳۴۴ تومان ورودی و ۱۶,۷۲۲ تومان خروجی به ازای هر ۱۰۰۰ توکن هزینه دارند. claude-3-sonnet و claude-sonnet-4 نیز ۶۶۹ تومان ورودی و ۳,۳۴۴ تومان خروجی هستند.

چطور SDK را نصب و کلید API را تنظیم کنم؟

برای Python دستور `pip install anthropic` و برای Node.js دستور `npm install @anthropic-ai/sdk` را اجرا کنید، سپس کلید دریافتی از 1xAi را با `export ANTHROPIC_API_KEY="1xai-..."` در محیط ذخیره کرده و base_url را روی `https://1xai.ir/v1` تنظیم نمایید.

آیا برای خرید اکانت claude pro یا claude max نیاز به کارت خارجی دارم؟

خیر، برای دسترسی برنامه‌نویسی به مدل‌های Claude نیازی به کارت خارجی یا اشتراک مستقیم Anthropic نیست؛ از طریق درگاه‌هایی مثل 1xAi می‌توانید مستقیماً با تومان و پرداخت زرین‌پال کلید API فعال کنید و هر مدل Claude موردنیاز را با همان کلید فراخوانی کنید.