آموزش‌ها / آموزش Codex CLI با API سازگار با OpenAI (llmapi)

آموزش Codex CLI با API سازگار با OpenAI (llmapi)

به‌روزرسانی: 2026-10-06

Codex ایجنت برنامه‌نویسی OpenAI است که به‌صورت CLI، افزونهٔ IDE و اپ دسکتاپ عرضه می‌شود. هر سه از یک فایل تنظیمات (~/.codex/config.toml) می‌خوانند، پس با یک بار تنظیم، همه به llmapi وصل می‌شوند.

راه‌اندازی با یک دستور

macOS و Linux:

curl -fsSL https://llmapi.cheap/install.sh | sh

Windows (PowerShell):

irm https://llmapi.cheap/install.ps1 | iex

به Node.js نیازی نیست. دستور، کلید sk-llm-… شما را می‌پرسد، اعتبارش را بررسی می‌کند و ابزارهای نصب‌شده را تنظیم می‌کند. داشبورد همین دستور را با کلید شما نشان می‌دهد.

فقط Codex (macOS/Linux):

curl -fsSL https://llmapi.cheap/install.sh | sh -s -- --only codex

این دستور چه چیزهایی را تغییر می‌دهد؟

در ~/.codex/config.toml (یا $CODEX_HOME/config.toml):

  • مقدار model_provider = "llmapi" و model = "gemini-3.8-flash-high" در بالای فایل ست می‌شود.
  • بخش [model_providers.llmapi] اضافه یا جایگزین می‌شود.
  • توکن داخل خود فایل ذخیره می‌شود تا افزونهٔ IDE و اپ دسکتاپ هم بدون export کردن متغیر کار کنند.

بقیهٔ فایل دست نمی‌خورد و نسخهٔ پشتیبان config.toml.llmapi-backup ساخته می‌شود.

راه‌اندازی دستی

این را به ~/.codex/config.toml اضافه کنید:

model = "gemini-3.8-flash-high"
model_provider = "llmapi"

[model_providers.llmapi]
name = "llmapi"
base_url = "https://llmapi.cheap/v1"
wire_api = "responses"
experimental_bearer_token = "YOUR_API_KEY"

دقت کنید model و model_provider باید قبل از اولین جدول ([...]) در فایل بیایند. Codex از OpenAI Responses API استفاده می‌کند و آدرس پایه این‌جا با /v1 است.

تغییر مدل

  • داخل Codex دستور /model را بزنید.
  • یا هنگام اجرا: codex --model gemini-3.1-pro-high
  • یا مقدار model را در config.toml عوض کنید.

شناسه‌های قابل استفاده: gemini-3.8-flash-high، gemini-3.8-flash، gemini-3.8-flash-low، gemini-3-flash، gemini-3.1-pro-high، gemini-3.1-pro-low، claude-sonnet-4-6، claude-opus-4-6، gpt-oss-120b. مدل‌های Claude و GPT-OSS فقط در پلن‌های پولی فعال‌اند.

مشکلات رایج

  • Codex هنوز از حساب OpenAI استفاده می‌کند: خط model_provider = "llmapi" یا وجود ندارد یا بعد از یک جدول TOML آمده. آن را به بالای فایل ببرید.
  • خطای 401: کلید اشتباه است یا در experimental_bearer_token جا نیفتاده. کلید را از داشبورد دوباره کپی کنید.
  • خطای 404: آدرس پایه باید https://llmapi.cheap/v1 باشد، نه بدون /v1.
  • مدل مجاز نیست: در دورهٔ آزمایشی فقط مدل‌های Gemini در دسترس‌اند.
  • تغییرات اعمال نمی‌شود: Codex، افزونهٔ IDE یا اپ را کامل ببندید و دوباره باز کنید.

سؤالات متداول

افزونهٔ Codex در VS Code هم تنظیم می‌شود؟

بله. CLI، افزونهٔ IDE و اپ دسکتاپ همه همین config.toml را می‌خوانند.

می‌توانم Codex را با Claude استفاده کنم؟

بله، در پلن‌های پولی مدل claude-sonnet-4-6 یا claude-opus-4-6 را انتخاب کنید. همان provider به نام llmapi برای همهٔ مدل‌ها کار می‌کند و فقط مقدار model عوض می‌شود.

تنظیمات قبلی Codex از بین می‌رود؟

نه. فقط کلیدهای مربوط به llmapi اضافه یا جایگزین می‌شوند و نسخهٔ پشتیبان هم ساخته می‌شود.

شروع کنید

ثبت‌نام کنید و یک ساعت آزمایش رایگان با ۲ میلیون کردیت روی مدل‌های Gemini بگیرید؛ کلید API خودکار ساخته می‌شود. بعد دستور یک‌خطی را اجرا کنید. برای جزئیات بیشتر، راهنمای انگلیسی Codex CLI با provider سفارشی را ببینید.