Bobea katika Claude Code kwa Kanuni za Mradi, Mawakala, Hooks, MCP na CI

Kozi ya Claude Code PRO Inatoa Nini

Claude Code PRO ni kozi ya vitendo ya lugha ya Kirusi na kifurushi cha usanidi kwa Claude Code. Inaendelea kutoka usakinishaji na uandishi wa maelekezo hadi usanidi wa timu nzima, otomatiki inayoweza kutumika tena, miunganisho ya nje, na mtiririko wa CI.

Hifadhi hii ina moduli 12 za kujifunza, maabara 8 ya vitendo, maktaba ya maelekezo, mfano wa programu-jalizi, mitiririko ya GitHub Actions, muhtasari wa haraka, Maswali Yanayoulizwa Mara kwa Mara, na kifurushi cha kuanzia kilicho tayari kusakinishwa. Kifurushi cha kuanzia kina stadi nane, mawakala wasaidizi watano, hooks nne, kanuni, mstari wa hali, na mtindo wa matokeo.

Mafunzo haya yanafupisha mtiririko mkuu wa hifadhi hii ili uweze kuanza kutumia usanidi wake katika mradi uliopo. Kozi ya awali imeandikwa kwa Kirusi, huku hatua zilizo hapa chini zikielezwa kwa Kiingereza.

Elewa Jinsi Claude Code Inavyofanya Kazi

Claude Code ni wakala, si zana ya kawaida ya kukamilisha msimbo. Ukipewa lengo, inaweza kukagua faili, kutafuta katika hifadhi, kuhariri msimbo, kutekeleza amri, na kukagua matokeo. Mzunguko wake wa kawaida ni:

1. Kusanya muktadha kutoka kwa maelekezo ya mradi, faili, utafutaji, na matokeo ya amri.
2. Panga mabadiliko yanayohitajika.
3. Hariri faili au ita zana.
4. Tekeleza majaribio, linta, miundo, au ukaguzi mwingine.
5. Rudia hadi ukaguzi ufaulu au hadi maelezo zaidi yahitajike.

Majukumu yako muhimu zaidi ni kutoa lengo lililo wazi, kumwelekeza Claude kwenye muktadha unaofaa, kutaja vikwazo, na kufafanua jinsi mafanikio yatakavyothibitishwa.

Mfumo muhimu wa kuandika maelekezo ni: lengo + mahali pa kuangalia + vikwazo + njia ya uthibitishaji.

Sakinisha Claude Code na Kifurushi cha Kuanzia

Hatua ya 1: Sakinisha Claude Code

Kwenye macOS, Linux, au Windows Subsystem for Linux, tumia hati rasmi ya usakinishaji:

curl -fsSL https://claude.ai/install.sh | bash

README pia inatoa chaguo la usakinishaji kupitia npm:

npm install -g @anthropic-ai/claude-code

Hatua ya 2: Nakili Hifadhi ya Kozi

git clone https://github.com/justxor/claude-code-pro-course.git

Hatua ya 3: Sakinisha Kifurushi cha Kuanzia kwenye Mradi Wako

Tekeleza kisakinishi kilichojumuishwa na upitishe njia ya mradi unaolenga:

bash claude-code-pro-course/install.sh ~/path/to/my-project

Hii hufanya usanidi wa Claude Code unaoweza kutumika tena wa hifadhi upatikane katika mradi wako. Kwa kuwa kifurushi kinasakinisha vipengele vingi vya usanidi, kagua mabadiliko yaliyotokea kabla ya kuyaweka kwenye udhibiti wa matoleo.

Hatua ya 4: Anzisha Claude Code

cd ~/path/to/my-project
claude

Ndani ya kipindi, kagua muktadha wa sasa na utekeleze stadi ya kuanza ya kifurushi:

/context
/onboard

/context huonyesha kinachotumia dirisha la muktadha. /onboard hutoa muhtasari wa mradi kwa kutumia stadi iliyosakinishwa.

Panga Usanidi wa Claude Code

Kozi inagawanya usanidi katika viwango vya mtumiaji, mradi, na eneo la ndani.

• Usanidi wa mtumiaji: faili zilizo chini ya ~/.claude/, zikiwemo maelekezo binafsi, mipangilio, stadi, mawakala, na mitindo ya matokeo.
• Usanidi wa mradi: faili zinazoshirikiwa kama CLAUDE.md, .claude/rules/, .claude/settings.json, stadi za mradi, mawakala wa mradi, na .mcp.json.
• Usanidi wa ndani: faili mahususi kwa mashine kama CLAUDE.local.md na .claude/settings.local.json, ambazo hazipaswi kushirikiwa kama usanidi wa timu.
• Programu-jalizi: mikusanyo iliyofungashwa ya stadi, mawakala, hooks, na usanidi wa MCP inayoweza kusambazwa kwenye hifadhi nyingi.

Chagua Njia Sahihi ya Usanidi

• Tumia CLAUDE.md au .claude/rules/ kwa maarifa ya mradi na kanuni za uandishi wa msimbo.
• Tumia mipangilio ya ruhusa kuruhusu amri salama, kuomba uthibitisho kwa vitendo nyeti, na kukataa ufikiaji hatari.
• Tumia stadi kwa utaratibu au maelekezo yanayoweza kutumika tena.
• Tumia wakala msaidizi wakati kazi inahitaji utaalamu maalum au dirisha la muktadha lililotengwa.
• Tumia hook wakati kitendo lazima kifanyike kwa uthabiti.
• Tumia MCP kuunganisha mfumo wa nje kama GitHub, kivinjari, au hifadhidata.
• Tumia programu-jalizi kusambaza usanidi kamili kwenye hifadhi nyingine au kwa washiriki wa timu.
• Tumia claude -p, GitHub Actions, au Agent SDK kwa utekelezaji usiohitaji uangalizi.

Unda CLAUDE.md Yenye Manufaa

CLAUDE.md hutumika kama kumbukumbu ya mradi. Claude Code inaweza kuunda toleo la awali kwa /init, na unaweza kuhariri kumbukumbu kupitia /memory. Weka faili hii fupi na thabiti: jumuisha amri, mipaka ya usanifu, kanuni za uandishi wa msimbo, na vizuizi vilivyo wazi.

Huu ni mfano uliorekebishwa kutoka kwenye kozi:

# Mradi: Duka la Next.js na PostgreSQL

## Amri
- npm run dev — anza uundaji
- npm test — tekeleza majaribio ya Vitest
- npm run lint — tekeleza linta
- npm run db:migrate — inahitaji uthibitisho

## Usanifu
- src/app — njia
- src/lib — mantiki ya biashara
- src/db — ufikiaji wa hifadhidata
- Shughuli za hifadhidata lazima zipitie src/db

## Kanuni
- Tumia TypeScript kali na epuka any
- Ongeza majaribio kwa msimbo mpya
- Zalisha tena hitilafu kwa jaribio linaloshindwa kabla ya kuirekebisha
- Usibadilishe src/legacy isipokuwa ukiombwa wazi
- Kabla ya kumaliza, tekeleza npm test na npm run lint

Epuka kugeuza CLAUDE.md kuwa mwongozo mrefu. Weka maelekezo ya kina au yenye masharti katika .claude/rules/ au ujuzi unaoweza kutumika tena, ili maelekezo muhimu yasifunikwe.

Tumia Mtiririko Mkuu wa Maendeleo

Hifadhi ya msimbo inapendekeza mfuatano wa Chunguza → Panga → Andika Msimbo → Thibitisha → Fanya Commit. Kwa kazi yoyote inayoathiri eneo kubwa kuliko dogo kabisa, anza katika hali ya Kupanga badala ya kumwomba Claude ahariri mara moja.

1. Bonyeza Shift+Tab hadi hali ya Kupanga iwe amilifu.
2. Muulize Claude akague msimbo husika bila kufanya mabadiliko.
3. Kagua faili, hatua za utekelezaji, hatari na ukaguzi aliopendekeza.
4. Sahihisha mpango inapohitajika.
5. Ruhusu utekelezaji baada tu ya mpango kukubalika.
6. Hitaji majaribio, ukaguzi wa lint, ukaguzi wa aina za data, au picha za skrini.
7. Kagua diff kabla ya kuomba commit au ombi la kuvuta.

Kidokezo kizuri cha uchunguzi ni:

Hali ya Kupanga. Chunguza hifadhi ya msimbo na ueleze usanifu wake,
sehemu za kuanzia, mtiririko wa data wa /api/orders, majaribio yalipo,
na jinsi ya kuyaendesha. Usibadilishe chochote. Malizia kwa kutaja
maeneo matano ambapo mchangiaji mpya anaweza kufanya kosa.

Andika Maagizo Yanayoweza Kuthibitishwa

Badala ya kusema “rekebisha hitilafu,” eleza tatizo na uthibitishaji unaotarajiwa:

Barua pepe ikiwa tupu, signup() hushindwa kwa TypeError.
Rudia tatizo kwa jaribio linaloshindwa, lirekebishe kwa mabadiliko
madogo yanayofaa, kisha endesha npm test.

Kwa kazi ya kipengele inayoongozwa na majaribio:

Kipengele: tumia punguzo la 10% kwa oda za 5000 au zaidi.
Kwanza andika majaribio ya 4999, 5000, 0, na thamani hasi.
Thibitisha kuwa majaribio mapya yanashindwa, kisha tekeleza kipengele
bila kubadilisha majaribio hayo.

Kwa urekebishaji salama wa muundo:

Gawanya @src/services/user.ts kuwa moduli kulingana na majukumu.
Usibadilishe tabia au API ya umma. Endesha majaribio na tsc baada ya
kila hatua. Ikiwa coverage haitoshi, ongeza kwanza majaribio ya
kuainisha tabia iliyopo.

Dhibiti Muktadha kwa Makusudi

Dirisha la muktadha lina maelekezo ya mfumo, kanuni za mradi, maelezo ya ujuzi na mawakala, historia ya mazungumzo, faili na matokeo ya amri. Nyenzo zisizohusika zinapoongezeka, majibu yanaweza kuwa yasiyo sahihi zaidi.

• Tumia /context kukagua matumizi ya muktadha.
• Tumia /clear kabla ya kuanza kazi isiyohusiana.
• Tumia /compact kufupisha kipindi kirefu huku ukihifadhi maamuzi muhimu.
• Ongeza faili moja kwa moja kwa sintaksia kama @src/api/client.ts.
• Endesha amri na uweke matokeo yake kwenye muktadha kwa sintaksia kama !git status.
• Kwa kazi za muda mrefu, muombe Claude adumishe PLAN.md au NOTES.md.
• Kabidhi uchunguzi mkubwa kwa wakala mdogo ili muhtasari wake pekee urudi kwenye kipindi kikuu.

Pia unaweza kuelekeza kumbukumbu kwenye uombaji wa mara moja wa Claude Code:

cat error.log | claude

Sanidi Ruhusa Salama

Kanuni za ruhusa hutathminiwa kwa mpangilio wa kataa → uliza → ruhusu. Kataa ina kipaumbele kuliko ruhusu. Kozi inapendekeza kuruhusu kwa orodha amri salama badala ya kuzima ukaguzi wa ruhusa.

Usanidi wa timu unaweza kuweka kanuni katika .claude/settings.json:

{
  "permissions": {
    "allow": [
      "Bash(npm run test:*)",
      "Bash(npm run lint)",
      "Bash(git status)",
      "Bash(git diff:*)"
    ],
    "ask": [
      "Bash(git push:*)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Bash(rm -rf:*)",
      "Bash(curl:*)"
    ]
  }
}

Mfano huu unaruhusu majaribio ya kawaida na ukaguzi, huomba uthibitisho kabla ya kusukuma mabadiliko, na huzuia ufikiaji wa siri pamoja na amri hatari zilizochaguliwa.

• Usiweke siri katika CLAUDE.md.
• Hitaji uthibitisho kabla ya kusukuma mabadiliko, kusambaza, na kuendesha uhamishaji wa data.
• Endesha kazi huru katika kontena au sandbox isiyoweza kufikia uzalishaji.
• Chukulia maudhui yanayorudishwa na tovuti na mifumo ya MCP kuwa data, si maagizo yanayoaminika.
• Kagua git diff kabla ya kufanya commit ya mabadiliko.

Geuza Kazi Zinazorudiwa Kuwa Ujuzi

Ukijikuta ukirudia utaratibu mara kadhaa, ugeuze kuwa ujuzi. Ujuzi unafaa kwa mtiririko wa kazi kama kuandaa maelezo ya toleo, kukagua ombi la kuvuta, au kuanza kazi kwenye mradi.

Kozi huhifadhi ujuzi wa mradi katika .claude/skills/. Ujuzi unaweza kujumuisha jina, maelezo yanayomsaidia Claude kuamua wakati wa kuutumia, na mfuatano wa maelekezo. Weka utaratibu huo katika mipaka finyu na fafanua matokeo yanayotarajiwa.

Kwa mfano, ujuzi wa maelezo ya toleo unaweza kumwelekeza Claude kutafuta tagi ya hivi karibuni ya Git, kukusanya commit tangu tagi hiyo, na kupanga mabadiliko katika kategoria. Kifurushi cha kuanzia tayari hutoa ujuzi unaoweza kutumika tena, ambao unaweza kuchunguzwa baada ya usakinishaji.

Tumia Mawakala Wadogo kwa Kazi Zilizotengwa au Maalumu

Wakala mdogo hupokea dirisha lake la muktadha na kurudisha matokeo kwenye kipindi kikuu. Hii ni muhimu kwa utafiti wa hifadhi ya msimbo wenye taarifa nyingi, uendeshaji wa majaribio, uchanganuzi wa usalama, au ukaguzi huru.

Mfano wa mkaguzi wa hifadhi umehifadhiwa kama .claude/agents/reviewer.md na humpa wakala zana za kusoma, kutafuta na kutumia shell. Jukumu lake ni kukagua git diff kwa hitilafu, hali za mipakani, uvujaji wa siri, na ukiukaji wa mtindo wa mradi.

Mfumo wa vitendo wa mwandishi na mkaguzi ni:

1. Tumia kipindi kimoja cha Claude kutekeleza mabadiliko.
2. Fungua kipindi safi au wakala mdogo kukagua diff.
3. Rudisha matokeo kwenye kipindi cha utekelezaji.
4. Rekebisha matatizo na urudie uthibitishaji.

Muktadha safi humsaidia mkaguzi kutambua matatizo ambayo yanaweza kupuuzwa baada ya kipindi kirefu cha utekelezaji.

Imarisha Dhamana kwa Kulabu

Maelekezo ya mradi ni mwongozo, huku hooks zikiweza kuendesha au kuzuia vitendo kiotomatiki. Matukio muhimu ya hooks yaliyoelezwa na kozi ni pamoja na:

• SessionStart kwa kupakia maelezo ya tawi au kazi.
• UserPromptSubmit kwa kuongeza muktadha kwenye maelekezo.
• PreToolUse kwa kuzuia amri hatari au mabadiliko kwenye faili zilizolindwa.
• PostToolUse kwa uumbizaji, linting, au majaribio mahususi.
• Notification kwa arifa za eneo-kazi Claude inapohitaji ingizo.
• Stop kwa hatua ya mwisho ya uthibitishaji.
• PreCompact kwa kuhifadhi taarifa muhimu kabla ya kubanwa kwa muktadha.

Mfano huu unaendesha Prettier baada ya kuhariri au kuandika faili:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  }
}

Kwa ulinzi muhimu, changanya permissions.deny na hook ya PreToolUse badala ya kutegemea maelekezo yaliyoandikwa pekee.

Unganisha Mifumo ya Nje kwa MCP

Tumia MCP Claude inapohitaji zana au data iliyo nje ya hazina ya ndani. Kozi inashughulikia miunganisho inayohusisha GitHub, vivinjari, hifadhidata, na seva maalum za MCP.

MCP ya kivinjari ni muhimu hasa kwa kazi za kuona: Claude anaweza kutekeleza UI, kunasa picha ya skrini, kuilinganisha na rejeleo, na kurekebisha tofauti. Maudhui ya nje yanaweza kuwa na maandishi yasiyoaminika, kwa hiyo kagua kwa makini ufikiaji wa MCP na uwe macho dhidi ya sindano za maelekezo.

Otomatisha Kazi kwa Hali Isiyo na Kiolesura

Chaguo la -p huendesha maelekezo bila kipindi shirikishi, hivyo linafaa kwa skripti na CI. Kwa mfano, tuma kumbukumbu ya build iliyoshindwa na uombe matokeo yenye muundo:

claude -p "Find the cause of the build failure" \
  --output-format json < build.log

Kagua mabadiliko yako ya sasa kabla ya kusukuma:

git diff main | claude -p \
  "Review this diff for bugs, edge cases, and security issues"

Punguza zana na idadi ya zamu kwa kazi ya otomatiki yenye mipaka:

claude -p "Update CHANGELOG from recent commits" \
  --allowedTools "Read,Edit,Bash(git log:*)" \
  --max-turns 10

Hazina pia ina mifano ya GitHub Actions ya kutumia @claude kwenye issues na pull requests, pamoja na ukaguzi wa kiotomatiki.

Endesha Kazi Nyingi kwa Git Worktrees

Kwa kazi sambamba, unda worktree na tawi tofauti kwa kila kazi. Kila kipindi cha Claude hufanya kazi katika saraka tofauti, hivyo kuzuia mawakala kuhariri working tree moja kwa wakati mmoja.

git worktree add ../app-auth -b feature/auth
cd ../app-auth && claude

Unaweza kurudia muundo huu kwa kazi za malipo, marekebisho ya hitilafu, au kazi nyingine huru. Unganisha au kagua kila tawi kwa kutumia mtiririko wako wa kawaida wa Git.

Vidhibiti Muhimu vya Kipindi

• Esc hukatiza Claude bila kutupa muktadha wa kipindi.
• Esc Esc au /rewind hurudi kwenye hali ya awali ya msimbo na mazungumzo.
• Shift+Tab hubadilisha kati ya hali ya kawaida, kukubali mabadiliko kiotomatiki, na Plan.
• /model hubadilisha modeli inayotumika.
• /permissions, /hooks, /agents, na /mcp hufungua michakato ya usanidi inayohusiana.
• claude --continue huendeleza kipindi cha hivi karibuni.
• claude --resume hukuruhusu kuchagua kipindi cha awali.

Vidokezo vya Juu na Makosa ya Kawaida

• Anza kwa mpango: tumia hali ya Plan kwa mabadiliko yanayohusisha faili nyingi au yenye hatari kubwa.
• Toa mrejesho kila mara: majaribio, ukaguzi wa aina, linters, builds, picha za skrini, au matokeo yanayotarajiwa kwa usahihi humwezesha wakala kujirekebisha.
• Weka vipindi vikilenga kazi: futa muktadha kati ya kazi zisizohusiana badala ya kudumisha kipindi kimoja siku nzima.
• Rudisha nyuma mbinu zilizoshindwa: baada ya marekebisho kadhaa yasiyofanikiwa, tumia /rewind na eleza upya kazi badala ya kukusanya muktadha mbaya.
• Usikubali diffs bila kuzikagua: kagua mabadiliko mwenyewe au muombe subagent huru ayakague.
• Epuka ruhusa zisizo na mipaka: tumia orodha zinazoruhusiwa na sandbox badala ya kupita ukaguzi wa usalama.
• Otomatisha taratibu zinazorudiwa: geuza marudio kuwa skill na tabia ya lazima kuwa hook.
• Hifadhi maendeleo nje ya kipindi: dumisha faili la mpango au madokezo wakati wa kazi ndefu ili kazi iendelee baada ya /clear.

Fuata Njia Kamili ya Kujifunza

Moduli za hazina zinaendelea kupitia usakinishaji, uandishi wa maelekezo, kumbukumbu ya mradi, mipangilio, mitiririko ya kitaalamu ya kazi, skills, subagents, hooks, MCP, plugins, CI isiyo na kiolesura, na mbinu za juu. Maabara nane zinahusu kuanza kutumia, ruhusa, TDD, kuunda skill, subagents, hooks, MCP, na otomatiki.

Anza na usakinishaji wa haraka na amri za msingi za muktadha. Kisha unda CLAUDE.md fupi na sera salama ya ruhusa. Baada ya hapo, pitia upangaji, TDD, skills, subagents, na hooks kabla ya kuhamia MCP, plugins, na utekelezaji wa CI bila usimamizi.

Hitimisho

Claude Code huwa na ufanisi zaidi inapochukuliwa kama wakala wa usanidi wa maendeleo anayeweza kusanidiwa, badala ya kiolesura cha mazungumzo. Mpe muktadha unaolenga kazi, kubaliana kuhusu mpango, toa ukaguzi wa lengo, na tekeleza mipaka muhimu kwa ruhusa na hooks. Hazina ya Claude Code PRO inatoa kozi yenye muundo, maabara za vitendo, na violezo vinavyoweza kutumika tena kwa kutumia mtiririko huo kuanzia maendeleo ya mtu binafsi hadi otomatiki ya timu.