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

اربط T3 Code v0.1.7 بـ QCode.cc: عيّن ANTHROPIC_BASE_URL وANTHROPIC_AUTH_TOKEN على مثيل Claude، وأضف نموذجًا مخصصًا، ثم تحقّق.

تحتاج مفتاح API؟ أنشئ حسابًا ←·نقاط النهاية وعناوين Base URL ←

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

نظرة سريعة¶

أي بروتوكول¶

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

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

لا تعمل نماذج Claude إلا على بروتوكول Anthropic، لذا يتوقف Base URL عند /api؛ ويضيف Claude Code المسار /v1/messages من تلقاء نفسه. لا تُضف شرطة مائلة / في النهاية. يرد جدول البروتوكولات الكامل في نقاط النهاية ومسارات API.

التثبيت¶

يحتاج T3 Code إلى مزوّد واحد على الأقل مثبتًا على الجهاز الذي يشغّل الوكلاء. في هذا الدليل، المزوّد هو Claude Code؛ ثبّته أولًا باستخدام دليل تثبيت QCode. تتم مصادقة نسخة Claude التي تضيفها ضمن الإعداد باستخدام مفتاح QCode الخاص بك.

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

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

على Windows، في PowerShell:

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

شغّل t3 لبدء الخادم وفتح تطبيق الويب المحلي. لتجربته مرة واحدة دون تثبيت، شغّل npx t3@latest. يتوفر تطبيق سطح المكتب أيضًا من إصدارات GitHub أو من مدير حزم:

لا يوجد ملف تنفيذي t3 لأجهزة Mac المزودة بمعالجات Intel؛ استخدم تطبيق سطح المكتب هناك. تُدرج المنصات الأخرى وتطبيقات الجوال في دليل التثبيت الرسمي.

الإعداد¶

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

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

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

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

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

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

نسخ 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: مزوّد qcode في ~/.codex/config.toml ومفتاحك بصفته OPENAI_API_KEY في ~/.codex/auth.json. ثم، في الإعدادات > المزوّدون، أضف نسخة Codex، واختر التهيئة يدويًا وأكمل معالج الإعداد؛ ووجّه مسار CODEX_HOME الخاص بالنسخة إلى المجلد الذي يضم هذين الملفين (على سبيل المثال ~/.codex). اختر تلك النسخة من منتقي النموذج في المحادثة.

التحقق¶

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

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"}]}'

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

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

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

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

• نقاط النهاية ومسارات API — جدول البروتوكول × عائلة النماذج
• نظرة عامة على توافق الأدوات — أي الأدوات تتحدث بأي بروتوكول
• Codex CLI — ملف config.toml الخاص بـ QCode
• DeepSeek Harness (dsh) — إطار تشغيل للوكلاء مع استمارة API لنموذج مخصص

المؤسسات ←