# إعداد T3 Code مع QCode.cc

> **آخر تحقق**: 2026-11-09 · 📄 وفقًا للوثائق الرسمية (T3 Code v0.1.7، الصادر في 2026-11-04؛ قُرئت وثائق T3 Code على الفرع main في 2026-11-09)

## نظرة سريعة

| البند | التفاصيل |
|---|---|
| ما هو | T3 Code هو «سطح تحكم لأداة تسخير الوكلاء» يتضمن تطبيق سطح مكتب وتطبيق ويب وتطبيق جوال. يستخدم الوكلاء الموجودين بالفعل على جهازك، وليس أداة تسخير بحد ذاته |
| النماذج التي يمكنك استخدامها | Claude ✅ (مثيل Claude موجّه إلى نقطة نهاية Anthropic) · كما تُقدَّم النماذج الصينية (GLM / Kimi / DeepSeek / Qwen) على نقطة النهاية تلك، راجع [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths) · GPT ❌ على هذا المسار · Gemini ❌ (لا يوفّر QCode نماذج Gemini في الوقت الحالي) |
| البروتوكول وBase URL | Anthropic: `https://api.qcode.cc/api` |
| مكان الإعداد | **الإعدادات > المزوّدون** → مثيل Claude → **متغيرات البيئة** |
| الوثائق الرسمية | [دليل مزوّد Claude في T3 Code](https://github.com/pingdotgg/t3code/blob/main/docs/user/providers-claude.md) · [الأسئلة الشائعة](https://github.com/pingdotgg/t3code/blob/main/docs/user/faq.md) |

## أي بروتوكول

لا يستدعي T3 Code واجهة API لنموذج من تلقاء نفسه. في الأسئلة الشائعة الرسمية: «يستخدم T3 Code أدوات التسخير تلك. وهو ليس أداة تسخير، ولا يعمل من دون واحدة.» بالنسبة إلى Claude، فإن أداة التسخير هي Claude Code، لذا يُوصَل QCode بالطريقة نفسها المستخدمة مع Claude Code نفسه: عنوان Base URL لـ Anthropic Messages ومفتاح QCode.

تجيب الأسئلة الشائعة الرسمية بـ «نعم» عن إمكانية استخدام مفتاح API أو OpenRouter بدلًا من الاشتراك: أضف مثيل مزوّد آخر في الإعدادات وامنحه مفاتيحه ونقطة النهاية الخاصة به؛ يبقى إعداد الاشتراك لديك دون تغيير.

| ما تريده | الاستخدام في T3 Code | QCode `ANTHROPIC_BASE_URL` |
|---|---|---|
| Claude (`claude-sonnet-5`، `claude-opus-5` …) | مثيل Claude له **متغيرات البيئة** الخاصة به | `https://api.qcode.cc/api` |
| Codex / GPT | مثيل Codex، راجع «مثيلات Codex» أدناه | لا ينطبق |

لا تعمل نماذج Claude إلا على بروتوكول Anthropic، لذا يتوقف Base URL عند `/api`؛ ويضيف Claude Code المسار `/v1/messages` من تلقاء نفسه. لا تُضف شرطة مائلة `/` في النهاية. يرد جدول البروتوكولات الكامل في [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths).
## التثبيت

يحتاج T3 Code إلى مزوّد واحد على الأقل مثبتًا على الجهاز الذي يشغّل الوكلاء. في هذا الدليل، المزوّد هو Claude Code؛ ثبّته أولًا باستخدام [دليل تثبيت QCode](/docs/getting-started/installation). تتم مصادقة نسخة Claude التي تضيفها ضمن الإعداد باستخدام مفتاح QCode الخاص بك.

ثم ثبّت T3 Code. الأوامر الرسمية:

```bash
curl -fsSL https://t3.codes/install.sh | sh
```

على Windows، في PowerShell:

```powershell
irm https://t3.codes/install.ps1 | iex
```

شغّل `t3` لبدء الخادم وفتح تطبيق الويب المحلي. لتجربته مرة واحدة دون تثبيت، شغّل `npx t3@latest`. يتوفر تطبيق سطح المكتب أيضًا من [إصدارات GitHub](https://github.com/pingdotgg/t3code/releases) أو من مدير حزم:

| المنصة | التثبيت |
|---|---|
| Windows | `winget install T3Tools.T3Code` |
| macOS | `brew install --cask t3-code` |
| Debian, Ubuntu | `sudo apt install ./T3-Code-*.deb` |
| Arch Linux | `yay -S t3code-bin` |

لا يوجد ملف تنفيذي `t3` لأجهزة Mac المزودة بمعالجات Intel؛ استخدم تطبيق سطح المكتب هناك. تُدرج المنصات الأخرى وتطبيقات الجوال في [دليل التثبيت الرسمي](https://github.com/pingdotgg/t3code/blob/main/docs/user/install.md).

## الإعداد

الوصفة الرسمية لموجّه يتحدث بروتوكول Anthropic هي نسخة Claude منفصلة بدليل إعدادات خاص بها. تطبّق هذه الخطوات ذلك على QCode.

يضيف دليل التثبيت الرسمي أن كل نسخة مزوّد يمكن أن تمتلك متغيرات بيئة خاصة بها، مثل مفاتيح API أو Base URL مخصص، وأن T3 Code لا يعرض القيم المعلّمة كحساسة بعد الحفظ.

1. افتح **الإعدادات > المزوّدون** وأضف نسخة Claude. أبقِ **مسار الملف التنفيذي** مضبوطًا على `claude`. اضبط **مسار CLAUDE_CONFIG_DIR** على مجلد خاص بها؛ يستخدم مثال OpenRouter الرسمي `~/.claude_openrouter`، لذا فإن اسمًا مثل `~/.claude_qcode` يتبع الفكرة نفسها.
2. في **متغيرات البيئة** لتلك النسخة، أضف:

   | المتغير | القيمة |
   |---|---|
   | `ANTHROPIC_BASE_URL` | `https://api.qcode.cc/api` |
   | `ANTHROPIC_AUTH_TOKEN` | مفتاح QCode الخاص بك (يبدأ بـ `cr_`)، معلّم كحساس |
   | `ANTHROPIC_API_KEY` | قيمة فارغة صراحةً |

   تنتمي إسنادات المتغيرات إلى **متغيرات البيئة**، وليس إلى **وسائط التشغيل**.
3. إذا كان دليل إعدادات Claude هذا يحتوي على تسجيل دخول Anthropic مخزّن مؤقتًا، فشغّل `/logout` في جلسة Claude Code تستخدم الدليل نفسه قبل أن تبدأ. يحذّر الدليل الرسمي من أن بيانات اعتماد تسجيل الدخول المخزّنة مؤقتًا قد تتعارض مع token الموجّه.
4. اختر النموذج في T3 Code. لنموذج خارج القائمة المدمجة، افتح نسخة Claude تلك في **الإعدادات > المزوّدون** وأضف معرّف النموذج الكامل الخاص به عبر **إضافة نموذج مخصص**، على سبيل المثال `claude-sonnet-5` من [qcode.cc/models](https://qcode.cc/models). ثم اختره في منتقي نموذج الدردشة.

تفصيلان من الدليل الرسمي: تعيّن متغيرات `ANTHROPIC_DEFAULT_*_MODEL` أسماء Claude Code المستعارة مثل `sonnet`؛ وهي لا تستبدل معرّف النموذج الصريح المحدد في T3 Code. قد تمتلك النماذج المخصصة عناصر تحكم أقل في الجهد أو التفكير أو السياق مقارنة بالنماذج المدمجة.

يعمل المفتاح نفسه على نطاقات الوصول الأخرى لـ QCode (`us.qcode.cc`، `asia.qcode.cc`)؛ بدّل المضيف في `ANTHROPIC_BASE_URL` وأبقِ المسار `/api`. راجع [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths).

### نسخ Codex

يغطي دليل Codex الخاص بـ T3 Code تسجيل الدخول باستخدام ChatGPT أو باستخدام تسجيل دخول موجود لـ Codex CLI. يظهر في مصدر T3 Code مكان قراءة النسخة التي تستخدم تثبيت Codex لديك لإعداداتها (إصدار v0.1.7؛ والفرع main المقروء في 2026-11-09 يحتوي على الأسطر نفسها):

- بالنسبة لنسخة تستخدم Codex مثبتًا، يشغّل T3 Code خادم تطبيق Codex ويضبط `CODEX_HOME` على **مسار CODEX_HOME** الذي أدخلته (`apps/server/src/provider/CodexProvider.ts`، الأسطر 476–482). ويستخدم مثال دليل Codex نفسه `~/.codex` هناك.
- يصف مخطط خادم تطبيق Codex المضمّن في المصدر طبقة إعدادات المستخدم بأنها `$CODEX_HOME/config.toml` (`packages/effect-codex-app-server/src/_generated/schema.gen.ts`، السطر 19730).
- الاتصال المنشأ باستخدام ChatGPT داخل T3 Code مختلف: يضبط T3 Code قيمة `model_provider` الخاصة به ويزيل `OPENAI_BASE_URL` له (`apps/server/src/provider/CodexManagedRuntime.ts`، الأسطر 24–26 و124)، لذا لا تنطبق إعدادات QCode هناك.

لذا، اعتبارًا من T3 Code v0.1.7، تقرأ نسخة Codex التي تستخدم تثبيت Codex الحالي لديك ملف `config.toml` في دليل Codex الرئيسي الخاص بها. اضبط Codex لـ QCode أولًا كما هو موضح في [دليل Codex](/docs/ide/codex): مزوّد `qcode` في `~/.codex/config.toml` ومفتاحك بصفته `OPENAI_API_KEY` في `~/.codex/auth.json`. ثم، في **الإعدادات > المزوّدون**، أضف نسخة Codex، واختر **التهيئة يدويًا** وأكمل معالج الإعداد؛ ووجّه **مسار CODEX_HOME** الخاص بالنسخة إلى المجلد الذي يضم هذين الملفين (على سبيل المثال `~/.codex`). اختر تلك النسخة من منتقي النموذج في المحادثة.
## التحقق

1. ابدأ محادثة جديدة، واختر نسخة Claude والنموذج المخصص، ثم أرسل رسالة قصيرة مثل `ping`.
2. افتح [probe.qcode.cc](https://probe.qcode.cc)، وأدخل المفتاح الخاص بـ QCode، وتحقق من ظهور الطلب مع النموذج الذي اخترته. هذا هو النظير في QCode للنصيحة الرسمية بالتحقق من النموذج في لوحة نشاط الموجّه.
3. لاختبار المفتاح والمسار دون T3 Code:

```bash
curl -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'
```

## استكشاف الأخطاء وإصلاحها

| العرض | السبب | الحل |
|---|---|---|
| لا يظهر المزوّد | لم يتم تثبيت CLI أو أنه ليس على `PATH` في الجهاز الذي يشغّل الخادم | ثبّت `claude` هناك، أو وجّه **Binary path** إليه في إعدادات المزوّد (الأسئلة الشائعة الرسمية) |
| `Invalid API key` | مفتاح خاطئ أو مسافات زائدة | تحقق من أن المفتاح يبدأ بـ `cr_`؛ اضبطه في `ANTHROPIC_AUTH_TOKEN` وأبقِ `ANTHROPIC_API_KEY` فارغًا |
| أخطاء مصادقة رغم صحة المفتاح | تسجيل دخول مخزَّن مؤقتًا إلى Anthropic في دليل إعدادات Claude نفسه | نفّذ `/logout` في جلسة Claude Code تستخدم ذلك الدليل، أو امنح النسخة دليل إعدادات جديدًا |
| 404 | شرطة `/` زائدة أو كتابة `/v1/messages` داخل Base URL | استخدم `https://api.qcode.cc/api` تمامًا |
| يُرفض الطلب بسبب النموذج | تم اختيار معرّف نموذج GPT في نسخة Claude؛ ونقطة نهاية Anthropic لا تخدم GPT | استخدم هناك معرّف نموذج Claude أو معرّف نموذج صيني؛ أما نماذج GPT فتمر عبر Codex |
| النموذج غير موجود في قائمة الاختيار | ليس ضمن القائمة المدمجة | أضف المعرّف الكامل عبر **Add custom model** |
| 402 مع `*_cost_limit_exceeded` | استُهلكت حصة المفتاح | راجع [رموز الأخطاء](/docs/reference/errors#402-quota-exhausted) |

## القيود المعروفة

- يصرّح T3 Code بأنه برنامج في مرحلة مبكرة: «نحن في مرحلة مبكرة جدًا جدًا من هذا المشروع. توقّع وجود أخطاء.»
- إعداد الموجّه في الدليل الرسمي مكتوب لنسخ Claude؛ أما نماذج GPT فتمر عبر نسخة Codex، كما هو موضح في قسم نسخ Codex أعلاه.
- في الاتصال عن بُعد، يستخدم T3 Code إعدادات Claude الموجودة على الخادم المتصل به، لذا اضبط النسخة على ذلك الجهاز.

## مواضيع ذات صلة

- [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths) — جدول البروتوكول × عائلة النماذج
- [نظرة عامة على توافق الأدوات](/docs/ide/tool-compatibility) — أي الأدوات تتحدث بأي بروتوكول
- [Codex CLI](/docs/ide/codex) — ملف `config.toml` الخاص بـ QCode
- [DeepSeek Harness (dsh)](/docs/ide/deepseek-harness) — إطار تشغيل للوكلاء مع استمارة API لنموذج مخصص