تسلط بر OpenCode: راهنمای نهایی برای کدنویسی هوش مصنوعی Local-First

OpenCode چیزی بیش از یک دستیار کدنویسی هوش مصنوعی دیگر است. این یک عامل کدنویسی خودکار local-first است که برای عمل کردن به عنوان یک برنامه‌نویس جفت واقعی طراحی شده است. برخلاف ابزارهای تکمیل خودکار ساده، OpenCode کل مخزن شما را درک می‌کند، برای بازسازی‌های پیچیده برنامه‌ریزی می‌کند و دستورات ترمینال را اجرا می‌کند — همه اینها در حالی است که کد شما را در دستگاه خودتان ایمن نگه می‌دارد.

در این راهنمای نهایی، ما همه چیزهایی را که برای رفتن از صفر تا تسلط بر پیشرفته‌ترین ویژگی‌های OpenCode نیاز دارید، پوشش خواهیم داد.

1. نصب: دروازه شما به سوی کدنویسی خودکار

شروع کار به گونه‌ای طراحی شده است که بدون اصطکاک باشد. OpenCode به صورت بومی در ترمینال شما اجرا می‌شود، به این معنی که هر کجا که کار می‌کنید کار می‌کند — چه VS Code، JetBrains یا یک پوسته مستقل.

نصب سریع (Mac, Linux, Windows WSL)

سریع‌ترین راه برای نصب از طریق اسکریپت رسمی ما است:

curl -fsSL "https://opencode.ai/install" | bash

جایگزین: بسته npm

اگر ترجیح می‌دهید ابزارها را از طریق Node.js مدیریت کنید، می‌توانید OpenCode را به صورت سراسری نصب کنید:

npm install -g opencode-ai

پس از نصب، به سادگی opencode را تایپ کنید تا نصب را تأیید کرده و رابط کاربری را راه‌اندازی کنید.

2. مدل‌ها و ارائه‌دهندگان: انتخاب نامحدود (BYOK)

یکی از فلسفه‌های اصلی OpenCode بی‌طرفی مدل است. ما شما را در یک مدل "جعبه سیاه" واحد حبس نمی‌کنیم. در عوض، به شما اجازه می‌دهیم کلیدهای خود را بیاورید (BYOK) یا به اشتراک‌های هوش مصنوعی موجود خود متصل شوید.

احراز هویت

برای اتصال ارائه‌دهنده مدل مورد نظر خود، اجرا کنید:

opencode auth login

این دستور تعاملی شما را برای ورود با موارد زیر راهنمایی می‌کند:

• Anthropic (Claude 4.5 Sonnet, Opus)
• OpenAI (GPT-5, o1-preview)
• Google (Gemini 3 Pro, 1.5 Pro)
• Models.dev (دسترسی به بیش از 75 مدل منبع باز و میزبانی شده)

مدیریت مدل‌ها

بسته به وظیفه می‌توانید مدل‌ها را در لحظه تغییر دهید. از یک مدل سریع‌تر برای اصلاحات ساده و یک مدل استدلال قوی‌تر برای برنامه‌ریزی معماری استفاده کنید.

# لیست کردن تمام مدل‌های موجود
opencode models

# تازه کردن لیست مدل‌ها پس از افزودن یک ارائه‌دهنده جدید
opencode models --refresh

محلی شدن با Ollama

برای حفظ حریم خصوصی نهایی و قابلیت آفلاین، OpenCode از مدل‌های محلی از طریق Ollama پشتیبانی می‌کند. OpenCode را به نمونه محلی خود هدایت کنید تا بدون خروج هیچ داده‌ای از شبکه خود کدنویسی کنید — ایده‌آل برای محیط‌های سازمانی یا کار روی مالکیت معنوی حساس.

3. گردش کار اصلی: تعاملی در مقابل یک‌باره

OpenCode با نحوه کار شما سازگار می‌شود.

جلسه تعاملی

قدرتمندترین راه برای استفاده از OpenCode یک جلسه تعاملی است. opencode را در ریشه پروژه خود اجرا کنید تا وارد یک محیط چت پایدار شوید.

• آگاه از زمینه: عامل ساختار فایل و سیگنال‌های LSP شما را می‌خواند.
• چند نوبتی: می‌توانید برنامه را اصلاح کنید، درخواست اصلاح کنید و تکرار کنید.
• استفاده از ابزار: عامل می‌تواند به طور خودکار فایل‌ها را بخواند، کد را ویرایش کند و تست‌ها را اجرا کند.

دستور یک‌باره (One-Off)

برای وظایف سریع که در آن به یک مکالمه کامل نیاز ندارید، از opencode run استفاده کنید. این برای دستورالعمل‌های "شلیک کن و فراموش کن" عالی است.

# خلاصه کردن پایگاه کد و پیشنهاد بهبودها
opencode run "Analyze this codebase and propose a refactoring plan for performance"

# اصلاح سریع
opencode run "Fix the type error in src/utils/helper.ts"

4. عوامل و مجوزها: اول ایمنی

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

مجوزهای دقیق

شما دقیقا کنترل می‌کنید که عامل چه کاری می‌تواند انجام دهد. مجوزها را به صورت سراسری یا در هر جلسه تنظیم کنید:

• اجازه دادن (Allow): عامل دستورات را اجرا می‌کند و فایل‌ها را به صورت خودکار ویرایش می‌کند.
• پرسیدن (Ask): عامل باید برای هر اقدام تأیید شما را درخواست کند (پیش‌فرض برای عملیات حساس).
• رد کردن (Deny): عامل به شدت از انجام اقدام منع شده است.

عوامل تخصصی: برنامه‌ریزی در مقابل ساخت

برای به حداقل رساندن ریسک، ما یک گردش کار تقسیم شده را توصیه می‌کنیم:

1. عامل برنامه‌ریزی (Plan Agent): از یک مدل "برنامه‌ریز" برای تحلیل کد و پیش‌نویس استراتژی استفاده کنید. این عامل را در حالت فقط خواندنی یا پرسیدن نگه دارید.
2. عامل ساخت (Build Agent): پس از تأیید برنامه، به یک عامل "سازنده" با مجوزهای اجازه دادن بروید تا تغییرات را به سرعت اجرا کنید.

5. ویژگی‌های پیشرفته: چند جلسه‌ای و اشتراک‌گذاری

مهندسی دنیای واقعی خطی نیست. OpenCode از گردش کارهای پیشرفته برای برآوردن نیازهای چندوظیفه‌ای شما پشتیبانی می‌کند.

جلسات موازی

اجازه ندهید یک بازسازی طولانی‌مدت مانع اصلاح سریع باگ شما شود. OpenCode به شما امکان می‌دهد چندین جلسه موازی را اجرا کنید.

• جلسه A: "بازسازی میان‌افزار احراز هویت."
• جلسه B: "رفع باگ z-index CSS در صفحه اصلی."

این جلسات به صورت مستقل عمل می‌کنند و تضمین می‌کنند که زمینه بین وظایف مخلوط نمی‌شود.

لینک‌های قابل اشتراک‌گذاری

آیا نیاز دارید به هم‌تیمی خود نشان دهید که هوش مصنوعی چه کرده است؟ از /share برای تولید یک گزارش دقیق و فقط خواندنی از جلسه خود استفاده کنید.

• همکاری: لینک را برای یک بررسی‌کننده PR ارسال کنید تا بتوانند ببینند چرا تغییرات ایجاد شده است.
• مستندسازی: جلسات موفق را به عنوان "دستورالعمل" برای وظایف آینده ذخیره کنید.
• کنترل حریم خصوصی: اشتراک‌گذاری به طور پیش‌فرض خاموش است. شما صریحاً کنترل می‌کنید چه چیزی منتشر شود.

نتیجه‌گیری

OpenCode برای توسعه‌دهندگانی ساخته شده است که قدرت هوش مصنوعی را بدون قربانی کردن کنترل یا حریم خصوصی می‌خواهند. با تسلط بر این گردش کارها — انتخاب مدل‌های مناسب، بهره‌گیری از مجوزهای دقیق و استفاده از جلسات موازی — می‌توانید OpenCode را از یک دستیار ساده به یک شریک خودکار خستگی‌ناپذیر تبدیل کنید.

آماده شروع هستید؟ اکنون OpenCode را نصب کنید و آینده مهندسی local-first را تجربه کنید.