راهنمای ادغام OpenCode: نحوه دسترسی به Claude 4.5، GPT-5.2 و Gemini 3 Pro از طریق EvoLink API (2026)

توجه: این مقاله بازنشر از وبلاگ رسمی EvoLink است.

مقدمه: عصر جدید هوش مصنوعی مبتنی بر ترمینال

در چشم انداز به سرعت در حال تحول سال 2026، ترمینال توسعه دهنده از یک خط فرمان ساده به یک مرکز فرماندهی پیچیده برای هوش مصنوعی تبدیل شده است. روزهای تغییر زمینه بین IDE، یک ربات چت مبتنی بر مرورگر و مستندات API به پایان رسیده است. امروزه، کارآمدترین توسعه دهندگان، عوامل هوش مصنوعی را مستقیماً در گردش کار CLI خود ادغام می کنند.

با این حال، چالش جدیدی پدیدار شده است: تیکه تکه شدن مدل. شما به Claude 4.5 برای قابلیت های کدنویسی برتر آن، GPT-5.2 برای استدلال پیچیده و Gemini 3 Pro برای پنجره زمینه عظیم آن نیاز دارید. مدیریت سه اشتراک و کلید API جداگانه ناکارآمد و پرهزینه است.

این راهنما راه حل نهایی را ارائه می دهد: ادغام OpenCode، پیشروترین عامل کدنویسی ترمینال منبع باز، با EvoLink، دروازه API یکپارچه. با دنبال کردن این راهنمای "آسمان خراش"، یاد خواهید گرفت که چگونه یک محیط توسعه قوی و مقرون به صرفه بسازید که دسترسی درخواستی به بهترین مدل های هوش مصنوعی جهان را به شما می دهد - تا 70٪ در هزینه های API صرفه جویی می کند در حالی که سرعت کدنویسی شما را افزایش می دهد.

قسمت 1: اجزای پشته هوش مصنوعی شما

OpenCode چیست؟

OpenCode یک ابزار برنامه نویسی خط فرمان (CLI) منبع باز مبتنی بر Go است که جامعه توسعه دهندگان را طوفانی کرده و بیش از 45000 ستاره در GitHub جمع آوری کرده است. برخلاف افزونه های تکمیل خودکار استاندارد، OpenCode به عنوان یک عامل مستقل عمل می کند. دارای یک رابط کاربری ترمینال مدرن (TUI) است که به شما امکان می دهد:

• با استفاده از زبان طبیعی با پایگاه کد خود چت کنید.
• دستورات ترمینال را به صورت مستقل اجرا کنید (با اجازه).
• فایل ها را در کل ساختار پروژه خود ویرایش کنید.
• خطاها را با خواندن ردیابی پشته مستقیماً از خروجی اشکال زدایی کنید.

قدرت واقعی آن در طراحی مستقل از ارائه دهنده آن نهفته است. OpenCode شما را مجبور به استفاده از یک مدل خاص نمی کند؛ این به عنوان ظرفی برای هر هوشی که تصمیم می گیرید به آن متصل کنید عمل می کند.

EvoLink چیست؟

EvoLink لایه زیرساختی است که قدرت این راه اندازی را تامین می کند. این یک دروازه API هوشمند است که بیش از 40 مدل هوش مصنوعی اصلی را در یک رابط واحد جمع می کند.

• دسترسی یکپارچه: یک کلید API به شما امکان دسترسی به مدل های OpenAI، Anthropic، Google، Alibaba و ByteDance را می دهد.
• کارایی هزینه: از طریق Smart Routing، EvoLink به طور خودکار درخواست ها را به مقرون به صرفه ترین ارائه دهنده برای یک مدل خاص هدایت می کند و در مقایسه با استفاده مستقیم از ارائه دهنده، 20-70٪ صرفه جویی ارائه می دهد.
• قابلیت اطمینان: با معماری وظیفه ناهمگام و failover خودکار، EvoLink زمان کار 99.9٪ را تضمین می کند و اطمینان می دهد که عامل کدنویسی شما هرگز در طول یک جلسه اشکال زدایی حیاتی "هنگ" نمی کند.

قسمت 2: چرا OpenCode را با EvoLink ادغام کنید؟

ادغام OpenCode و EvoLink نشان دهنده "اصل آسمان خراش" توسعه نرم افزار است - ساختن بر روی پایه های قوی برای رسیدن به ارتفاعات جدید.

1. چابکی مدل: می توانید بدون تغییر پیکربندی یا کلیدهای API خود، از استفاده از Claude 4.5 Opus برای نوشتن کلاس های پیچیده به Gemini 3 Pro برای تجزیه و تحلیل یک PDF مستندات 500 صفحه ای تغییر دهید.
2. مهاجرت بدون کد: EvoLink کاملاً با فرمت API OpenAI سازگار است. این بدان معنی است که OpenCode "فکر می کند" با یک ارائه دهنده استاندارد صحبت می کند، در حالی که EvoLink مسیریابی پیچیده را در پس زمینه انجام می دهد.
3. جریان اطلاعات با چگالی بالا: با اتصال توانایی OpenCode برای خواندن فایل های محلی با دسترسی EvoLink به مدل های با زمینه بالا، می توانید کل مخازن را برای تجزیه و تحلیل به پنجره زمینه تغذیه کنید.

قسمت 3: درک سه مدل قدرتمند (نسخه 2026)

قبل از پیکربندی ادغام، درک اینکه چه چیزی را ادغام می کنید بسیار مهم است. از اوایل سال 2026، سه مدل بر چشم انداز تسلط دارند. از طریق EvoLink، شما به همه آنها دسترسی دارید.

1. Claude 4.5 (Sonnet & Opus) - معمار کد

• بهترین برای: نوشتن کد تمیز و قابل نگهداری، بازآرایی (refactoring) و برنامه ریزی معماری.
• آمار: Claude 4.5 Opus با امتیاز 80.9٪ تاج را در تابلوی امتیازات SWE-bench Verified در اختیار دارد، به این معنی که مشکلات دنیای واقعی GitHub را بهتر از هر مدل دیگری حل می کند.
• چرا از آن در OpenCode استفاده کنیم: "انسان مانند ترین" ساختار کد را تولید می کند و کمتر مستعد توهم کتابخانه های ناموجود است. در پیروی از دستورالعمل های پیچیده و چند مرحله ای عالی است.

2. GPT-5.2 - موتور استدلال

• بهترین برای: منطق پیچیده، الگوریتم های ریاضی و "فکر کردن از طریق" اشکالات مبهم.
• آمار: GPT-5.2 به امتیاز کامل 100٪ در معیار AIME 2025 (ریاضیات) و 52.9٪ در ARC-AGI-2 دست می یابد که به طور قابل توجهی از رقبا در استدلال انتزاعی پیشی می گیرد.
• چرا از آن در OpenCode استفاده کنیم: وقتی در یک خطای منطقی گیر کرده اید که توضیح را به چالش می کشد، یا نیاز به تولید عبارات منظم پیچیده یا کوئری های SQL دارید، GPT-5.2 انتخاب برتر است.

3. Gemini 3 Pro - پادشاه زمینه و چند وجهی

• بهترین برای: تجزیه و تحلیل پایگاه های کد عظیم، خواندن تصاویر مستندات و تکرار با سرعت بالا.
• آمار: دارای یک پنجره زمینه عظیم 1 میلیون توکن و سرعت پیشرو در صنعت (تقریباً 180 توکن در ثانیه) است.
• چرا از آن در OpenCode استفاده کنیم: از Gemini 3 Pro زمانی استفاده کنید که باید کل دایرکتوری پروژه خود را برای بررسی سازگاری جهانی به اعلان (prompt) تغذیه کنید. همچنین مقرون به صرفه ترین گزینه برای کارهای با حجم بالا است.

قسمت 4: راهنمای ادغام گام به گام

این راهنما فرض می کند که شما در یک محیط شبیه یونیکس (macOS/Linux) یا WSL برای ویندوز کار می کنید.

پیش نیازها

1. شبیه ساز ترمینال: iTerm2 (macOS)، Windows Terminal یا Hyper.
2. حساب EvoLink: یک حساب معتبر در evolink.ai.
3. Git: روی دستگاه شما نصب شده است.

مرحله 1: نصب OpenCode

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

curl -fsSL https://raw.githubusercontent.com/opencode-ai/opencode/main/install | bash

تایید نصب:

opencode --version

مرحله 2: کلید API EvoLink خود را دریافت کنید

1. وارد داشبورد EvoLink خود شوید.
2. به بخش API Keys بروید.
3. روی Create New Key کلیک کنید.
4. رشته کلید را کپی کنید (با sk-evo... شروع می شود). این کلید را به اشتراک نگذارید.

مرحله 2.5: ارائه دهنده OpenCode را راه اندازی کنید

قبل از پیکربندی فایل JSON، باید EvoLink را به عنوان یک ارائه دهنده سفارشی در مدیر اعتبار OpenCode ثبت کنید. این یک تنظیم یک بار مصرف است که به OpenCode اجازه می دهد EvoLink را به عنوان یک ارائه دهنده معتبر تشخیص دهد.

1. راه اندازی OpenCode برای اولین بار:

opencode

2. وقتی OpenCode شروع می شود، از شما می خواهد که یک ارائه دهنده را متصل کنید. در لیست ارائه دهندگان، به پایین بروید و other را انتخاب کنید (می توانید با تایپ کردن جستجو کنید).

3. شناسه ارائه دهنده را وارد کنید: هنگامی که از شما خواسته شد، evolink را به عنوان شناسه ارائه دهنده تایپ کنید. این یک ورودی ارائه دهنده سفارشی در سیستم OpenCode ایجاد می کند.

4. کلید API را وارد کنید: می توانید هر مقدار نگهدارنده ای را در اینجا وارد کنید (مثلاً admin یا temp). کلید API واقعی EvoLink از طریق فایل پیکربندی در مرحله بعد ارجاع داده خواهد شد.

مهم: این مرحله راه اندازی evolink را در مدیر اعتبار محلی OpenCode ثبت می کند. فایل پیکربندی که در ادامه ایجاد می کنیم، جزئیات اتصال واقعی را ارائه می دهد.

مرحله 3: پیکربندی OpenCode

1. پیدا کردن/ایجاد دایرکتوری پیکربندی:

   • macOS/Linux: ~/.config/opencode/
   • Windows: %AppData%\opencode\

   برای کاربران ویندوز: Win + R را فشار دهید، %AppData%\opencode\ را جایگذاری کنید و Enter را فشار دهید تا دایرکتوری باز شود:

   

2. ایجاد فایل opencode.json:

mkdir -p ~/.config/opencode
nano ~/.config/opencode/opencode.json

3. جایگذاری پیکربندی زیر:
   نکته: YOUR_EVOLINK_API_KEY را با کلیدی که در مرحله 2 تولید کردید جایگزین کنید.

{
    "$schema": "https://opencode.ai/config.json",
    "provider": {
        "evolink": {
            "npm": "@ai-sdk/anthropic",
            "name": "Evolink",
            "options": {
                "baseURL": "https://code.evolink.ai/v1",
                "apiKey": "your-evolink-api-key"
            },
            "models": {
                "claude-opus-4-5-20251101": {
                    "name": "Claude-4.5-Opus"
                },
                "claude-sonnet-4-5-20250929": {
                    "name": "Claude-4.5-Sonnet"
                },
                "claude-haiku-4-5-20251001": {
                    "name": "Claude-4.5-Haiku"
                }
            }
        }
    }
}

نکته فنی: با وجود اینکه ما از مدل های Claude و Gemini استفاده می کنیم، در JSON مقدار provider را روی "openai" تنظیم می کنیم. دلیل این امر این است که EvoLink فرمت API OpenAI را به طور یکپارچه به فرمت های بومی Anthropic و Google ترجمه می کند. این "ترفند" به OpenCode اجازه می دهد تا با استفاده از پروتکل های استاندارد با مدل های غیر GPT ارتباط برقرار کند.

مرحله 4: تایید اتصال

OpenCode را در ترمینال خود راه اندازی کنید:

opencode

در کادر ورودی تایپ کنید:

"Hello, which model are you and who is your provider?"

اگر به درستی پیکربندی شده باشد، پاسخ باید مدلی را که تعریف کرده اید تأیید کند (مثلاً "I am GPT-5.2...").

قسمت 5: پیکربندی پیشرفته و تغییر مدل

پس از ورود به OpenCode، شما روی یک مدل قفل نمی شوید. می توانید مدل ها را به صورت پویا بر اساس وظیفه ای که در دست دارید تغییر دهید.

تغییر مدل از طریق CLI

می توانید مدل را مستقیماً هنگام راه اندازی ابزار مشخص کنید:

# برای بررسی سریع منطق
opencode --model gpt-5.2

# برای یک جلسه کدنویسی سنگین
opencode --model claude-3-5-sonnet-20240620

تغییر مدل از طریق TUI

در رابط OpenCode، می توانید از دستور /models برای مشاهده تنظیمات موجود استفاده کنید.

1. /models را تایپ کنید و Enter را فشار دهید.
2. شناسه مدل را از لیست opencode.json خود انتخاب کنید.
3. برای تغییر فوری زمینه، Enter را فشار دهید.

قسمت 6: بهترین شیوه ها برای توسعه با تراکم بالا

برای استفاده واقعی از پتانسیل "آسمان خراش" این ادغام، این بهترین شیوه ها را دنبال کنید:

1. استراتژی زمینه

• هنگام استفاده از Gemini 3 Pro: در اجرای دستوراتی مانند /add src/ برای افزودن کل پوشه منبع خود تردید نکنید. پنجره زمینه 1 میلیونی Gemini می تواند بار را تحمل کند و به آن اجازه می دهد نمودار وابستگی کامل پروژه شما را درک کند.
• هنگام استفاده از GPT-5.2: انتخابی تر عمل کنید. فقط فایل های مربوطه (/add src/utils/helper.ts) را اضافه کنید تا اطمینان حاصل کنید که موتور استدلال بدون حواس پرتی دقیقاً روی منطق مورد نظر متمرکز می شود.

2. مسیریابی هوشمند برای کنترل هزینه

Smart Routing EvoLink به طور پیش فرض فعال است. با این حال، می توانید با استفاده از نسخه های "Turbo" یا "Flash" مدل ها برای کارهای ساده، بیشتر بهینه سازی کنید.

• یک ورودی gpt-4o-mini یا gemini-3-flash را در opencode.json خود برای نوشتن تست های واحد ساده یا نظرات پیکربندی کنید. این مدل ها کسری از مدل های پیشرو هزینه دارند اما برای کارهای اساسی کافی هستند.

3. اول ایمنی

هرگز فایل opencode.json خود را در یک مخزن عمومی commit نکنید. .config/opencode/ را به فایل .gitignore جهانی خود اضافه کنید.

echo ".config/opencode/" >> ~/.gitignore_global
git config --global core.excludesfile ~/.gitignore_global

قسمت 7: عیب یابی مشکلات رایج

س: خطای 401 Unauthorized دریافت می کنم.

• اصلاح: کلید API EvoLink خود را بررسی کنید. اطمینان حاصل کنید که رشته کامل sk-evo... را کپی کرده اید. همچنین بررسی کنید که موجودی اعتبار مثبتی در حساب EvoLink خود دارید.

س: OpenCode می گوید "Model not found".

• اصلاح: اطمینان حاصل کنید که نام model در JSON شما دقیقاً با شناسه های مدل پشتیبانی شده توسط EvoLink مطابقت دارد (مثلاً gpt-4o، claude-3-opus-20240229). برای رشته های دقیق شناسه، لیست مدل های EvoLink را بررسی کنید.

س: پاسخ به آرامی پخش می شود.

• اصلاح: اگرچه EvoLink سریع است، تأخیر شبکه متفاوت است. بررسی کنید که آیا برای یک پرس و جوی ساده از یک مدل بسیار بزرگ (مانند Opus) استفاده می کنید یا خیر. برای تعاملات سریع تر به gpt-5.2 یا gemini-3-flash بروید.

نتیجه گیری

با ادغام OpenCode با EvoLink، شما یک محیط توسعه ساخته اید که به بالاترین استانداردهای کارایی و قدرت پایبند است. شما دیگر محدود به محدودیت های یک ارائه دهنده هوش مصنوعی نیستید. در عوض، شما یک مرکز فرماندهی دارید که هوشمندترین مدل های جهان را هماهنگ می کند - Claude برای معماری، GPT برای استدلال و Gemini برای زمینه - همه از طریق یک خط لوله مقرون به صرفه.

آماده ارتقای ترمینال خود هستید؟

1. کلید API خود را از EvoLink دریافت کنید
2. OpenCode را دانلود کنید
3. کدنویسی با آینده را امروز شروع کنید.