Kumpletong Gabay sa Paggamit ng Claude Code: Mula sa Pag-install Hanggang sa Pagpapatakbo ng AI para Tapusin ang Isang Feature

Alas-onse ng gabi, dalawang tao na lang ang natira sa isang startup office sa Neihu. Nakatanggap ang isang engineer ng bug na kailangang maayos bago mag-deploy kinabukasan. Ang problema, ang module ay isinulat ng isang kasamahan na umalis tatlong taon na ang nakararaan—walang comments, walang tests. Ipinasok niya ang kinakailangan (requirement) sa terminal at tumayo para kumuha ng kape. Pagbalik niya, nakalista na sa screen ang limang kaugnay na file, tinukoy ang posibleng sanhi, naayos ang isa rito, at napatakbo na ang mga test.

Hindi ito isang eksena sa patalastas; ito na ang araw-araw na paggamit ng Claude Code ngayon. Pero dahil talagang binabago nito ang iyong source code, ang halaga ng maling paggamit ay mas mataas kaysa sa mga karaniwang AI tool. Inayos ko sa artikulong ito ang mismong ginagamit kong daloy ng trabaho (workflow), kasama ang ilang pagkakamali na pinagsisihan ko na.

Ano Ito: Isang Agent, Hindi Lang Code Completion

Linawin muna natin ang posisyon nito dahil ito ang magpapasya kung paano mo ito gagamitin.

Ang pamilyar na AI coding tools sa karamihan ay "completion-type": ikaw ang nagta-type, hinuhulaan nito ang susunod na linya, at pinipindot mo ang Tab para tanggapin. Ang GitHub Copilot ay nasa ganitong modelo noong simula. Nakatutok ka lang habang binabawasan nito ang oras mo sa pag-type.

Ang Claude Code naman ay "agent-type." Magbibigay ka ng layunin (goal)—ayusin ang bug na ito, o lagyan ng pagination ang API na ito—at ito na ang magpapasya kung aling mga file ang babasahin, aling mga command ang tatakbo, at paano aayusin kapag nabigo ang test. Pagkatapos ng buong ikot (cycle), ikaw na lang ang magre-review at mag-aapruba.

Ang praktikal na kahulugan nito ay: ang iyong papel ay lumilipat mula sa "taong nagta-type" patungo sa "taong nagrerepaso (reviewer)." Ang natitipid ay hindi ang oras sa pag-type, kundi ang oras sa pag-unawa sa hindi kilalang code at sa pagsubok at pagkakamali (trial and error). At para sa mga taong kulang sa kakayahang mag-review, mapanganib ang paggamit ng tool na ito.

Saan Ito Magagamit

Mas marami ang kasalukuyang interface kaysa sa inaakala ng karamihan:

• Terminal CLI: Pinakabuong features; ang install command ay curl -fsSL https://claude.ai/install.sh | bash
• Desktop App: Available sa macOS, Linux, at Windows
• Browser Version: claude.ai/code, hindi na kailangang i-install
• IDE Extensions: VS Code at JetBrains
• Mobile: iOS at Android App
• Slack Bot: Direktang magbukas ng mga task sa loob ng usapan
• GitHub Actions: Para sa automated PR review

Personal kong ginagamit ang CLI habang tinitingnan ko ang progress sa mobile. Ang bentahe ng CLI ay nasa loob ito mismo ng direktoryo ng proyekto, kaya handa na ang mga environment variables, git status, at test commands.

Paano Gamitin: Apat na Hakbang

Hakbang 1: I-install at Ilunsad sa Direktoryo ng Proyekto

Pagkatapos itong i-install, siguraduhing mag-cd muna sa root directory ng proyekto bago ito simulan. Marami ang nagsisimula nito sa kanilang home directory, kaya hindi nito makita ang istruktura ng proyekto at napipilitang manghula lamang. Sa unang paglulunsad, hihingi ito ng login. Kung may Claude subscription ka, i-bind mo lang ito nang direkta; kung API keys naman, sisingilin ito ayon sa paggamit (token-based).

Hakbang 2: Hayaan Muna Itong Unawain ang Proyekto Bago Magutos

Ang pinakakaraniwang pagkakamali ng mga baguhan ay ang pagbato ng mga kahilingan agad-agad. Ang mas magandang unang linya ay:

Tingnan muna ang istruktura ng proyektong ito, sabihin sa akin ang tech stack, kung paano nahahati ang pangunahing modules, at kung paano pinatatakbo ang mga test. Huwag munang baguhin ang anuman.

Napakahalaga ng linyang "Huwag munang baguhin ang anuman"—likas itong agresibo, at kung hindi mo ito pipigilan, maaaring simulan na nito ang pagbabago. Siguraduhing naintindihan niya bago magpatuloy sa susunod na hakbang.

Hakbang 3: Sumulat ng CLAUDE.md, ang Pinakamahalagang Bahagi ng Tool na Ito

Maglagay ng CLAUDE.md sa root directory ng proyekto kung saan nakasulat ang mga patakaran (rules) ng proyekto. Binabasa ito sa tuwing magsisimula ka. Ang kalidad ng file na ito ang direktang magpapasiya kung magiging madali o nakakainis ang paggamit mo.

Ang dapat talagang isulat:

Mga Kaugalian sa Proyekto (Project Conventions)

• Frontend TypeScript + React, Backend Node.js
• Gumamit ng vitest para sa testing, i-run ang command na npm run test
• Ang commit messages ay dapat nasa tamang pormat: type: description

Mga Mahigpit na Limitasyon (Important Constraints)

• Gawin lamang ang aking malinaw na ipinagagawa. Huwag kusang mag-refactor o magdagdag ng mga abstraction layer na hindi hinihingi.
• Huwag magdagdag ng mga third-party package maliban na lang kung magtanong muna sa akin.
• Huwag galawin ang code sa ilalim ng src/legacy/ dahil iyon ang lumang sistema na papalitan pa.
• Pagkatapos magbago, siguraduhing patakbuhin ang npm run test. Huwag sabihing tapos na kung hindi pasa ang tests.

Para sa akin, ang linyang "Gawin lamang ang aking malinaw na ipinagagawa" ang pinakamahalagang patakaran. Kapag pinagawa mo ito ng isang bug fix, baka kusang i-refactor nito ang tatlong file, magdagdag ng error handling, at maglagay ng types. Kahit mukhang tama ang mga ito nang hiwalay, magiging bangungot ang iyong code review, at hindi mo na makikita kung alin ang talagang kinakailangan para sa bug fix at alin ang dinagdag lamang nito nang kusang-loob.

Hakbang 4: Magbigay ng Task at Mag-review

Mas detalyado ang paglalarawan ng task, mas mabuti. Masamang tanong kumpara sa magandang tanong:

• ❌ "Tulungan mo akong i-optimize ang code na ito" — hindi nito alam kung ano ang gusto mong i-optimize; baka baguhin ang performance o kaya ay ang readability.
• ✅ "Ang function na ito ay nag-e-timeout kapag lumampas sa 10,000 ang data. Hanapin ang bottleneck at ayusin ito nang hindi binabago ang external interface nito. Pagkatapos baguhin, patakbuhin ang mga test."

Ang ikalawang paraan ay nagbibigay ng layunin, mga limitasyon, at pamantayan sa pag-apruba (acceptance criteria).

Mga Advanced na Tip

Gamitin ang /clear para putulin ang context. Kapag lumipat ka ng task nang hindi bina-clear, makakaapekto sa desisyon nito ang konteksto ng nakaraang task. Isang malinis na usapan bawat task.

Samantalahin ang plan mode. Para sa malalaking pagbabago, hilingin muna rito na "Magbigay lamang ng plano, huwag munang kumilos." Mas madaling mag-review muna bago payagan kaysa sa magbago muna bago i-rollback.

Hayaan itong basahin ang error message nang mag-isa. Hindi na kailangang kopyahin at i-paste ang mga error; direktang utusan itong patakbuhin ang mga test. Babasahin nito ang output at aayusin ito nang mag-isa.

Pamamahala ng Quota. Ang Pro plan (mga $17–$20 USD kada buwan) ay madaling maubos ang quota sa loob ng ilang oras kapag gumagawa ng malalaking refactoring. Ang mga seryosong gumagamit nito ay kadalasang nag-a-upgrade sa Max 5x ($100) o Max 20x ($200). Iminumungkahi kong gamitin muna ang Pro nang isang buwan at itala ang dalas ng pagkaubos ng limit bago magdesisyon.

Mga Pag-iingat

Maaari itong gumawa ng code na mukhang tama pero may mali pala. Ang isinusulat nito ay may wastong syntax, pare-parehong estilo, at mukhang propesyonal, ngunit maaaring mali ang lohika, lalo na sa mga edge cases at concurrency issues. Kailangan mong magkaroon ng kakayahang i-review ang output nito—hindi ito opsyonal.

Kumpirmahin muna ang isyu ng data leakage. Ang code ay ipapadala sa cloud model. Para sa mga proyektong may kinalaman sa pananalapi, pangangalagang pangkalusugan (healthcare), at may mga kontrata sa pagiging konpidensyal (NDA), siguraduhing kumpirmahin murang patakaran ng kumpanya at mga tuntunin ng kontrata bago ito gamitin.

Huwag itong hayaang hawakan ang database migrations at production deployment. Ang mga ganitong operasyon ay hindi na maibabalik (irreversible), at ang halaga ng pagkakamali ay mas mataas kaysa sa oras na matitipid. Ang aking alituntunin ay: Hayaang gawin ang mga bagay na pwedeng ibalik (reversible), pero ikaw ang gumawa sa mga hindi na maibabalik.

Huwag asahan na papalitan nito ang iyong pag-iisip sa arkitektura. Magaling ito sa pagpapatupad (execution), ngunit ang mga desisyong tulad ng "dapat bang gawin ang feature na ito, dapat bang hatiin ang mga serbisyo, paano idisenyo ang data model" ay nananatiling trabaho mo pa rin. Kung gusto mong mag-cross-compare, maaari mo itong ipares sa mga editor integration tulad ng Cursor.

Angkop na Daloy ng Trabaho (Workflow)

Ang aking ritmo: sa umaga, ibinibigay ko rito ang mga task na may malinaw na saklaw (scope) para tumakbo, habang ginagawa ko naman ang mga bahaging nangangailangan ng pagpapasiya (judgment). Sa hapon, sabay-sabay kong nire-repaso ang mga diff na ginawa nito. Para sa higit pang mga paraan ng pagsasama ng AI sa pang-araw-araw na trabaho, maaari mong tingnan ang AI Task Guide o Prompt Template Library.

Puna mula sa TheAI學院

Sa totoo lang, naiinis ako sa mga pahayag na "papalitan ng AI ang mga engineer," pero pagkatapos ng ilang buwang paggamit, inaamin ko na talagang nagbabago ang nilalaman ng trabaho ng isang engineer. Ang nagbago ay hindi "kung kailangan pa ba ang mga engineer," kundi ang paglipat ng halaga mula sa "pagsusulat" patungo sa "pagpapasya kung tama ba ang pagkakasulat."

Puna: Ang Claude Code ang kasalukuyang pinaka-mature na AI coding agent, ngunit pinapalaki lamang nito ang iyong umiiral na kakayahan sa pagpapasya—ang mga taong may malakas na pagpapasya ay dodoble ang produksyon, habang ang mga mahina ang pagpapasya ay mas mabilis lamang na makakagawa ng technical debt.

Isang tiyak na mungkahi para sa mga mambabasa: ang mga engineer na may higit sa tatlong taong karanasan ay dapat na itong ilagay sa kanilang daloy ng trabaho ngayon, simula sa "pagsusulat ng tests" at "pag-aayos ng mga malilinaw na bug"—pinakamataas ang balik at pinakamababa ang panganib. Para naman sa mga baguhan, iminumungkahi ko na isulat muna ito nang mag-isa bago ihambing sa output nito; huwag laktawan ang yugto ng pagbuo ng sariling kakayahan sa pagpapasya. Para sa mga koponan (teams) na nais itong gamitin, hayaan muna ang isa o dalawang senior engineer na subukan ito sa loob ng isang buwan, at kalkulahin ang balik batay sa natipid na oras—mas tumpak ito kaysa sa anumang pagsusuri (review).

Pinagmulan ng Datos

• Opisyal na Pahina ng Produkto ng Claude Code (Para sa mga paraan ng pag-install, mga sinusuportahang platform, at mga plano)

Inayos ayon sa pampublikong impormasyon, sumangguni sa opisyal na site para sa katotohanan. Ang mga aktwal na tampok at pagpepresyo ay maaaring magbago ayon sa bersyon.