متغیرهای محیطی

فهرست کامل AIRA_* و سازگارهای ANTHROPIC_* / CLAUDE_*.

AiraCode تلاش می‌کنه با env varهای آشنای جامعهٔ Claude Code / Anthropic سازگار بمونه، در عین حال یه پیشوند native AIRA_* ارائه بده.

احراز هویت

AIRA_API_KEY
توکن JWT برای حالت headless / CI. جایگزین aira login.
ANTHROPIC_API_KEY
synonym برای 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_MODEL
override کامل برای getSmallFastModel (بالاترین اولویت).
ANTHROPIC_MODEL
override کلی مدل از قدیم. اگه ست بشه، main loop ازش استفاده می‌کنه.

حافظه

AIRA_REMOTE_MEMORY
پیش‌فرض: 0
روی 1 ست کن تا حافظه از CogX (AiraChat) خوانده/نوشته بشه. پیش‌فرض فایل‌سیستم.
AIRA_PROJECT_SLUG
override اسم پروژه برای scoping حافظه (پیش‌فرض basename of git root).

پوشهٔ کانفیگ

AIRA_CONFIG_DIR
پیش‌فرض: ~/.aira
پوشهٔ کانفیگ کاربر. پشتیبانی از CLAUDE_CONFIG_DIR هم به‌عنوان fallback.
CLAUDE_CONFIG_DIR
legacy synonym. اگه AIRA_CONFIG_DIR ست نشده باشه استفاده می‌شه.
CLAUDE_CODE_REMOTE_MEMORY_DIR
override فقط برای 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.