# تكامل OpenCode

> **آخر تحقق**: 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](https://opencode.ai/docs) |

[OpenCode](https://github.com/anomalyco/opencode) مساعد برمجة بالذكاء الاصطناعي مفتوح المصدر 100% للطرفية، مشابه لـ Claude Code لكن بمرونة وخيارات تخصيص أكبر. يدعم التبديل بين عدة نماذج، وتكامل LSP، وواجهة TUI، ولا يرتبط بأي مزوّد ذكاء اصطناعي محدّد.

## مقدمة المشروع

### OpenCode

[OpenCode](https://github.com/anomalyco/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](https://github.com/code-yeongyu/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](https://github.com/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](https://opencode.ai/docs)

طرق التثبيت الشائعة:

```bash
# 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](#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](https://qcode.cc/models). لا يوفّر QCode حاليًا Gemini أو Grok، لذا لا يتضمن الإعداد سوى المزوّدين `anthropic` و`openai`. معرّفات النماذج الصينية: [نماذج عائلة الصين](/docs/usage/cn-models).

> **حول 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](/docs/getting-started/endpoints-and-api-paths).

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

```json
{
  "$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](https://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 | أساسي | التخطيط/التفكيك/التصميم التقني (للقراءة فقط) |
| **build** | Claude Opus 5.5 | أساسي | التطوير الرئيسي، التنفيذ من البداية إلى النهاية |
| **codex** | GPT-6.1 Sol | أساسي | إعادة الهيكلة/الترحيل/التغييرات الكبرى |
| **review** | GPT-5.6 Terra | وكيل فرعي | مراجعة الشيفرة (للقراءة فقط) |
| **explore** | Claude Haiku 5.5 | وكيل فرعي | فحص سريع للشيفرة/تحديد موقع الملفات (للقراءة فقط) |
| **general** | Claude Sonnet 5.5 | وكيل فرعي | بحث عام/توثيق (للقراءة فقط) |
| **think** | GPT-6.1 Sol | وكيل فرعي | المساعدة في التفكير/تحليل الحالات الحدّية (للقراءة فقط) |

يمكنك تخصيص إعدادات `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، تحقق من إعداداتك باختبار:

```bash
# Start OpenCode
opencode

# Test in OpenCode
> Hello, please introduce yourself
```

إذا عملت المحادثة بشكل طبيعي، فإن إعداداتك ناجحة!

## نصائح الاستخدام

### وضع ultrawork

يتيح لك oh-my-opencode الأقدم (إصدار OpenCode) إضافة `ultrawork` أو `ulw` إلى prompt لتمكين التنسيق المتوازي متعدد النماذج؛ أما OmO الأحدث فهو أمر `omo` مستقل، لذا اتبع README الخاص به. مثال للإصدار الأقدم:

```text
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](https://opencode.ai/v2/docs) أوامر التثبيت هذه:

```bash
# 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 الأصلي، فتبدو نقاط النهاية نفسها هكذا:

```json
{
  "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 وإزالة مشاركة الجلسات](https://qcode.cc/en/opencode-2-upgrade-and-session-sharing-removed).

### التغييرات في 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](https://github.com/code-yeongyu/oh-my-openagent#configuration)

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

- [الموقع الرسمي لـ OpenCode](https://opencode.ai)

- [OpenCode على GitHub](https://github.com/anomalyco/opencode)

- [oh-my-opencode على GitHub](https://github.com/code-yeongyu/oh-my-openagent)

- [الوثائق الرسمية لـ OpenCode](https://opencode.ai/docs)

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

- اطّلع على [التكامل مع VS Code](/docs/ide/vscode) لاستخدام IDE

- استكشف [التكامل مع Codex](/docs/ide/codex) لاستخدام نماذج OpenAI Codex

- تعلّم [نصائح CLI](/docs/usage/cli-tips) لتحسين كفاءة الطرفية