Mabilisang Buod: Ang Claude Code CLI ay ini-install gamit ang isang solong utos na awtomatikong nagda-download at nagko-configure ng tool. Sa macOS at Linux, gamitin ang opisyal na shell script mula sa mga dokumentasyon ng Anthropic, habang ang mga gumagamit ng Windows ay nagpapatakbo ng mga utos sa PowerShell o WSL. Pagkatapos ng pag-install, mag-authenticate gamit ang iyong API key upang simulan ang paggamit ng AI coding assistant ng Claude sa iyong terminal.
Ang Claude Code ay isang agentic coding tool na naninirahan sa iyong terminal at nauunawaan ang iyong buong codebase. Ayon sa opisyal na dokumentasyon ng Claude Code, kaya nitong magbasa ng mga file, magpatakbo ng mga utos, mag-edit ng code, at mag-integrate sa mga development tool sa pamamagitan ng mga natural na pag-uusap.
Ngunit ang pagsisimula ay nangangailangan ng tamang pag-install. Narito ang lahat ng kailangan upang mai-install ang Claude Code CLI at maayos itong ma-configure.
Mga Kinakailangan sa Sistema Bago ang Pag-install
Bago i-install ang Claude Code, beripikahin na natutugunan ng sistema ang mga pangunahing kinakailangan. Ayon sa opisyal na dokumentasyon ng Advanced setup, alisin ang pangungusap na ito nang buo.
Suriin ang pag-install ng Node.js sa pamamagitan ng pagbubukas ng terminal at pagpapatakbo ng:
| node –version |
Kung hindi pa naka-install ang Node.js o ang bersyon ay mas mababa sa 18, i-download ito mula sa opisyal na website ng Node.js. Gumagana nang perpekto ang Long-Term Support (LTS) na bersyon para sa Claude Code.
Bukod sa Node.js, kailangan ng sistema ang mga pangunahing kinakailangan: macOS 13.0 o mas mataas para sa mga gumagamit ng Mac, Windows 10 o mas mataas para sa mga sistemang Windows, at karamihan sa mga modernong distribusyon ng Linux ay gumagana nang walang problema. Kinakailangan din ang isang Claude account mula sa Anthropic para sa pag-authenticate pagkatapos ng pag-install.
Pag-install ng Claude Code sa macOS at Linux
Ang proseso ng pag-install para sa macOS at Linux ay gumagamit ng isang solong shell command na awtomatikong humahawak sa lahat. Ang pamamaraang ito ay nakadokumento sa opisyal na gabay sa mabilisang pagsisimula ng Claude Code.
Buksan ang Terminal at patakbuhin ang installation script:
| curl -fsSL claude.ai/install.sh | bash |
Ang script ay nagda-download ng binary ng Claude Code, inilalagay ito sa tamang direktoryo, at awtomatikong inaayos ang PATH. Karaniwang natatapos ang buong proseso sa wala pang isang minuto.
Para sa mga gumagamit ng macOS na mas gusto ang Homebrew, mayroong alternatibong paraan ng pag-install bagaman hindi ito opisyal na nakadokumento sa mga pangunahing mapagkukunan. Ang pamamaraang curl ang nananatiling inirerekomendang diskarte ayon sa opisyal na dokumentasyon.
Pag-verify ng Pag-install
Pagkatapos makumpleto ang pag-install, beripikahin na naa-access ang Claude Code:
| claude –version |
Dapat ipakita ng utos na ito ang naka-install na numero ng bersyon. Kung magkaroon ng error na nagsasabing "command not found", kailangang ayusin ang PATH configuration.
Ayon sa opisyal na dokumentasyon sa pag-troubleshoot, ang mga problema sa PATH ang pinakakaraniwang problema sa pag-install. Ang solusyon ay ang pagdaragdag ng installation directory ng Claude sa file ng configuration ng shell.
Pag-install ng Claude Code sa macOS at Linux
Ang proseso ng pag-install para sa macOS at Linux ay umaasa sa npm (Node Package Manager). Ayon sa opisyal na dokumentasyon, dapat mayroon kang Node.js 18+ na naka-install sa iyong sistema bago magpatuloy. Hindi tulad ng mga tradisyonal na CLI tool na gumagamit ng mga shell script, ang Claude Code ay ini-install nang global sa pamamagitan ng iyong terminal upang matiyak na ang lahat ng dependencies ay nahahawak nang tama.
Buksan ang iyong Terminal at patakbuhin ang sumusunod na utos upang i-install ang package:
| export CLAUDE_CODE_RELEASE_ALPHA=1 && npm install -g @anthropic-ai/claude-code |
Tandaan: Ang environment variable na CLAUDE_CODE_RELEASE_ALPHA=1 ay kasalukuyang kinakailangan sa panahon ng pampublikong beta/alpha phase upang kilalanin ang preview status ng tool.
Ang utos na ito ay nagda-download ng package mula sa opisyal na npm registry at iniuugnay ang claude executable sa global bin directory ng iyong sistema. Habang ang ilang gumagamit ay maaaring sumubok na hanapin ang mga Homebrew formula, ang pamamaraang npm ang tanging opisyal na suportado at nakadokumentong landas ng pag-install.
Pag-verify ng Pag-install
Pagkatapos makumpleto ang pag-install, beripikahin na ang CLI ay tama ang pagkakaugnay sa iyong kapaligiran sa pamamagitan ng pagpapatakbo ng:
| claude –version |
Dapat ipakita ng utos na ito ang kasalukuyang numero ng bersyon (hal., 0.2.9). Kung makaranas ka ng error na "command not found", karaniwan itong nangangahulugan na ang iyong global npm directory ay wala sa PATH ng iyong sistema.
Ayon sa opisyal na dokumentasyon sa pag-troubleshoot, maaari mo itong ayusin sa pamamagitan ng pagtukoy sa iyong npm prefix gamit ang npm config get prefix at tiyaking ang magiging /bin folder ay maidagdag sa iyong .zshrc o .bashrc file.
Pag-install ng Claude Code sa Windows
Ang pag-install sa Windows ay nag-aalok ng dalawang pangunahing paraan: native na pag-install sa PowerShell o paggamit ng Windows Subsystem for Linux (WSL). Inirerekomenda ng opisyal na dokumentasyon ang PowerShell para sa karamihan ng mga gumagamit.
Paraan ng Pag-install sa PowerShell
Buksan ang PowerShell bilang Administrator (mag-right-click sa Start menu at piliin ang "Windows PowerShell (Admin)"). Patakbuhin ang utos na ito:
| irm claude.ai/install.ps1 | iex |
Ang PowerShell script ay awtomatikong humahawak sa pag-download, pag-install, at pag-configure ng PATH. Pagkatapos makumpleto, isara at muling buksan ang PowerShell upang matiyak na magkabisa ang mga update sa PATH.
Paraan ng Pag-install sa WSL
Ang mga developer na gumagamit na ng WSL ay maaaring mag-install ng Claude Code gamit ang pamamaraan sa Linux. Buksan ang WSL terminal at patakbuhin ang parehong curl command na ginamit para sa Linux:
| curl -fsSL claude.ai/install.sh | bash |
Ang pamamaraang WSL ay gumagana nang magkapareho sa mga native na pag-install sa Linux. Isang bentahe: nagbibigay ang WSL ng kapaligirang mas malapit sa Unix na tumutugma sa mga configuration ng production server.
Ayon sa opisyal na dokumentasyon sa pag-troubleshoot, paminsan-minsan ay nakakaranas ang mga gumagamit ng WSL ng mga problema sa koneksyon sa network. Kung mahinto ang pag-install, beripikahin na maa-access ng WSL ang mga panlabas na network at hindi hinaharangan ng mga panuntunan sa firewall ang trapiko.
Hanapin ang Claude at AI Tool Credits sa Isang Lugar
Ang pag-install ng Claude Code CLI ay isang hakbang. Ang pagbabayad para sa mga AI tool sa pangmatagalan ay isa pa. Ang Get AI Perks ay nangongolekta ng mga startup credit at diskwento sa software para sa mga AI at cloud tool sa isang lugar. Nagbibigay ito ng access sa mga founder sa mahigit 200 perks, kabilang ang mga alok mula sa Anthropic, Claude, OpenAI, Gemini, ElevenLabs, Intercom, at iba pa. Ipinapakita rin ng platform ang mga kondisyon ng perk at mga gabay sa pag-claim ng bawat alok.
Naghahanap ng Claude o Anthropic Credits?
Suriin ang Get AI Perks upang:
- maghanap ng mga AI tool credit at diskwento sa isang lugar
- suriin ang mga kondisyon ng perk bago mag-apply
- magkaroon ng access sa mga gabay sa pag-claim ng mga startup alok
👉 Bisitahin ang Get AI Perks upang tingnan ang mga available na Claude, Anthropic, at iba pang AI software perks.
Pag-authenticate at Paunang Pag-configure
Pagkatapos ng pag-install, kinakailangan ng Claude Code ang pag-authenticate bago ito gumana. Gumagamit ang tool ng mga API key mula sa Anthropic upang beripikahin ang access.
Simulan ang proseso ng pag-authenticate sa pamamagitan ng pagpapatakbo ng:
| claude |
Sa unang pagpapatakbo ng utos na ito, magtatanong ang Claude Code para sa pag-authenticate. Ayon sa opisyal na gabay sa mabilisang pagsisimula, magbubukas ito ng browser window upang mag-log in sa Claude account.
Pagkatapos mag-log in sa pamamagitan ng browser, awtomatikong makakakuha ang CLI ng isang authentication token. Ang token na ito ay naka-imbak nang lokal at nananatili sa mga session, kaya hindi na kailangan ng paulit-ulit na pag-authenticate.
Pag-configure ng mga Setting sa Antas ng Proyekto
Sinusuportahan ng Claude Code ang pag-configure sa maraming antas ayon sa opisyal na dokumentasyon ng mga setting. Ang pinakakaraniwang antas ng pag-configure ay:
| Saklaw | Lokasyon | Gamit |
|---|---|---|
| Gumagamit | ~/.claude/ directory | Mga personal na kagustuhan sa lahat ng proyekto |
| Proyekto | .claude/ sa repository | Pinagsasaluhang configuration ng koponan |
| Lokal | .claude/settings.local.json | Mga pag-override na partikular sa makina |
Para sa unang pag-setup, sapat na ang configuration sa antas ng gumagamit. Nagiging mahalaga ang mga setting sa antas ng proyekto kapag nagtatrabaho kasama ang mga koponan na nagbabahagi ng mga pamantayan sa pag-code.
Pagsisimula ng Iyong Unang Claude Code Session
Kapag kumpleto na ang pag-install at pag-authenticate, ilunsad ang Claude Code sa pamamagitan ng pagpapatakbo ng utos nang walang argumento:
| claude |
Ito ay magsisimula ng interactive mode kung saan sasagot ang Claude sa mga natural na kahilingan sa wika. Inilalarawan ng opisyal na dokumentasyon ang interactive mode bilang pangunahing paraan ng paggamit ng Claude Code para sa mga gawain sa pag-develop.
Subukan ang isang simpleng test command:
| Ipakita sa akin ang istraktura ng proyektong ito |
Susuriin ng Claude Code ang kasalukuyang direktoryo at magbibigay ng pangkalahatang-ideya ng istraktura ng codebase. Ito ay nagpapakita na ang pag-install ay gumagana nang tama at may access ang Claude na basahin ang mga file.
Mahahalagang Utos para sa Pang-araw-araw na Paggamit
Bukod sa interactive mode, sinusuportahan ng Claude Code ang ilang mga pattern ng utos na nakadokumento sa CLI reference:
| Pattern ng Utos | Layunin | Halimbawa |
|---|---|---|
| claude | Simulan ang interactive session | claude |
| claude “gawain” | Magpatakbo ng one-time task | claude “ayusin ang mga linting error” |
| claude -p “query” | Mabilisang query nang walang session | claude -p “ano ang ginagawa ng function na ito” |
Ang one-time task pattern ay partikular na kapaki-pakinabang para sa mga CI/CD pipeline at mga automation script kung saan hindi angkop ang isang interactive session.
Mga Karaniwang Pag-troubleshoot sa Pag-install
Kahit na may mga automated installation script, paminsan-minsan ay nagkakaroon ng mga problema. Sakop ng opisyal na dokumentasyon sa pag-troubleshoot ang mga pinakakaraniwang problema.
Mga Error na "Command Not Found"
Kung ipinapakita ng terminal ang "command not found: claude" pagkatapos ng pag-install, hindi tama ang pagkakakumpleto ng PATH configuration. Para sa macOS at Linux, manu-manong idagdag ang lokasyon ng binary ng Claude sa configuration file ng shell.
Para sa mga gumagamit ng bash, i-edit ang ~/.bashrc o ~/.bash_profile at idagdag:
| export PATH=”$HOME/.local/bin:$PATH” |
Para sa mga gumagamit ng zsh (default sa modernong macOS), i-edit ang ~/.zshrc gamit ang parehong linya. Pagkatapos mag-save, i-reload ang configuration gamit ang source ~/.zshrc o buksan ang isang bagong terminal window.
Mga Isyu sa Network at Firewall
Ang mga corporate network at mahigpit na firewall ay paminsan-minsan ay hinaharangan ang installation script. Ayon sa dokumentasyon sa pag-troubleshoot, kung mahinto ang pag-install o magbalik ng HTML sa halip na magpatupad, maaaring nahaharangan ang network access sa mga server ng Anthropic.
Ang solusyon ay ang pag-download ng install script nang hiwalay:
| curl -fsSL code.anthropic.com/install.sh -o install.sh chmod +x install.sh ./install.sh |
Ang pamamaraang ito ay nagbibigay ng mas maraming nakikitang impormasyon tungkol sa kung ano ang nabibigo kung magkaroon ng mga error sa pag-download o pagpapatupad.
Mga Problema na Espesipiko sa WSL
Ang mga gumagamit ng Windows na nagpapatakbo ng WSL ay paminsan-minsan ay nakakaranas ng mga problema sa koneksyon sa pagitan ng Linux subsystem at Windows. Binabanggit ng opisyal na dokumentasyon na maaaring kailanganing ayusin ang mga panuntunan sa firewall upang payagan ang trapiko ng WSL.
Kung matagumpay na nai-install ang Claude Code ngunit hindi nito maabot ang mga server ng Anthropic para sa pag-authenticate, tingnan kung pinapayagan ng Windows firewall ang pag-access sa network ng WSL. Nagbibigay ang gabay sa pag-troubleshoot ng mga partikular na utos sa PowerShell para sa pag-configure ng mga panuntunan sa firewall.
Pag-update ng Claude Code
Ang Claude Code ay nakakakuha ng mga regular na update na may mga bagong feature at pagpapahusay. Ayon sa opisyal na dokumentasyon, ang mga update ay ini-install gamit ang parehong utos tulad ng paunang pag-install.
Patakbuhin muli ang install script:
| curl -fsSL code.anthropic.com/install.sh | sh |
Natutuklasan ng script ang kasalukuyang pag-install at ina-upgrade ito sa pinakabagong bersyon. Walang configuration o authentication na nawawala sa proseso ng pag-update.
Suriin ang kasalukuyang bersyon bago at pagkatapos ng pag-update:
| claude –version |
Nakalista sa changelog sa opisyal na dokumentasyon ng Claude Code ang lahat ng mga pagbabago sa pagitan ng mga bersyon, na tumutulong sa pagtukoy kung ang isang update ay nagpapakilala ng mga feature na nauugnay sa mga partikular na workflow.
Mga Susunod na Hakbang Pagkatapos ng Pag-install
Kapag naka-install at gumagana na ang Claude Code, magiging posible ang pag-explore ng mga advanced na feature. Inilalarawan ng opisyal na dokumentasyon ang ilang mga lugar na sulit tuklasin:
- Mga Kakayahan at pag-customize: Ayon sa opisyal na dokumentasyon ng mga kakayahan, sinusuportahan ng Claude Code ang mga custom na kakayahan na tinukoy sa mga Markdown file sa loob ng .claude/skills/ directory. Ang mga kakayahang ito ay nagpapalawak ng mga kakayahan ng Claude sa mga utos at workflow na partikular sa proyekto.
- Model Context Protocol (MCP): Pinapayagan ng MCP integration ang Claude Code na kumonekta sa mga panlabas na tool at serbisyo. Ginagawa nitong hub ang Claude na makaka-access sa mga database, API, at iba pang mga mapagkukunan ng pag-develop.
- Pakikipagtulungan ng Koponan: Ang mga configuration file sa antas ng proyekto sa .claude/ directory ay maaaring i-commit sa version control, na nagbabahagi ng mga setting ng Claude Code sa buong mga development team.
- Nagbibigay ang opisyal na dokumentasyon ng detalyadong mga gabay para sa bawat isa sa mga lugar na ito, na bumubuo sa mga pangunahing pag-install na sakop dito.
Mga Madalas Itanong
Kailangan ko ba ng bayad na Claude subscription para magamit ang Claude Code CLI?
Kinakailangan ng Claude Code ang isang Claude account mula sa Anthropic, ngunit ang partikular na antas ng subscription na kailangan ay depende sa paggamit. Ayon sa opisyal na dokumentasyon, kinakailangan ang pag-authenticate ngunit ang mga detalye ng pagpepresyo ay dapat beripikahin sa opisyal na website ng Anthropic dahil nagbabago ang mga plano sa paglipas ng panahon.
Maaari ko bang i-install ang Claude Code nang walang administrator privileges?
Sa macOS at Linux, naka-install ang Claude Code sa home directory ng gumagamit bilang default at hindi nangangailangan ng administrator access. Ang mga gumagamit ng Windows ay maaaring mangailangan ng administrator privileges para sa paraan ng pag-install sa PowerShell, bagaman hindi nangangailangan ng admin access ang mga pag-install sa WSL.
Gumagana ba ang Claude Code offline?
Hindi. Ang Claude Code ay isang AI-powered tool na nakikipag-usap sa mga server ng Anthropic upang iproseso ang mga kahilingan. Ayon sa opisyal na dokumentasyon, kinakailangan ang aktibong koneksyon sa internet upang masuri ng Claude ang code at makabuo ng mga tugon.
Paano ko ia-uninstall ang Claude Code?
Ipinaliliwanag ng opisyal na dokumentasyon ng Advanced setup na ang pag-uninstall ay nagsasangkot ng pagtanggal ng binary at mga configuration file. Sa macOS at Linux, tanggalin ang ~/.claude directory at alisin ang pagbabago sa PATH mula sa mga configuration file ng shell. Ang mga gumagamit ng Windows ay dapat tanggalin ang installation directory at linisin ang PATH environment variable.
Maa-access ba ng Claude Code ang aking buong filesystem?
Bilang default, ang Claude Code ay gumagana sa loob ng kasalukuyang working directory at mga subdirectory nito. Ayon sa opisyal na dokumentasyon ng mga pahintulot, maaaring mas higpitan pa ang access gamit ang mga setting ng sandbox sa mga configuration file. Palaging humihingi ng kumpirmasyon ang Claude bago magpatupad ng mga potensyal na mapanirang operasyon.
Ano ang pagkakaiba ng Claude Code CLI at Claude Desktop?
Ang Claude Code CLI ay tumatakbo sa terminal at nakatutok sa mga workflow sa pag-develop na may direktang pag-access sa filesystem at pagpapatupad ng utos. Ang Claude Desktop ay isang standalone na aplikasyon na may graphical interface. Parehong nagsisilbi ang mga tool sa iba't ibang gamit, kung saan ang CLI ay na-optimize para sa mga developer na mas gusto ang mga workflow na nakabatay sa terminal.
Gaano kadalas ko dapat i-update ang Claude Code?
Maaaring i-install ang mga update kapag ito ay maginhawa. Idinodokumento ng opisyal na changelog ang mga bagong feature at pag-aayos ng bug. Para sa mga koponan, ang pag-coordinate ng mga update ay tinitiyak na lahat ay gumagamit ng mga katugmang bersyon, bagaman pinapanatili ng Claude Code ang backward compatibility sa mga configuration file sa lahat ng bersyon.
Konklusyon
Ang pag-install ng Claude Code CLI ay tumatagal lamang ng ilang minuto anuman ang operating system. Hinahawakan ng mga automated installation script ang configuration, PATH setup, at paglalagay ng binary nang walang manu-manong interbensyon.
Pagkatapos ng pag-install at pag-authenticate, ang Claude Code ay nagiging isang makapangyarihang AI coding assistant na maa-access mula sa anumang terminal. Pinapayagan ng mga natural na utos sa wika ang mga developer na magsulat ng code, ayusin ang mga bug, at i-automate ang mga gawain nang hindi umaalis sa command line.
Handa nang maranasan ang AI-assisted development? Patakbuhin ang installation command para sa iyong platform at simulan ang iyong unang Claude Code session ngayon. Nagbibigay ang opisyal na dokumentasyon sa code.claude.com ng mga komprehensibong gabay para sa mga advanced na feature kapag natapos na ang pangunahing setup.
