T3 Code للتحكم في وكلاء البرمجة: التثبيت والضبط

T3 Code للتحكم في وكلاء البرمجة: التثبيت بحسب README، وأوضاع الصلاحيات، والوصول عن بُعد، وخادم MCP، ومتابعة الخدمة يوميًا.
T3 Code pilotage agents de code : installer et régler

T3 Code للتحكم في وكلاء البرمجة: يصف المستودع pingdotgg/t3code أداة T3 Code بأنها «واجهة تحكم في harness الوكلاء». فهي تدير الوكلاء المثبتين أصلًا على جهازك (Claude Code وCodex وCursor وGrok Build وOpenCode وGoogle Antigravity) من تطبيق جوال أو تطبيق ويب أو تطبيق مكتبي بـ Electron. ويضم المستودع نحو 29300 نجمة في نهاية أكتوبر 2026.

بالنسبة إلى فريق التشغيل هي وسيط جديد بين إنسان ووكلاء ينفذون أوامر. والموضوع ليس السرعة بل الصلاحيات: من يوافق على ماذا، ومن أي جهاز، وعبر أي مسار شبكي. يتبع هذا المقال README ووثائق المستودع. وللمراقبة من جهة الوكيل، راجع مراقبة وكيل برمجة في المؤسسة.

توضيح للأمانة: لم تثبّت span.observer أداة T3 Code. الأوامر مأخوذة من README ووثائق المستودع، واللقطة من الموقع الرسمي للمشروع.

T3 Code للتحكم في وكلاء البرمجة: ما يقوله المستودع

  • الناشر والترخيص: ترخيص MIT؛ ويحمل ملف LICENSE العبارة «Copyright (c) 2026 T3 Tools Inc.».
  • أرقام أُعيدت قراءتها في 22 أكتوبر 2026: نحو 29300 نجمة، ونحو 7900 فرع (fork)، و7360 commit على الفرع الرئيسي. لا تعرض صفحة المستودع أي إصدار منشور؛ وتوصف المثبّتات والحزم في README.
  • المبدأ: لا تحل T3 Code محل وكلائك، بل تأمرهم. يوضح README أنها تعمل باشتراكاتك الحالية: إذا كان مزود مثبتًا ومصادقًا عليه، تستطيع T3 Code التحكم فيه.
  • النضج: يكتب README «We are very very early in this project. Expect bugs» ويذكر أنه لا يقبل (تقريبًا) مساهمات في الوقت الحالي.

جولة في الواجهة

يعرض موقع المشروع t3.codes التطبيق المكتبي: قائمة الخيوط (threads) على اليسار، ومحادثة مع الوكيل في الوسط، وفروقات الشيفرة (diff) للمستودع على اليمين. اللقطة مأخوذة من هذا الموقع الرسمي، وتعرض خيط عمل لفريق المشروع.

لقطة من موقع T3 Code: تطبيق مكتبي بقائمة خيوط المحادثة، ومحادثة مع وكيل برمجة، ولوحة فروقات ملف مع أسطر مضافة بالأخضر ومحذوفة بالأحمر
Source : t3.codes

يظهر فيها اختيار النموذج تحت حقل الإدخال، ومؤشر شجرة العمل (worktree) مع رقم طلب الدمج (pull request)، ولوحة diff لكل دور من أدوار الوكيل. وبحسب الوثائق، يرتبط الخيط بمشروع، وتُطبَّق أوضاع الصلاحيات خيطًا خيطًا.

التثبيت خطوة بخطوة

الخطوة 1 — تثبيت مزود واحد على الأقل والمصادقة عليه

يطلب README تثبيت وكيل واحد على الأقل وربطه قبل الاستخدام، مثل codex login أو claude auth login أو agent login (Cursor) أو grok login أو opencode auth login. أما Antigravity فيُفعَّل من الإعدادات، من دون CLI.

الخطوة 2 — سطر الأوامر

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

على Windows: irm https://t3.codes/install.ps1 | iex. يُثبَّت الملف التنفيذي t3 في ~/.local/bin. الأمر t3 يشغّل الخادم ويفتح تطبيق الويب المحلي؛ وt3 service install يُبقيه نشطًا في الخلفية (macOS وLinux)؛ وt3 update يحدّثه؛ وnpx t3@latest يتيح التجربة من دون تثبيت. وكما في أي أمر curl | sh، اقرأ السكربت أولًا.

الخطوة 3 — التطبيق المكتبي

winget install T3Tools.T3Code
brew install --cask t3-code
yay -S t3code-bin

هذه على التوالي أوامر README لـ Windows (winget) وmacOS (Homebrew) وArch Linux (AUR). ويذكر README أيضًا Scoop وحزمة .deb لـ Debian وUbuntu وإصدارات GitHub.

الصلاحيات والوصول عن بُعد: لبّ الموضوع

تصف وثائق أوضاع الصلاحيات أربعة مستويات: Supervised (موافقة على الأوامر وتعديلات الملفات) وAuto-accept edits وAuto (مراجعة تلقائية من المزود) وFull access (من دون أي طلب). الإعداد الافتراضي الأولي هو Full access، ويمكن تغييره في Settings ثم General ثم New threads ثم Permissions.

مقطع من وثائق T3 Code: جدول أوضاع الصلاحيات الأربعة Supervised وAuto-accept edits وAuto وFull access مع سلوك كل منها، والإعداد الافتراضي الأولي Full access

بعبارة أخرى، عند التثبيت يستطيع وكيل يُشغَّل من T3 Code تنفيذ أوامر من دون أن يسأل. وإن لم يناسبك ذلك، اجعل الإعداد الافتراضي Supervised قبل أول خيط. وتضيف الوثائق أن المزودين يطبقون الصلاحيات بطرق مختلفة، وأن بعض الحالات (Claude وAntigravity) قد تطلب موافقة حتى في Full access.

  • الوصول عن بُعد: يتيح T3 Connect بيئة على أجهزتك الأخرى من دون إعادة توجيه منفذ (t3 connect، بعد تسجيل الدخول إلى حساب). وإلا فهناك اقتران عبر شبكة محلية أو خاصة: t3 serve --host <ip-privée>، ثم t3 pair للحصول على رابط يُستخدم مرة واحدة. وتوضح الوثائق أن المضيف يجب أن يبقى مشغّلًا ويمكن الوصول إليه.
  • الوكلاء الخارجيون: تعرض T3 Code خادم MCP على عنوان البيئة متبوعًا بـ /mcp. يتصل به الوكلاء (Claude Code وCodex وChatGPT) بعد اتصال معتمد؛ والوصول الافتراضي للقراءة فقط، ولا ينجح الاتصال إلا على localhost أو عبر https.
  • الخدمة في الخلفية: تُوضع متغيرات الخدمة في ~/.t3/service.env (مثل T3CODE_PORT=3773 وT3CODE_HOST=127.0.0.1). وإذا احتوى الملف على بيانات اعتماد توصي الوثائق باستخدام chmod 600.

خادم MCP في T3 Code هو نفسه خادم ينبغي مراقبته: أعد قراءة دليل خادم MCP لـ GitHub لمنطق القراءة فقط والرموز المميّزة (tokens) ذات الحد الأدنى من الصلاحيات.

مراقبة T3 Code

لا يصف README تصديرًا إلى OpenTelemetry ولا مقاييس. أما ما تتيح الوثائق متابعته فهو:

  • حالة الخدمة: يعرض t3 service status الحالة ومكان السجلات؛ ويُستخدم t3 doctor لاسترجاع مساحة قاعدة البيانات.
  • البيانات المحلية: المشاريع والخيوط والإعدادات تحت ~/.t3/userdata؛ خذ نسخة احتياطية من هذا المجلد قبل أي تحديث كبير.
  • الوكلاء الأساسيون: التتبعات والأحداث والتكاليف تأتي من الوكلاء أنفسهم. اتبع نهج مراقبة وكلاء MCP مع OpenTelemetry وتكلفة وكيل ذكاء اصطناعي بالـ tokens.
  • التحديثات: إعادة تشغيل الخدمة تقطع أدوار الوكلاء والطرفيات والعملاء البعيدين الجارية؛ والأمر t3 update يطلب تأكيدًا.

الحدود والنقاط المفتوحة

  • مشروع فتي، باعتراف README: توقّع أخطاء وتغييرات في الخيارات.
  • لا يوجد موقع وثائق: كل شيء في مجلد docs/ من المستودع.
  • الإعداد الافتراضي Full access: غيّره قبل استخدامه على جهاز يحتوي على أسرار.
  • المسارات البعيدة (T3 Connect وTailscale وSSH) توسّع سطح الهجوم؛ وتوصي الوثائق بروابط تُستخدم مرة واحدة لكل جهاز.
  • للمقارنة مع أداة أخرى لإدارة أسطول الوكلاء، راجع Paperclip.

أفضل الممارسات

  • اجعل Supervised الوضع الافتراضي؛ ووسّع الصلاحيات خيطًا خيطًا.
  • أبقِ T3CODE_HOST=127.0.0.1 ما دمت لا تحتاج إلى الوصول عن بُعد، وفضّل T3 Connect أو شبكة خاصة على التعريض العام.
  • امنح الوكلاء الخارجيين وصول «القراءة فقط» افتراضيًا.
  • سجّل من وافق على ماذا، من دون البحث عن مذنب.

الأسئلة الشائعة

هل تحل T3 Code محل Claude Code أو Codex؟

لا. بحسب README هي تديرهما: يجب أن يكون الوكيل مثبتًا ومصادقًا عليه على الجهاز أصلًا.

هل هي للبيع؟

يجيب README بـ «Nothing» عن سؤال «ما الذي يُباع لي؟»؛ والمستودع بترخيص MIT. وتبقى اشتراكات مزودي الوكلاء على عاتقك.

هل يمكن استخدامها من الهاتف؟

نعم، يذكر README تطبيقي iOS وAndroid. يتصلان ببيئة عبر T3 Connect أو الاقتران؛ ويعمل الوكيل على الجهاز المضيف، الذي يجب أن يبقى متاحًا.

الخلاصة

T3 Code جهاز تحكم عن بُعد لوكلاء البرمجة، سهل التثبيت ويُضبط بحذر: وضع الصلاحيات، وعنوان الاستماع، والوصول عن بُعد. وهي فتية؛ فاختبرها على جهاز بلا أسرار قبل التوسع. المصادر: مستودع pingdotgg/t3code وموقع t3.codes.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا للمشاريع المذكورة. العلامات التجارية المذكورة ملك لأصحابها. الأدوات تتطور بسرعة: تحقق من الأوامر والخيارات في وثائقها الرسمية.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Impeccable langage design agents IA : installer et vérifier

Impeccable لغة تصميم وكلاء الذكاء الاصطناعي: التثبيت والتحقق

Next Post
Cursor plugins spécification : structure, installation, droits

مواصفات إضافات Cursor: البنية والتثبيت والصلاحيات

Related Posts