اکوان
مستندات اکوان
مستندات/Providerها

راه‌اندازی OpenAI Codex

ورود از طریق Codex CLI یا کلید OpenAI؛ پیکربندی و عیب‌یابی.

provider OpenAI Codex به شما اجازه می‌دهد با همان ورود Codex CLI (codex login) یا با کلید مستقیم OpenAI از مدل‌های OpenAI استفاده کنید.

راه‌اندازی

تنظیم‌کنندهٔ مدل را اجرا کنید:

bash
akvan model
  1. provider OpenAI Codex را انتخاب کنید.
  2. یکی از روش‌های احراز هویت را انتخاب کنید:
    • ورود Codex CLI — اگر قبلاً با codex login وارد شده‌اید، Akvan از همان اطلاعات احراز هویت استفاده می‌کند.
    • API key — کلید OPENAI_API_KEY را وارد کنید.
  3. مدل موردنظر را انتخاب کنید.

تنظیم دستی با API key

اگر می‌خواهید کلید مستقیم OpenAI استفاده شود، مقدار AKVAN_CODEX_AUTH_MODE را هم تنظیم کنید؛ مقدار پیش‌فرض، ورود از طریق Codex CLI است.

env
AKVAN_PROVIDER=openai-codex
AKVAN_CODEX_AUTH_MODE=api-key
OPENAI_API_KEY=sk-...
AKVAN_MODEL=gpt-5.5

ورود از طریق Codex CLI

اگر از Codex CLI استفاده می‌کنید و قبلاً با codex login وارد شده‌اید، Akvan می‌تواند بدون وارد کردن مجدد کلید از فایل auth همان CLI استفاده کند. Akvan مسیرهای $CODEX_HOME/auth.json، سپس ~/.codex/auth.json و در نهایت ~/codex/auth.json را بررسی می‌کند. اگر ورود منقضی شده باشد، دوباره codex login را اجرا کنید یا حالت API key را انتخاب کنید.

برای تنظیم دستی حالت CLI:

env
AKVAN_PROVIDER=openai-codex
AKVAN_CODEX_AUTH_MODE=cli
AKVAN_MODEL=gpt-5.5

عیب‌یابی

مشکلاقدام
خطای احراز هویت در حالت CLIcodex login را اجرا کنید و بعد akvan model را دوباره باز کنید
API key استفاده نمی‌شودمطمئن شوید AKVAN_CODEX_AUTH_MODE=api-key تنظیم شده است
مدل در دسترس نیستنام مدل و دسترسی حساب OpenAI خود را بررسی کنید
خطای اتصالاتصال اینترنت را بررسی کنید؛ AKVAN_LOG_LEVEL=DEBUG akvan را اجرا کنید

امنیت

  • OPENAI_API_KEY و فایل auth مربوط به Codex CLI محرمانه هستند.
  • پیش از اشتراک log، مقدار key یا token را از خروجی حذف کنید.
گزارش مشکل مستندات