دليل CG Claude: فحص وتهيئة واسترجاع آمن لبيئة Claude Code المحلية

شنو هو CG Claude

CG Claude هو منصة ديال الإعدادات والفحص موجهة لبيئة Claude Code المحلية، وكتوفر نسخة سطح مكتب بـ Electron ونسخة كتخدم فالمتصفح المحلي. كيقدر يفحص النظام، والطرفية، والمتصفح، والوكيل، وTLS، وإعدادات Claude، والعناصر الخاصة بالمشروع، وكيساعد فإصلاح الإعدادات باستعمال المعاينة والنسخ الاحتياطية واللقطات.

الأداة فيها 31 فحص للبيئة، وكتدير افتراضيا ثلاث جولات متتابعة ديال الفحص. ما كتستنتجش حالة الحساب انطلاقا من نتائج البيئة؛ جلسة الحساب، ومنطقة الخدمة، والحصة، والأداء، وخصوصية الويب، وبعض حالات الشبكة خاصها تبقى محل مراجعة يدوية.

القدرات الرئيسية

• فحص المنطقة الزمنية ديال النظام والمتصفح، والطرفية TZ، والوكيل، وDNS، وIPv6، وTLS، ومصدر المصادقة، ومجلد إعدادات Claude.
• تنفيذ الإعدادات عبر 13 عقدة، مع إعادة المحاولة حتى ثلاث مرات كحد أقصى بعد أول فشل فكل عقدة، ومن بعد كيتجاوز العقدة وكيكمل العقد الموالية.
• عرض المعاينة قبل التعديل، وإنشاء نسخة احتياطية قبل الكتابة؛ وأول عقدة إعدادات كتحتافظ حتى بلقطة كاملة للإعدادات.
• فحص الصلاحيات، وHooks، وMCP، والوكيل، وTLS، وتصريحات بيانات الاعتماد، وملفات قفل التبعيات داخل المشروع.
• تحرير إعدادات الاتصال المحلية ديال Claude، بما فيها الوكيل، والبوابة، وNO_PROXY، والمسار الإضافي لشهادات CA.
• حفظ واسترجاع محتوى الملفات، والصلاحيات، وحالة غياب الملفات، وتفضيلات الفحص، والمنطقة الزمنية وTZ المسجلين.
• إعداد Chat Completions المتوافق مع OpenAI أو Anthropic Messages، واختبار الترجمة الثنائية الاتجاه بين الصينية والإنجليزية بأمثلة ثابتة.
• توفير واجهة بالصينية والإنجليزية، وألوان فاتحة／مريحة للعين／داكنة، وتقليل الحركة، والفحص اليدوي للإصدار.

CG Claude كيفكك بشكل ثابت غير ملفات الإعدادات المدعومة، وما كينفذش سكريبتات التشغيل، أو سكريبتات المشروع، أو Hooks، أو MCP، أو تثبيت التبعيات، وما كينقيش أوتوماتيكيا سلسلة المفاتيح، أو جلسات Claude، أو Skills، أو Hooks.

تثبيت نسخة سطح المكتب

بالنسبة للمستخدمين العاديين، الأفضل استعمال حزمة تثبيت سطح المكتب. حزم الإصدار 1.2.7 كاينة فمرفقات Release داخل release/1.2.7/، ومن بعد التثبيت ما كايناش حاجة لتثبيت Node.js بوحدو.

• macOS Apple Silicon:CG-Claude-1.2.7-macos-arm64.dmg
• macOS Intel:CG-Claude-1.2.7-macos-x64.dmg
• Windows x64:CG-Claude-1.2.7-windows-x64-setup.exe
• Linux x64:CG-Claude-1.2.7-linux-x86_64.AppImage أو CG-Claude-1.2.7-linux-amd64.deb

من بعد التحميل، تقدر تستعمل SHA256SUMS.txt باش تتأكد من سلامة الملفات. خاص الانتباه أن نسخة macOS مازال ما موقعة وما موثقةش؛ والتفاعل ديال سطح المكتب فـ Windows وLinux مازال ما تجربش على أجهزة حقيقية.

ملي كتسد أو كتصغر نافذة سطح المكتب، غالبا كتختبى فشريط القوائم أو فصينية النظام، والمهمة كتبقى خدامة. إلا بغيتي تسالي الخدمة فعلا، اختار “الخروج من CG Claude” من قائمة الصينية؛ البرنامج كيتسنى حتى تسالي عملية الفحص أو الإعداد أو الاسترجاع، ومن بعد كيحرر قفل الخدمة.

نسخة سطح المكتب وخدمة المتصفح ما يقدروش يستعملو نفس مجلد السجلات فآن واحد. قبل ما تشغل شي نسخة، خرج من النسخة الأخرى باش تتفادى الكتابة المتزامنة.

التشغيل من المصدر

تحضير البيئة

تشغيل المصدر كيتطلب Node.js 22.12 أو إصدار أحدث. من بعد ما تدخل لمجلد المشروع، ثبت التبعيات المقفولة وشغل Electron:

npm ci
npm run desktop

فـ macOS تقدر حتى تنقر جوج مرات على 启动工具.command، وفـ Windows تنقر جوج مرات على 启动工具.cmd. مستخدمو Linux خاصهم يشغلو npm run desktop من داخل مجلد المشروع.

سكريبت التحضير كينزل Electron حسب الإصدار المقفول، وكيعاود يستعمل الملفات الثنائية المثبتة من قبل. عملية التحميل كتستعمل بيئة وكيل HTTP／HTTPS الموجودة، ولكن ما كتبدلش إعدادات الوكيل ديال المستخدم.

تشغيل نسخة المتصفح

npm run build
npm start

من بعد التشغيل، دخل لـ http://127.0.0.1:4318. الخدمة كتستمع غير لعنوان الحلقة المحلية، وتقدر تخرج منها بـ Ctrl+C. فـ Linux تقدر حتى تشغل:

./scripts/start.sh

الفحص الأول: إنشاء خط أساس للبيئة

1. ضبط تفضيلات الفحص. اختار نمط الشبكة الفعلي، وطريقة الخدمة، والهدف ديال المنطقة الزمنية، وتفضيلات الخصوصية. المنطقة الزمنية كتتقارن افتراضيا مع اقتراح تايبيه، وتقدر تبدلها للمخرج الحالي أو تحددها يدويا.
2. تأكيد فحوصات الشبكة الاختيارية. الفحص الافتراضي كيقرأ بالأساس إعدادات الجهاز المحلي. إلا بغيتي تستعلم على المخرج العمومي أو تجمع بيانات WebRTC، خاصك تعلم الاختيار الإضافي؛ والخدمات الخارجية المرتبطة غادي تشوف IP ديال الاتصال.
3. بدا الفحص. نقر على “بدا الفحص”، والأداة كتدير افتراضيا ثلاث جولات متتابعة باش تنقص من النتائج الخاطئة الناتجة عن الحالات المؤقتة.
4. صفي حسب الحالة. استعمل مداخل “الفحص داز”، أو “خاص الانتباه”، أو “فانتظار التأكيد” اللي فوق. المداخل كتمسح البحث القديم وشروط التصنيف، وكتوسع وكتوصل لأول نتيجة.
5. شوف الأدلة والحدود. النتائج كتتقسم إلى داز، خاص الانتباه، خاص المعالجة، فانتظار التأكيد، وما تفحصش. فالعناصر المتعلقة بالحساب، والمنطقة، والأداء، وخصوصية الويب، والمنطقة الزمنية ديال الهاتف، أو خدمات تحديد الموقع، خاص التأكيد اليدوي حسب التعليمات.

الفحوصات الـ31 كتشمل المنطقة الزمنية ديال النظام والمتصفح، وTZ، ووكيل النظام، والواجهات الافتراضية، وDNS، وIPv6، ووكيل العمليات وملفات التشغيل، ووكيل npm وGit، وعناوين API، ومجلد إعدادات Claude، والخصوصية، وCLI، وTLS، وتوافق الوكيل، ومصدر المصادقة، وCA／mTLS مخصصين، بالإضافة إلى المخرج العمومي الاختياري وتطابق المتصفح.

تنفيذ الإعداد بنقرة وحدة

من بعد ما يسالي الفحص، ما تكتبش الإعدادات مباشرة وبلا مراجعة. قرا أولا معاينة التعديلات، وتأكد من القيم المستهدفة، والملفات المتأثرة، والعمليات اللي كتحتاج صلاحيات النظام.

1. نقر على “إعداد بنقرة وحدة”، وعمر بالتتابع نمط الشبكة، وطريقة الخدمة، وتفضيلات الخصوصية. تنظيف عنوان API المخصص ما متعلمش عليه افتراضيا.
2. راجع جوج العقد اللي عليهم الاختيار افتراضيا: المنطقة الزمنية ديال النظام وTZ ديال الطرفية؛ إلا ما بغيتيش التعديل، حيد الاختيار.
3. قرا معاينة الكتابة، وتأكد من الحقول والملفات والصلاحيات اللي غادي تتبدل.
4. بدا الإعداد. الأداة كتخدم العقد الـ13 بالترتيب، وكتحفظ نسخة احتياطية قبل كل كتابة، وكتحفظ لقطة كاملة فالعقدة الأولى.
5. من بعد نهاية الإعداد، استعمل لائحة العناصر الباقية باش تفتح صفحة الإعدادات، أو تنسخ الأوامر، أو تشغل الطرفية، وتكمل الخطوات اللي ما كتتعالجش أوتوماتيكيا.
6. عاود فتح الطرفية وعميل Claude، ومن بعد دير ثلاث جولات ديال إعادة الفحص. الطرفية المفتوحة ما كتجددش متغيرات البيئة أوتوماتيكيا ملي كتبدل الملفات.

الأداة كتقدر تعالج وكيل المستخدم ديال shell وnpm وGit، وعنوان API المخصص ديال shell وClaude، ومتغيرات خصوصية Claude، والتحقق من TLS ديال npm؛ وكتقدر حتى تضبط المنطقة الزمنية ديال النظام وTZ ديال الطرفية ضمن العملية بنقرة وحدة.

مواضع الإعدادات المدعومة هي:

• .zshrc، .zprofile، .zshenv
• .bashrc، .bash_profile، .bash_login، .profile
• .npmrc، .gitconfig، .config/git/config
• .claude/settings.json

تعديل المنطقة الزمنية فـ macOS كيتطلب صلاحية المسؤول، وWindows كيستعمل UAC، وLinux كيعتمد على وكيل polkit متاح. إلا كان الضبط الأوتوماتيكي للمنطقة الزمنية خدام فـ macOS وكانت الحالة قابلة للقراءة، فالإعداد بنقرة وحدة غادي يحاول يوقفو من بعد الترخيص ويعاود يقرا النتيجة.

تحرير الاتصال المحلي ديال Claude

من آخر عنصر فالتنقل، حل “الإعدادات المحلية”، وتقدر تختار لكل عنصر الاحتفاظ، أو الضبط، أو الحذف. هاد الوظيفة كتكتب غير فالحقول التالية داخل ~/.claude/settings.json:

• HTTPS_PROXY
• HTTP_PROXY
• NO_PROXY
• ANTHROPIC_BASE_URL
• NODE_EXTRA_CA_CERTS

قبل الحفظ كتظهر المعاينة، وكتتسجل اللقطة الكاملة والنسخة الاحتياطية ديال الملف قبل التعديل. الحقول الأخرى، وHooks، والصلاحيات، وبيانات الاعتماد كتبقى محفوظة، وJSON كيتنسق فالأخير بمسافتين. حتى التطبيع ديال عناصر الوكيل ذات الأحرف الصغيرة بنفس الاسم كيبان فالمعاينة.

ملف CA الإضافي خاصو يكون مسارا مطلقا محليا، قابل للقراءة، وماشي فارغ. الأداة ما كتقراش محتوى الشهادة، وما كتديرش طلب اتصال بسبب هاد الشي. إلا لقات CLAUDE_CONFIG_DIR مخصصا، مدخل تحرير الاتصال كيتعطل باش يتفادى الكتابة فمجلد خاطئ.

فحص إعدادات المشروع

حل “فحص المشروع”، واختار مجلد المشروع المحلي. نطاق الفحص كيشمل تغطية الإعدادات، والصلاحيات، وصندوق أوامر معزول، وHooks، وMCP، والوكيل، وTLS، وتصريحات بيانات الاعتماد، وملفات قفل التبعيات، وعمليات Git المحلية.

فحص المشروع كيقرأ غير ملفات الإعدادات والبيانات الوصفية المحددة، وما كينفذش سكريبتات المشروع، أو Hooks، أو MCP، أو تثبيت التبعيات. بالنسبة لملفات dotenv، الأداة كتتحقق غير من وجودها وما كتقراش المحتوى؛ وحقول بيانات الاعتماد كتقدم غير تنبيها وما كتظهرش القيم.

فحص المشروع ما كيعاوضش فحص ثغرات المصدر، أو ثغرات التبعيات، أو صحة البناء. هاد المشاكل خاصها تبقى متعالجة بأدوات الأمان والتبعيات والبناء المناسبة.

استرجاع النسخ الاحتياطية واللقطات الكاملة

من “استرجاع النسخ الاحتياطية”، اختار لقطة كاملة موجودة، ونقر على “استرجاع لقطة الإعدادات السابقة بنقرة وحدة”. نطاق الاسترجاع يقدر يشمل محتوى الملفات، والصلاحيات الأصلية، وحالة عدم وجود الملفات فالأصل، وتفضيلات الفحص، والمنطقة الزمنية ديال النظام وTZ المسجلين.

1. اختار اللقطة المستهدفة وشوف معاينة الاسترجاع.
2. تأكد أن محتوى الملفات، والصلاحيات، وحالة المنطقة الزمنية مازالو مطابقين لخط أساس المعاينة.
3. نفذ الاسترجاع. الأداة غادي تحفظ الحالة الحالية مرة إضافية أولا، ومن بعد ترجع اللقطة المستهدفة.
4. عاود فتح الطرفية والعميل، وتحقق من متغيرات البيئة وإعدادات Claude.

إلا تبدل محتوى الملف، أو الصلاحيات، أو المنطقة الزمنية من بعد المعاينة، غادي يتمنع الاسترجاع باش ما يغطيش التعديلات الجديدة. اللقطة كتغطي غير مواضع إعدادات المستخدم الـ11 المدعومة، وتفضيلات الفحص، والمنطقة الزمنية وTZ القابلين للقراءة؛ وما كتشملاش إعدادات الترجمة، أو مجلد ~/.claude الكامل، أو سلسلة المفاتيح، أو الجلسات السابقة.

إعداد الترجمة الثنائية الاتجاه

من “الترجمة الثنائية الاتجاه” فالجهة اليسرى، تقدر تضبط البروتوكول، وعنوان API، واسم النموذج، والمفتاح، والمهلة. كيتدعم Chat Completions المتوافق مع OpenAI وAnthropic Messages.

من بعد النقر على “اختبار الترجمة الثنائية الاتجاه”، الأداة كترسل فعليا جوج أمثلة ثابتة، وكتعرض بوحدها نتيجة الترجمة من الصينية للإنجليزية ومن الإنجليزية للصينية. الاختبار ما كيقراش محتوى المشروع ولا جلسات Claude، وما كيعيدش أوتوماتيكيا الطلبات اللي ممكن تكون مؤدى عنها.

المفتاح كيتشفر بـ AES-256-GCM، والمفتاح الرئيسي كيتحفظ فمجلد السجلات الخاص بالجهاز المحلي. ولكن هاد المجلد ماشي سلسلة مفاتيح ديال النظام، واللي عندو صلاحية القراءة عليه يقدر يبقى قادر يفك التشفير. المفاتيح المحفوظة ما كترجعش للواجهة؛ ومن بعد تبديل عنوان الخدمة أو البروتوكول خاص تعاود تعمرها.

نجاح اختبار نموذج الترجمة ما كيعنيش أن الطرفية الأصلية ديال Claude Code ولات مربوطة، وما كيفعلش اعتراض الجلسات أوتوماتيكيا.

استعمال العرض المعزول وCLI

قبل تعديل الإعدادات الحقيقية، تقدر تستعمل وضع العرض المعزول:

npm run demo
npm run desktop:demo

demo كيستعمل مجلد إعدادات مؤقت مخصص والمنفذ 4319؛ وdesktop:demo كيستعمل مجلد بيانات مستقل ديال Electron. الكتابة فالعرض كتأثر غير على مجلد الاختبار، والمنطقة الزمنية ديال النظام وTZ كيتستعملو بمحاكاة معزولة، ولكن معلومات المنصة وإصدار العميل كيبقاو مقروئين من الجهاز المحلي.

إلا احتجتي تقرا نتائج الفحص أوتوماتيكيا، تقدر تستعمل CLI:

npm run doctor -- --json

CLI كيدير افتراضيا الفحص فقط وما كيبدلش الإعدادات. إلا بغيتي تفعل الاستعلام العمومي من الطرفية، زيد --network:

npm run doctor -- --json --network

متغيرات التشغيل الشائعة

• CG_PORT: منفذ خدمة المتصفح، الافتراضي 4318؛ Electron كيستعمل منفذا عشوائيا فالحلقة المحلية.
• CG_HOME: الجذر ديال إعدادات المستخدم، والافتراضي هو المجلد الرئيسي ديال المستخدم الحالي، ويمكن استعمالو للعزل والتحقق.
• CG_DATA_DIR: مجلد السجلات، والافتراضي كاين داخل جذر الإعدادات فـ .claude-guard.
• CG_DEMO=1: كيعلم على الوضع المعزول، وخاص يتحدد مع جذر إعدادات مستقل.

نصائح متقدّمة للاستعمال

تجنّب استعمال معاينة قديمة

إلا تبدّلات التقارير القديمة، ولا تفضيلات الفحص، ولا الخطّ الأساسي ديال الإعدادات، خاصك تعاود الفحص قبل ما تعاين الإصلاحات. تقدر تبقى تقرا التقرير القديم، ولكن ما خاصّوش يتستعمل مباشرة كأساس لجولة جديدة ديال الكتابة. الأداة حتى هي كتراجع صلاحيات الملفات وحالة القراية، وكتمنع استعمال معاينة تبدّلات المعطيات ديالها.

التعامل الصحيح مع ملفات الإعدادات المعقّدة

ملفات التشغيل كتتحلّل بشكل ثابت غير بالنسبة للتعيينات المباشرة. الدوال المعقّدة، والكتل الشرطية، والتعابير المتعدّدة الأسطر، و heredoc ما كيتعدّلوش أوتوماتيكياً. خاص نصّ الإعدادات يكون بترميز UTF-8 صارم؛ الملفات اللي فيها UTF-8 غير صالح ولا NUL كيتستبعدو من اللقطة، وكيبان تنبيه باش يتراجعو يدوياً، بلا ما يتم التخمين بترميزات بحال GBK.

فهم حدود الخصوصية ديال الفحص العمومي

الفحص العمومي يقدر يوصل لـ https://ipinfo.io/json وhttps://api.ipify.org?format=json وstun:stun.l.google.com:19302. هاد الخدمات كتشوف IP ديال الاتصال، ولكن ما كيوصلهاش إعدادات الجهاز ولا المفاتيح. تصدير التقرير كيزيد يخبي IP وأسماء المضيفين بشكل افتراضي.

التمييز بين لغة المتصفّح وإعداد المنطقة الزمنية

اللغة المستهدفة ديال المتصفّح هي en-US بشكل افتراضي، وen-CN حتى هي بالإنجليزية، ولكن المنطقة مختلفة. هاد الفحص من الإضافات ديال المشروع وماشي مطلب إجباري فالنص الأصلي. إعداد المنطقة الزمنية بنقرة وحدة ما كيبدّلش لغة المتصفّح الخارجية، وخاصك تتبع الإرشادات ديال Chrome ولا Edge ولا Firefox ولا Safari اللي كيعطيها الموقع وتضبطها يدوياً.

حماية السجلات المحلية

المجلد الافتراضي ديال السجلات هو ~/.claude-guard/، وكيحفظ تفضيلات الفحص، وآخر 30 تقرير، والنسخ الاحتياطية، واللقطات، والمراجعة اليدوية، وحالة سير العمل. النص الأصلي ديال النسخ الاحتياطية ولا اللقطات يقدر يحتوي على بيانات الدخول، وداكشي علاش ما خاصكش تنسخ هاد المجلد ولا تدفعو للمستودع بلا سبب.

فأنظمة POSIX، صلاحيات مجلد السجلات هي 0700، وصلاحيات ملفات السجلات هي 0600؛ أما Windows فكيورّث ACL ديال مجلد المستخدم. ملفات الإعدادات الجديدة كتستعمل 0600 فـ POSIX، ومع ذلك كيتحافظ قدر الإمكان على صلاحيات الإعدادات الأصلية.

التطوير والتغليف

نمط التطوير كيستعمل المنفذ 5173 للواجهة الأمامية والمنفذ 4318 للواجهة الخلفية:

npm run dev

قبل إرسال التعديلات، تقدر تشغّل الفحص الكامل والتحقّق من التنسيق:

npm run check
npm run format:check

باش تولّد مجلد التطبيق ولا حزمة التثبيت ديال المنصة الحالية:

npm run pack
npm run dist

pack كيولّد مجلد التطبيق؛ وdist كيولّد حسب النظام الحالي dmg／zip ديال macOS، ولا NSIS／portable ديال Windows، ولا AppImage／deb ديال Linux، وكيستعمل وقت تشغيل Electron الموافق للنظام الحالي ومعمارية CPU ديالو.

الخلاصة

CG Claude كيجمع فـ ورشة عمل محلية وحدة فحص البيئة، ومعاينة الإعدادات، وإصلاح الحقول، وفحص المشاريع، واسترجاع اللقطات. من الأحسن تبدا بنمط العرض باش تولف المسار، ومن بعد تبني خطّاً أساسياً للبيئة الحقيقية؛ وقبل كل كتابة راجع المعاينة، ومن بعد سدّ التيرمينال وحلّو من جديد وعاود الفحص بشكل متتابع. بالنسبة للحسابات، والمناطق، والأداء، والمنطقة الزمنية ديال الهاتف، وخصوصية المتصفّح، وغيرها من العناصر اللي ما يمكنش الحكم عليها أوتوماتيكياً بثقة، خاصك تخلي خطوة للمراجعة اليدوية.

إلا بغيتي تشوف إضافة إعدادات بيئة المتصفّح، تقدر تزور مشروع LC-time.