Ruka hadi maudhui makuu
Mafunzo ya AI

Mafunzo ya CG Claude: Kagua, Sanidi na Urejeshe kwa Usalama Mazingira ya Claude Code ya Ndani

Mafunzo haya yanaeleza jinsi ya kusakinisha na kutumia CG Claude kufanya ukaguzi wa vipengele 31 vya mazingira, usanidi wa mbofyo mmoja, uchanganuzi wa mradi, uhariri kupitia muunganisho wa ndani, majaribio ya tafsiri za pande mbili, pamoja na kuhifadhi nakala za usanidi na kuurejesha kwa usalama.

Takriban dakika 35 za kusoma
Mafunzo ya CG Claude ya kukagua, kusanidi na kurejesha mazingira ya Claude Code

CG Claude ni nini

CG Claude ni kituo cha kazi cha kusanidi na kukagua mazingira ya ndani ya Claude Code, kinachopatikana kama programu ya mezani ya Electron na toleo la kivinjari la ndani. Kinaweza kukagua mfumo, terminali, kivinjari, proksi, TLS, usanidi wa Claude na vipengee vya mradi, na kusaidia kurekebisha usanidi kupitia onyesho la awali, nakala rudufu na picha za hali.

Zana hii ina ukaguzi 31 wa mazingira, na kwa chaguo-msingi hufanya ukaguzi mfululizo mara tatu. Haitabiri hali ya akaunti kutokana na matokeo ya mazingira; kipindi cha akaunti, eneo la huduma, kikomo, malipo, faragha ya wavuti na baadhi ya hali za mtandao bado vinahitaji uhakiki wa kibinafsi.

Uwezo mkuu

  • Kukagua saa za eneo za mfumo na kivinjari, TZ ya terminali, proksi, DNS, IPv6, TLS, chanzo cha uthibitishaji na saraka ya usanidi wa Claude.
  • Kutekeleza usanidi kupitia nodi 13 za mchakato; kila nodi inajaribiwa tena hadi mara tatu baada ya kushindwa mara ya kwanza, kisha inarukwa na nodi zinazofuata kuendelea.
  • Kuonyesha onyesho la awali kabla ya mabadiliko na kuunda nakala rudufu kabla ya kuandika; nodi ya kwanza ya usanidi pia huhifadhi picha kamili ya usanidi.
  • Kuchanganua ruhusa, Hooks, MCP, proksi, TLS, matamko ya vitambulisho na faili za kufunga vitegemezi katika mradi.
  • Kuhariri mipangilio ya muunganisho wa Claude ya ndani, ikijumuisha proksi, lango, NO_PROXY na njia za ziada za CA.
  • Kuhifadhi na kurejesha maudhui ya faili, ruhusa, hali ya faili kutokuwepo, mapendeleo ya ukaguzi na saa za eneo pamoja na TZ zilizorekodiwa.
  • Kusanidi Chat Completions inayoendana na OpenAI au Anthropic Messages, na kujaribu tafsiri ya kudumu ya Kichina na Kiingereza katika pande zote mbili.
  • Kutoa kiolesura cha Kichina na Kiingereza, mandhari angavu／ya kulinda macho／nyeusi, kupunguza uhuishaji na ukaguzi wa matoleo kwa mkono.

CG Claude huchanganua tuli tu faili za usanidi zinazotumika. Haiendeshi hati za kuanzisha, hati za mradi, Hooks, MCP au usakinishaji wa vitegemezi, wala haisafishi kiotomatiki keychain, vipindi vya Claude, Skills au Hooks.

Kusakinisha toleo la mezani

Watumiaji wa kawaida wanapaswa kutumia kifurushi cha usakinishaji cha mezani. Vifurushi vya toleo 1.2.7 viko katika viambatisho vya Release chini ya release/1.2.7/; baada ya kusakinisha, hakuna haja ya kusakinisha Node.js kando.

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

Baada ya kupakua, unaweza kutumia SHA256SUMS.txt kuthibitisha uadilifu wa faili. Kumbuka kuwa muundo wa macOS bado haujasainiwa wala kuthibitishwa; mwingiliano wa mezani wa Windows na Linux bado haujathibitishwa kwenye vifaa halisi.

Dirisha la mezani linapofungwa au kupunguzwa, kwa kawaida hufichwa kwenye upau wa menyu au trei ya mfumo, huku kazi ikiendelea. Ili kumaliza huduma kabisa, chagua “退出 CG Claude” kwenye menyu ya trei; programu itasubiri shughuli ya ukaguzi, usanidi au urejeshaji ikamilike kabla ya kuachilia kufuli la huduma.

Toleo la mezani na huduma ya kivinjari haziwezi kutumia saraka moja ya rekodi kwa wakati mmoja. Toka kwenye mfano mwingine kabla ya kuanzisha mojawapo, ili kuepuka uandishi wa wakati mmoja.

Kuanzisha kutoka kwenye msimbo wa chanzo

Kuandaa mazingira

Kuendesha msimbo wa chanzo kunahitaji Node.js 22.12 au toleo jipya zaidi. Baada ya kuingia kwenye saraka ya mradi, sakinisha vitegemezi vilivyofungwa na uanzishe Electron:

npm ci
npm run desktop

Kwenye macOS unaweza pia kubofya mara mbili 启动工具.command, na kwenye Windows kubofya mara mbili 启动工具.cmd. Watumiaji wa Linux wanapaswa kuendesha npm run desktop ndani ya saraka ya mradi.

Hati ya maandalizi hupakua Electron kulingana na toleo lililofungwa na kutumia tena jozi ambazo tayari zimesakinishwa. Upakuaji hutumia mazingira yaliyopo ya proksi ya HTTP／HTTPS, lakini haibadilishi usanidi wa proksi wa mtumiaji.

Kuanzisha toleo la kivinjari

npm run build
npm start

Baada ya kuanzisha, tembelea http://127.0.0.1:4318. Huduma husikiliza anwani ya loopback pekee; bonyeza Ctrl+C ili kutoka. Kwenye Linux unaweza pia kuendesha:

./scripts/start.sh

Ukaguzi wa kwanza: kuunda msingi wa mazingira

  1. Weka mapendeleo ya ukaguzi. Chagua hali halisi ya mtandao, njia ya huduma, lengo la saa za eneo na mapendeleo ya faragha. Kwa chaguo-msingi, saa za eneo hukaguliwa kwa mapendekezo ya Taipei; unaweza pia kuchagua njia ya sasa ya kutoka au kuibainisha mwenyewe.
  2. Thibitisha ukaguzi wa hiari wa mtandao. Kwa chaguo-msingi, ukaguzi mkuu husoma usanidi wa ndani. Ili kuuliza njia ya kutoka ya umma au kukusanya data ya WebRTC, chagua chaguo hilo zaidi; huduma za nje zinazohusika zitaona IP ya muunganisho.
  3. Anza ukaguzi. Bofya “开始检测”; zana kwa chaguo-msingi hufanya ukaguzi mara tatu mfululizo ili kupunguza tathmini zisizo sahihi zinazosababishwa na hali za muda mfupi.
  4. Chuja kwa hali. Tumia “检查通过”, “需要关注” au “待确认” iliyo juu. Kiingilio hiki hufuta utafutaji na masharti ya kategoria ya awali, kisha hupanua na kuelekeza kwenye matokeo ya kwanza.
  5. Angalia ushahidi na mipaka. Matokeo yamegawanywa kuwa yamefaulu, yanahitaji uangalizi, yanahitaji kushughulikiwa, yanahitaji kuthibitishwa na hayajakaguliwa. Kwa akaunti, eneo, malipo, faragha ya wavuti, saa za simu au huduma za eneo, fuata maelekezo na uthibitishe mwenyewe.

Ukaguzi 31 unashughulikia saa za eneo za mfumo na kivinjari, TZ, proksi ya mfumo, violesura pepe, DNS, IPv6, proksi za mchakato na faili za kuanzisha, proksi za npm na Git, anwani ya API, saraka ya usanidi wa Claude, faragha, CLI, TLS, upatanifu wa proksi, chanzo cha uthibitishaji, CA maalum／mTLS, pamoja na njia ya kutoka ya umma na ulinganifu wa hiari wa kivinjari.

Kutekeleza usanidi wa kubofya mara moja

Baada ya ukaguzi kukamilika, usiandike bila kufikiri. Soma kwanza onyesho la awali la mabadiliko na uthibitishe thamani lengwa, faili zinazoathiriwa na shughuli zinazohitaji ruhusa ya mfumo.

  1. Bofya “一键配置”, kisha jaza hali ya mtandao, njia ya huduma na mapendeleo ya faragha hatua kwa hatua. Usafishaji wa anwani chaguomsingi ya API maalum haujachaguliwa kwa chaguo-msingi.
  2. Kagua nodi mbili zilizochaguliwa kwa chaguo-msingi za saa za eneo la mfumo na TZ ya terminali; unaweza kuziondoa ikiwa hutaki mabadiliko.
  3. Soma onyesho la awali la uandishi na uthibitishe sehemu, faili na ruhusa zitakazobadilishwa.
  4. Anza usanidi. Zana hutekeleza nodi 13 kwa mpangilio; huhifadhi nakala rudufu kabla ya kila uandishi, na huhifadhi picha kamili kabla ya nodi ya kwanza.
  5. Baada ya usanidi, tumia vipengee vilivyosalia vinavyoonyeshwa pamoja kufungua ukurasa wa mipangilio, kunakili amri au kuanzisha terminali ili kukamilisha hatua zisizoweza kushughulikiwa kiotomatiki.
  6. Fungua tena terminali na mteja wa Claude, kisha fanya ukaguzi mara tatu tena. Terminali iliyokuwa wazi haitasasisha kiotomatiki vigezo vya mazingira baada ya faili kubadilika.

Zana inaweza kushughulikia proksi za mtumiaji za shell, npm na Git, anwani maalum ya API ya shell na Claude, vigezo vya faragha vya Claude na uthibitishaji wa TLS wa npm; pia inaweza kusanidi saa za eneo la mfumo na TZ ya terminali katika mchakato wa kubofya mara moja.

Maeneo ya usanidi yanayotumika ni pamoja na:

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

Kubadilisha saa za eneo la mfumo kwenye macOS kunahitaji ruhusa ya msimamizi, Windows hutumia UAC, na Linux hutegemea proksi ya polkit inayopatikana. Ikiwa saa za eneo za kiotomatiki za macOS zimewashwa na hali yake inaweza kusomwa, usanidi wa kubofya mara moja utajaribu kuzima baada ya kuidhinishwa na kusoma matokeo tena.

Kuhariri muunganisho wa ndani wa Claude

Fungua “本机配置” mwishoni mwa urambazaji ili kuchagua kwa kila kipengee kuhifadhi, kuweka au kuondoa vigezo vya muunganisho. Kipengele hiki huandika tu sehemu zifuatazo katika ~/.claude/settings.json:

  • HTTPS_PROXY
  • HTTP_PROXY
  • NO_PROXY
  • ANTHROPIC_BASE_URL
  • NODE_EXTRA_CA_CERTS

Onyesho la awali huonyeshwa kabla ya kuhifadhi, na picha kamili ya kabla ya mabadiliko pamoja na nakala rudufu ya faili asili huhifadhiwa. Sehemu nyingine, Hooks, ruhusa na vitambulisho huhifadhiwa, huku JSON ikiwekewa mwishowe nafasi za indenti mbili. Urekebishaji wa majina madogo ya proksi yenye jina lilelile pia huonyeshwa kwenye onyesho la awali.

Faili ya ziada ya CA lazima iwe njia kamili ya ndani inayoweza kusomeka na isiyo tupu. Zana haisomi maudhui ya cheti wala kutuma ombi la muunganisho kwa sababu hii. Ikiwa CLAUDE_CONFIG_DIR maalum itagunduliwa, kiingilio cha kuhariri muunganisho huzimwa ili kuepuka kuandika kwenye saraka isiyo sahihi.

Kuchanganua usanidi wa mradi

Fungua “项目扫描” na uchague saraka ya mradi wa ndani. Upeo wa ukaguzi unajumuisha vigeuzi vya usanidi, ruhusa, sandbox ya amri, Hooks, MCP, proksi, TLS, matamko ya vitambulisho, faili za kufunga vitegemezi na mihasisho ya ndani ya Git.

Ukaguzi wa mradi husoma tu faili maalum za usanidi na metadata; hauendeshi hati za mradi, Hooks, MCP au usakinishaji wa vitegemezi. Kwa faili za dotenv, zana hukagua tu uwepo wake bila kusoma maudhui; sehemu za vitambulisho hutoa tahadhari pekee bila kuonyesha thamani.

Ukaguzi wa mradi hauwezi kuchukua nafasi ya ukaguzi wa udhaifu wa msimbo wa chanzo, udhaifu wa vitegemezi au usahihi wa ujenzi. Masuala haya bado yanahitaji zana husika za usalama, vitegemezi na ujenzi.

Kurejesha nakala rudufu na picha kamili

Kwenye “备份恢复”, chagua picha kamili iliyopo, kisha ubofye “一键还原之前的配置快照”. Urejeshaji unaweza kujumuisha maudhui ya faili, ruhusa asili, hali ya faili kutokuwepo hapo awali, mapendeleo ya ukaguzi, pamoja na saa za eneo la mfumo na TZ zilizorekodiwa.

  1. Chagua picha lengwa na uangalie onyesho la awali la urejeshaji.
  2. Thibitisha kuwa maudhui ya faili, ruhusa na hali ya saa za eneo bado zinalingana na msingi wa onyesho la awali.
  3. Tekeleza urejeshaji. Zana itahifadhi kwanza hali ya sasa kwa ziada, kisha kurejesha picha lengwa.
  4. Fungua tena terminali na mteja, kisha uthibitishe vigezo vya mazingira na usanidi wa Claude.

Ikiwa maudhui ya faili, ruhusa au saa za eneo zitabadilika baada ya onyesho la awali, urejeshaji utazuiwa ili kuepuka kufunika mabadiliko mapya. Picha inafunika tu maeneo kumi na moja yanayotumika ya usanidi wa mtumiaji, mapendeleo ya ukaguzi na saa za eneo pamoja na TZ zinazoweza kusomeka; haijumuishi usanidi wa tafsiri, saraka kamili ya ~/.claude, keychain au vipindi vya awali.

Kusanidi tafsiri ya pande mbili

Kwenye “双向翻译” upande wa kushoto, unaweza kuweka itifaki, anwani ya API, jina la modeli, ufunguo na muda wa kusubiri. Inatumika na Chat Completions inayoendana na OpenAI pamoja na Anthropic Messages.

Baada ya kubofya “测试双向翻译”, zana hutuma kwa kweli mifano miwili isiyobadilika na kuonyesha kando matokeo ya tafsiri ya Kichina kwenda Kiingereza na Kiingereza kwenda Kichina. Jaribio halisomi maudhui ya mradi au vipindi vya Claude, wala halijaribu tena kiotomatiki maombi yanayoweza kutozwa.

Ufunguo husimbwa kwa AES-256-GCM, na ufunguo mkuu huhifadhiwa katika saraka ya rekodi binafsi ya ndani. Hata hivyo, hii si keychain ya mfumo; mtu mwenye ruhusa ya kusoma saraka hiyo bado anaweza kuufungua. Ufunguo uliohifadhiwa haurudishwi kwenye kiolesura; baada ya kubadilisha anwani ya huduma au itifaki, lazima uujaze tena.

Kufaulu kwa jaribio la modeli ya tafsiri hakumaanishi kuwa terminali asilia ya Claude Code imeunganishwa, wala haiwashi kiotomatiki uzuiaji wa vipindi.

Kutumia onyesho lililotengwa na CLI

Kabla ya kubadilisha usanidi halisi, unaweza kutumia hali ya onyesho lililotengwa:

npm run demo
npm run desktop:demo

demo hutumia saraka maalum ya muda ya usanidi na lango 4319; desktop:demo hutumia saraka huru ya data ya Electron. Uandishi wa onyesho huathiri saraka ya majaribio pekee, na saa za eneo la mfumo pamoja na TZ hutumia uigaji uliotengwa, huku taarifa za jukwaa na toleo la mteja zikiendelea kusomwa kutoka kwenye kompyuta ya ndani.

Unapohitaji kusoma matokeo ya ukaguzi kiotomatiki, unaweza kutumia CLI:

npm run doctor -- --json

Kwa chaguo-msingi, CLI hukagua tu na haibadilishi usanidi. Ili kuwezesha ombi la njia ya kutoka ya umma kupitia terminali, ongeza --network:

npm run doctor -- --json --network

Vigezo vya kawaida vya kuendesha

  • CG_PORT: Lango la huduma ya kivinjari, kwa chaguo-msingi 4318; Electron hutumia lango la loopback la nasibu.
  • CG_HOME: Saraka kuu ya usanidi wa mtumiaji, kwa chaguo-msingi saraka kuu ya mtumiaji wa sasa, na inaweza kutumika kwa uthibitishaji uliotengwa.
  • CG_DATA_DIR: Saraka ya rekodi, kwa chaguo-msingi iko chini ya saraka kuu ya usanidi katika .claude-guard.
  • CG_DEMO=1: Huashiria hali iliyotengwa; inapaswa kuambatana na saraka kuu huru ya usanidi.

Mapendekezo ya matumizi ya hali ya juu

Epuka kutumia hakikisho zilizopitwa na wakati

Ikiwa ripoti za awali, mapendeleo ya ukaguzi au msingi wa usanidi vimebadilika, fanya ukaguzi upya kabla ya kuhakiki marekebisho. Ripoti za zamani bado zinaweza kusomwa, lakini hazipaswi kutumiwa moja kwa moja kama msingi wa uandishi wa awamu mpya. Zana pia itakagua ruhusa za faili na hali ya usomaji, na itakataa kuendelea kutumia hakikisho ambalo tayari limebadilika.

Shughulikia kwa usahihi faili changamano za usanidi

Faili za kuanzisha huchanganua kwa njia tuli ugawaji wa moja kwa moja pekee. Vitendaji changamano, vizuizi vya masharti, misemo ya mistari mingi na heredoc havitahaririwa kiotomatiki. Maandishi ya usanidi lazima yawe UTF-8 halali kabisa; faili zilizo na UTF-8 batili au NUL zitaondolewa kwenye picha ya hali na zitaashiria ukaguzi wa mwongozo, badala ya kubashiri usimbaji kama GBK.

Elewa mipaka ya faragha ya ukaguzi wa mtandao wa umma

Ukaguzi wa mtandao wa umma unaweza kufikia https://ipinfo.io/json, https://api.ipify.org?format=json na stun:stun.l.google.com:19302. Huduma hizi zitaona IP ya muunganisho, lakini hazitapokea usanidi au funguo za kompyuta hii. Kwa chaguo-msingi, usafirishaji wa ripoti utaendelea kuficha IP na jina la mpangishaji.

Tenganisha lugha ya kivinjari na usanidi wa saa za eneo

Lugha lengwa ya kivinjari kwa chaguo-msingi ni en-US; en-CN pia ni Kiingereza, lakini eneo lake ni tofauti. Ukaguzi huu ni kipengele cha ziada cha mradi, si sharti la lazima katika maandishi ya awali. Usanidi wa saa za eneo kwa kubofya mara moja hautabadilisha lugha ya kivinjari cha nje; unahitaji kuiweka mwenyewe kwa kufuata maelekezo ya Chrome, Edge, Firefox au Safari yanayotolewa kwenye ukurasa.

Linda rekodi za ndani

Saraka ya rekodi kwa chaguo-msingi ni ~/.claude-guard/, na huhifadhi mapendeleo ya ukaguzi, ripoti 30 za hivi karibuni, nakala rudufu, picha za hali, ukaguzi wa mwongozo na hali ya mtiririko wa kazi. Maandishi asilia ya nakala rudufu au picha za hali yanaweza kuwa na vitambulisho vya kuingia, hivyo usinakili au kuwasilisha saraka hii bila sababu.

Kwenye mifumo ya POSIX, ruhusa za saraka ya rekodi ni 0700 na faili za rekodi ni 0600; Windows hurithi ACL ya saraka ya mtumiaji. Faili mpya za usanidi hutumia 0600 kwenye POSIX, huku zikihifadhi kwa kadiri iwezekanavyo ruhusa za usanidi wa awali.

Uendelezaji na ufungashaji

Hali ya uendelezaji hutumia mlango wa mbele 5173 na mlango wa nyuma 4318:

npm run dev

Kabla ya kuwasilisha marekebisho, unaweza kuendesha ukaguzi kamili na uthibitishaji wa uumbizaji:

npm run check
npm run format:check

Unda saraka ya programu au kifurushi cha usakinishaji cha jukwaa la sasa:

npm run pack
npm run dist

pack huunda saraka ya programu; dist huunda dmg／zip ya macOS, NSIS／portable ya Windows au AppImage／deb ya Linux kulingana na mfumo wa sasa, na hutumia mazingira ya Electron yanayolingana na mfumo wa sasa na usanifu wa CPU.

Hitimisho

CG Claude huweka pamoja ukaguzi wa mazingira, hakikisho la usanidi, marekebisho ya sehemu, uchanganuzi wa mradi na urejeshaji wa picha za hali katika kituo kimoja cha kazi cha ndani. Inapendekezwa kwanza kuzoea mchakato katika hali ya onyesho, kisha kuunda msingi wa mazingira halisi; kagua hakikisho kabla ya kila uandishi, halafu fungua tena terminal baada ya kukamilisha na ufanye ukaguzi mfululizo. Kwa vipengele kama akaunti, eneo, malipo, saa za eneo za simu na faragha ya kivinjari ambavyo haviwezi kuhukumiwa kwa kutegemewa kiotomatiki, unapaswa kuhifadhi hatua ya ukaguzi wa mwongozo.

Ukitaka kuona programu-jalizi ya usanidi wa mazingira ya kivinjari, tembelea mradi wa LC-time.