Paano Simulan ang Claude Code sa Terminal (Gabay sa 2026)

Mabilis na Buod: Ang pagsisimula ng Claude Code sa terminal ay direkta: i-install ito gamit ang isang-linyang utos mula sa opisyal na site, mag-authenticate gamit ang iyong Anthropic account, at i-type ang ‘claude’ upang ilunsad ang isang interactive session. Ang CLI tool ay gumagana sa macOS, Linux, at Windows, na nagpapahintulot sa mga developer na bumuo ng mga feature, ayusin ang mga bug, at i-automate ang mga gawain sa pamamagitan ng mga utos sa natural na wika nang direkta sa kanilang terminal environment.

Ang Claude Code ay kumakatawan sa isang pagbabago sa paraan ng pakikipag-ugnayan ng mga developer sa tulong ng AI. Sa halip na kopyahin ang code sa pagitan ng mga tab sa browser at text editor, ang terminal-based na tool na ito ay nananatili sa loob ng development workflow, nauunawaan ang buong codebases at nagsasagawa ng mga kumplikadong gawain sa pamamagitan ng mga utos sa pag-uusap.

Ang proseso ng pag-setup ay tumatagal ng wala pang limang minuto para sa karamihan ng mga developer. Ngunit may higit pa sa pagsisimula ng Claude Code nang epektibo kaysa sa simpleng pag-install.

Ang gabay na ito ay sumasaklaw sa lahat mula sa paunang pag-install hanggang sa paglulunsad ng mga produktibong sesyon, na may mga praktikal na halimbawa na gumagana sa mga totoong proyekto.

Ano Talaga ang Ginagawa ng Claude Code

Ayon sa opisyal na dokumentasyon, ang Claude Code ay isang agentic coding tool na nagbabasa ng codebases, nag-e-edit ng mga file, nagpapatakbo ng mga utos, at nakikipag-ugnayan sa mga development tool. Ang terminal interface ay nagsisilbing pangunahing punto ng interaksyon para sa karamihan ng mga developer.

Ang tool ay humahawak ng mga karaniwang gawain sa pag-develop: pagbuo ng mga feature, pag-aayos ng mga bug, pag-automate ng mga workflow, at pagpapaliwanag ng mga kumplikadong seksyon ng code. Ito ay gumagana na may buong konteksto ng mga file ng proyekto, git history, at mga tumatakbong proseso.

Hindi tulad ng mga AI assistant na nakabatay sa browser, ang Claude Code ay nagpapatakbo ng mga utos nang direkta sa shell environment. Kapag tinanong na ayusin ang isang build error, hindi lamang ito nagmumungkahi ng mga solusyon—maaari nitong aktwal na isagawa ang pag-aayos, subukan ang resulta, at i-commit ang mga pagbabago.

Terminal Kumpara sa Iba Pang Platform

Ang Claude Code ay gumagana sa maraming platform: terminal CLI, desktop application, web interface, IDE extensions para sa VS Code at JetBrains, at isang Chrome extension para sa pag-debug ng mga live na application. Ang bersyon ng terminal ay nag-aalok ng pinaka-direktang kontrol.

Ang mga terminal session ay nagbibigay ng mga keyboard shortcut, background task execution, at integrasyon sa mga umiiral na shell configurations. Ang mga developer na nakatira sa command line ay makakahanap nito na pinakamabilis na interface.

Mga Kinakailangan sa Pag-install

Bago i-install ang Claude Code, i-verify ang sistema na nakakatugon sa mga pangunahing kinakailangan. Ang tool ay tumatakbo sa macOS, Linux, at Windows (kasama ang WSL2).

Kinakailangan ang isang aktibong Anthropic account. Kung wala ka pa, gumawa nito sa opisyal na website ng Anthropic bago magpatuloy sa pag-install.

Ang terminal ay dapat may internet connectivity at pahintulot na mag-download at magpatakbo ng mga script. Ang ilang corporate network ay naghihigpit sa script execution—kumunsulta sa IT kung nabigo ang pag-install.

Mga Suportadong Operating System

Alisin ang pahayag na ito – hindi matagpuan sa opisyal na materyal ng mapagkukunan. Ang pag-install ay gumagana sa pamamagitan ng Terminal o anumang terminal emulator tulad ng iTerm2.

Ang mga distribusyon ng Linux ay nangangailangan ng modernong shell (bash o zsh). Karamihan sa mga kamakailang Ubuntu, Debian, Fedora, at Arch installations ay gumagana nang walang pagbabago.

Ang mga user ng Windows ay dapat munang i-install ang Windows Subsystem for Linux (WSL2). Mayroong native na suporta sa Windows ngunit ang WSL2 ay nagbibigay ng mas mahusay na compatibility sa mga development tool.

Bawasan ang Gastos sa AI Tools gamit ang Get AI Perks Habang Nagsisimula Ka

Ang pagsisimula sa Claude Code ay madalas na nangangahulugang sinusubukan din ang iba pang AI tools. Ang Get AI Perks ay tumutulong sa mga founder na makahanap ng startup credits at software discounts sa AI at cloud products. Pinagsasama-sama ng platform ang 200+ na alok, kabilang ang mga perk para sa Claude, Anthropic, OpenAI, Gemini, ElevenLabs, at higit pa, kasama ang mga kundisyon para sa bawat isa.

Gusto Mo Bang Makita ang Mga Available na AI Tool Perks?

Tingnan ang Get AI Perks para:

• Mag-browse ng mga alok para sa Claude at iba pang AI tool
• Makita kung aling mga perk ang babagay sa iyong kumpanya
• Sundin ang mga gabay upang makuha ang mga available na credits

👉 Bisitahin ang Get AI Perks upang paghambingin ang mga available na AI software perks.

Hakbang-Hakbang na Proseso ng Pag-install

Ang opisyal na paraan ng pag-install ay gumagamit ng isang utos na nakakadetect ng operating system at nag-i-install ng naaangkop na bersyon.

Para sa macOS at Linux

Magbukas ng terminal window at patakbuhin ang utos na ito:

Ang installation script ay nagda-download ng Claude Code binary, inilalagay ito sa isang system path location, at inaayos ang shell integration. Karaniwang natatapos ang proseso sa wala pang 30 segundo.

Kung magtagumpay ang pag-install, ang terminal ay magpapakita ng kumpirmasyon ng mensahe. Subukan ang pag-install sa pamamagitan ng pag-type:

Ang utos na ito ay dapat magbalik ng kasalukuyang numero ng bersyon. Kung sa halip ay may lumabas na error na nagsasabing “command not found,” kailangan ng pag-aayos sa PATH configuration.

Para sa Windows na may WSL2

Una, tiyaking naka-install at naka-configure ang WSL2. Magbukas ng WSL2 terminal (Ubuntu ang inirerekomenda) at patakbuhin ang parehong installation command gaya ng sa Linux:

Minsan nagkakaroon ng mga isyu sa networking na partikular sa Windows sa WSL2. Ayon sa troubleshooting documentation, maaaring kailanganin ang pag-aayos ng mga firewall rule upang payagan ang komunikasyon sa pagitan ng WSL2 at mga proseso ng Windows.

Pag-troubleshoot ng Mga Isyu sa Pag-install

Ang pinakakaraniwang problema sa pag-install ay ang PATH configuration. Kapag ipinapakita ng terminal ang “command not found” pagkatapos ng pag-install, ang Claude binary ay wala sa executable path ng shell.

Tingnan ang lokasyon ng pag-install sa pamamagitan ng:

Kung wala itong ibabalik, manu-manong idagdag ang installation directory sa PATH. Para sa bash, idagdag ang linyang ito sa ~/.bashrc:

Para sa mga zsh user, idagdag ang parehong linya sa ~/.zshrc sa halip. I-restart ang terminal o patakbuhin ang source ~/.bashrc upang agad na mailapat ang mga pagbabago.

Ang mga pagkabigo sa pag-install na nauugnay sa network ay madalas na ipinapakita bilang “TLS connect error” o pagkaantala ng download. Nagpapahiwatig ang mga ito ng mga paghihigpit sa firewall o mga lipas na sertipiko. I-update ang mga system certificate o makipag-ugnayan sa mga network administrator kung nagtatrabaho sa isang corporate network.

Pag-authenticate at Unang Paglunsad

Pagkatapos ng matagumpay na pag-install, ang pag-authenticate ay nagkokonekta sa lokal na CLI sa isang Anthropic account. Simulan ang proseso ng pag-authenticate sa pamamagitan ng pagpapatakbo ng:

Ang unang paglunsad ay awtomatikong nagti-trigger ng pag-authenticate. Magbubukas ang isang window ng browser na nagpapakita ng isang login page. Mag-sign in gamit ang iyong Anthropic account credentials.

Pagkatapos makumpleto ang pag-authenticate sa browser, ang terminal session ay magiging aktibo. Ang isang welcome message ay kumpirmahin ang koneksyon at magpakita ng mga pangunahing tagubilin sa paggamit.

Pamamahala ng Session

Sa bawat pagpapatakbo ng claude sa isang terminal, nagsisimula ito ng bagong session. Ang mga session ay nagpapatuloy hanggang sa tahasang matapos gamit ang Ctrl+D o sa pag-type ng exit.

Ang authentication token ay naka-store nang lokal, kaya ang mga susunod na paglunsad ay hindi nangangailangan ng browser login. Ang token ay mananatiling balido hanggang sa manu-manong ma-revoke sa pamamagitan ng mga setting ng account sa website ng Anthropic.

Pagsisimula ng Interactive Mode

Ang interactive mode ay kumakatawan sa pangunahing paraan ng paggamit ng mga developer ng Claude Code. Ilunsad ito sa pamamagitan ng pag-type ng claude nang walang karagdagang argumento.

Ang terminal ay lilipat sa isang interactive na prompt kung saan ang mga utos sa natural na wika ay nagdidirekta sa AI. Ang mode na ito ay nagpapanatili ng konteksto ng pag-uusap, naaalala ang mga nakaraang kahilingan, at maaaring magsagawa ng multi-step na mga workflow.

Mahahalagang Utos sa Interactive

Maraming built-in na utos ang kumokontrol sa pag-uugali ng session. 

I-type ang mga ito sa Claude Code prompt:

• /model – Lumipat sa pagitan ng iba’t ibang Claude models (Opus, Sonnet)
• /status – Tingnan ang kasalukuyang modelo, session ID, at configuration
• /btw – Magtanong ng mga side question nang hindi binabago ang task context
• ? – Ipakita ang mga keyboard shortcut at impormasyon ng tulong

Ang mga keyboard shortcut ay nagpapabuti sa productivity. Pindutin ang Ctrl+L upang linisin ang screen ng terminal nang hindi tinatapos ang session. Gamitin ang Ctrl+C upang kanselahin ang isang tumatakbong generation. Ang Ctrl+F ay magko-terminate ng lahat ng background tasks (pindutin nang dalawang beses upang kumpirmahin).

Ang status line sa ibaba ay nagpapakita ng mga aktibong background na proseso, kasalukuyang modelo, at paggamit ng token. Ang impormasyong ito ay nakakatulong sa pagsubaybay sa pagkonsumo ng mapagkukunan sa panahon ng mga kumplikadong gawain.

Pagpapatakbo ng Background Task

Maaaring magpatakbo ang Claude Code ng mahabang operasyon sa background habang nananatiling responsive sa mga bagong utos. Ang mga background task ay nagpapakita ng mga progress indicator at kumukumpleto nang asynchronous.

Kapag maraming operasyon ang tumatakbo nang sabay-sabay, sinusubaybayan ng task list ang bawat isa. Pindutin ang Ctrl+F upang tingnan at pamahalaan ang mga background na proseso.

Pagpapatakbo ng mga One-Time Command

Hindi lahat ng gawain ay nangangailangan ng isang interactive na sesyon. Para sa mga mabilis na operasyon, ang Claude Code ay tumatanggap ng mga utos nang direkta bilang mga argumento:

Ang utos na ito ay magsisimula ng Claude Code, ipoproseso ang kahilingan, ipapakita ang output, at agad na lalabas. Walang interactive session na magsisimula.

Ang mga one-time command ay gumagana nang mahusay para sa scripting at automation. Maaari silang isama sa mga git hook, CI/CD pipeline, o shell script na nangangailangan ng AI assistance para sa mga partikular na subtask.

Query-Only Mode

Ang -p flag ay nagpapatakbo ng query-only mode, na sumasagot sa mga tanong nang hindi gumagawa ng mga pagbabago sa file:

Ang mode na ito ay nagbabasa ng mga file ng proyekto ngunit hindi ito mag-e-edit, magagawa, o mabubura ng anumang bagay. Nagbibigay lamang ito ng impormasyon, kaya ligtas ito para sa paggalugad nang walang panganib ng hindi sinasadyang pagbabago.

Pagpili at Konfigurasyon ng Modelo

Sinusuportahan ng Claude Code ang maraming AI models na may iba’t ibang kakayahan at bilis ng pagproseso. Ayon sa opisyal na dokumentasyon, ang mga suportadong modelo ay kinabibilangan ng Sonnet 4.6, Opus 4.6, Opus 4.5, Haiku 4.5, at Sonnet 4.5.

Baguhin ang aktibong modelo gamit ang /model command sa panahon ng isang interactive na sesyon. Ang isang interactive na menu ay naglilista ng mga available na opsyon na may maikling paglalarawan ng mga kalakasan ng bawat modelo.

Para sa permanenteng kagustuhan ng modelo, magtakda ng environment variable bago ilunsad ang Claude Code:

Ang konfigurasyong ito ay nagpapatuloy sa mga sesyon hanggang sa mabago ang variable o maalis ito.

Konfigurasyon ng Fast Mode

Priyoridad ng fast mode ang bilis ng tugon kaysa sa komprehensibong pagsusuri. Ito ay kapaki-pakinabang para sa mabilis na mga pag-ulit at simpleng mga gawain kung saan ang buong konteksto ng pagsusuri ay hindi kinakailangan.

Paganahin ang fast mode sa pamamagitan ng configuration ng mga setting o sa pamamagitan ng paggamit ng mga variant ng modelo na na-optimize para sa bilis. Suriin ang opisyal na dokumentasyon para sa mga kasalukuyang opsyon ng fast mode dahil nagbabago ang mga ito sa mga bagong model release.

Paggawa sa mga Proyekto

Nauunawaan ng Claude Code ang istraktura ng proyekto sa pamamagitan ng pagsusuri ng mga file sa kasalukuyang direktoryo at mga subdirectory. Mag-navigate sa isang project directory bago magsimula:

Awtomatikong binabasa ng tool ang mga file ng proyekto, nauunawaan ang istraktura ng codebase, at kinikilala ang mga karaniwang pattern tulad ng mga package manager, mga configuration ng framework, at mga build tool.

Pagbubukod ng mga Sensitibong File

Ang ilang mga file ay hindi dapat suriin o baguhin ng mga AI tool—mga credential, API key, malalaking binary file, o nabuong nilalaman. Gumawa ng .claudeignore file sa root ng proyekto upang ibukod ang mga partikular na path:

Ito ay gumagana nang katulad sa .gitignore syntax. Ang mga ibinukod na file ay mananatiling hindi nakikita ng Claude Code sa panahon ng parehong pagsusuri at pagpapatupad.

Mga Tip sa Konfigurasyon ng Terminal

Mas mahusay na gumagana ang Claude Code sa ilang mga konfigurasyon ng terminal. Karamihan sa mga problema ay nagmumula sa mga hindi tugmang setting ng shell o mga nawawalang feature.

Shell Integration

Palamigin: Ang ilang modernong terminal ay sumusuporta sa mga opsyonal na feature ng shell integration tulad ng prompt detection sa pamamagitan ng OSC 133 sequences, bagaman ang mga ito ay hindi kinakailangan

Para sa pinakamahusay na compatibility, gumamit ng mga kamakailang bersyon ng mga sikat na terminal emulator: iTerm2 sa macOS, Alacritty, Kitty, o WezTerm sa Linux. Gumagana nang maayos ang Windows Terminal sa WSL2.

Pag-customize ng Keyboard Shortcut

Ang mga default na keyboard shortcut ay maaaring magkasalungat sa mga umiiral na terminal o shell bindings. I-customize ang mga ito sa pamamagitan ng settings configuration file na matatagpuan sa ~/.claude/settings.json.

Ang settings file ay gumagamit ng JSON format at sumusuporta sa pag-remap ng anumang built-in command sa iba’t ibang key combinations. Pagkatapos i-edit, i-restart ang Claude Code upang mailapat ang mga pagbabago.

Mga Karaniwang Workflow ng Unang Session

Totoo: ang unang Claude Code session ay kadalasang nagsasangkot ng eksperimentasyon. Narito ang mga praktikal na panimulang punto na nagpapakita ng mga pangunahing kakayahan.

Galugarin ang Codebase

Magsimula sa pamamagitan ng pagtatanong sa Claude Code na ipaliwanag ang istraktura ng proyekto:

“Bigyan mo ako ng pangkalahatang-ideya ng codebase na ito. Ano ang mga pangunahing bahagi at paano sila nagtutulungan?”

Ang kahilingang ito ay hindi nagbabago ng anumang bagay—ito ay nagsusuri at nagpapaliwanag lamang. Ang tugon ay nakakatulong upang kumpirmahin na tama ang pagkakaintindi ng Claude Code sa organisasyon ng proyekto.

Gumawa ng Simpleng Pagbabago

Subukan ang isang mababang-risk na pagbabago upang makita ang pag-e-edit ng file na gumagana:

“Magdagdag ng komento sa itaas ng README.md na nagpapaliwanag kung ano ang ginagawa ng proyektong ito”

Binabasa ng Claude Code ang file, bumubuo ng naaangkop na nilalaman, at ginagawa ang pag-edit. Suriin ang pagbabago gamit ang git diff upang makita kung ano mismo ang nangyari.

Ayusin ang Isang Umiiral na Isyu

Kung ang proyekto ay may mga kilalang bug o TODO items, hilingin sa Claude Code na tugunan ang mga ito:

“Ayusin ang bug sa pagpapatunay ng login na inilarawan sa isyu #42”

Binabasa ng tool ang mga kaugnay na source file, tinutukoy ang problema, ipinapatupad ang isang pag-aayos, at maaari pa itong magpatakbo ng mga pagsusuri upang kumpirmahin na gumagana ang solusyon.

Mga Pahintulot at Kaligtasan

Humihingi ng pahintulot ang Claude Code bago magsagawa ng mga potensyal na mapanganib na operasyon. Ang sistema ng pahintulot ay nagkakategorya ng mga utos ayon sa antas ng epekto.

Ang pagbabasa ng file ay nangyayari nang walang mga prompt ng pahintulot—ang pagbasa ng code ay palaging ligtas. Ang pagsulat, pagbubura ng file, at pagpapatupad ng shell command ay nangangailangan ng tahasang pag-apruba sa unang paglitaw.

Ang mga pagpipilian sa pahintulot ay maaaring i-save para sa sesyon o permanente. Ang mga permanenteng pahintulot ay naka-store sa mga configuration file at nalalapat sa lahat ng mga susunod na sesyon.

Konfigurasyon ng Sandboxing

Ayon sa opisyal na dokumentasyon ng mga setting, ang sandboxing ay naghihigpit kung saan maaaring gumawa ng mga pagbabago ang Claude Code. I-configure ang mga sandbox path prefix upang limitahan ang pag-access sa file system sa mga partikular na direktoryo.

Ang security layer na ito ay pumipigil sa hindi sinasadyang pagbabago ng mga system file o mga direktoryo sa labas ng saklaw ng proyekto. Ang mga koponan na nagtatrabaho sa mga sensitibong codebase ay dapat mag-configure ng sandboxing bago ang deployment.

Mga Madalas Itanong

Mga Susunod na Hakbang Pagkatapos ng Pag-install

Kapag matagumpay na tumatakbo ang Claude Code, galugarin ang mga pinalawig nitong kakayahan. Ang opisyal na dokumentasyon ay sumasaklaw sa mga advanced na paksa tulad ng custom subagents, plugin development, at naka-schedule na task automation.

Ang mga Skills ay nagbibigay ng paraan upang palawigin ang Claude Code gamit ang mga project-specific commands at workflows. Ang paggawa ng mga skills sa .claude/skills/ directory ay nagdaragdag ng custom na kakayahan na akma sa mga partikular na pangangailangan sa pag-develop.

Ang integrasyon ng Model Context Protocol (MCP) ay nagpapahintulot sa Claude Code na makipag-ugnayan sa mga external tools at services. Nagbubukas ito ng mga posibilidad para sa mga database query, API testing, at infrastructure management sa pamamagitan ng parehong conversational interface.

Ang mga Remote Control feature ay nagpapahintulot sa pagpapatuloy ng mga session sa iba’t ibang device. Simulan ang trabaho sa isang desktop machine, pagkatapos ay ipagpatuloy ang parehong sesyon sa isang laptop o mobile device. Suriin ang platform integrations documentation para sa mga tagubilin sa pag-setup.

Pagkuha ng Tulong Kapag Nahihirapan

Ang opisyal na troubleshooting documentation ay tumutugon sa karamihan ng mga karaniwang isyu. Kapag nagkaroon ng mga problema, suriin muna ito bago lumalim sa system configuration.

Ang mga diskusyon sa komunidad sa mga platform tulad ng Reddit ay nagbibigay ng mga real-world na solusyon mula sa ibang mga developer. Maraming user ang nagbabahagi ng kanilang mga configuration tweaks at workflow optimizations sa mga forum na ito.

Para sa mga problema sa pag-install o pag-authenticate, i-verify ang status ng account sa website ng Anthropic. Ang mga expired na subscription o mga paghihigpit sa account ay pumipigil sa matagumpay na koneksyon kahit na may tamang lokal na setup.

Ang mga isyu na partikular sa terminal ay kadalasang nauugnay sa shell configuration o compatibility. Ang pagsubok gamit ang isang default na terminal configuration (nang walang custom shell customizations) ay tumutulong sa paghihiwalay kung ang problema ay nagmumula sa mga lokal na pagbabago.

Konklusyon

Ang pagsisimula ng Claude Code sa terminal ay tumatagal lamang ng ilang minuto kapag natapos na ang pag-install. Ang kombinasyon ng mga utos sa natural na wika at direktang integrasyon sa codebase ay lumilikha ng isang development workflow na humahawak sa parehong mga simpleng query at kumplikadong multi-file refactoring.

Pinapanatili ng terminal interface ang mga developer sa kanilang pinipiling environment nang walang context switching sa mga tab sa browser o hiwalay na mga application. Ang pagpapatakbo ng background task ay nangangahulugan na ang mga mahabang operasyon ay hindi humaharang sa iba pang trabaho.

Gaya ng anumang development tool, ang kahusayan ay nakukuha sa pamamagitan ng pagsasanay. Magsimula sa mga simpleng read-only query upang maunawaan kung paano binibigyang-kahulugan ng Claude Code ang istraktura ng proyekto. Mag-graduate sa mga pag-edit ng file at automated workflows habang tumataas ang kumpiyansa. Pinipigilan ng permission system ang mga hindi maibabalik na pagkakamali sa yugto ng pag-aaral.

Handa ka na bang baguhin ang iyong coding workflow? I-install ang Claude Code ngayon at maranasan ang AI-assisted development nang direkta sa iyong terminal.