دور زدن محدودیت OpenCode در سال ۲۰۲۶

دور زدن محدودیت OpenCode در سال ۲۰۲۶

OpenCode یک agent کدنویسی متن‌باز است که در اواخر ۲۰۲۵ به‌عنوان «کلون BYOK Claude Code» پیش‌فرض جایگزین Aider شد. هیچ اشتراکی ندارد، هیچ سقف ماهانه‌ای ندارد، هیچ slow pool ندارد. مشکل اینجاست: هر ارائه‌دهنده‌ای که به آن هدایت می‌کنید دارد.

اگر OpenCode را در برابر کلید Anthropic یا OpenAI شخصی‌تان پیکربندی کرده‌اید، قبلاً متوجه شده‌اید:

• محدودیت‌های rate limit در tier کلید سریع می‌رسند (به‌خصوص کلیدهای Anthropic Tier 1 / Tier 2 با ۵۰ RPM).
• هزینه جمع می‌شود — Opus 4.7 خرده‌فروشی $15/$75 به ازای هر میلیون توکن است.
• یک key، یک مدل — جابجایی ارائه‌دهنده یعنی ویرایش دوباره config.

راه‌حل دور زدن OpenCode نیست. هدایت آن به ارائه‌دهنده‌ای است که آن مشکلات را ندارد.

چطور OpenCode ارائه‌دهنده انتخاب می‌کند

OpenCode، فایل ~/.config/opencode/opencode.json (یا معادل محلی پروژه) را می‌خواند و هر فراخوانی مدل را از طریق entry ارائه‌دهنده مطابق ارسال می‌کند. از SDK های کامل OpenAI / Anthropic به صورت native پشتیبانی می‌کند، به علاوه هر base URL سازگار با OpenAI که مشخص کنید.

این خطی است که اهمیت دارد:

{
  "provider": {
    "hypereal": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Hypereal",
      "options": {
        "baseURL": "https://api.hypereal.cloud/v1",
        "apiKey": "{env:HYPEREAL_API_KEY}"
      },
      "models": {
        "claude-opus-4-7": { "name": "Claude Opus 4.7 (1M)" },
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" },
        "gpt-5": { "name": "GPT-5" },
        "gpt-5-codex": { "name": "GPT-5 Codex" },
        "gemini-2.5-pro": { "name": "Gemini 2.5 Pro" }
      }
    }
  },
  "model": "hypereal/claude-opus-4-7"
}

این را در config قرار دهید، HYPEREAL_API_KEY=hyp_... را در shell تنظیم کنید، و opencode سرتاسری روی Hypereal اجرا می‌شود.

چرا Hypereal را به‌جای API های رسمی انتخاب کنیم

برای OpenCode به‌خصوص — که از طریق فراخوانی‌های ابزار به‌طور تهاجمی loop می‌کند، اغلب ۵-۱۰ درخواست مدل در هر «نوبت» می‌زند — سقف RPM بیشتر از قیمت per-token اهمیت دارد. محدودیت‌های RPM Hypereal بیش از ۱۰ برابر یک حساب Anthropic Tier 1 تازه است.

برای توسعه‌دهندگان ایرانی، API ارزان Claude در ایران از طریق Hypereal قابل دسترسی است — بدون دغدغه تحریم و با پشتیبانی از روش‌های پرداخت بین‌المللی.

راه‌اندازی ۶۰ ثانیه‌ای

# 1. Get a key
open https://hypereal.cloud

# 2. Save it to your shell
echo 'export HYPEREAL_API_KEY=hyp_...' >> ~/.zshrc
source ~/.zshrc

# 3. Edit OpenCode config
opencode config edit
# Paste the provider block above, save.

# 4. Run
opencode

در اولین راه‌اندازی از انتخابگر مدل، hypereal/claude-opus-4-7 را انتخاب کنید.

تغییر مدل در میان جلسه

دستور slash /model در OpenCode همان‌طور که همیشه کار می‌کند:

/model hypereal/gpt-5-codex

مدل فعال را بدون راه‌اندازی مجدد جلسه عوض می‌کند. برای جابجایی Opus 4.7 (برنامه‌ریزی) با GPT-5-Codex (refactor سنگین) و Sonnet 4.6 (ویرایش‌های کوچک) در یک کار مفید است.

یادداشتی درباره هزینه

یک هفته معمول استفاده سنگین از OpenCode (refactor های واقعی، چندین loop تست، بازنویسی کامل فایل) حدود ۵۰-۱۰۰ میلیون توکن ورودی و ۴-۸ میلیون توکن خروجی است.

برای کاربران OpenCode که از IDE اندازه‌گیری‌شده (Cursor Ultra، Claude Max) می‌آیند، مسیر API مستقیم از طریق Hypereal معمولاً هم ارزان‌ترین تیر و بالاترین throughput است.

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

آیا Hypereal از فرمت tool-call OpenCode پشتیبانی می‌کند؟ بله — Hypereal schema فراخوانی ابزار OpenAI را دقیقاً mirror می‌کند، که همان چیزی است که @ai-sdk/openai-compatible انتظار دارد. فراخوانی‌های ابزار، streaming و خروجی ساختاریافته همه رفتار یکسانی دارند.

آیا می‌توانم برای بعضی مدل‌ها از کلیدهای OpenAI / Anthropic و برای بعضی دیگر از Hypereal استفاده کنم؟ بله. OpenCode از چندین ارائه‌دهنده در یک config پشتیبانی می‌کند؛ Opus را از طریق Hypereal مسیریابی کنید و اگر خواستید کلید مستقیم OpenAI را برای o1/o3 نگه دارید.

آیا Hypereal برای جلسات agent طولانی پایدار است؟ streaming سطح جلسه Hypereal از اوایل ۲۰۲۶ GA شده و همان چیزی است که محصولات agent خودمان را تغذیه می‌کند. loop های استفاده از ابزار طولانی بار کاری اصلی هستند.

کردیت آزمایشی؟ بله — حساب‌های جدید کردیت آزمایشی دارند.

شروع کنید

OpenCode + Hypereal نزدیک‌ترین چیز به «Claude Code بدون سقف» است که در ۲۰۲۶ وجود دارد. در hypereal.cloud ثبت‌نام کنید، provider block بالا را paste کنید، و از محدودیت رد شده‌اید.