اتصال Claude Code به API هوش مصنوعی از ایران
Claude Code — ایجنت کدنویسی ترمینالی Anthropic — بهصورت پیشفرض به api.anthropic.com وصل میشود. با دو متغیر محیطی میتوانی آن را روی مسیر نیتیو Anthropic در 1xAi بیاوری: همان Messages API رسمی، اما با کلید ایرانی و کسر هزینه به تومان. نه حساب Anthropic لازم است، نه کارت ارزی.
راهاندازی در چند دقیقه
- 01
ساخت حساب و دریافت کلید 1xAi
در 1xai.ir ثبتنام و ایمیلت را تأیید کن. هدیهٔ ۱۰۰٬۰۰۰ تومانی پس از ثبتنام با یک کلیک از داشبورد دریافت میشود. سپس از داشبورد یک کلید 1xai-* بساز و همان لحظه یک نسخه از آن کپی کن — کلید فقط یک بار نمایش داده میشود.
- 02
نصب Claude Code
اگر هنوز نصب نیست، Claude Code را طبق مستندات رسمی Anthropic نصب کن (از طریق npm یا نصبکنندهٔ رسمی). خود نصب نیازی به کلید ندارد.
- 03
تنظیم دو متغیر محیطی
در ترمینال، ANTHROPIC_BASE_URL را روی https://1xai.ir/anthropic و ANTHROPIC_AUTH_TOKEN را روی کلید 1xai-* خودت بگذار.
- 04
اجرای claude در پوشهٔ پروژه
دستور claude را اجرا کن. تمام درخواستها از مسیر نیتیو /anthropic در 1xAi عبور میکنند و هزینهٔ هر تماس به تومان از حسابت کسر و در داشبورد ثبت میشود.
- 05
ماندگار کردن تنظیم
برای اینکه در هر ترمینال جدید دوباره export نکنی، همان دو خط را به ~/.bashrc یا ~/.zshrc اضافه کن و یک ترمینال تازه باز کن.
تنظیمات آماده برای کپی
# دو متغیر محیطی، تمام تنظیمات همین است
export ANTHROPIC_BASE_URL="https://1xai.ir/anthropic"
export ANTHROPIC_AUTH_TOKEN="1xai-XXXXXXXXXXXXXXXX"
# اجرا در پوشهٔ پروژه
claude
# ماندگار کردن برای هر ترمینال (zsh؛ برای bash فایل ~/.bashrc):
echo 'export ANTHROPIC_BASE_URL="https://1xai.ir/anthropic"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="1xai-XXXXXXXXXXXXXXXX"' >> ~/.zshrcمدل پیشنهادی و هزینه
پیشنهاد: claude-sonnet-4-6 — و برای هزینهٔ کمتر: claude-haiku-4-5
Claude Code با مدلهای خانوادهٔ Claude کار میکند؛ claude-sonnet-4-6 برای کدنویسی روزمره انتخاب اصلی است و برای کارهای سنگینتر میتوانی به claude-opus-4-7 سوئیچ کنی.
هزینهٔ تقریبی به حجم توکن مصرفیات بستگی دارد: قیمت تومانی هر مدل، قیمت لیست سرویسدهنده بهعلاوهٔ مارکآپ ثابت ۲۰٪ است و نرخ دلار هر روز ساعت ۰۹:۰۰ بهوقت تهران بهصورت خودکار با بازار همگام میشود. عدد دقیق برای مصرف خودت را در محاسبهگر هزینه ببین.
اگر کار نکرد
- با وجود کلید درست، خطای احراز هویت میگیرم
- مطمئن شو هر دو متغیر در همان شلی تعریف شدهاند که claude را اجرا میکنی (با echo $ANTHROPIC_BASE_URL چک کن). اگر قبلاً با حساب Anthropic لاگین کرده بودی، یک ترمینال تازه باز کن تا متغیرهای محیطی اعمال شوند.
- 401 — کلید نامعتبر
- کلید اشتباه است، منقضی شده یا باطلش کردهای. کلید را دوباره از داشبورد کپی کن یا یک کلید تازه بساز. فاصله یا خط جدیدِ اضافی هنگام paste رایجترین علت این خطاست.
- 402 — موجودی کافی نیست
- اعتبار تومانی حسابت تمام شده. حداقل شارژ ۱۰۰٬۰۰۰ تومان از طریق زرینپال است و بلافاصله پس از پرداختِ موفق، تماسهای بعدی کار میکنند. شارژ حساب ←
- خطای نام مدل / مسیریابی
- 1xAi بر اساس نام مدل مسیریابی میکند: claude-* به Anthropic، gemini-* به Google، deepseek-* به DeepSeek و بقیهٔ نامها به OpenAI میروند. نام مدل را دقیقاً از صفحهٔ مدلها کپی کن — یک حرف اشتباه یعنی خطای مدلِ ناشناخته. فهرست مدلها و قیمت تومانی ←
با اعتبار هدیهٔ ۱۰۰٬۰۰۰ تومانی شروع کن
هدیه پس از ثبتنام با یک کلیک از داشبورد دریافت میشود — بدون ویپیان و بدون کارت ارزی؛ حداقل شارژ بعدی ۱۰۰٬۰۰۰ تومان از طریق زرینپال است.
آیا برای Claude Code به حساب Anthropic نیاز دارم؟
نه. مسیر نیتیو /anthropic در 1xAi همان Messages API رسمی Anthropic را ارائه میدهد؛ کلید 1xai-* جای کلید Anthropic مینشیند و هزینهٔ هر تماس به تومان از حساب 1xAi تو کسر میشود.
آیا قابلیتهایی مثل کش پرامپت هم کار میکنند؟
بله. مسیر /anthropic پاستروی کامل به API رسمی است، بنابراین قابلیتهای نیتیو مثل cache_control و thinking حفظ میشوند — و کش پرامپت هزینهٔ توکنهای تکراری را بهشکل محسوسی پایین میآورد.
- مدلها و قیمت تومانی
فهرست کامل مدلها با نرخ لحظهای هر ۱ میلیون توکن
- محاسبهگر هزینه
برآورد هزینهٔ ماهانه بر پایهٔ مصرف واقعی خودت
- خرید API هوش مصنوعی
شروع کار با کلید بومی و پرداخت تومانی
- مستندات کامل
مرجع API، مسیرهای نیتیو، استریم و کدهای خطا
- وضعیت سرویس
سلامت لحظهای اتصال به هر سرویسدهنده