پیکربندی (Config)

قالب فایل

AshaCode از JSON و JSONC (به همراه کامنت) پشتیبانی می‌کند. فایل اصلی در مسیر زیر قرار می‌گیرد:

~/.config/ashacode/config.json

در ویندوز مسیر %APPDATA%\ashacode\config.json است. برای پیکربندی مربوط به یک پروژه، از opencode.json در همان پروژه استفاده کنید.

اولویت ادغام

تنظیمات به ترتیب زیر ادغام می‌شوند (اولویت از بالا به پایین):

Remote .well-known/opencode
Global ~/.config/ashacode/config.json
Custom OPENCODE_CONFIG
Project opencode.json
.opencode/ شامل agents / commands / plugins
Inline OPENCODE_CONFIG_CONTENT
Managed /Library/Application Support/ + MDM

مثال کامل

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "asha-ai": {
      "options": {
        "apiKey": "ASHAAI-API-KEY",
        "baseURL": "https://app.asha-ai.ir/v1"
      }
    }
  },
  "model": "asha-ai/deepseek/deepseek-v4-flash"
}

فراهم‌کننده پیش‌فرض asha-ai با آدرس https://app.asha-ai.ir/v1 است.

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

برای جلوگیری از ذخیره کلید در فایل، از متغیرهای محیطی استفاده کنید:

{
  "provider": { "asha-ai": { "options": { "apiKey": "{env:ASHAAI_API_KEY}" } } },
  "instructions": ["{file:~/.secrets/rules.md}"]
}

مقادیر {env:...} و {file:...} در زمان اجرا خوانده می‌شوند.