خانه → راهنماها → Codex با API سفارشی: تنظیم config.toml برای Codex CLI و نسخهٔ دسکتاپ

Codex با API سفارشی: تنظیم config.toml برای Codex CLI و نسخهٔ دسکتاپ

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

تنظیمات

یک ارائه‌دهنده به config.toml اضافه کنید و آن را پیش‌فرض کنید:

model = "gpt-6.1-sol"
model_provider = "apiclan"
model_reasoning_effort = "medium"

[model_providers.apiclan]
name = "APICLAN"
base_url = "https://apiclan.us/v1"
env_key = "APICLAN_API_KEY"
wire_api = "responses"

سه نکته مهم است. base_url با /v1 تمام می‌شود، چون Codex خودش /responses را اضافه می‌کند. wire_api = "responses" باعث می‌شود Codex از Responses API استفاده کند که این درگاه پشتیبانی می‌کند. و env_key نام یک متغیر محیطی است، نه خود کلید.

فایل کجاست

• macOS / Linux: ~/.codex/config.toml
• Windows: %USERPROFILE%\.codex\config.toml

اگر پوشه و فایل وجود ندارند، بسازیدشان. برنامهٔ دسکتاپ Codex همان فایلی را می‌خواند که ابزار خط فرمان می‌خواند، پس یک ویرایش برای هر دو کافی است. اگر نمی‌خواهید TOML را دستی ویرایش کنید، CC Switch می‌تواند آن را برایتان بنویسد — راهنمای برنامه‌های دسکتاپ را ببینید.

تنظیم کلید به‌گونه‌ای که Codex آن را ببیند

macOS / Linux — به پروفایل شِل اضافه کنید:

echo 'export APICLAN_API_KEY=sk-your-key' >> ~/.zshrc
source ~/.zshrc

Windows — برای حساب کاربری‌تان ذخیره کنید:

setx APICLAN_API_KEY "sk-your-key"

بیشتر تنظیمات همین‌جا خراب می‌شوند. متغیری که با export یا $env: تعریف شود فقط در همان ترمینال وجود دارد؛ برنامهٔ دسکتاپی که از Dock یا منوی Start باز شود هرگز آن را نمی‌بیند. setx در Windows آن را دائمی ذخیره می‌کند، اما فقط برنامه‌هایی که پس از آن اجرا شوند آن را می‌خوانند — Codex را کامل ببندید و دوباره باز کنید.

انتخاب مدل و سطح استدلال

model را در تنظیمات تغییر دهید یا درون جلسه با /model عوض کنید:

مدل	مناسب برای
gpt-6.1-sol, gpt-5.6-terra	برنامه‌نویسی روزمره، ویرایش، تست — ارزان‌ترین برای هر فراخوانی
gpt-5.6-sol	وقتی پرامپت‌هایتان برای GPT-5.6 تنظیم شده‌اند
gpt-6-astra	مسائل دشواری که پاسخ بهتر ارزش پنج برابر قیمت را دارد

model_reasoning_effort مقادیر low، medium، high و xhigh را می‌پذیرد. سطح بالاتر بیشتر می‌نویسد: در اینجا روی gpt-5.6-sol، فراخوانی میانه با high ۳۷۳ توکن خروجی و با medium ۱۳۹ توکن برگرداند — ۲٫۷ برابر، که همه به‌عنوان خروجی حساب می‌شود. از medium شروع کنید. قیمت‌ها در راهنمای قیمت API شرکت OpenAI آمده است.

ترافیک Codex در اینجا

در ۳۰ روز گذشته، ۸۷٪ همهٔ فراخوانی‌های GPT در این درگاه از Codex بود و همه از طریق /v1/responses به‌صورت جریانی. فراخوانی میانه:

• حدود ۶۷٬۰۰۰ توکن زمینه داشت که ۸۶٪ آن از کش بود
• در مجموع ۱۴ ثانیه طول کشید و نخستین توکن پس از ۱۰ ثانیه رسید
• ۲۱۴ توکن خروجی برگرداند

چهار خطای رایج

• 401 Unauthorized ← Codex متغیر APICLAN_API_KEY را نمی‌بیند. آن را مانند بالا تنظیم کنید و Codex را کامل دوباره اجرا کنید. اجرای echo $APICLAN_API_KEY در همان محیط باید کلید را نشان دهد.
• 404 یا یک صفحهٔ HTML ← در base_url مقدار /v1 نیست یا دو بار آمده است.
• model not found ← نام مدل اشتباه نوشته شده یا کلید شما به گروهی تعلق دارد که آن مدل را ندارد. فهرست معتبر، خروجی GET https://apiclan.us/v1/models است.
• stream disconnected یا پایان مهلت در کارهای طولانی ← استدلال بسیار طولانی از صبر پراکسی فراتر می‌رود. base_url را به https://api.apiclan.us/v1 تغییر دهید که محدودیت ۱۰۰ ثانیه‌ای را دور می‌زند.

Claude Code قاعدهٔ برعکس دارد — بدون /v1 — که در راهنمای base URL برای Claude Code توضیح داده شده است.

شروع به استفاده کنید

بدون اشتراک، بدون حداقل ماهانه، بدون تماس فروش. با USDT شارژ کنید و فقط به‌اندازهٔ مصرف بپردازید — 1 USDT برابر 2 اعتبار موجودی API است.

راهنمای 30 ثانیه‌ای شروع سریع را بخوانید

زبان: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

قیمت‌های این صفحه به‌طور خودکار از داده‌های واقعی صورتحساب پر می‌شوند. شرایط اشخاص ثالث از مستندات خودشان نقل شده است.