با Codex CLI چهار قدم کار را امنتر میکند: اول مرز دسترسی (sandbox) را انتخاب کن، قبل از ویرایش بگذار برنامه بنویسد، بعد از کار تغییرات را با /review ببین و پیش و پس از کار نقطهٔ Git بساز. Codex از ترمینال کد را میخواند، ویرایش میکند و اجرا میکند؛ پس مرزهایش اهمیت دارد.
بر پایهٔ مستندات رسمی Codex در ۲۶ آبان ۱۴۰۵. بخشهایی مثل Cloud و افزونهٔ IDE را نخواندهایم و دربارهٔ آنها نمینویسیم.
مرز دسترسی: sandbox و تأیید
مستندات دو مفهوم را جدا میکند: sandbox مرز فنی است و سیاست تأیید تعیین میکند چه وقت از تو بپرسد.
- حالتهای sandbox:
read-only(فقط خواندن)،workspace-write(نوشتن در فضای کار؛ حالت کماصطکاک برای کار محلی) وdanger-full-access(بدون مرز فایل و شبکه). - سیاست تأیید:
on-request(در مرز sandbox کار میکند و برای بیرون از آن میپرسد) وnever(هرگز نمیپرسد).
قاعدهٔ ما: برای کار روزمره workspace-write با on-request. danger-full-access با never را فقط در محیط یکبارمصرف استفاده کن. دستور /permissions در CLI همینها را تغییر میدهد.
قبل از ویرایش: /plan
/plan Codex را وامیدارد پیش از ویرایش بررسی کند و رویکردی پیشنهاد دهد. مستندات برای بازآرایی (refactor) پیشنهاد میکند برنامهای با راه بازگشت بخواهی.
یک دستور خوب چه دارد؟
مستندات میگوید دستور باید هدف، زمینه، خروجی و مرزها را پوشش دهد (هرکدام که کمک میکند). نکتههای ویژهٔ Codex:
- رفتار را نام ببر.
- به کد مرتبط یا مراحل بازتولید اشاره کن.
- محدودیتها را حفظ کن.
- بگو چطور سنجیده شود.
برای باگ، یک تست بازگشتی «اگر ممکن است» بخواه؛ برای کد جدید، تستی مطابق قراردادهای موجود. «کوچکترین مجموعهٔ تست مرتبط» و لینت را اجرا کن، نه کل پروژه را.
فایلها را با @ بده
در CLI با @ یا /mention فایل را ضمیمه کن. در افزونهٔ IDE فایلهای باز خودکار وارد میشوند. دستورهای ثابت پروژه را هم در AGENTS.md بنویس.
بعد از کار: /review
/review تغییرات را بازبینی میکند: نسبت به شاخهٔ پایه (مثل PR)، تغییرات ثبتنشده، یک commit یا با دستور دلخواه. مستندات تصریح میکند فقط یافتهها را با اولویت گزارش میدهد و پوشهٔ کاری را تغییر نمیدهد.
نقطهٔ Git قبل و بعد
مستندات توصیه میکند پیش و پس از هر کار یک نقطهٔ Git بسازی تا بتوانی تغییرات را برگردانی. ما یک commit ساده یا شاخهٔ جدا پیشنهاد میکنیم.
ابزارهای دیگر CLI
codex execبرای اجرا در اسکریپت و CI.codex resumeبرای ادامهٔ کار./statusبرای دیدن تنظیمات جلسه و/modelبرای انتخاب مدل و میزان استدلال.
اگر ویرایشی را خودت برگرداندی
به Codex بگو؛ در غیر این صورت ممکن است دوباره همان را بنویسد. مستندات این را هم صریح یادآوری میکند.
ایمنی
دستور ناشناس را بدون خواندن اجرا نکن و رمز را در دستور نگذار. نکتههای بیشتر در راهنمای استفادهٔ مسئولانه است. برای مقایسه با Claude Code، تأیید کار و مجوزها را ببین.
سوالات متداول
راهنمای اصلی این بخش
کار مؤثر با ابزارهای هوش مصنوعی: پنج اصل مشترکتحریریهٔ سرنخ
تیم نویسندگان و آزمایشگران
ما چند نفریم که هر روز با ابزارهای هوش مصنوعی و اتوماسیون کار میکنیم. هر راهنمایی که اینجا میبینید اول روی کارِ خودمان امتحان شده و بعد نوشته شده است.