مستندات کدنویسی با Codex

Codex در ایران

Codex CLI را با کلید DaLAi و پرداخت ریالی راه بیندازید: نصب، فایل تنظیمات، انتخاب مدل و هزینۀ هر نوبت.

Codex CLI ابزار خط فرمان OpenAI برای کدنویسی با هوش مصنوعی است: در پوشۀ پروژه اجرا می‌شود، کد را می‌خواند، فایل‌ها را ویرایش می‌کند و دستور اجرا می‌کند. برای Codex در ایران به حساب OpenAI یا اشتراک نیاز ندارید: با کلید API DaLAi کار می‌کند و هزینه به اندازۀ توکن مصرفی از موجودی شما کم می‌شود. درخواست‌هایش هم به آدرس DaLAi در ایران می‌رود، پس برای آن‌ها تحریم‌شکن یا VPN لازم نیست.

این راهنما را با Codex CLI نسخۀ 0.167.0 روی همین درگاه تا انتها اجرا کرده‌ایم: فهرست فایل‌ها، ویرایش یک فایل و پاسخ درست، با هر مدلی که در جدول پایین آمده است.

Codex فقط گویش Responses را می‌فرستد (مسیر /v1/responses). DaLAi این گویش را با بیشتر مدل‌ها پاسخ می‌دهد، اما نه با همه؛ مدل‌هایی که با Codex آزموده‌ایم در بخش «کدام مدل» آمده‌اند.

نصب Codex CLI

Codex CLI با Node.js نصب می‌شود. اگر Node.js دارید:

npm install -g @openai/codex

پس از نصب، دستور codex --version شمارۀ نسخه را نشان می‌دهد. بستۀ npm روی ویندوز، macOS و Linux نصب می‌شود و همۀ فایل‌های همراه Codex را دارد.

کلید DaLAi در یک متغیر محیطی

Codex کلید را از یک متغیر محیطی می‌خواند، نه از فایل تنظیمات. نام متغیر را خودتان در تنظیمات می‌دهید؛ این راهنما DALAI_API_KEY را به کار می‌برد.

در PowerShell ویندوز، برای همین پنجره:

$env:DALAI_API_KEY="sk-YOUR-KEY"

و برای همیشه (پس از آن یک پنجرۀ تازه باز کنید):

setx DALAI_API_KEY "sk-YOUR-KEY"

در macOS و Linux:

export DALAI_API_KEY=sk-YOUR-KEY

برای اینکه در پنجره‌های بعدی هم بماند، همین خط را به ~/.zshrc یا ~/.bashrc اضافه کنید.

اتصال Codex به DaLAi با config.toml

تنظیمات Codex در فایل config.toml در پوشۀ .codex است: در macOS و Linux فایل ~/.codex/config.toml و در ویندوز %USERPROFILE%\.codex\config.toml. اگر فایل نیست بسازیدش، و اگر هست این خط‌ها را به آن اضافه کنید:

model = "gpt-5.5"
model_provider = "dalai"

[model_providers.dalai]
name = "DaLAi"
base_url = "https://dalai.ir/v1"
env_key = "DALAI_API_KEY"
wire_api = "responses"

سه نکته که اگر رعایت نشوند، کار نمی‌کند:

همین چند خط کافی است. مقدار wire_api تنها گویشی است که Codex می‌فهمد.

کدام مدل برای Codex؟

مدلکی
gpt-5.5پیش‌فرض مطمئن. Codex این مدل را می‌شناسد و ابزار ویرایش خودش را با آن به کار می‌برد
gpt-6-solنسل تازه‌تر و ارزان‌تر از gpt-5.5؛ Codex آن را هم می‌شناسد
gpt-5.6-terraنسل پیش از gpt-6-sol؛ Codex آن را هم می‌شناسد
gpt-5.2-codexمدل ویژۀ کد؛ کار می‌کند، با هشداری که پایین‌تر آمده
gpt-5.4-miniارزان، برای کارهای کوچک و پرتکرار
qwen3-coder-nextارزان‌ترین مدلی که آزموده‌ایم، از مدل‌های باز

قیمت هر مدل در فهرست مدل‌ها است. همه را آبان ۱۴۰۵ با Codex روی همین درگاه آزموده‌ایم.

مدل‌های Claude هم با Codex کار می‌کنند، اما دو کمبود دارند: Codex ابزار ویرایش خودش را برای آن‌ها نمی‌فرستد، و بخش تکراری هر نوبت از حافظۀ موقت (کش) خوانده نمی‌شود، پس هر نوبت با قیمت کامل حساب می‌شود. برای Claude، ابزار بهتر Claude Code است.

claude-sonnet-4-5 و claude-opus-4-5 با Codex کار نمی‌کنند و خطای ۴۰۰ با این متن برمی‌گردانند:

model claude-sonnet-4-5 does not support /v1/responses

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

نخستین اجرا

در پوشۀ پروژه دستور codex را اجرا کنید. با این تنظیمات Codex صفحۀ ورود به حساب نشان نمی‌دهد و مستقیم آمادۀ کار است. اگر مدل gpt-5.5 باشد، بار اول پیشنهاد می‌کند به gpt-6-sol بروید: هر دو گزینه با DaLAi کار می‌کنند.

برای یک کار بدون گفت‌وگو، مثلاً در یک اسکریپت:

codex exec "List the files in this folder"

دو خطا که در نخستین اجرا ممکن است ببینید:

unexpected status 401 Unauthorized: Invalid token
ERROR: Missing environment variable: `DALAI_API_KEY`.

اولی یعنی کلید درست نیست. دومی یعنی متغیر در همین پنجره تعریف نشده است؛ اگر آن را با setx گذاشته‌اید، یک پنجرۀ تازه باز کنید. خطاهای دیگر در خطاها و محدودیت‌ها آمده است.

برنامۀ دسکتاپ Codex در ویندوز

Codex در برنامۀ دسکتاپ ChatGPT ویندوز هم با همین تنظیمات به DaLAi وصل می‌شود: همان فایل config.toml و همان متغیر DALAI_API_KEY. آن را آبان ۱۴۰۵ با مدل gpt-5.6-sol روی همین درگاه آزموده‌ایم. سه نکته دربارۀ این برنامه:

هشدار Model metadata not found

برای مدل‌هایی که Codex مشخصاتشان را ندارد، مثل gpt-5.2-codex، gpt-5.4-mini، qwen3-coder-next و مدل‌های Claude، این هشدار را می‌بینید:

Model metadata for `gpt-5.2-codex` not found. Defaulting to fallback metadata

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

مدل‌های gpt-6-sol و gpt-5.6-terra در Codex به یک برنامۀ همراه به نام codex-code-mode-host نیاز دارند که بستۀ npm آن را نصب می‌کند. اگر Codex را به‌صورت یک فایل تکی گرفته‌اید و پیام Code Mode is unavailable دیدید، آن را با npm نصب کنید یا gpt-5.5 را بردارید.

هزینۀ Codex از کجا می‌آید؟

Codex در هر نوبت دستور سیستمی و تعریف ابزارهایش را دوباره می‌فرستد. در آزمایش ما هر نوبت ۷ تا ۱۰ هزار توکن ورودی داشت، پیش از آنکه فایلی از پروژه به آن اضافه شود. با مدل‌های GPT بیشتر این بخش تکراری (در آزمایش ما ۶۰ تا ۸۰ درصد) از حافظۀ موقت خوانده می‌شود که بسیار ارزان‌تر حساب می‌شود؛ با مدل‌های Claude نه. یک کار کوتاه پنج‌نوبتی با gpt-5.5 حدود یک‌دهم دلار از موجودی برداشت.

چرا کدنویسی از گفت‌وگو گران‌تر است و ابزارهای دیگر کدنویسی چطور تنظیم می‌شوند، در هوش مصنوعی برای برنامه‌نویسی آمده است.

پرسش‌های رایج

برای Codex حساب OpenAI یا اشتراک لازم است؟ نه. با کلید DaLAi کار می‌کند و هر درخواست به اندازۀ توکن مصرفی از موجودی کم می‌شود.

Codex در ایران بدون تحریم‌شکن کار می‌کند؟ درخواست‌هایی که Codex به مدل می‌فرستد به آدرس DaLAi می‌رود که در ایران است، پس برای آن‌ها تحریم‌شکن یا VPN لازم نیست.

کلید را کجا نگه دارم؟ فقط روی دستگاه خودتان و در متغیر محیطی. آن را در فایلی که در مخزن git پروژه است ننویسید، از جمله فایل .codex/config.toml داخل پروژه.

Codex یا Claude Code؟ برای مدل‌های GPT و مدل‌های باز، Codex؛ برای Claude، Claude Code.

جست‌وجوی وب Codex با DaLAi کار می‌کند؟ آن را نیازموده‌ایم. تنظیمات بالا بدون آن درست کار می‌کنند.