
آموزش اوپن کد یعنی آشنا شدن با دستیار هوش مصنوعی متن بازی که مستقیماً داخل ترمینال اجرا می شود. OpenCode یا همان اوپن کد، عامل کدنویسی است که فایل های پروژه شما را می خواند، تحلیل می کند و در صورت تایید، کد را تغییر می دهد. بنابراین نیازی به ترک محیط کار یا نصب نرم افزار سنگین ندارید. در ادامه مراحل نصب، راه اندازی و استفاده عملی از آن را بررسی می کنیم.
این ابزار از بیش از ۷۵ ارائه دهنده هوش مصنوعی پشتیبانی می کند. برای مثال می توانید از Gemini، Anthropic یا OpenAI استفاده کنید. همچنین نسخه رایگان Gemini برای شروع کاملاً کافی است. در نتیجه یک توسعه دهنده یا مدیر سرور می تواند بدون پرداخت هزینه، کار با دستیار هوش مصنوعی را تجربه کند.
آموزش اوپن کد چیست و چرا باید آن را امتحان کنید؟
اوپن کد برخلاف چت بات های ساده، تمام پروژه شما را در نظر می گیرد. این ابزار می تواند چند فایل را همزمان بررسی کند و ارتباط میان آن ها را درک نماید. علاوه بر این، با نوشتن @ و نام فایل، مشخص می کنید که مدل دقیقاً کدام قسمت را ببیند. بنابراین پاسخ ها مرتبط تر و دقیق تر می شوند.
اگر از پیش با خط فرمان آشنا هستید، یادگیری آن آسان است. در واقع کافی است بدانید چگونه یک دستور اجرا و خروجی آن را بخوانید. پیشنهاد می کنیم ابتدا نگاهی به ابزارهای خط فرمان لینوکس بیندازید تا تسلط بیشتری پیدا کنید.
پیش نیازها و مخاطبان این راهنما
برای شروع آموزش اوپن کد به سه چیز نیاز دارید. نخست، پایتون نسخه ۳.۱۱ یا بالاتر. دوم، یک ترمینال مدرن. سوم، حساب کاربری نزد یک ارائه دهنده هوش مصنوعی. البته نصب خود ابزار وابسته به پایتون نیست و روی بیشتر سیستم ها کار می کند.
همچنین دانستن مفاهیم اولیه پایتون کمک می کند تا اصلاحات پیشنهادی مدل را بهتر قضاوت کنید. با این حال نگران نباشید؛ مثال ما یک اسکریپت ساده تاس اندازی است. بنابراین حتی کاربر تازه کار هم می تواند مراحل را دنبال کند.
نصب OpenCode در لینوکس، مک و ویندوز
سریع ترین روش نصب، اجرای اسکریپت رسمی است. این اسکریپت سیستم عامل را تشخیص می دهد، فایل مناسب را دانلود می کند و مسیر اجرایی ابزار را تنظیم می نماید.
آموزش اوپن کد با اسکریپت رسمی، Homebrew و npm
curl -fsSL https://opencode.ai/install | bash
brew install anomalyco/tap/opencode
npm install -g opencode-ai
opencode --version
پس از نصب، دستور opencode –version باید شماره نسخه ای مانند 1.14.20 را نشان دهد. اگر خطایی دیدید، تنظیمات پوسته را دوباره بارگذاری کنید. برای مثال در لینوکس از source ~/.bashrc و در مک از source ~/.zshrc استفاده کنید. در صورت نیاز، مسیر ~/.opencode/bin را به PATH اضافه نمایید. جزئیات کامل در مستندات رسمی اوپن کد موجود است.
نصب در ویندوز با WSL و رفع خطای PATH
کاربران ویندوز بهتر است نخست WSL را نصب کنند و سپس داخل آن همان دستور curl را اجرا نمایند. توصیه می شود پروژه خود را داخل فایل سیستم WSL نگه دارید تا سرعت کار بهتر شود. سپس با دستور opencode –version سلامت نصب را بررسی کنید.
mkdir dice-project
cd dice-project
touch dice.py
در نتیجه یک پوشه خالی دارید که می توانید اسکریپت نمونه را داخل آن قرار دهید.
آموزش اوپن کد: اتصال به Gemini و انتخاب مدل
با اجرای دستور opencode، رابط متنی ابزار باز می شود. اکنون /connect را تایپ کنید و از فهرست ارائه دهنده ها، گوگل را انتخاب نمایید.
دریافت کلید API رایگان از Google AI Studio
به Google AI Studio بروید، با حساب گوگل خود وارد شوید و یک کلید API بسازید. سپس کلید را کپی کنید و آن را داخل ترمینال بچسبانید. این اطلاعات در مسیر ~/.local/share/opencode/auth.json ذخیره می شوند و دوباره پرسیده نخواهند شد.
مدل پیش فرض، Gemini 3 Flash Preview است. با دستور /models می توانید فهرست مدل ها را ببینید و گزینه دیگری را انتخاب کنید. علاوه بر این، نوع تفکر مدل را با Ctrl+T تغییر دهید. بهتر است گزینه Default را نگه دارید تا ابزار به طور خودکار میزان تفکر را با پیچیدگی کار هماهنگ کند.
برای آزمایش اولیه، یک سوال ساده بپرسید. برای مثال بپرسید تفاوت append و extend در لیست پایتون چیست. سپس پاسخ مدل را بررسی کنید. در صورتی که پاسخی دریافت کردید، اتصال با موفقیت انجام شده است.
آشنایی با رابط ترمینالی و دستورات اسلش
رابط کاربری ابزار شامل چند میانبر مفید است. با Tab میان حالت های Plan و Build جابه جا می شوید. همچنین Ctrl+P فهرست دستورات را نمایش می دهد. علاوه بر این، با نوشتن @ و نام فایل، محتوای آن فایل را به عنوان زمینه به مدل اضافه می کنید.
میانبرها و دستورات پرکاربرد
| دستور | کاربرد |
|---|---|
| /init | ساخت فایل AGENTS.md |
| /new | شروع جلسه تازه |
| /undo | لغو آخرین تغییر |
| /compact | خلاصه کردن جلسه |
| /help | نمایش راهنما |
همچنین می توانید با شروع پیام به علامت ! یک دستور شل اجرا کنید. خروجی آن دستور به گفتگو اضافه می شود. بنابراین نیازی به کپی کردن دستی خروجی ها ندارید. اگر به تمرین بیشتر با دستورات شل علاقه دارید، مطلب دستورات wget در لینوکس را هم ببینید.
آموزش اوپن کد برای تحلیل و بهبود پروژه پایتون
اکنون اسکریپت تاس اندازی را در پوشه dice-project قرار دهید. سپس در همان پوشه دستور opencode را اجرا نمایید. ابزار ساختار پروژه را بررسی می کند و زمینه لازم را در اختیار مدل می گذارد.
آموزش اوپن کد برای ساخت فایل AGENTS.md
در حالت Build دستور /init را اجرا کنید. این دستور نام فایل ها، ایمپورت ها و ساختار پوشه ها را بررسی می کند و فایل AGENTS.md می سازد. این فایل قواعدی مانند سبک نامگذاری، نحوه نوشتن docstring و دستورات تست را مشخص می نماید.
/init
python dice.py
pytest
پس از ویرایش دستی فایل AGENTS.md، از مدل بخواهید دوباره آن را بخواند. سپس جلسه تازه ای آغاز کنید تا قواعد جدید بارگذاری شوند. در ادامه قواعد مخصوص پایتون را به انتهای فایل اضافه نمایید. برای مثال بنویسید که توابع حتماً type hint داشته باشند و از except ساده استفاده نشود. در نتیجه مدل هنگام اصلاح کد، این قواعد را رعایت می کند.
حالت Plan و Build و نحوه بازگشت تغییرات
همیشه پیش از تغییرات بزرگ، حالت Plan را انتخاب کنید. در این حالت ابزار فقط پیشنهاد می دهد و فایلی را تغییر نمی دهد. سپس پیشنهاد را بررسی کنید و در صورت تایید، با Tab به حالت Build بروید. اگر نتیجه مناسب نبود، دستور /undo تغییر آخر را پس می گیرد.
برای مثال ابزار پیشنهاد می دهد که کد اجرایی داخل تابع main قرار گیرد و با if __name__ == “__main__” محافظت شود. همچنین می تواند ثابت های MIN_DICE و MAX_DICE را تعریف کند و type hint به توابع اضافه نماید. علاوه بر این، خطاها را به ValueError تبدیل می کند تا مدیریت آن ها ساده تر شود.
قابلیت های پیشرفته: تعویض مدل، LSP و رابط وب
در ادامه آموزش اوپن کد، سه قابلیت پیشرفته را بررسی می کنیم. این قابلیت ها کار روزمره را ساده تر می نمایند.
یکی از ویژگی های جالب، تعویض مدل در میان جلسه است. کافی است /connect یا /models را اجرا کنید تا مدل دیگری انتخاب نمایید. نیازی به شروع مجدد جلسه نیست. بنابراین می توانید همان سوال را با دو مدل مختلف مقایسه کنید.
همچنین بیش از ۳۰ سرور زبانی داخلی وجود دارد. سرور Pyright به طور پیش فرض برای پایتون فعال است و خطاهای نوع، نام های تعریف نشده و مشکلات ایمپورت را تشخیص می دهد. سپس ابزار این اطلاعات را مستقیماً به مدل می دهد. در نتیجه تحلیل کد دقیق تر می شود.
اگر نمایشگر بزرگ تری نیاز دارید، دستور opencode web را اجرا کنید. این دستور یک سرور محلی روی 127.0.0.1 راه اندازی می کند و رابط وب را باز می نماید. علاوه بر این، جلسات و وضعیت شما میان ترمینال و مرورگر مشترک است.
نکات امنیتی و عیب یابی رایج
یک نکته مهم در آموزش اوپن کد، حفظ امنیت کلید API است. آن را هرگز در فایل های پروژه یا مخزن git قرار ندهید. ابزار آن را در مسیر مشخصی ذخیره می کند، پس از همان مکان استفاده کنید. همچنین پیش از تایید تغییرات گسترده، حتماً حالت Plan را فعال نگه دارید.
اگر دستور opencode پیدا نشد، مسیر PATH را بررسی کنید. اگر پاسخی از مدل نرسید، اتصال و کلید API را دوباره تنظیم نمایید. در نهایت، همیشه تغییرات را در یک مخزن git نگه دارید تا در صورت لزوم بتوانید به نسخه قبلی برگردید.
خلاصه؛ آموزش اوپن کد از نصب تا اصلاح کد
در این مطلب دیدیم که نصب ابزار ساده است و اتصال به Gemini تنها چند دقیقه طول می کشد. سپس با فایل AGENTS.md قواعد پروژه را مشخص کردیم و با حالت Plan و Build کد را بازبینی نمودیم. در نتیجه می توانید یک دستیار هوش مصنوعی رایگان و متن باز را وارد جریان کاری خود کنید. همین امروز آن را امتحان کنید و تفاوت را در پروژه بعدی خود مشاهده نمایید.
