CG Claude qo‘llanmasi: Claude Code lokal muhitini tekshirish, sozlash va xavfsiz tiklash

CG Claude nima

CG Claude — Claude Code’ning mahalliy muhiti uchun konfiguratsiya va tekshiruv ish stansiyasi bo‘lib, Electron ish stoli versiyasi va mahalliy brauzer versiyasini taqdim etadi. U tizim, terminal, brauzer, proksi, TLS, Claude konfiguratsiyasi va loyiha sozlamalarini tekshiradi hamda oldindan ko‘rish, zaxiralash va snapshot mexanizmlari orqali konfiguratsiyani tuzatishga yordam beradi.

Vosita 31 ta muhit tekshiruvini o‘z ichiga oladi va sukut bo‘yicha ularni ketma-ket uch marta bajaradi. U muhit natijalariga asoslanib akkaunt holatini aniqlamaydi; akkaunt sessiyasi, xizmat hududi, limit, to‘lov, veb-maxfiylik va ayrim tarmoq holatlari hali ham qo‘lda tekshirilishi kerak.

Asosiy imkoniyatlar

• Tizim va brauzer vaqt mintaqasi, terminaldagi TZ, proksi, DNS, IPv6, TLS, autentifikatsiya manbasi va Claude konfiguratsiya katalogini tekshiradi.
• Konfiguratsiyani 13 ta jarayon tuguni orqali bajaradi; har bir tugun birinchi muvaffaqiyatsizlikdan so‘ng ko‘pi bilan uch marta qayta urinadi, keyin o‘tkazib yuborilib, keyingi tugunlar davom ettiriladi.
• O‘zgartirishdan oldin oldindan ko‘rishni ko‘rsatadi va yozishdan avval zaxira yaratadi; birinchi konfiguratsiya tuguni to‘liq konfiguratsiya snapshotini ham saqlaydi.
• Loyihadagi ruxsatlar, Hooks, MCP, proksi, TLS, hisob ma’lumotlari deklaratsiyasi va bog‘liqliklar lock-fayllarini skanerlaydi.
• Claude’ning mahalliy ulanish sozlamalarini, jumladan proksi, gateway, NO_PROXY va qo‘shimcha CA yo‘lini tahrirlaydi.
• Fayl tarkibi, ruxsatlar, fayl yo‘qligi holati, tekshiruv afzalliklari hamda qayd etilgan vaqt mintaqasi va TZ ni saqlaydi va tiklaydi.
• OpenAI’ga mos Chat Completions yoki Anthropic Messages’ni sozlaydi va belgilangan misollar yordamida xitoycha-inglizcha ikki tomonlama tarjimani sinaydi.
• Xitoycha va inglizcha interfeys, ochiq／ko‘zga qulay／qorong‘i rang sxemalari, animatsiyani kamaytirish va versiyani qo‘lda tekshirishni taqdim etadi.

CG Claude faqat qo‘llab-quvvatlanadigan konfiguratsiya fayllarini statik tahlil qiladi. U ishga tushirish skriptlari, loyiha skriptlari, Hooks, MCP yoki bog‘liqliklarni o‘rnatishni bajarmaydi, shuningdek keychain, Claude sessiyalari, Skills yoki Hooks’ni avtomatik tozalamaydi.

Ish stoli versiyasini o‘rnatish

Oddiy foydalanuvchilarga avvalo ish stoli o‘rnatish paketi tavsiya etiladi. 1.2.7 versiyasi paketi Release ilovalaridagi release/1.2.7/ ichida joylashgan; o‘rnatilgandan so‘ng Node.js’ni alohida o‘rnatish shart emas.

• 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 yoki CG-Claude-1.2.7-linux-amd64.deb

Yuklab olgach, fayl yaxlitligini SHA256SUMS.txt yordamida tekshirishingiz mumkin. E’tibor bering: macOS build hali imzolanmagan va notarizatsiya qilinmagan; Windows va Linux ish stoli o‘zaro ishlashi haqiqiy qurilmada hali tekshirilmagan.

Ish stoli oynasi yopilganda yoki kichraytirilganda odatda menyu paneli yoki tizim tray’iga yashiriladi, vazifa esa bajarilishda davom etadi. Xizmatni haqiqatan tugatish uchun tray menyusidan “CG Claude’dan chiqish”ni tanlang; dastur tekshiruv, konfiguratsiya yoki tiklash tranzaksiyasi tugashini kutib, so‘ng xizmat blokirovkasini bo‘shatadi.

Ish stoli va brauzer xizmatlari bir xil qayd katalogidan bir vaqtda foydalana olmaydi. Versiyalardan birini ishga tushirishdan oldin ikkinchi instansiyani yoping, aks holda parallel yozish yuz berishi mumkin.

Manba kodidan ishga tushirish

Muhitni tayyorlash

Manba kodidan ishlash uchun Node.js 22.12 yoki undan yuqori versiya talab qilinadi. Loyiha katalogiga kirgach, lock qilingan bog‘liqliklarni o‘rnating va Electron’ni ishga tushiring:

npm ci
npm run desktop

macOS’da 启动工具.command faylini ikki marta bosish, Windows’da esa 启动工具.cmd faylini ikki marta bosish mumkin. Linux foydalanuvchilari loyiha katalogida npm run desktop buyrug‘ini bajarishi kerak.

Tayyorlash skripti Electron’ni lock qilingan versiya bo‘yicha yuklab oladi va allaqachon o‘rnatilgan binar fayllardan qayta foydalanadi. Yuklab olish jarayoni mavjud HTTP／HTTPS proksi muhitidan foydalanadi, ammo foydalanuvchi proksi konfiguratsiyasini o‘zgartirmaydi.

Brauzer versiyasini ishga tushirish

npm run build
npm start

Ishga tushgach, http://127.0.0.1:4318 manziliga kiring. Xizmat faqat loopback manzilini tinglaydi; chiqish uchun Ctrl+C tugmalarini bosing. Linux’da quyidagini ham bajarish mumkin:

./scripts/start.sh

Birinchi tekshiruv: muhit bazasini yaratish

1. Tekshiruv afzalliklarini sozlang. Haqiqiy tarmoq rejimi, xizmat usuli, vaqt mintaqasi maqsadi va maxfiylik afzalliklarini tanlang. Sukut bo‘yicha vaqt mintaqasi Taypey tavsiyasi bo‘yicha tekshiriladi; uni joriy chiqish nuqtasiga yoki qo‘lda belgilangan qiymatga o‘zgartirish mumkin.
2. Ixtiyoriy tarmoq tekshiruvini tasdiqlang. Sukut bo‘yicha tekshiruv asosan mahalliy konfiguratsiyani o‘qiydi. Ommaviy chiqish nuqtasini aniqlash yoki WebRTC ma’lumotlarini yig‘ish uchun qo‘shimcha belgi qo‘yish kerak; tegishli tashqi xizmatlar ulanish IP manzilini ko‘radi.
3. Tekshiruvni boshlang. “Tekshiruvni boshlash”ni bosing. Vosita vaqtinchalik holat sababli noto‘g‘ri xulosalarni kamaytirish uchun sukut bo‘yicha tekshiruvni ketma-ket uch marta bajaradi.
4. Holat bo‘yicha filtrlang. Yuqoridagi “Tekshiruvdan o‘tgan”, “E’tibor kerak” yoki “Tasdiqlash kutilmoqda” bo‘limlaridan foydalaning. Bo‘lim eski qidiruv va toifa shartlarini tozalaydi, so‘ng birinchi natijani ochib, unga olib boradi.
5. Dalillar va chegaralarni ko‘ring. Natijalar o‘tgan, e’tibor kerak, qayta ishlash kerak, tasdiqlash kutilmoqda va tekshirilmagan turlariga bo‘linadi. Akkaunt, hudud, to‘lov, veb-maxfiylik, telefon vaqt mintaqasi yoki joylashuv xizmatlari kabi bandlar uchun ko‘rsatmalarga muvofiq qo‘lda tasdiqlang.

31 ta tekshiruv tizim va brauzer vaqt mintaqasi, TZ, tizim proksisi, virtual interfeyslar, DNS, IPv6, jarayon va ishga tushirish fayllari proksisi, npm va Git proksisi, API manzili, Claude konfiguratsiya katalogi, maxfiylik, CLI, TLS, proksi mosligi, autentifikatsiya manbasi, maxsus CA／mTLS hamda ixtiyoriy ommaviy chiqish nuqtasi va brauzer muvofiqligini qamrab oladi.

Bir bosishda konfiguratsiya

Tekshiruv tugagach, darhol ko‘r-ko‘rona yozmang. Avval o‘zgartirish oldindan ko‘rishini o‘qing, maqsad qiymatlari, ta’sir qiladigan fayllar va tizim ruxsati talab qiladigan amallarni tasdiqlang.

1. “Bir bosishda konfiguratsiya”ni bosing va tarmoq rejimi, xizmat usuli hamda maxfiylik afzalliklarini ketma-ket to‘ldiring. Maxsus API manzilini tozalash sukut bo‘yicha belgilanmagan.
2. Tizim vaqt mintaqasi va terminaldagi TZ uchun sukut bo‘yicha belgilangan ikki tugunni tekshiring; o‘zgartirishni istamasangiz, belgini olib tashlang.
3. Yozish oldindan ko‘rishini o‘qing va o‘zgartiriladigan maydonlar, fayllar hamda ruxsatlarni tasdiqlang.
4. Konfiguratsiyani boshlang. Vosita 13 ta tugunni belgilangan tartibda bajaradi, har bir yozishdan oldin zaxira saqlaydi, birinchi tugun esa to‘liq snapshotni saqlaydi.
5. Konfiguratsiya tugagach, markazlashtirilgan tarzda ko‘rsatilgan qolgan bandlar bo‘yicha sozlamalar sahifasini oching, buyruqni nusxalang yoki terminalni ishga tushiring.
6. Terminal va Claude mijozini qayta oching, so‘ng uch marta qayta tekshiring. Ochiq terminal fayl o‘zgargani sababli muhit o‘zgaruvchilarini avtomatik yangilamaydi.

Vosita shell, npm va Git foydalanuvchi proksisi, shell va Claude maxsus API manzili, Claude maxfiylik o‘zgaruvchilari hamda npm TLS tekshiruvini boshqaradi; shuningdek bir bosishdagi jarayonda tizim vaqt mintaqasi va terminaldagi TZ ni sozlaydi.

Qo‘llab-quvvatlanadigan konfiguratsiya joylari:

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

macOS’da tizim vaqt mintaqasini o‘zgartirish administrator ruxsatini talab qiladi, Windows UAC’dan foydalanadi, Linux esa mavjud polkit agentiga tayanadi. Agar macOS avtomatik vaqt mintaqasi yoqilgan va holatni o‘qish mumkin bo‘lsa, bir bosishdagi konfiguratsiya ruxsatdan keyin uni o‘chirishga va natijani qayta o‘qishga urinadi.

Claude’ning mahalliy ulanishini tahrirlash

“Mahalliy konfiguratsiya”ni navigatsiyaning oxiridan ochib, har bir ulanish parametrini saqlash, o‘rnatish yoki olib tashlashni tanlash mumkin. Bu funksiya faqat ~/.claude/settings.json faylidagi quyidagi maydonlarga yozadi:

• HTTPS_PROXY
• HTTP_PROXY
• NO_PROXY
• ANTHROPIC_BASE_URL
• NODE_EXTRA_CA_CERTS

Saqlashdan oldin oldindan ko‘rish ko‘rsatiladi va o‘zgartirishdan avvalgi to‘liq snapshot hamda asl fayl zaxirasi qayd etiladi. Boshqa maydonlar, Hooks, ruxsatlar va hisob ma’lumotlari saqlanadi; JSON yakunda ikki bo‘shliq bilan formatlanadi. Bir xil nomdagi kichik harfli proksi bandlarini me’yorlashtirish ham oldindan ko‘rishda ko‘rsatiladi.

Qo‘shimcha CA fayli o‘qiladigan, bo‘sh bo‘lmagan mahalliy mutlaq yo‘l bo‘lishi kerak. Vosita sertifikat tarkibini o‘qimaydi va buning uchun ulanish so‘rovini yubormaydi. Maxsus CLAUDE_CONFIG_DIR aniqlansa, noto‘g‘ri katalogga yozmaslik uchun ulanishni tahrirlash kirishi o‘chiriladi.

Loyiha konfiguratsiyasini skanerlash

“Loyiha skaneri”ni ochib, mahalliy loyiha katalogini tanlang. Skanerlash doirasi konfiguratsiya override’lari, ruxsatlar, buyruq sandbox’i, Hooks, MCP, proksi, TLS, hisob ma’lumotlari deklaratsiyasi, bog‘liqliklar lock-fayllari va mahalliy Git commit’larini o‘z ichiga oladi.

Loyiha skaneri faqat belgilangan konfiguratsiya va metadata fayllarini o‘qiydi; loyiha skriptlari, Hooks, MCP yoki bog‘liqliklarni o‘rnatmaydi. dotenv fayllari uchun vosita faqat mavjudligini tekshiradi, tarkibini o‘qimaydi; hisob ma’lumotlari maydonlari faqat ogohlantirish sifatida ko‘rsatiladi, qiymatlar namoyish etilmaydi.

Loyiha skaneri manba kodi zaifliklari, bog‘liqliklar zaifliklari yoki build to‘g‘riligini tekshirish o‘rnini bosa olmaydi. Bunday masalalar tegishli xavfsizlik, bog‘liqlik va build vositalari yordamida tekshirilishi kerak.

Zaxira va to‘liq snapshotni tiklash

“Zaxirani tiklash” bo‘limida mavjud to‘liq snapshotni tanlang va “Avvalgi konfiguratsiya snapshotini bir bosishda tiklash”ni bosing. Tiklash doirasi fayl tarkibi, asl ruxsatlar, fayl avval mavjud bo‘lmagan holati, tekshiruv afzalliklari hamda qayd etilgan tizim vaqt mintaqasi va TZ ni o‘z ichiga olishi mumkin.

1. Maqsad snapshotni tanlang va tiklash oldindan ko‘rishini ko‘ring.
2. Fayl tarkibi, ruxsatlar va vaqt mintaqasi holati hali ham oldindan ko‘rish bazasiga mosligini tasdiqlang.
3. Tiklashni bajaring. Vosita avval joriy holatni qo‘shimcha saqlaydi, so‘ng maqsad snapshotini tiklaydi.
4. Terminal va mijozni qayta ochib, muhit o‘zgaruvchilari hamda Claude konfiguratsiyasini tekshiring.

Oldindan ko‘rishdan so‘ng fayl tarkibi, ruxsatlar yoki vaqt mintaqasi o‘zgarsa, yangi o‘zgarishlar ustidan yozmaslik uchun tiklash bloklanadi. Snapshot faqat qo‘llab-quvvatlanadigan o‘n bitta foydalanuvchi konfiguratsiya joyi, tekshiruv afzalliklari va o‘qilishi mumkin bo‘lgan vaqt mintaqasi hamda TZ ni qoplaydi; tarjima konfiguratsiyasi, to‘liq ~/.claude katalogi, keychain yoki tarixiy sessiyalarni o‘z ichiga olmaydi.

Ikki tomonlama tarjimani sozlash

Chap tomondagi “Ikki tomonlama tarjima” bo‘limida protokol, API manzili, model nomi, kalit va timeout’ni sozlash mumkin. OpenAI’ga mos Chat Completions va Anthropic Messages qo‘llab-quvvatlanadi.

“Ikki tomonlama tarjimani sinash”ni bosganda, vosita ikkita belgilangan misolni haqiqatan yuboradi va xitoychadan inglizchaga hamda inglizchadan xitoychaga natijalarni alohida ko‘rsatadi. Sinov loyiha tarkibi yoki Claude sessiyalarini o‘qimaydi va haq olinishi mumkin bo‘lgan so‘rovlarni avtomatik qayta yubormaydi.

Kalit AES-256-GCM yordamida shifrlanadi, asosiy kalit esa mahalliy shaxsiy qayd katalogida saqlanadi. Biroq bu tizim keychain’i emas; katalogni o‘qish huquqiga ega shaxs uni hal qilishi mumkin. Saqlangan kalit interfeysga qaytarilmaydi; xizmat manzili yoki protokol o‘zgartirilgach, uni qayta kiritish kerak.

Tarjima modeli sinovdan o‘tishi Claude Code’ning asl terminaliga ulanish amalga oshirilganini anglatmaydi va sessiyani ushlashni avtomatik yoqmaydi.

Izolyatsiyalangan demo va CLI’dan foydalanish

Haqiqiy konfiguratsiyani o‘zgartirishdan oldin izolyatsiyalangan demo rejimidan foydalanishingiz mumkin:

npm run demo
npm run desktop:demo

demo maxsus vaqtinchalik konfiguratsiya katalogi va 4319 portidan foydalanadi; desktop:demo esa alohida Electron ma’lumotlar katalogidan foydalanadi. Demo yozuvlari faqat test katalogiga ta’sir qiladi, tizim vaqt mintaqasi va TZ izolyatsiyalangan tarzda simulyatsiya qilinadi, ammo platforma ma’lumotlari va mijoz versiyasi mahalliy kompyuterdan o‘qiladi.

Tekshiruv natijalarini avtomatik o‘qish kerak bo‘lsa, CLI’dan foydalaning:

npm run doctor -- --json

CLI sukut bo‘yicha faqat tekshiradi, konfiguratsiyani o‘zgartirmaydi. Terminal orqali ommaviy tarmoq so‘rovini yoqish uchun --network qo‘shing:

npm run doctor -- --json --network

Ko‘p ishlatiladigan ishga tushirish o‘zgaruvchilari

• CG_PORT: brauzer xizmati porti, sukut bo‘yicha 4318; Electron tasodifiy loopback portidan foydalanadi.
• CG_HOME: foydalanuvchi konfiguratsiyasining ildiz katalogi, sukut bo‘yicha joriy foydalanuvchining uy katalogi; izolyatsiyalangan tekshiruv uchun foydalanish mumkin.
• CG_DATA_DIR: qayd katalogi, sukut bo‘yicha konfiguratsiya ildizidagi .claude-guard katalogida joylashadi.
• CG_DEMO=1: izolyatsiya rejimini belgilaydi; alohida konfiguratsiya ildiz katalogi bilan birga ko‘rsatilishi kerak.

Ilg‘or foydalanish bo‘yicha tavsiyalar

Muddati o‘tgan ko‘rib chiqishlardan foydalanmang

Agar tarixiy hisobotlar, tekshiruv afzalliklari yoki konfiguratsiya bazasi o‘zgargan bo‘lsa, tuzatishlarni ko‘rib chiqishdan oldin qayta tekshiruv o‘tkazing. Eski hisobotlarni o‘qish mumkin, ammo ulardan yangi yozish jarayoni uchun bevosita asos sifatida foydalanmaslik kerak. Vosita fayl ruxsatlari va o‘qish holatini ham tekshiradi hamda o‘zgargan ko‘rib chiqishdan foydalanishni rad etadi.

Murakkab konfiguratsiya fayllarini to‘g‘ri qayta ishlash

Ishga tushirish fayllari faqat to‘g‘ridan-to‘g‘ri tayinlashlarni statik tahlil qiladi. Murakkab funksiyalar, shart bloklari, ko‘p qatorli ifodalar va heredoc avtomatik tahrirlanmaydi. Konfiguratsiya matni qat’iy UTF-8 formatida bo‘lishi kerak; yaroqsiz UTF-8 yoki NUL belgilarini o‘z ichiga olgan fayllar snapshotdan chiqarib tashlanadi va qo‘lda tekshirish haqida xabar beriladi, GBK kabi kodlash formatlari esa taxmin qilinmaydi.

Ommaviy tarmoq tekshiruvlarining maxfiylik chegaralarini tushuning

Ommaviy tarmoq tekshiruvi https://ipinfo.io/json, https://api.ipify.org?format=json va stun:stun.l.google.com:19302 manzillariga murojaat qilishi mumkin. Bu xizmatlar ulanish IP manzilini ko‘radi, ammo kompyuteringiz konfiguratsiyasi yoki kalitlarini olmaydi. Hisobot eksportida IP manzili va xost nomi sukut bo‘yicha qo‘shimcha ravishda yashiriladi.

Brauzer tili va vaqt mintaqasi konfiguratsiyasini farqlang

Brauzerning maqsadli tili sukut bo‘yicha en-US; en-CN ham ingliz tili bo‘lsa-da, mintaqasi boshqacha. Bu tekshiruv loyiha kengaytmasiga kiradi va asl talabda majburiy emas. Vaqt mintaqasini bir tugma bilan sozlash tashqi brauzer tilini o‘zgartirmaydi; sahifada taqdim etilgan Chrome, Edge, Firefox yoki Safari yo‘riqnomalariga muvofiq uni qo‘lda sozlash kerak.

Mahalliy yozuvlarni himoyalang

Yozuvlar katalogi sukut bo‘yicha ~/.claude-guard/ bo‘lib, unda tekshiruv afzalliklari, so‘nggi 30 ta hisobot, zaxira nusxalari, snapshotlar, qo‘lda ko‘rib chiqish ma’lumotlari va ish jarayoni holati saqlanadi. Zaxira nusxalari yoki snapshotlarning asl matnida hisob ma’lumotlari bo‘lishi mumkin, shuning uchun bu katalogni o‘zboshimchalik bilan nusxalash yoki repozitoriyga yuborish mumkin emas.

POSIX tizimlarida yozuvlar katalogi ruxsatlari 0700, yozuv fayllariniki 0600; Windows tizimida foydalanuvchi katalogining ACL ruxsatlari meros qilib olinadi. Yangi konfiguratsiya fayllari POSIX tizimlarida 0600 ruxsatlari bilan yaratiladi va shu bilan birga asl konfiguratsiya ruxsatlarini imkon qadar saqlab qoladi.

Ishlab chiqish va paketlash

Ishlab chiqish rejimida frontend uchun 5173, backend uchun 4318 portlari ishlatiladi:

npm run dev

O‘zgartirishlarni yuborishdan oldin to‘liq tekshiruv va formatlashni tekshirishni ishga tushirish mumkin:

npm run check
npm run format:check

Ilova katalogi yoki joriy platforma uchun o‘rnatish paketini yaratish:

npm run pack
npm run dist

pack ilova katalogini yaratadi; dist joriy tizimga qarab macOS dmg／zip, Windows NSIS／portable yoki Linux AppImage／deb paketini yaratadi va joriy tizim hamda CPU arxitekturasiga mos Electron muhitidan foydalanadi.

Xulosa

CG Claude muhitni tekshirish, konfiguratsiyani ko‘rib chiqish, maydonlarni tuzatish, loyihani skanerlash va snapshotni tiklash jarayonlarini bitta mahalliy ish stolida birlashtiradi. Avval namoyish rejimida jarayon bilan tanishib, keyin haqiqiy muhit bazasini yaratish tavsiya etiladi; har bir yozishdan oldin ko‘rib chiqishni tekshiring, yakunlangach terminalni qayta oching va ketma-ket qayta tekshiruv o‘tkazing. Hisoblar, mintaqa, to‘lov, telefon vaqt mintaqasi va brauzer maxfiyligi kabi ishonchli tarzda avtomatik aniqlab bo‘lmaydigan bandlar uchun qo‘lda tekshirish bosqichini saqlab qolish kerak.

Brauzer muhiti konfiguratsiyasi plaginini ko‘rish uchun LC-time loyihasiga tashrif buyuring.