متغیرهای محیطی
فهرست کامل AIRA_* و سازگارهای ANTHROPIC_* / CLAUDE_*.
AiraCode تلاش میکنه با env varهای آشنای جامعهٔ Claude Code / Anthropic سازگار بمونه، در عین حال یه پیشوند native AIRA_* ارائه بده.
احراز هویت
AIRA_API_KEYتوکن JWT برای حالت headless / CI. جایگزین aira login.
ANTHROPIC_API_KEYsynonym برای AIRA_API_KEY (سازگاری اسکریپتهای قدیمی).
ANTHROPIC_AUTH_TOKENتوکن Bearer مستقیم. برای override OAuth.
Gateway
AIRA_BASE_URLپیشفرض: https://app.airachat.ir/api
API base آیراچت. برای dev محلی روی http://localhost:8000 بذار.
AIRA_GATEWAY_BASE_URLپیشفرض: ${AIRA_BASE_URL}/airacode/gateway
فقط بخش gateway. برای استفاده از gateway third-party.
ANTHROPIC_BASE_URLاگه ست بشه، Gateway آیراچت رو دور میزنه و مستقیم به این URL میره. برای استفاده از Anthropic native.
انتخاب مدل
AIRA_MODEL_DEFAULTپیشفرض: aira-balanced
مدل پیشفرض اگه --model پاس نشه.
AIRA_MODEL_SMALL_FASTمدل برای کارهای cost-efficient. سازگار با queryHaiku.
AIRA_MODEL_TITLE_GENERATIONمدل اختصاصی برای تولید عنوان جلسه.
AIRA_MODEL_INTENT_DETECTIONمدل برای intent classification و parsing.
AIRA_MODEL_MEMORY_EXTRACTIONمدل برای forked agent استخراج حافظه.
AIRA_MODEL_MEMORY_COMPACTIONمدل برای context compaction.
ANTHROPIC_SMALL_FAST_MODELoverride کامل برای getSmallFastModel (بالاترین اولویت).
ANTHROPIC_MODELoverride کلی مدل از قدیم. اگه ست بشه، main loop ازش استفاده میکنه.
حافظه
AIRA_REMOTE_MEMORYپیشفرض: 0
روی 1 ست کن تا حافظه از CogX (AiraChat) خوانده/نوشته بشه. پیشفرض فایلسیستم.
AIRA_PROJECT_SLUGoverride اسم پروژه برای scoping حافظه (پیشفرض basename of git root).
پوشهٔ کانفیگ
AIRA_CONFIG_DIRپیشفرض: ~/.aira
پوشهٔ کانفیگ کاربر. پشتیبانی از CLAUDE_CONFIG_DIR هم بهعنوان fallback.
CLAUDE_CONFIG_DIRlegacy synonym. اگه AIRA_CONFIG_DIR ست نشده باشه استفاده میشه.
CLAUDE_CODE_REMOTE_MEMORY_DIRoverride فقط برای cowork/SDK use cases.
تلهمتری و آپدیت
AIRA_ENABLE_AUTOUPDATERپیشفرض: 0
auto-updater پیشفرض خاموش. روی 1 ست کن (فعلاً npm publish نشده، 404 میگیری).
AIRA_ENABLE_GROWTHBOOKپیشفرض: 0
GrowthBook پیشفرض خاموش. روی 1 ست کن اگه به feature flag نیاز داری.
CLAUDE_CODE_ENABLE_TELEMETRYپیشفرض: 0
OpenTelemetry exporters. پیشفرض خاموش.
نصب
AIRA_NPM_MIRRORپیشفرض: https://npm.runflare.com
میرور npm که install.sh ازش استفاده میکنه. روی هر Verdaccio / artifactory بذار.
توسعه محلی
USE_LOCAL_OAUTHبرای dev local، اگه 1 باشه به localhost:8000 وصل میشه.
AIRA_LOCAL_API_BASEپیشفرض: http://localhost:8000
override pure dev از USE_LOCAL_OAUTH.
سرور (ops)
AIRACODE_GW_ALLOW_ALL[server] allowlist رو خاموش کن (dev only).
AIRACODE_GW_EXTRA_MODELS[server] مدل اضافه به allowlist بدون deploy.
AIRACODE_GW_UPSTREAM_BASEپیشفرض: https://api.airachat.ir/inference
[server] override upstream gateway.