راه‌اندازی OpenCode 2.1.4: Claude و GPT (2026)

OpenCode 2.1.4 (2026-10-23): QCode.cc را در opencode.json با ورودی‌های baseURL مربوط به anthropic و openai متصل کنید، سپس کلید را از طریق /connect ذخیره کنید.

به‌روزرسانی 2026-11-13

به کلید API نیاز دارید؟ ثبت‌نام ←نقاط پایانی و Base URL ←

در این صفحه

آخرین بازبینی: 2026-10-26 · 📄 بر اساس مستندات رسمی (OpenCode 2 v2.1.4، منتشرشده در 2026-10-23؛ آخرین نسخه OpenCode 1، v1.19.4، منتشرشده در 2026-10-22 (مخزن اکنون anomalyco/opencode)؛ بازبینی 2026-10-20 نسخه‌های v2.1.0 و v1.19.3 را بررسی کرد)

در یک نگاه

مورد جزئیات
مدل‌های قابل استفاده Claude ✅ (ارائه‌دهنده anthropic) · GPT ✅ · مدل‌های چینی ⚠️ (ارائه‌دهنده داخلی openai آن‌ها را ارائه نمی‌دهد؛ یک ارائه‌دهنده جداگانه @ai-sdk/openai-compatible بسازید) · Gemini ❌ (QCode در حال حاضر Gemini را ارائه نمی‌دهد)
پروتکل و Base URL Anthropic: https://api.qcode.cc/claude/v1 · OpenAI: https://api.qcode.cc/openai/v1 (options.baseURL به‌ازای هر ارائه‌دهنده)
محل پیکربندی ~/.config/opencode/opencode.json؛ کلیدها از طریق opencode auth login در auth.json
مستندات رسمی opencode.ai/docs

OpenCode یک دستیار کدنویسی با هوش مصنوعی، ترمینالی و 100% متن‌باز است؛ مشابه Claude Code اما با انعطاف و گزینه‌های سفارشی‌سازی بیشتر. از جابه‌جایی بین چند مدل، یکپارچگی با LSP و رابط TUI پشتیبانی می‌کند و به هیچ ارائه‌دهنده هوش مصنوعی خاصی وابسته نیست.

معرفی پروژه

OpenCode

OpenCode یک عامل کدنویسی با هوش مصنوعی متن‌باز است که توسط تیم SST توسعه یافته است. ویژگی‌های کلیدی عبارت‌اند از:

  • 100% متن‌باز - مجوز MIT، کاملاً شفاف

  • پشتیبانی از چند مدل - هم‌زمان از Claude، OpenAI و موارد بیشتر استفاده کنید

  • پشتیبانی بومی از LSP - Language Server Protocol داخلی برای تحلیل هوشمند کد

  • اولویت با TUI - برای کاربران ترمینال طراحی شده و توسط علاقه‌مندان Neovim ساخته شده است

  • معماری کلاینت/سرور - سرور را به‌صورت محلی اجرا کنید و از دستگاه‌های موبایل به‌صورت از راه دور کنترل کنید

  • دو عامل داخلی - build (پیش‌فرض، دسترسی کامل) و plan (فقط‌خواندنی، برای تحلیل و برنامه‌ریزی)

OpenCode 2 (2026-10-20): OpenCode 2 پیکربندی lsp را می‌پذیرد و حفظ می‌کند، اما نه سرورهای زبان را اجرا می‌کند، نه ابزارهای LSP را در دسترس قرار می‌دهد و نه تشخیص‌های LSP تولید می‌کند (مستندات رسمی).

آمار پروژه (تا 2026-10-20):

  • ستاره‌های GitHub: 218,397 (تا 2026-10-20؛ 213k+ تا 2026-10-15)

  • مخزن: anomalyco/opencode (پیش‌تر sst/opencode؛ URL قدیمی تغییر مسیر می‌دهد)

  • نسخه: OpenCode 2 v2.1.4 (2026-10-23)؛ آخرین نسخه OpenCode 1، v1.19.4 (2026-10-22). نسخه‌های v2.1.0 (2026-10-20)، v1.19.3 (2026-10-16) و v1.19.0 (2026-10-11) که پیش‌تر فهرست شده بودند، اکنون انتشارهای تاریخی هستند.

oh-my-opencode

oh-my-opencode یک افزونه تقویتی شخص ثالث برای OpenCode است که اغلب «OpenCode با قدرت بیشتر» نامیده می‌شود. توجه کنید که تا 2026-10-15 نام مخزن آن به code-yeongyu/oh-my-openagent تغییر کرده است و README اکنون پروژه را OmO می‌نامد و یک فرمان مستقل omo به‌عنوان نقطه ورود اصلی دارد. نسخه پیشین OpenCode در README با عنوان «OpenCode edition» یاد می‌شود و omo setup از آن مهاجرت می‌کند (به راهنمای «Migrating from OpenCode» آن مراجعه کنید). README هنوز کلیدواژه ultrawork را توصیف می‌کند.

چون شکل آن تغییر کرده است، این صفحه دیگر نقش‌های عامل داخلی قدیمی یا فرمان قدیمی bunx oh-my-opencode install را فهرست نمی‌کند. اگر به آن نیاز دارید، از README رسمی پیروی کنید: code-yeongyu/oh-my-openagent. پیکربندی OpenCode در ادامه به آن وابسته نیست.

تا 2026-10-20، README پروژه را OmO 5.0 معرفی می‌کند و curl -fsSL https://get.omo.dev/install.sh | bash را به‌عنوان فرمان نصب آن می‌آورد؛ همچنین می‌گوید OmO روی senpi اجرا می‌شود، فورک اختصاصی خود OmO از pi.

نصب و پیکربندی

گام 1: نصب OpenCode

OpenCode با سرعت زیاد به‌روزرسانی می‌شود؛ لطفاً به راهنمای نصب رسمی مراجعه کنید:

مستندات رسمی: https://opencode.ai/docs

روش‌های رایج نصب:

# Install with curl (recommended)
curl -fsSL https://opencode.ai/install | bash

# Using package managers
npm install -g opencode-ai  # or bun/pnpm/yarn

# macOS Homebrew
brew install anomalyco/tap/opencode

تا تاریخ 2026-10-20، این اسکریپت فقط OpenCode 1 را نصب می‌کند. OpenCode 2 از دستورهای نصب جداگانه استفاده می‌کند؛ OpenCode 2 را در ادامه ببینید.

گام 2: oh-my-opencode (اختیاری)

oh-my-opencode الزامی نیست. اگر می‌خواهید از آن استفاده کنید، آن را مطابق README رسمی که در بالا پیوند داده شد نصب کنید؛ پیکربندی OpenCode در ادامه به آن وابسته نیست.

گام 3: پیکربندی QCode API

این گام کلیدی است! فایل پیکربندی ~/.config/opencode/opencode.json را ایجاد یا ویرایش کنید:

درباره انتخاب مدل: پیکربندی زیر از خط Claude 5.5 و مدل‌های GPT در QCode استفاده می‌کند. پیش‌فرض‌های روزانه claude-sonnet-5-5 / claude-opus-5-5 هستند و برای کارهای سبک claude-haiku-5-5؛ برای GPT از gpt-6.1-sol / gpt-6-sol / gpt-5.6-terra استفاده کنید. مدل‌هایی که می‌توانید فراخوانی کنید در qcode.cc/models فهرست شده‌اند. QCode در حال حاضر Gemini یا Grok ارائه نمی‌دهد، بنابراین پیکربندی فقط ارائه‌دهنده‌های anthropic و openai را دارد. شناسه‌های مدل‌های چینی: مدل‌های خانواده چین.

درباره baseURL: نمونه baseURL مربوط به Anthropic در مستندات OpenCode تا /v1 می‌رود (https://api.anthropic.com/v1)، پس در اینجا هم همین‌طور است: برای Anthropic از https://api.qcode.cc/claude/v1 و برای OpenAI از https://api.qcode.cc/openai/v1 استفاده کنید که با مسیرهای نقاط پایانی و مسیرهای API مطابقت دارد.

درباره مدل‌های چینی: ارائه‌دهنده openai داخلی OpenCode (@ai-sdk/openai) از رابط Responses استفاده می‌کند و رابط Responses در QCode مدل‌های چینی را ارائه نمی‌دهد. برای آن‌ها یک ارائه‌دهنده جداگانه @ai-sdk/openai-compatible ایجاد کنید (chat/completions، baseURL https://api.qcode.cc/openai/v1)؛ شناسه‌های مدل در مدل‌های خانواده چین قرار دارند. مستندات ارائه‌دهنده‌های OpenCode می‌گوید برای /v1/responses از @ai-sdk/openai و برای /v1/chat/completions از @ai-sdk/openai-compatible استفاده کنید.

{
  "$schema": "https://opencode.ai/config.json",

  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://api.qcode.cc/claude/v1"
      }
    },
    "openai": {
      "options": {
        "baseURL": "https://api.qcode.cc/openai/v1"
      }
    }
  },

  "model": "anthropic/claude-opus-5-5",
  "small_model": "anthropic/claude-haiku-5-5",
  "default_agent": "build",

  "permission": {
    "read": "allow",
    "list": "allow",
    "glob": "allow",
    "grep": "allow",
    "lsp": "allow",

    "edit": "ask",
    "bash": "ask",
    "webfetch": "ask",
    "websearch": "ask",

    "external_directory": "deny",
    "doom_loop": "ask"
  },

  "agent": {
    "plan": {
      "mode": "primary",
      "description": "Planning/decomposition/technical design (read-only, avoid accidental code changes)",
      "model": "anthropic/claude-opus-5-5",
      "prompt": "You are a senior technical lead. Goal: break down requirements into executable steps (with acceptance criteria/risks/rollback). Read-only by default, do not modify files or run commands; if execution is truly needed, explain the reason and suggest switching to build/codex.",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "deny",
        "bash": "deny",
        "webfetch": "deny",
        "websearch": "deny",
        "external_directory": "deny",
        "doom_loop": "deny"
      }
    },

    "build": {
      "mode": "primary",
      "description": "Main development (end-to-end implementation/debugging/fixing tests) - Claude Opus 5.5",
      "model": "anthropic/claude-opus-5-5",
      "prompt": "You are the main software engineering agent. Priorities: minimal viable changes, readability, testability. Before making changes, briefly explain the approach; after changes, always provide: key diff points, how to verify locally (commands), potential edge cases.",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "allow",
        "bash": "allow",
        "webfetch": "ask",
        "websearch": "ask",
        "external_directory": "deny",
        "doom_loop": "ask"
      }
    },

    "codex": {
      "mode": "primary",
      "description": "Refactoring/migration/major changes (Codex) - GPT-6.1 Sol",
      "model": "openai/gpt-6.1-sol",
      "prompt": "You are a Codex-style engineering agent, skilled in large-scale refactoring, migration, code review, and complex toolchain collaboration. Priority: keep the project runnable: step-by-step commits, each step verifiable; when uncertain, add safeguards and tests first.",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "allow",
        "bash": "allow",
        "webfetch": "ask",
        "websearch": "ask",
        "external_directory": "deny",
        "doom_loop": "ask"
      }
    },

    "review": {
      "mode": "subagent",
      "description": "Code review/second brain (read-only) - GPT-5.6 Terra",
      "model": "openai/gpt-5.6-terra",
      "prompt": "You are a strict code reviewer. Output: 1) Key risks (bugs/security/concurrency/edge cases) 2) Maintainability suggestions 3) Minimal modification suggestions (can use pseudo diff) 4) Necessary test points. Read-only by default, do not modify files/run commands.",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "deny",
        "bash": "deny",
        "webfetch": "deny",
        "websearch": "deny",
        "external_directory": "deny",
        "doom_loop": "deny"
      }
    },

    "explore": {
      "mode": "subagent",
      "description": "Quick code scan/file location/context summary (read-only) - Claude Haiku 5.5",
      "model": "anthropic/claude-haiku-5-5",
      "prompt": "You are a quick exploration subagent: locate relevant files/functions/call chains with minimal steps, provide clear paths and summaries. Read-only by default, do not modify files/run commands.",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "deny",
        "bash": "deny",
        "webfetch": "deny",
        "websearch": "deny",
        "external_directory": "deny",
        "doom_loop": "deny"
      }
    },

    "general": {
      "mode": "subagent",
      "description": "General research/documentation/comparing approaches (medium cost) - Claude Sonnet 5.5",
      "model": "anthropic/claude-sonnet-5-5",
      "prompt": "You are a general analysis subagent: focus on explanation, trade-offs, documentation, and approach comparison; read-only by default, try not to modify code.",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "deny",
        "bash": "deny",
        "webfetch": "ask",
        "websearch": "ask",
        "external_directory": "deny",
        "doom_loop": "deny"
      }
    },

    "think": {
      "mode": "subagent",
      "description": "Assist thinking/edge case reasoning (read-only) - GPT-6.1 Sol",
      "model": "openai/gpt-6.1-sol",
      "prompt": "You are a reasoning and edge case analysis subagent: provide structured analysis and suggestions for design, exception paths, concurrency/consistency, performance bottlenecks. Read-only by default.",
      "permission": {
        "read": "allow",
        "list": "allow",
        "glob": "allow",
        "grep": "allow",
        "lsp": "allow",
        "edit": "deny",
        "bash": "deny",
        "webfetch": "deny",
        "websearch": "deny",
        "external_directory": "deny",
        "doom_loop": "deny"
      }
    }
  }
}

انتخاب نقطه پایانی API

بر اساس وضعیت شبکه خود، می‌توانید baseURL را در پیکربندی provider تغییر دهید:

نقطه ورود Anthropic (Claude) OpenAI (Codex) کاربرد
ورودی جهانی (توصیه‌شده) https://api.qcode.cc/claude/v1 https://api.qcode.cc/openai/v1 کاربران سراسر جهان
آسیا https://asia.qcode.cc/claude/v1 https://asia.qcode.cc/openai/v1 چین سرزمین اصلی و آسیا
آمریکای شمالی / اروپا https://us.qcode.cc/claude/v1 https://us.qcode.cc/openai/v1 آمریکای شمالی و اروپا

برای کاربران سرزمین اصلی چین: از asia.qcode.cc (نقطه ورود آسیا) استفاده کنید و baseURL را به دو نشانی موجود در ردیف آسیا در بالا تغییر دهید.

مدل‌های موجود

QCode در حال حاضر از این مدل‌های پرکاربرد پشتیبانی می‌کند (فهرست کامل و نرخ‌ها در qcode.cc/models):

سری Claude (مسیر: /claude/v1):

  • claude-opus-5-5 - پرچم‌دار اصلی فعلی (claude-opus-5 و claude-opus-4-8 هنوز قابل فراخوانی هستند)

  • claude-sonnet-5-5 - پیش‌فرض روزانه (claude-sonnet-5 و claude-sonnet-4-6 هنوز قابل فراخوانی هستند)

  • claude-haiku-5-5 - Haiku 5.5، پاسخ فوق‌سریع

سری OpenAI/Codex (مسیر: /openai/v1):

  • gpt-6.1-sol - پرچم‌دار، با زمینه 1.05M (توصیه‌شده)

  • gpt-6-sol - GPT-6 Sol، با زمینه 1.05M

  • gpt-5.6-terra - برنامه‌نویسی / Codex CLI

  • gpt-5.6-sol - هم‌خانواده 5.6

QCode در حال حاضر سری Gemini و همچنین gpt-6-luna / gpt-5.6-luna را ارائه نمی‌دهد.

نمای کلی پیکربندی

پیکربندی بالا شامل یک گردش کار کامل چندعاملی است:

عامل مدل حالت هدف
plan Claude Opus 5.5 primary برنامه‌ریزی/تجزیه/طراحی فنی (فقط‌خواندنی)
build Claude Opus 5.5 primary توسعه اصلی، پیاده‌سازی سرتاسری
codex GPT-6.1 Sol primary بازآرایی/مهاجرت/تغییرات عمده
review GPT-5.6 Terra subagent بازبینی کد (فقط‌خواندنی)
explore Claude Haiku 5.5 subagent اسکن سریع کد/مکان‌یابی فایل (فقط‌خواندنی)
general Claude Sonnet 5.5 subagent پژوهش/مستندسازی عمومی (فقط‌خواندنی)
think GPT-6.1 Sol subagent کمک به تفکر/استدلال درباره موارد لبه‌ای (فقط‌خواندنی)

می‌توانید تنظیمات model، prompt و permission هر عامل را بر اساس ترجیحات خود سفارشی کنید.

گام 4: پیکربندی کلید API

پس از باز کردن OpenCode، با دستور /connect کلید API خود را پیکربندی کنید:

پیکربندی Anthropic (Claude)

  1. در OpenCode دستور /connect را تایپ کنید

  2. Anthropic را انتخاب کنید

  3. ورود دستی کلید API را انتخاب کنید

  4. کلید API را که از QCode خریده‌اید وارد کنید

  5. برای ذخیره، Enter را فشار دهید

پیکربندی OpenAI (Codex)

  1. دستور /connect را تایپ کنید

  2. OpenAI را انتخاب کنید

  3. ورود دستی کلید API را انتخاب کنید

  4. کلید API را که از QCode خریده‌اید وارد کنید

  5. برای ذخیره، Enter را فشار دهید

ذخیره و راه‌اندازی مجدد

پس از پیکربندی:

  1. برای خروج از OpenCode دستور /exit را تایپ کنید

  2. OpenCode را دوباره باز کنید

کلیدهای API شما در ~/.local/share/opencode/auth.json ذخیره می‌شوند و برای تنظیمات آینده می‌توانید مستقیماً آن‌ها را ویرایش کنید.

در OpenCode 2، کلیدهای API ذخیره‌شده و توکن‌های OAuth در پایگاه‌داده SQLite سرور قرار دارند. V2 هنگام مهاجرت پایگاه‌داده، اعتبارنامه‌های پشتیبانی‌شده را از auth.json قدیمی وارد می‌کند (مستندات رسمی 2026-10-20).

بررسی پیکربندی

پس از بازگشایی مجدد OpenCode، پیکربندی خود را با آزمایش زیر بررسی کنید:

# Start OpenCode
opencode

# Test in OpenCode
> Hello, please introduce yourself

اگر گفتگو به‌طور عادی کار کند، پیکربندی شما موفق بوده است!

نکات استفاده

حالت ultrawork

oh-my-opencode قدیمی‌تر (نسخه OpenCode) به شما امکان می‌دهد ultrawork یا ulw را به یک prompt اضافه کنید تا ارکستراسیون موازی چندمدلی فعال شود؛ OmO جدیدتر یک فرمان مستقل omo است، پس README آن را دنبال کنید. مثال برای نسخه قدیمی‌تر:

ultrawork Help me refactor the authentication module of this project

جابه‌جایی عامل‌ها با Tab

برای جابه‌جایی بین عامل‌های build و plan، Tab را فشار دهید:

  • build - دسترسی کامل، برای کار توسعه

  • plan - حالت فقط‌خواندنی، برای تحلیل و برنامه‌ریزی

در OpenCode 2، کلید پیش‌فرض برای جابه‌جایی بین عامل‌ها Shift+Tab است (مستندات رسمی 2026-10-20).

OpenCode 2

OpenCode 2 یک نسخه اصلی جداگانه از همان پروژه است. نصب‌کننده پیش‌فرض هنوز OpenCode 1 را نصب می‌کند و هر دو نسخه از فرمان opencode استفاده می‌کنند، بنابراین با آن فرمان پیش‌فرض نمی‌توان آن‌ها را در کنار هم نصب کرد (نصب‌کننده رسمی و راهنمای مهاجرت 2026-10-20).

نصب OpenCode 2

مستندات V2 این فرمان‌های نصب را فهرست می‌کند:

# OpenCode 2
curl -fsSL https://opencode.ai/v2/install | bash
npm install -g @opencode/cli
brew install anomalyco/tap/opencode-v2
bun install -g --trust @opencode/cli
pnpm add -g --allow-build=@opencode/cli @opencode/cli
yarn global add @opencode/cli

پیش از نصب V2، نصب V1 مدیریت‌شده با بسته را حذف کنید؛ نصب‌کننده curl نسخه V2 جایگزین باینری V1 می‌شود. برای ارتقای نصب موجود OpenCode 1، opencode upgrade --major را اجرا کنید (مستندات رسمی 2026-10-20).

پیکربندی شما در هر دو نسخه کار می‌کند

OpenCode 2 پیکربندی موجود سیستمی، سراسری و پروژه را از همان مکان‌هایی می‌خواند که V1 می‌خواند، از جمله ~/.config/opencode/opencode.json(c). قرار است پیکربندی V1 پشتیبانی‌شده موجود همچنان کار کند؛ قالب پیکربندی V1 همچنان پشتیبانی می‌شود و قالب بومی V2 اختیاری است. OpenCode 2 فیلدهای پشتیبانی‌شده V1 و فیلدهای بومی V2 را در حافظه نرمال‌سازی می‌کند بدون اینکه فایل منبع را بازنویسی کند. راهنمای مهاجرت توصیه می‌کند پس از تبدیل فایل‌ها به شکل‌های فقط بومی V2، V1 را طوری پیکربندی نکنید که به آن فایل‌ها اشاره کند.

بنابراین پیکربندی provider / options.baseURL بالا در هر دو OpenCode 1 و OpenCode 2 کار می‌کند. اگر فقط از OpenCode 2 استفاده می‌کنید و قالب بومی V2 را ترجیح می‌دهید، همان نقاط پایانی به این شکل هستند:

{
  "providers": {
    "anthropic": { "settings": { "baseURL": "https://api.qcode.cc/claude/v1" } },
    "openai": { "settings": { "baseURL": "https://api.qcode.cc/openai/v1" } }
  }
}

این شکل بومی فقط برای OpenCode 2 است.

تفاوت‌های رفتاری که بر پیکربندی بالا اثر می‌گذارند

  • دایرکتوری‌های خارجی: V1 پیش از دسترسی به مسیرهای خارج از پروژه می‌پرسد؛ V2 به‌طور پیش‌فرض external_directory را مجاز می‌کند. راهنمای مهاجرت نمی‌گوید V2 چگونه قواعد external_directory با قالب V1 را در بالا اعمال می‌کند (آن‌ها اینجا deny هستند)، بنابراین خودتان اثر آن را در V2 بررسی کنید. برای حفظ رفتار V1 در V2 بومی، راهنما یک قاعده external_directory با اثر ask اضافه می‌کند.
  • کنش‌های مجوز: lsp و doom_loop کنش‌های مجوز فعلی V2 Core نیستند.
  • سرورهای زبان: OpenCode 2 پیکربندی lsp را می‌پذیرد و حفظ می‌کند، اما سرورهای زبان را اجرا نمی‌کند، ابزارهای LSP را در دسترس قرار نمی‌دهد و تشخیص‌های LSP را تولید نمی‌کند.
  • اعتبارنامه‌ها: کلیدهای API ذخیره‌شده و توکن‌های OAuth در پایگاه‌داده SQLite سرور قرار دارند. V2 در طول مهاجرت پایگاه‌داده‌اش، اعتبارنامه‌های پشتیبانی‌شده را از auth.json قدیمی وارد می‌کند؛ اعتبارنامه‌های جدید و به‌روزرسانی‌شده در SQLite ذخیره می‌شوند، نه اینکه در آن فایل بازنویسی شوند.
  • جابه‌جایی عامل: کلید پیش‌فرض برای agent.cycle، Shift+Tab است.
  • افزونه‌ها: پیاده‌سازی‌های افزونه V1 در V2 اجرا نمی‌شوند؛ افزونه‌ها از API جدید افزونه استفاده می‌کنند.

برای یادداشت‌های ارتقا به OpenCode 2 در qcode.cc، از جمله حذف اشتراک‌گذاری نشست در 1.19.1، ارتقا به OpenCode 2 و حذف اشتراک‌گذاری نشست را ببینید.

تغییرات در 2.1.3–2.1.4 و 1.19.4 (2026-10-26)

OpenCode 2.1.4 در 2026-10-23 منتشر شد، 2.1.3 در 2026-10-22، و آخرین نسخه 1.x یعنی 1.19.4 در 2026-10-22. مواردی که به پیکربندی بالا مربوط می‌شوند (نقل‌شده به‌صورت واژه‌به‌واژه):

  • 2.1.3 — «تنظیمات baseURL ارائه‌دهنده سفارشی اکنون همان‌طور که انتظار می‌رود، نقاط پایانی مدل‌های کاتالوگ را بازنویسی می‌کنند.»
  • 2.1.3 — «زمان اجرای Bun همراه به 1.4.4 ارتقا یافت که شامل اصلاحات امنیتی برای Brotli، TLS، HTTP/1.1، HTTP/2، HTTP/3، WebSocket و fetch است و گواهی‌های ریشه را به NSS 3.131.1 به‌روزرسانی می‌کند.»
  • 2.1.4 — وقتی یک سرور MCP در طول فراخوانی ابزار درخواست ورودی می‌کند، اکنون فرم نمایش داده می‌شود به‌جای اینکه فراخوانی تا پایان مهلت منتظر بماند؛ فشرده‌سازی پس‌زمینه آزمایشی با experimental.background_compaction فعال می‌شود.
  • 1.19.4 — خط 1.x همان اصلاحات امنیتی Bun 1.4.4 را دریافت کرد.

فرمان‌های نصب V2 در بالا در مستندات بررسی‌شده در 2026-10-26 بدون تغییر هستند.

عیب‌یابی

اتصال API ناموفق بود

  1. بررسی کنید که پیکربندی نقطه پایانی API درست است

  2. اطمینان حاصل کنید که کلید API به‌درستی ذخیره شده است

  3. تلاش کنید نقطه پایانی API دیگری را انتخاب کنید (مثلاً asia.qcode.cc یا us.qcode.cc)

  4. بررسی کنید که آیا شبکه شما به پروکسی نیاز دارد

مدل در دسترس نیست

اطمینان حاصل کنید که تعریف مدل به‌درستی در opencode.json پیکربندی شده است و شناسه مدل با نام‌های مدل پشتیبانی‌شده‌ی QCode مطابقت دارد.

مشکلات پیکربندی oh-my-opencode

به مستندات رسمی مراجعه کنید: https://github.com/code-yeongyu/oh-my-openagent#configuration

پیوندهای مرتبط

گام‌های بعدی

با QCode شروع کنید

یک کلید API برای Claude Code، Codex و بیشتر — بر اساس توکن، قیمت هر مدل در qcode.cc/models

سازمانی ←