آشا آشا AI Gateway
ورود شروع رایگان

Codex CLI

عامل کدنویسیِ متن‌باز OpenAI را در ترمینال، به‌جای اتصال مستقیم، از درگاه آشا وصل کنید؛ با جابه‌جایی خودکار پروایدرها، کنترل هزینهٔ تیم و مصرف کاملاً شفاف.

Codex CLI عامل (Agent) کدنویسیِ متن‌باز و محلی OpenAI است که در ترمینال شما اجرا می‌شود و از چند ارائه‌دهندهٔ مدل پشتیبانی می‌کند. وقتی آن را به آشا وصل می‌کنید، همهٔ درخواست‌ها از درگاه عبور می‌کنند؛ پس علاوه بر مدل‌های OpenAI، به API یکپارچه، جابه‌جایی خودکار بین پروایدرها و کنترل‌های سازمانیِ آشا هم دسترسی دارید.

!

توصیهٔ سازگاری: استفاده از Codex CLI از طریق درگاه با خانوادهٔ پروایدرهای OpenAI (و سازگار با آن) تضمین می‌شود؛ مدل‌های غیر-OpenAI ممکن است با هشدار «Unknown model» برای متادیتا مواجه شوند. برای حداکثر سازگاری، هنگام اتصال Codex CLI، پروایدرهای OpenAI را در اولویت بالای انتخاب پروایدر قرار دهید.

چرا باید Codex CLI را به آشا وصل کنیم؟

آشا یک لایهٔ پایداری و مدیریت بین Codex CLI و API ارائه‌دهندگان اضافه می‌کند و چند مزیت کلیدی برای شما و سازمانتان فراهم می‌کند.

جابه‌جایی خودکار پروایدر برای دسترس‌پذیری بالا

API ارائه‌دهندگان هر از گاهی با قطعی یا محدودیت نرخ روبه‌رو می‌شود. وقتی Codex CLI را از طریق آشا مسیردهی کنید، درخواست‌ها به‌صورت خودکار بین چند پروایدر جابه‌جا می‌شوند؛ اگر یکی در دسترس نباشد یا محدودیت داشته باشد، آشا درخواست را به پروایدر دیگری هدایت می‌کند و نشست کدنویسی شما بی‌وقفه ادامه می‌یابد.

کنترل بودجهٔ سازمانی

برای تیم‌ها و سازمان‌ها، آشا مدیریت بودجهٔ متمرکز فراهم می‌کند: سقف هزینه تعیین کنید، اعتبار را بین اعضای تیم تقسیم کنید و از پرش هزینهٔ ناگهانی جلوگیری کنید؛ همه در کیف پول به تومان. این قابلیت وقتی چند توسعه‌دهنده به‌صورت هم‌زمان از Codex CLI استفاده می‌کنند بسیار ارزشمند است.

دید و تحلیل مصرف

آشا دید کاملی از نحوهٔ استفاده از Codex CLI در تیم شما می‌دهد: الگوی مصرف را دنبال کنید، هزینه‌ها را لحظه‌ای ببینید و متوجه شوید کدام پروژه یا کدام عضو تیم بیشترین منابع را مصرف می‌کند. همهٔ این داده‌ها در داشبورد فعالیت آشا در دسترس است.

انعطاف در انتخاب مدل

فیلد model را هر زمان که خواستید به هر slug از فهرست مدل‌های آشا تغییر دهید — مثلاً از ~openai/gpt-latest به ~anthropic/claude-sonnet-latest یا یک نسخهٔ سنجاق‌شده — بدون نصب دوبارهٔ Codex؛ فقط config.toml را به‌روزرسانی کنید.

شروع سریع

این راهنما شما را در چند دقیقه به Codex CLI‌ای که با آشا کار می‌کند می‌رساند.

گام ۱ — نصب Codex CLI

Codex CLI را طبق دستورالعمل‌های نصب رسمی در GitHub نصب کنید:

npm Terminal 
npm install -g @openai/codex

گام ۲ — دریافت کلید API آشا

  1. در داشبورد آشا ثبت‌نام یا وارد شوید.
  2. به صفحهٔ کلیدهای API بروید.
  3. یک کلید API جدید بسازید.
  4. کلید را کپی کنید (با sk-asha-... شروع می‌شود).

گام ۳ — پیکربندی Codex برای آشا

Codex از فایل config.toml استفاده می‌کند که معمولاً در مسیر ~/.codex/config.toml قرار دارد. این فایل را با پیکربندی زیر بسازید یا ویرایش کنید: 

model_provider = "asha"
model_reasoning_effort = "high"
model = "~openai/gpt-latest"

[model_providers.asha]
name = "asha"
base_url = "https://app.asha-ai.ir/v1"

[model_providers.asha.auth]
command = "sh"
args = ["-c", "echo $ASHA_API_KEY"]
model_provider = "asha"
model_reasoning_effort = "high"
model = "~openai/gpt-latest"

[model_providers.asha]
name = "asha"
base_url = "https://app.asha-ai.ir/v1"

[model_providers.asha.auth]
command = "powershell"
args = ["-NoProfile", "-Command", "Write-Output $env:ASHA_API_KEY"]
!

فقط env_key = "ASHA_API_KEY" هم برای احراز هویت کار می‌کند، اما در آن حالت Codex کاتالوگ مدل آشا را بارگیری نمی‌کند؛ مدل‌های غیر-OpenAI هشدار fallback با متادیتای «Unknown model» را نشان می‌دهند. بلوک auth فرمان‌محور بالا را ترجیح دهید.

گام ۴ — تنظیم کلید API

کلید API آشا را در فایل پوستهٔ خود export کنید:

# به ~/.zshrc، ~/.bashrc یا ~/.config/fish/config.fish اضافه کنید
export ASHA_API_KEY="sk-asha-..."
setx ASHA_API_KEY "sk-asha-..."
م

ری‌استارت Codex: متغیر را به‌صورت سطح کاربر تنظیم کنید و سپس Codex — از جمله برنامهٔ دسکتاپ، که متغیرهای تنظیم‌شده فقط در یک نشست ترمینال را نمی‌بیند — را کامل ری‌استارت کنید.

ت

دستور auth در گام ۳ کلید را از $ASHA_API_KEY می‌خواند؛ مطمئن شوید این متغیر محیطی پیش از شروع Codex تنظیم شده است.

گام ۵ — شروع Codex

به پوشهٔ پروژهٔ خود بروید و اجرا کنید:

Terminal bash 
cd /path/to/your/project
codex

درخواست‌های شما حالا از درگاه آشا عبور می‌کنند.

مرجع پیکربندی

تنظیمات اصلی

تنظیمتوضیحمثال
model_providerپروایدر مورد استفاده برای درخواست‌های مدل."asha"
modelشناسهٔ مدل در آشا."~openai/gpt-latest"
model_reasoning_effortسطح تلاش استدلال برای مدل‌های Codex."low"، "medium"، "high"، "xhigh"، "max"
show_raw_agent_reasoningنمایش توکن‌های استدلال در رابط کاربری.true یا false
personalityپیش‌تنظیم شخصیت عامل."pragmatic"، "helpful" و…

بلوک پروایدر آشا

TOML ~/.codex/config.toml 
[model_providers.asha]
name = "asha"
base_url = "https://app.asha-ai.ir/v1"

[model_providers.asha.auth]
command = "sh"
args = ["-c", "echo $ASHA_API_KEY"]
  • base_url: نقطهٔ پایانی OpenAI-سازگار آشا. برای محیط تولید از https://app.asha-ai.ir/v1 استفاده کنید.
  • auth.command / auth.args: دستوری که Codex برای دریافت کلید API اجرا می‌کند؛ در اینجا $ASHA_API_KEY را echo می‌کند. احراز هویت فرمان‌محور همان چیزی است که تازه‌سازی کاتالوگ مدل Codex را فعال می‌کند، بنابراین مدل‌های غیر-OpenAI به‌جای متادیتای fallback، متادیتای درست می‌گیرند. در ویندوز از command = "powershell" با args = ["-NoProfile", "-Command", "Write-Output $env:ASHA_API_KEY"] استفاده کنید، چون sh در آنجا وجود ندارد.

سطوح اعتماد پروژه

Codex از سطوح اعتماد مجزا برای هر پروژه پشتیبانی می‌کند. مسیر پروژه‌ها را اضافه کنید تا مشخص شود عامل به چه چیزهایی دسترسی دارد:

TOML ~/.codex/config.toml 
[projects."/path/to/trusted/project"]
trust_level = "trusted"

[projects."/path/to/untrusted/project"]
trust_level = "untrusted"
  • trusted: عامل دسترسی کامل دارد (مثل اجرای دستورها و ویرایش فایل‌ها).
  • untrusted: دسترسی عامل برای ایمنی محدود می‌شود.

رفع اشکال

  • خطاهای احراز هویت: مطمئن شوید ASHA_API_KEY تنظیم و معتبر است (کلیدها را در صفحهٔ کلیدهای API داشبورد آشا بررسی کنید). خطای 401 با «Missing Authentication header» معمولاً یعنی دستور auth اجرا نشده است. در ویندوز از نوع PowerShell بالا استفاده کنید و متغیر را با setx به‌صورت کاربری تنظیم کنید، سپس Codex را کامل ری‌استارت کنید.
  • مدل پیدا نشد: شناسهٔ مدل را در فهرست مدل‌های آشا بررسی کنید و از قالب دقیق استفاده کنید (مثل ~openai/gpt-latest).
  • حریم خصوصی: آشا کدهای منبع و پرامپت‌های شما را ثبت نمی‌کند مگر اینکه صریحاً ثبت پرامپت را در تنظیمات حساب خود فعال کرده باشید. برای جزئیات، سیاست حریم خصوصی آشا را ببینید.

منابع