متغیرهای محیطی
متغیرهای رایج AIRA_* و AIRA_CODE_*، مقادیر پیشفرض و aliasهای مهاجرت.
AiraCode متغیرهای native آیرا یعنی AIRA_*، AIRACODE_*و AIRA_CODE_* رو ترجیح میده. چند alias قدیمی هنوز برای مهاجرت کار میکنن، ولی اسکریپتهای جدید باید از نامهای آیرا استفاده کنن.
احراز هویت
AIRA_API_KEYتوکن bearer آیراچت برای اجراهای headless و CI. توی اتوماسیونهای جدید این رو به متغیرهای auth قدیمی ترجیح بده.
ANTHROPIC_API_KEYalias سازگاری قدیمی برای اتوماسیون مبتنی بر API key. اسکریپتهای جدید AiraCode باید از AIRA_API_KEY استفاده کنن.
ANTHROPIC_AUTH_TOKENoverride توکن سازگاری قدیمی برای اتوماسیونهای OAuth قدیمیتر.
Gateway
AIRA_BASE_URLپیشفرض: https://app.airachat.ir/api
بیس API آیراچت. برای توسعهٔ local روی http://localhost:8000 بذار.
AIRA_GATEWAY_BASE_URLپیشفرض: ${AIRA_BASE_URL}/airacode/gateway
base URL مخصوص Gateway برای ترافیک مدل.
AIRA_API_TIMEOUT_MSپیشفرض: 10000
timeout برای فراخوانیهای helper مربوط به API آیرا.
ANTHROPIC_BASE_URLbase URL سازگاری قدیمی. اگه ست بشه، بهجای Gateway پیشفرض آیرا از یک upstream سازگار عبور میکنه.
انتخاب مدل
AIRA_MODELoverride مدل در سطح کل process برای نشستهای CLI و print mode. بر تنظیمات ذخیرهشده اولویت داره.
AIRA_MODEL_DEFAULTپیشفرض: aira-balanced
lane هوشمند پیشفرض وقتی flag، override محیطی یا مدل ذخیرهشدهای وجود نداره.
AIRA_DEFAULT_MODELalias قدیمی آیرا برای AIRA_MODEL_DEFAULT.
AIRA_MODEL_SMALL_FASToverride مدل کوچک و سریع برای فراخوانیهای کمکی مثل تولید عنوان و مسیریابی سبک.
AIRA_MODEL_TITLE_GENERATIONoverride مدل اختصاصیِ task برای تولید عنوان نشست.
AIRA_MODEL_INTENT_DETECTIONoverride مدل اختصاصیِ task برای دستهبندی intent و parsing.
AIRA_MODEL_MEMORY_EXTRACTIONoverride مدل اختصاصیِ task برای استخراج حافظه در پسزمینه.
AIRA_MODEL_MEMORY_COMPACTIONoverride مدل اختصاصیِ task برای فشردهسازی حافظه و context.
ANTHROPIC_MODELoverride مدل سازگاری قدیمی. وقتی هر دو ست باشن، AIRA_MODEL اولویت داره.
ANTHROPIC_SMALL_FAST_MODELoverride سازگاری قدیمی برای مدل کوچک و سریع.
حافظه
AIRA_REMOTE_MEMORYپیشفرض: enabled
حافظهٔ راهدور CogX بهصورت پیشفرض فعاله. برای استفاده فقط از حافظهٔ فایلسیستم local، مقدار 0، false، off، no یا خالی بذار.
AIRA_PROJECT_SLUGslug پروژهٔ حافظه رو override میکنه. AiraCode بهصورت پیشفرض اون رو از basename ریشهٔ گیت میسازه.
AIRA_CODE_DISABLE_AUTO_MEMORYپیشفرض: 0
روی 1، true، yes یا on بذار تا حافظهٔ خودکار کاملاً غیرفعال بشه.
پوشهٔ کانفیگ
AIRA_CONFIG_DIRپیشفرض: ~/.aira
پوشهٔ کانفیگ کاربر. اگه ست بشه، بر مسیرهای کانفیگ قدیمیِ مهاجرتشده اولویت داره.
CLAUDE_CONFIG_DIRپوشهٔ کانفیگ سازگاری قدیمی. فقط وقتی AIRA_CONFIG_DIR ست نشده باشه استفاده میشه.
CLAUDE_CODE_REMOTE_MEMORY_DIRoverride سازگاری قدیمی برای use caseهای پوشهٔ حافظهٔ راهدور یا SDK.
رفتار runtime
AIRA_CODE_SIMPLEپیشفرض: 0
حالت bare برای اسکریپتها. hookها، LSP، sync افزونه، خواندن keychain و بقیهٔ کارهای اضافهٔ startup رو غیرفعال میکنه.
AIRA_CODE_DISABLE_BACKGROUND_TASKSپیشفرض: 0
پشتیبانی background shell رو از schema ابزار و متن راهنما حذف میکنه.
AIRA_CODE_DISABLE_FAST_MODEپیشفرض: 0
Fast Mode رو غیرفعال میکنه.
AIRA_CODE_SYNTAX_HIGHLIGHTروی 0، false یا off بذار تا syntax highlighting غیرفعال بشه.
AIRA_CODE_NO_FLICKERرفتار fullscreen و alternate-screen رو کنترل میکنه. برای opt-in مقدار 1، و هرجا پشتیبانی بشه برای opt-out مقدار 0.
AIRA_CODE_DISABLE_MOUSEپیشفرض: 0
ردیابی ماوس رو در حالت fullscreen غیرفعال میکنه.
AIRA_CODE_DISABLE_MOUSE_CLICKSپیشفرض: 0
کلیکهای ماوس رو در fullscreen نادیده میگیره ولی رفتار wheel رو نگه میداره.
AIRA_CODE_DISABLE_TERMINAL_TITLEپیشفرض: 0
بهروزرسانی title ترمینال رو غیرفعال میکنه.
AIRA_CODE_EXIT_AFTER_FIRST_RENDERکمکیِ startup فقط برای benchmark که بعد از اولین render خارج میشه.
AIRA_DISABLE_BROWSER_OPENپیشفرض: 0
جلوی باز شدن مرورگر توسط فرمانهای login، شارژ، استیکر و remote-control رو میگیره.
AIRACODE_DISABLE_BROWSER_OPENپیشفرض: 0
املای سازگار برای AIRA_DISABLE_BROWSER_OPEN.
AIRA_ENABLE_BROWSER_INTEGRATIONپیشفرض: 0
یکپارچگی بتای Aira Browser رو بهصورت پیشفرض در نشستهای تعاملی فعال میکنه.
AIRACODE_ENABLE_BROWSER_INTEGRATIONاملای سازگار برای AIRA_ENABLE_BROWSER_INTEGRATION.
AIRA_BROWSER_PERMISSION_MODEحالت permission اختیاری Aira Browser: ask، skip_all_permission_checks یا follow_a_plan.
سرویسهای opt-in
AIRA_ENABLE_AUTOUPDATERپیشفرض: 0
مسیر auto-updater رو فعال میکنه.
AIRA_ENABLE_GROWTHBOOKپیشفرض: 0
دریافت feature-flagهای GrowthBook رو فعال میکنه.
CLAUDE_CODE_ENABLE_TELEMETRYپیشفرض: 0
کلید سازگاری قدیمی برای exporterهای OpenTelemetry.
نصب
AIRA_INSTALLروی bun بذار تا بهجای مسیر نصبِ باینری مستقل، نصب با Bun اجباری بشه.
AIRA_NPM_MIRRORپیشفرض: https://registry.npmmirror.com
میرور npm که install.sh و متن نصبِ صفحهٔ لندینگ ازش استفاده میکنن.
AIRA_DOWNLOAD_BASEپیشفرض: https://airacode.ir/download
بیس دانلود برای فایلهای نصبکنندهٔ باینری مستقل.
AIRA_VERSIONپیشفرض: latest
override نسخه برای نصبکنندهٔ PowerShell.
AIRA_MODEoverride حالت نصبکننده. برای رد کردن انتخاب میرور منطقهای مقدار direct رو بذار.
AIRA_CURL_MAX_TIMEپیشفرض: 180
حداکثر زمان curl برای install.sh پیش از fallback.
AIRA_DOWNLOAD_TIMEOUT_SECپیشفرض: 180
timeout دانلودِ نصبکنندهٔ PowerShell.
AIRACODE_DOWNLOAD_TIMEOUT_MSoverride تایماوت دانلودرِ باینری مستقل که helperهای دانلود CLI ازش استفاده میکنن.
AIRA_DOWNLOAD_TIMEOUT_MSاملای آیرا برای override تایماوت دانلودرِ باینری مستقل.
تولید تصویر
AIRA_GENIMAGE_ENDPOINTendpoint تولید تصویرِ مدیریتشده توسط آیرا برای /genimage.
AIRA_GENIMAGE_API_KEYAPI key اختیاری برای تولید تصویرِ مدیریتشده توسط آیرا وقتی از توکن ورود استفاده نمیکنی.
AIRA_GENIMAGE_MODELپیشفرض: gpt-image-2
override مدل پیشفرض /genimage.
AIRA_BYOK_OPENAIکلید شخصی OpenAI که حالت provider مستقیم /genimage ازش استفاده میکنه.
AIRA_OPENAI_API_KEYاملای آیرا برای کلید مستقیم تولید تصویر OpenAI.
OPENAI_API_KEYکلید مستقیم OpenAI برای /genimage. فراخوانیهای مستقیم خارج از AiraCredit حساب میشن.
توسعهٔ محلی
USE_LOCAL_OAUTHسوئیچ توسعهٔ local که flowهای OAuth رو به localhost مسیریابی میکنه.
AIRA_LOCAL_API_BASEپیشفرض: http://localhost:8000
override بیس API محلی که همراه توسعهٔ OAuth محلی استفاده میشه.
سرور (ops)
AIRACODE_GW_ALLOW_ALLflag سمت سرور برای توسعه که allowlist Gateway رو غیرفعال میکنه.
AIRACODE_GW_EXTRA_MODELSگسترش allowlist سمت سرور برای مدلهای اضافهٔ Gateway بدون deploy.
AIRACODE_GW_UPSTREAM_BASEپیشفرض: https://openrouter.ai/api
بیسِ upstream سازگار با Messages در سمت سرور.