انتخاب مدل
چطور مدلی که AiraCode استفاده میکنه رو کنترل کنی — alias، env، یا انتخاب مدل خام.
AiraCode بهجای اینکه مستقیم به Anthropic وصل بشه، درخواستها رو از طریق Gateway آیراکد به موتور inference میفرسته (مستندات کامل: Gateway آیراکد). این یعنی هر مدلی که در کاتالوگ هست، در صورت قرار گرفتن در allowlist، در دسترسته.
Aliasهای دوستانه
بهجای حفظ کردن نام دقیق مدل، از یکی از این aliasها استفاده کن:
| Alias | مدل پایه | برای چی |
|---|---|---|
aira-fast | openai/gpt-oss-20b | عنوان جلسه، intent، کارهای کوتاه |
aira-cheap | google/gemini-2.5-flash-lite | ارزونترین، برای تستهای سریع |
aira-balanced | deepseek/deepseek-v4-flash | پیشفرض، تعادل کیفیت/هزینه |
aira-pro | openai/gpt-oss-120b | refactor، طراحی، reasoning عمیق |
aira-max | qwen/qwen3-235b-a22b-2507 | سنگینترین، بهترین کیفیت |
aira-sonnet | anthropic/claude-sonnet-4-6 | Claude Sonnet مستقیم (گرونتر) |
aira-opus | anthropic/claude-opus-4-6 | Claude Opus، reasoning ممتاز |
aira-haiku | anthropic/claude-haiku-4-5 | Claude Haiku، سریع و ارزون |
روشهای تنظیم
یک نشست
aira --model aira-pro aira --model aira-pro -p "یک پلن برای migration پایگاهداده بنویس"
پیشفرض دائمی (env)
# توی ~/.zshrc یا ~/.bashrc: export AIRA_MODEL_DEFAULT=aira-balanced # یا برای یه پروژه با direnv: echo "export AIRA_MODEL_DEFAULT=aira-pro" >> .envrc
مدل خام
اگه میخوای مدلی استفاده کنی که alias نداره، اسم کامل مدل (با prefix provider) رو پاس بده:
aira --model deepseek/deepseek-v3 aira --model meta-llama/llama-3.3-70b-instruct aira --model mistralai/mistral-large-2411
مدل باید توی allowlist Gateway باشه. لیست کامل از این endpoint بخون:
curl -H "Authorization: Bearer $TOKEN" \
https://app.airachat.ir/api/airacode/gateway/v1/modelsمدل بر اساس task
فراتر از یک مدل پیشفرض، میتونی برای هر نوع کار (task_type) یه مدل متفاوت مشخص کنی. اینجا «نوع کار» چیزایی مثل تولید عنوان جلسه، تشخیص intent برای recall، یا خلاصهسازی Web fetch است.
# عنوان جلسه با مدل خیلی ارزون export AIRA_MODEL_TITLE_GENERATION=openai/gpt-oss-20b # تشخیص intent با Gemini export AIRA_MODEL_INTENT_DETECTION=google/gemini-2.5-flash-lite # Compaction context با Haiku export AIRA_MODEL_MEMORY_COMPACTION=anthropic/claude-haiku-4-5 # task پیشفرض اگه نسخهٔ خاصی تعریف نشده export AIRA_MODEL_SMALL_FAST=deepseek/deepseek-v4-flash
دور زدن Gateway
اگه خواستی AiraCode مستقیم بره به Anthropic یا یه gateway دیگه:
# مستقیم به Anthropic (نیاز به VPN از ایران) export ANTHROPIC_BASE_URL=https://api.anthropic.com export ANTHROPIC_API_KEY=sk-ant-... # یا یه gateway دیگه که شما کنترلش میکنی export AIRA_GATEWAY_BASE_URL=https://my-proxy.example.com/v1
برای ops
- افزودن مدل بدون deploy: روی سرور
AIRACODE_GW_EXTRA_MODELS=foo/bar,baz/qux - دور زدن allowlist برای dev:
AIRACODE_GW_ALLOW_ALL=1 - تغییر upstream به مقصد دیگه:
AIRACODE_GW_UPSTREAM_BASE=https://...