کار حرفه‌ای با ابزارها

Codex CLI: روال کاری امن با sandbox، تأیید و بازبینی

تستحریریهٔ سرنخ۲۳ آبان ۱۴۰۵۳ دقیقه مطالعه

این نوشته مستقل است و به هیچ برندی وابسته نیست. اگر ابزاری را معرفی کنیم، دلیلش را هم می‌نویسیم. رویهٔ نوشتن · روش بررسی ابزارها

با 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، تأیید کار و مجوزها را ببین.

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

اشتراک‌گذاری:تلگرامواتس‌اپایکس
تس

تحریریهٔ سرنخ

تیم نویسندگان و آزمایشگران

ما چند نفریم که هر روز با ابزارهای هوش مصنوعی و اتوماسیون کار می‌کنیم. هر راهنمایی که اینجا می‌بینید اول روی کارِ خودمان امتحان شده و بعد نوشته شده است.

کار حرفه‌ای با ابزارهاراهنمای اصلی

کار مؤثر با ابزارهای هوش مصنوعی: پنج اصل مشترک

پنج اصل مشترک برای کار با Claude، Codex، Cursor، Copilot، NotebookLM و Perplexity: زمینه، برنامه، سنجش، زمینهٔ تمیز و مرز دسترسی. به‌همراه فهرست راهنماها.

۲۶ آبان ۱۴۰۵۳ دقیقه مطالعه