Codex عامل کدنویسی OpenAI است؛ مناسب وقتی task تو روی repo واقعی، تغییر code، review، اجرای work itemهای توسعه و کنترل سریع با دستورهای / متمرکز است.
اکوسیستم OpenAI
Codex
OpenAI Codex چیست؟ Codex برای ساخت، فهمیدن، review کردن و debug کردن code در یک repository واقعی ساخته شده است و در دسترسِ worktree، cloud و slash commandها هم ممکن است قرار بگیرد.
عامل کدنویسی و automation روی repository واقعی
خلاصه عملی
تعریف و شروع
نصب و شروع عملی
Codex را از مسیر رسمی باز کن یا CLI را نصب کن، بعد روی یک repository واقعی با یک task کوچک شروع کن.
- دسترسی رسمی به Codex در ChatGPT یا API
- Git
- یک repository واقعی برای تست
نصب Codex CLI
curl -fsSL https://chatgpt.com/codex/install.sh | shبعد از ورود یا نصب، داخل یک repo واقعی یک task کوچک مثل توضیح ساختار پروژه، پیدا کردن باگ یا refactor محدود اجرا کن و بعد /review و /status را چک کن.
دستورها
دستورهای / در Codex
وقتی داخل Codex یا ChatGPT desktop app در بخش Codex علامت / را میزنید، میتوانید سریعتر mode، مدل، reasoning، پروژه، worktree، review، cloud یا وضعیت task را کنترل کنید. این دستورها برای مدیریت پروژههای واقعی برنامهنویسی، review کد، اجرای taskهای طولانی و کنترل context کاربرد دارند.
بعضی commandها بسته به plan، محیط، desktop app، cloud، workspace یا دسترسی کاربر ممکن است دیده نشوند. custom promptها ممکن است به شکل /prompts:<name> نمایش داده شوند و skillهای فعال هم میتوانند داخل فهرست slash commandها ظاهر شوند.
| دستور | توضیح |
|---|---|
| /approve | تأیید یک تلاش دوباره بعد از رد شدن auto-review، وقتی automatic review فعال است. |
| /cloud | اجرای task در cloud، اگر cloud execution برای حساب یا workspace فعال باشد. |
| /cloud-environment | انتخاب environment ابری برای اجرای task. |
| /compact | خلاصهسازی و فشردهکردن context فعلی برای ادامه کار بدون شلوغی زیاد. |
| /fast | روشن یا خاموش کردن tier سریع، اگر در سرویس فعال باشد. |
| /feedback | باز کردن فرم feedback و ارسال گزارش، در صورت نیاز همراه با log. |
| /fork | کپیکردن task فعلی به یک task یا worktree جدید. |
| /goal | تعریف یک هدف پایدار برای اینکه Codex تا رسیدن به نتیجه روی آن کار کند. |
| /ide-context | روشن یا خاموش کردن context اشتراکی IDE. |
| /init | ساخت scaffold اولیه AGENTS.md برای پروژه. |
| /local | اجرای task در پروژه local انتخابشده. |
| /mcp | نمایش وضعیت MCP serverهای متصل. |
| /memories | تنظیم اینکه task بتواند از memory استفاده کند یا memory بسازد. |
| /model | انتخاب مدل برای task فعلی. |
| /pet | نمایش یا مخفی کردن desktop pet. |
| /personality | انتخاب سبک پاسخگویی Codex، اگر مدل فعلی پشتیبانی کند. |
| /plan | فعال کردن plan mode برای برنامهریزی چندمرحلهای قبل از اجرا. |
| /project | انتخاب project برای task جدید. |
| /reasoning | انتخاب سطح reasoning برای task فعلی. |
| /review | شروع code review برای تغییرات commit نشده یا مقایسه با base branch. |
| /side | شروع گفتوگوی جانبی موقت بدون قطع task اصلی. |
| /status | نمایش task ID، میزان مصرف context و rate limit. |
| /task | شروع task بدون انتخاب project. |
| /worktree | اجرای task داخل Git worktree جدید. |
قابلیتها
قابلیتهای اصلی
Code generation
نوشتن feature، refactor و اسکریپت کد.
Repo understanding
فهم ساختار repository و context پروژه.
Debugging
ردیابی باگ و پیشنهاد اصلاح.
Task execution
انجام وظایف توسعه بهصورت مرحلهای.
Developer workflow
همراهی با review، automation و guardrailهای تیم.
تفاوت
این بخش را کی انتخاب کنیم
Codex ↔ ChatGPT
ChatGPT برای تعامل عمومی است؛ Codex برای repo-aware coding و task execution است.
Codex ↔ Responses API
Responses API کنترل backend میدهد؛ Codex برای workflow توسعه و تغییر کد است.
Codex ↔ Agents SDK
Agents SDK orchestration را میدهد؛ Codex روی coding automation تمرکز دارد.
شروع
نصب و شروع عملی
Codex را با quickstart رسمی نصب کن
برای شروع، نصب رسمی را انجام بده و بعد روی یک repo واقعی اولین task را اجرا کن.
- Git
- یک repository واقعی برای تست
- دسترسی به docs رسمی Codex
بعد از نصب، داخل پروژه `codex` را اجرا کن و یک task کوچک مثل fix bug یا refactor محدود تعریف کن.
اولین task را کوچک نگه دار
اولین اجرا باید روی یک task واضح و کوچک باشد تا رفتار Codex را در repo خودت ببینی.
- یک task مشخص
- امکان review کردن diff
- یک branch یا checkout تمیز
روی همان repository یک task کوچک تعریف کن، diff را review کن و خروجی را در repo validate کن.
مثال
مثال واقعی
repo-aware coding workflow
Codex را روی یک repo واقعی میگذاری تا code generation، debugging و task execution را با context همان پروژه ببیند.
- یک repository واقعی را باز کن.
- Codex را در همان پوشه اجرا کن.
- یک task کوچک مثل fix bug یا refactor تعریف کن.
- diff را review کن و خروجی را در repo validate کن.
این همان چیزی است که OpenAI در use caseهای رسمی Codex به آن اشاره میکند: از idea تا proof of concept و task execution روی کد واقعی.
خطاهای رایج
اشتباهات رایج
Codex را مثل ChatGPT استفاده نکن
Codex برای repo-aware coding workflow است، نه چت عمومی.
بدون repo شروع نکن
اگر کد و context واقعی ندهی، ارزش اصلی Codex را از دست میدهی.
اولین task را بزرگ نکن
با یک تغییر کوچک، debug یا refactor محدود شروع کن.
رسمی
لینکهای رسمی
اکوسیستم
اجزای مرتبط
منابع