‏مفاهیم پایه‌ی OpenAI Codex به زبون ساده

OpenAI Codex یه ایجنت کدنویسیه (یعنی ابزاری که خودش دستور اجرا می‌کنه و کار چندمرحله‌ای انجام می‌ده، نه فقط جواب بده). فرق اصلیش با ChatGPT یا نسخه‌ی وب Claude اینه که هر چت از صفر شروع نمی‌شه. Codex از یه پوشه روی کامپیوتر یا تو کلاد کار می‌کنه که توش اطلاعات شما، کارتون و انتظاراتتون نگه داشته می‌شه. این مقاله چندتا مفهوم پایه‌ی Codex رو برای تازه‌کارها توضیح می‌ده.

اولیش Project هست که در واقع فقط یه مجموعه پوشه و فایله. مثلا یه پروژه برای کل کسب‌وکار، یکی برای اپی که می‌سازید و یکی برای یه آزمایش. هر پروژه می‌تونه قوانین، credentialها، تاریخچه‌ی چت‌ها و اسناد رو نگه داره. چون Codex به همه‌ی این‌ها دسترسی داره، به سوالی مثل «این ماه روی چی کار کردیم» با نگاه کردن به فایل‌ها جواب می‌ده، نه با حدس زدن. یعنی دیگه لازم نیست هر بار کسب‌وکارتون رو از اول توضیح بدید.

دومی agents.md هست، یه فایل markdown ساده که قوانین پروژه توشه و هر کسی می‌تونه بازش کنه و بخونه. معمولا شامل اینه که ایجنت برای کی کار می‌کنه، قوانین رفتاری، محدودیت‌های امنیتی برای دسترسی به دسکتاپ، و یه «نقشه‌ی مسیر» که می‌گه هر نوع اطلاعات کجای پوشه‌هاست. وقتی پیام می‌فرستید، Codex اول agents.md رو می‌خونه، بعد پیامتون رو و بعد جواب می‌ده. پس قوانین خودکار تو هر تعامل اعمال می‌شن.

سومی agent loop هست، یعنی چرخه‌ی فکر کن، اقدام کن، جواب بده. Codex درباره‌ی کار فکر می‌کنه، ابزار لازم رو انتخاب می‌کنه، دستور اجرا می‌کنه، نتیجه رو بررسی می‌کنه و این چرخه رو تکرار می‌کنه. Claude Code هم همین‌طوری کار می‌کنه. نویسنده می‌گه چون این مراحل قابل دیدنه، نگاه کردن بهشون یکی از بهترین راه‌ها برای یاد گرفتن پرامپت‌نویسی بهتره.

چهارمی slash goal هست. به‌جای یه لیست قدم‌به‌قدم، به Codex یه هدف می‌دید و اون اون‌قدر تلاش و اصلاح می‌کنه تا به هدف برسه. هدف‌های قابل‌اندازه‌گیری (مثلا تعداد مشخص منبع یا خروجی) بهتر جواب می‌دن، چون ایجنت دقیق می‌دونه کی کار تمومه. تو یه نمونه، Codex یه سری موشن‌گرافیک برای ویدیو ساخت و با گرفتن اسکرین‌شات خروجی خودش رو چک کرد. نویسنده معتقده با قوی‌تر شدن مدل‌ها، ریز به ریز دستور دادن جلوشون رو می‌گیره، البته وقتی کار پرریسک نباشه.

مقاله فرق local و کلاد رو هم توضیح می‌ده: خروجی‌ای که Codex روی localhost سرو می‌کنه فقط روی همون سیستم باز می‌شه و اگه لینکش رو برای کسی بفرستید چیزی نمی‌بینه. برای مهاجرت از Claude Code هم کافیه فایل claude.md رو به agents.md تغییر اسم بدید و تنظیمات رو به پوشه‌های معادل منتقل کنید. Codex می‌تونه خودش این کارو انجام بده.

نکات کلیدی:

• پروژه تو Codex فقط یه پوشه از فایل‌هاست که ایجنت ازش context می‌خونه.
• فایل agents.md قبل از هر پیام خونده می‌شه و قوانین پروژه رو نگه می‌داره.
• agent loop چرخه‌ی فکر، اقدام و بررسیه که تا تموم شدن کار تکرار می‌شه.
• slash goal به‌جای دستور قدم‌به‌قدم یه هدف می‌ده و هدف‌های قابل‌اندازه‌گیری نتیجه‌ی بهتری دارن.
• لینک localhost فقط روی همون سیستمی باز می‌شه که Codex روش اجرا شده.
• مهاجرت از Claude Code بیشتر یعنی تغییر اسم claude.md به agents.md.