إعداد OpenCode 2.1.4: Claude وGPT (2026)

OpenCode 2.1.4 (2026-10-23): ربط QCode.cc في opencode.json عبر إدخالات anthropic وopenai baseURL، ثم حفظ المفتاح من خلال /connect.

تحتاج مفتاح 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)

لمحة سريعة¶

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»، وينتقل omo setup منه (راجع دليل الانتقال من 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 من QCode ونماذج GPT. الإعدادات الافتراضية اليومية هي 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)، لذا ينطبق الأمر نفسه هنا: استخدم https://api.qcode.cc/claude/v1 مع Anthropic وhttps://api.qcode.cc/openai/v1 مع OpenAI، بما يطابق المسارات في نقاط النهاية ومسارات API.

حول النماذج الصينية: يستخدم المزوّد المدمج openai في OpenCode (@ai-sdk/openai) واجهة Responses، ولا تخدم واجهة Responses لدى QCode النماذج الصينية. لهذه النماذج، أنشئ مزوّدًا منفصلًا @ai-sdk/openai-compatible (chat/completions، baseURL https://api.qcode.cc/openai/v1)؛ توجد معرّفات النماذج في نماذج عائلة الصين. تقول وثائق مزوّدي OpenCode إنه ينبغي استخدام @ai-sdk/openai مع /v1/responses و@ai-sdk/openai-compatible مع /v1/chat/completions.

{
  "$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:

لمستخدمي البر الرئيسي للصين: استخدم 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.

نظرة عامة على الإعداد¶

يتضمن الإعداد أعلاه سير عمل كاملًا متعدد الوكلاء:

يمكنك تخصيص إعدادات model وprompt وpermission لكل وكيل وفق تفضيلاتك.

الخطوة 4: إعداد مفتاح API¶

بعد فتح OpenCode، استخدم الأمر /connect لإعداد مفتاح API الخاص بك:

إعداد Anthropic (Claude)¶

1. اكتب /connect في OpenCode

2. اختر Anthropic

3. اختر «Manually enter API Key»

4. أدخل مفتاح API الذي اشتريته من QCode

5. اضغط Enter للحفظ

إعداد OpenAI (Codex)¶

1. اكتب /connect

2. اختر OpenAI

3. اختر «Manually enter API Key»

4. أدخل مفتاح API الذي اشتريته من QCode

5. اضغط Enter للحفظ

الحفظ وإعادة التشغيل¶

بعد الإعداد:

1. اكتب /exit للخروج من OpenCode

2. أعد فتح OpenCode

تُحفظ مفاتيح API الخاصة بك في ~/.local/share/opencode/auth.json ويمكن تحريرها مباشرةً لإجراء تعديلات مستقبلية.

في OpenCode 2، توجد مفاتيح API المحفوظة وtokens 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¶

اضغط Tab للتبديل بين وكيلَي build وplan:

• 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

أزل تثبيت V1 المُدار بواسطة مدير الحزم قبل تثبيت V2؛ إذ يستبدل مثبّت 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 الأصلية في الذاكرة دون إعادة كتابة الملف المصدر. ينصح دليل الترحيل بعدم توجيه V1 إلى ملفات بعد تحويلها إلى أشكال V2 الأصلية فقط.

لذلك يعمل إعداد 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 المحفوظة وtokens 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

روابط ذات صلة¶

• الموقع الرسمي لـ OpenCode

• OpenCode على GitHub

• oh-my-opencode على GitHub

• الوثائق الرسمية لـ OpenCode

الخطوات التالية¶

• اطّلع على التكامل مع VS Code لاستخدام IDE

• استكشف التكامل مع Codex لاستخدام نماذج OpenAI Codex

• تعلّم نصائح CLI لتحسين كفاءة الطرفية

المؤسسات ←