آموزش استفاده از Claude Code در ایران بدون تحریم و با پرداخت ریالی

چرا Claude Code با کایا کار می‌کند؟

Claude Code با پروتکل Messages آنتروپیک کار می‌کند و درخواست را به مسیر POST /api/v1/messages می‌فرستد. کایا ای آی همین اندپوینت را به‌صورت بومی پیاده کرده است؛ پس کلاینت شما همان درخواست استاندارد آنتروپیک را می‌فرستد و کایا آن را به مدل انتخابی در کاتالوگ می‌رساند و مصرف را از کیف پول ریالی شما کسر می‌کند.

نتیجه عملی: برای استفاده از Claude Code در ایران به حساب آنتروپیک، کارت اعتباری بین‌المللی یا تحریم‌شکن نیازی ندارید. فقط ANTHROPIC_BASE_URL را به کایا تغییر دهید و توکن خودتان را بگذارید.

• پشتیبانی بومی از POST /api/v1/messages — بدون patch، پروکسی یا ابزار واسط
• پرداخت ریالی بر اساس مصرف واقعی توکن (بدون اشتراک ماهانه)
• هر مدل چت کاتالوگ قابل استفاده است: Claude، DeepSeek، GPT، Gemini و…
• اعتبار، محدودیت نرخ و گزارش مصرف دقیقاً مثل سایر اندپوینت‌های کایا محاسبه می‌شود

پیش‌نیازها

node -v
npm install -g @anthropic-ai/claude-code
claude --version

• کلید API از پنل کلیدها — با پیشوند sk-llm-
• Node.js نسخه ۱۸ یا بالاتر (node -v)
• بسته Claude Code CLI
• اعتبار کایا؛ با ۱۰۰ اعتبار هدیه ثبت‌نام شروع کنید

اتصال Claude Code به کایا ای آی

1. ۱

   کلید API را بسازید

   ثبت‌نام کنید، وارد پنل کلیدها شوید و یک کلید بسازید. کلید فقط یک‌بار کامل نمایش داده می‌شود؛ همان مقدار را در ANTHROPIC_AUTH_TOKEN بگذارید.

2. ۲

   سه دستور اتصال را اجرا کنید

   دقیقاً این سه خط را در ترمینال بزنید: خط اول Claude Code را به کایا می‌فرستد، خط دوم توکن شماست و خط سوم برنامه را اجرا می‌کند.

   اتصال و اجراکپی

   export ANTHROPIC_BASE_URL="https://kayaai.ir/api"
   export ANTHROPIC_AUTH_TOKEN="sk-llm-YOUR_KEY"
   claude

   در ANTHROPIC_BASE_URL مسیر /v1 را اضافه نکنید؛ خود Claude Code مسیر /v1/messages را به آن می‌چسباند. مقدار درست https://kayaai.ir/api است.

3. ۳

   متغیرها را دائمی کنید (اختیاری)

   برای اینکه هر بار این دستورها را نزنید، آن‌ها را در فایل شل خود ذخیره کنید.

   zshbashPowerShell

   ~/.zshrcکپی

   # Kaya AI — Claude Code
   export ANTHROPIC_BASE_URL="https://kayaai.ir/api"
   export ANTHROPIC_AUTH_TOKEN="sk-llm-YOUR_KEY"
   unset ANTHROPIC_API_KEY
   
   # بارگذاری مجدد: source ~/.zshrc

   اگر ANTHROPIC_API_KEY روی سیستم تنظیم باشد، Claude Code ممکن است به سرور اصلی آنتروپیک وصل شود. همیشه آن را حذف یا خالی کنید.

4. ۴

   اولین اجرا داخل پوشه پروژه

   وارد پوشه پروژه شوید و claude را اجرا کنید. Claude Code پروژه را می‌خواند و آماده کار است.

   اجرای Claude Codeکپی

   cd ~/projects/my-app
   claude

   داخل Claude Code دستور /status وضعیت حساب و مدل فعال را نشان می‌دهد و با /model می‌توانید مدل را عوض کنید.

انتخاب مدل: Claude Sonnet 5.5 یا Opus 5.5

پیشنهاد ما برای کدنویسی روزمره anthropic/claude-sonnet-5.5 و برای کارهای سنگین‌تر anthropic/claude-opus-5.5 است. هر دو مدل در کاتالوگ کایا با پرداخت ریالی و بدون تغییر آی‌پی در دسترس‌اند.

می‌توانید برای مصرف بالا مدل ارزان‌تری مثل deepseek/deepseek-v4.1-flash یا برای تحلیل‌های سنگین openai/gpt-6.1-sol را هم در همین اندپوینت به کار ببرید.

export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-5.5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-5.5"

تست اندپوینت آنتروپیک با cURL

برای اینکه مطمئن شوید مسیر آنتروپیک کایا درست کار می‌کند، یک درخواست مستقیم بفرستید. کایا کلید را با هدر Authorization: Bearer یا x-api-key می‌پذیرد.

curl -X POST https://kayaai.ir/api/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-llm-YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "anthropic/claude-sonnet-5.5",
    "max_tokens": 256,
    "messages": [
      {"role": "user", "content": "سلام"}
    ]
  }'

عیب‌یابی سریع