راه‌اندازی OpenAI Codex CLI در ایران با اندپوینت Responses کایا ای آی

چرا Codex روی کایا کار می‌کند؟

Codex CLI با پروتکل Responses کار می‌کند و درخواست را به مسیر POST /api/v1/responses می‌فرستد. کایا ای آی این اندپوینت را به‌صورت بومی پیاده کرده است؛ به همین دلیل نیازی به تغییر کد Codex یا پروکسی واسط ندارید.

با تعیین OPENAI_BASE_URL، Codex به‌جای سرور OpenAI، آدرس کایا را صدا می‌زند. اعتبار و مصرف هم مثل بقیه اندپوینت‌ها بر اساس توکن و به ریال از کیف پول شما کسر می‌شود.

• پشتیبانی بومی از POST /api/v1/responses (فرمت استاندارد پروتکل Responses)
• بدون نیاز به تغییر آی‌پی، پروکسی یا کارت ارزی
• انتخاب مدل از کاتالوگ کایا با متغیر OPENAI_MODEL یا فایل config.toml
• اعتبار، محدودیت نرخ و گزارش مصرف یکسان با سایر اندپوینت‌های کایا

پیش‌نیازها

node -v
npm install -g @openai/codex
codex --version

• Node.js نسخه ۲۰ یا بالاتر
• بسته OpenAI Codex CLI
• کلید API از پنل کلیدها
• اعتبار ریالی؛ با ۱۰۰ اعتبار هدیه ثبت‌نام شروع کنید

اتصال Codex CLI به کایا در سه گام

1. ۱

   متغیرهای محیطی را تنظیم کنید

   دو متغیر اصلی را در ترمینال بگذارید: OPENAI_BASE_URL آدرس کایا را مشخص می‌کند و OPENAI_API_KEY کلید شماست. سپس Codex را اجرا کنید.

   اتصال و اجراکپی

   export OPENAI_BASE_URL="https://kayaai.ir/api/v1"
   export OPENAI_API_KEY="sk-llm-YOUR_KEY"
   codex

   آدرس را بدون /responses بنویسید؛ خود Codex مسیر /responses را به Base URL اضافه می‌کند. اگر می‌خواهید پروتکل را صریح کنید، متغیر OPENAI_WIRE_API="responses" را هم تنظیم کنید.

2. ۲

   برای اجرای دائمی، فایل config.toml را بنویسید

   اگر نمی‌خواهید هر بار متغیرها را ست کنید، یک Provider اختصاصی برای کایا در ~/.codex/config.toml بسازید و از کلید خودتان با نام دلخواه (KAYA_API_KEY) استفاده کنید.

   ~/.codex/config.tomlکپی

   model = "anthropic/claude-sonnet-5.5"
   model_provider = "kayaai"
   
   [model_providers.kayaai]
   name = "Kaya AI"
   base_url = "https://kayaai.ir/api/v1"
   env_key = "KAYA_API_KEY"
   wire_api = "responses"

   کلید و اجراکپی

   export KAYA_API_KEY="sk-llm-YOUR_KEY"
   codex

   مقدار wire_api = "responses" را حتماً نگه دارید؛ این همان پروتکلی است که کایا پشتیبانی می‌کند.

3. ۳

   داخل یک پروژه واقعی اجرا کنید

   وارد پوشه پروژه شوید و Codex را اجرا کنید. می‌توانید مدل را در لحظه هم مشخص کنید:

   اجرای Codex روی پروژهکپی

   cd ~/projects/my-app
   codex --model anthropic/claude-sonnet-5.5

   Codex مثل یک عامل (agent) عمل می‌کند: فایل‌ها را می‌خواند، دستورها را اجرا می‌کند و تغییرات را با تأیید شما اعمال می‌کند.

تست اندپوینت Responses با cURL

برای اطمینان از درست کار کردن مسیر Responses، یک درخواست مستقیم بفرستید. فیلد input می‌تواند رشته ساده یا آرایه‌ای از آیتم‌های پیام باشد.

curl -X POST https://kayaai.ir/api/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-llm-YOUR_KEY" \
  -d '{
    "model": "anthropic/claude-sonnet-5.5",
    "input": "فقط بنویس: تست موفق",
    "max_output_tokens": 256
  }'

انتخاب مدل در Codex

• کارهای عامل‌محور و اجرای طولانی: openai/gpt-6.1-sol
• کدنویسی روزمره با کیفیت بالا: anthropic/claude-sonnet-5.5
• مصرف بالا با هزینه کم: deepseek/deepseek-v4.1-flash
• فهرست کامل: کاتالوگ مدل‌ها

عیب‌یابی و محدودیت‌ها