Quick Summary: Ang Claude Code ay maaaring i-install sa pamamagitan ng native installers sa macOS, Windows, at Linux mula sa opisyal na website ng Claude Code. Kailangang i-install muna ng mga user ng Windows ang WSL2 bago patakbuhin ang Claude Code. Pagkatapos ng installation, mag-authenticate gamit ang iyong Claude account kapag nagbukas ang Claude Code ng browser window para mag-log in ka sa unang paglulunsad upang simulan ang coding gamit ang AI assistance direkta mula sa iyong terminal o desktop app.
Ang Claude Code ay kumakatawan sa pagtulak ng Anthropic sa mga agentic AI development tools. Ang command-line assistant na ito ay nagbabasa ng mga codebase, nag-e-edit ng mga file, nagpapatakbo ng mga command, at nakikipag-integrate sa mga development workflow.
Ngunit ang pag-install nito ay hindi palaging direkta. Ang iba't ibang platform ay nangangailangan ng iba't ibang paraan. Ang Windows ay nangangailangan ng karagdagang setup. At ang dokumentasyon, bagaman komprehensibo, ay maaaring makapagpalaki sa mga baguhan.
Ang gabay na ito ay nagpuputol sa pagiging kumplikado. Sinasaklaw nito ang mga kinakailangan sa system, mga hakbang sa pag-install na partikular sa platform, authentication, at verification—lahat ng kailangan upang gumana nang maayos ang Claude Code.
Mga Kinakailangan sa System Bago ang Pag-install
Ayon sa opisyal na dokumentasyon ng Claude Code, sinusuportahan ng tool ang macOS, Windows, at Linux. Gayunpaman, ang bawat platform ay may mga partikular na prerequisite.
Para sa macOS, minimal ang mga kinakailangan. Kailangan ng system ang macOS 13.0 o mas bago. Parehong gumagana nang maayos ang Intel at Apple Silicon chips.
Ang Windows ay nagpapakita ng mas maraming pagiging kumplikado. Ang operating system ay dapat na Windows 10 Build 19041 o mas bago, o Windows 11. Ngunit narito ang problema—hindi natively tumatakbo ang Claude Code sa Windows.
Ang Windows Subsystem for Linux 2 (WSL2) ay mandatory. Lumilikha ito ng Linux environment kung saan talagang gumagana ang Claude Code. Kung walang WSL2, mabibigo ang installation.
Kailangan ng mga user ng Linux ng 64-bit distribution. Kinukumpirma ng opisyal na dokumentasyon ang suporta para sa Ubuntu, Debian, Fedora, at iba pang malalaking distribusyon. Ang Alpine Linux at mga sistemang batay sa musl ay nangangailangan ng karagdagang configuration.
Kailangan ng lahat ng platform ng matatag na koneksyon sa internet sa panahon ng installation. Ang mga laki ng pag-download ay nag-iiba ngunit karaniwang nasa pagitan ng 50MB hanggang 500MB depende sa kung ano ang naka-install na.
| Platform | Minimum na Bersyon | Mga Espesyal na Kinakailangan |
|---|---|---|
| macOS | 13.0 | Wala |
| Windows | 10 Build 19041 o 11 | Kinakailangan ang WSL2 |
| Linux | 64-bit distribution | Mas gusto ang glibc-based |
Pag-install ng Claude Code sa macOS
Gumagamit ang proseso ng pag-install ng macOS ng native installer. Ito ang pinakasimpleng daan sa lahat ng platform.
Una, i-download ang installer mula sa opisyal na website ng Claude Code. Awtomatikong nakikita ng download page ang macOS at nag-aalok ng angkop na package.
Buksan ang na-download na .dmg file. I-drag ang Claude Code application sa Applications folder. Karaniwang pag-install ng macOS—walang kakaiba dito.
Nakakaranas ang ilang user ng security prompt kapag unang naglulunsad. Pinipigilan ng macOS ang mga app mula sa mga hindi natukoy na developer bilang default. I-right-click ang Claude Code application at piliin ang "Open" upang malampasan ang isang beses na babala na ito.
Awtomatikong nag-i-install ang command-line tool kasama ang desktop application. Buksan ang Terminal at i-type ang claude --version upang i-verify. Kung lumabas ang numero ng bersyon, matagumpay ang installation.
Pag-verify ng macOS Installation
Patakbuhin ang mga command na ito upang kumpirmahin na lahat ay gumagana:
| claude --version claude --help |
Dapat magbalik ng output ang parehong command nang walang error. Ang bersyon ng command ay nagpapakita ng naka-install na bersyon ng Claude Code. Ang help command ay nagpapakita ng mga available na opsyon at command.
Ang paglikha ng test directory ay nakakatulong upang ma-verify ang buong functionality. Mag-navigate sa isang project folder at patakbuhin ang claude upang simulan ang isang interactive session. Dapat na mag-initialize ang tool at humingi ng authentication kung hindi pa naka-log in.
Windows Installation Kasama ang WSL2
Ang pag-install sa Windows ay nangangailangan ng maraming hakbang. Mas matagal ang proseso kaysa sa macOS ngunit nananatiling manageable.
Dapat munang ma-install ang WSL2. Buksan ang PowerShell bilang Administrator at patakbuhin:
| wsl --install |
Ang command na ito ay nag-i-install ng WSL2 at Ubuntu bilang default. Kakailanganin ng system ng restart. Pagkatapos ng reboot, awtomatikong maglulunsad ang Ubuntu upang makumpleto ang paunang setup.
Gumawa ng Unix username at password kapag tinanong. Ang mga credential na ito ay hiwalay sa mga Windows login credential.
Kapag tumatakbo na ang WSL2, ang proseso ng pag-install ng Linux ang naaangkop. Buksan ang Ubuntu terminal (na-install kasama ang WSL2) at i-download ang Claude Code installer para sa Linux.
Pag-install ng Claude Code sa WSL2
Ayon sa opisyal na dokumentasyon, ang installation command ay nagda-download at nagpapatakbo ng native installer:
| curl -o- raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash |
Awtomatikong hinahawakan ng script na ito ang mga dependency. Ina-install nito ang Node.js kung kinakailangan, inaayos ang Claude Code binary, at kino-configure ang PATH variables.
Tumatagal ng ilang minuto ang installation. Ang mga progress bar at status message ay nagpapakita ng nangyayari. Kapag kumpleto na, isara at buksan muli ang terminal upang i-refresh ang mga environment variable.
Ang pagsubok sa installation ay sumusunod sa parehong proseso tulad ng sa macOS. Patakbuhin ang claude --version upang i-verify.
Proseso ng Pag-install sa Linux
Ang mga user ng Linux ay may pinakadiretsong daan ng installation. Gumagana ang native installer nang direkta nang walang karagdagang layer tulad ng WSL2.
I-download at patakbuhin ang installation script:
| curl -fsSL claude.ai/install.sh | bash |
Dinada-download nito ang Claude Code binary, nag-i-install ng mga dependency, at kino-configure ang shell environment. Nakikita ng script ang distribusyon at nag-a-adjust nang naaayon.
Para sa mga sistema na batay sa Ubuntu at Debian, ang script ay kino-configure ang installation. Kinukumpirma ng opisyal na dokumentasyon ang suporta para sa Ubuntu 20.04+, Debian 10+, at iba pang distribusyon.
Mga Konsiderasyon sa Alpine Linux
Ang Alpine Linux at mga distribusyong batay sa musl ay nangangailangan ng karagdagang hakbang. Napapansin ng opisyal na dokumentasyon na ang mga sistemang ito ay nangangailangan ng manual configuration.
Maaaring mabigo ang standard installer sa Alpine. Sa halip, i-download ang musl-compatible binary direkta mula sa releases page. I-extract ito sa isang directory sa system PATH, karaniwang /usr/local/bin.
Magtakda ng executable permissions:
| chmod +x /usr/local/bin/claude |
Dapat i-verify ng mga user ng Alpine ang compatibility bago magpatuloy. Ang ilang feature ay maaaring hindi gumana nang eksaktong tulad ng sa mga glibc-based distribution.
Authentication at Setup ng Account
Pagkatapos i-install ang Claude Code, patakbuhin ang claude sa iyong terminal. Sa unang paglulunsad, magbubukas ang Claude Code ng browser window para mag-log in ka.
Bubuksan nito ang Claude authentication page. Mag-sign in gamit ang isang umiiral na Claude account o gumawa ng bago.
Ipapakita ng browser ang isang authorization code. Kopyahin ang code na ito at bumalik sa terminal. I-paste ang code kapag tinanong.
Ang matagumpay na authentication ay nagse-save ng mga credential nang lokal. Ang mga susunod na session ay hindi mangangailangan ng login maliban kung mag-expire ang mga credential o manu-manong mabura.
Authentication ng Team at Enterprise
Ayon sa opisyal na dokumentasyon ng authentication, ang mga team na gumagamit ng Claude for Teams o Enterprise ay may karagdagang mga opsyon. Maaaring i-configure ng mga organisasyon ang single sign-on (SSO) o cloud provider authentication.
Ang setup ng SSO ay nangangailangan ng configuration ng administrator. Pagkatapos ay mag-a-authenticate ang mga indibidwal na developer sa pamamagitan ng identity provider ng kanilang organisasyon sa halip na mga personal na Claude account.
Ang cloud provider authentication ay gumagana para sa mga deployment ng AWS, Google Cloud, at Azure. Ang paraang ito ay gumagamit ng mga umiiral na cloud credential sa halip na mga hiwalay na Claude account.
| Paraan ng Authentication | Gamit | Pagiging Kumplikado ng Setup |
|---|---|---|
| Personal na Account | Mga indibidwal na developer | Simple |
| Teams/Enterprise SSO | Mga Organisasyon | Nangangailangan ng admin |
| Cloud Provider | Mga user ng AWS/GCP/Azure | Katamtaman |
Pag-install ng Desktop App
Nag-aalok ang Claude Code ng parehong command-line at desktop applications. Ang desktop app ay nagbibigay ng graphical interface habang pinapanatili ang buong functionality ng terminal.
I-download ang desktop installer mula sa opisyal na website ng Claude. Nag-aalok ang page ng mga bersyon para sa macOS, Windows, at Windows ARM64. Piliin ang angkop na bersyon para sa system.
Ang pag-install ng macOS ay sumusunod sa parehong proseso ng .dmg na nailarawan kanina. Maaaring mag-download ang mga user ng Windows ng desktop app para sa isang graphical interface nang hindi nangangailangan ng WSL2 setup.
Kasama sa desktop app ang integrated terminal access. Maaari itong maglunsad ng mga Claude Code session nang hindi lumilipat sa mga external na terminal application.
Ang isang kalamangan ng desktop app ay ang background availability. Ayon sa opisyal na download page, ang app ay 'nananatiling handa sa background' at maaaring ilabas mula sa anumang app nang hindi lumilipat ng mga window o nawawala ang focus.
Gamitin ang Get AI Perks upang Maghanap ng mga Credit para sa Iyong Claude Code Stack
Ang installation ang madaling bahagi. Ang tunay na gastos ay karaniwang nagmumula sa lahat ng bagay sa paligid nito: imprastraktura, mga sumusuportang tool, at mga bayad na serbisyo na ginamit sa panahon ng setup at pagsubok. Makakatulong ang Get AI Perks sa pamamagitan ng paglilista ng mga startup credit at diskwento sa isang lugar, kasama ang gabay sa kung paano mag-apply.
Sa Get AI Perks, maaari kang:
- Maghanap ng mga credit para sa cloud at mga tool na may kaugnayan sa AI
- Suriin ang mga kondisyon ng perk bago mag-apply
- Iwasan ang pag-aaksaya ng oras sa mga alok na maaaring hindi mo kwalipikado
- Babaan ang gastos sa paglalagay ng iyong setup
Bisitahin ang Get AI Perks upang makita kung ang mga available na alok ay tumutugma sa mga tool na plano mong gamitin sa Claude Code.
IDE Extensions at Integrations
Bukod sa standalone installation, nakikipag-integrate ang Claude Code sa mga popular na development environment. May mga extension para sa Visual Studio Code at JetBrains IDEs.
Ang VS Code extension ay nag-i-install sa pamamagitan ng marketplace. Maghanap ng "Claude Code" sa Extensions panel at i-click ang Install. Nangangailangan ang extension na ma-install muna ang command-line tool.
Naiulat ng ilang user ang mga isyu sa bundled VS Code extension file. Kung mabigo ang awtomatikong installation na may error na "End of central directory record signature not found", maaaring corrupted ang bundled .vsix file.
Ang workaround ay nagsasangkot ng manual installation ng extension mula sa VS Code marketplace sa halip na umasa sa bundled version ng CLI. Pinaghihiwalay nito ang dalawang bahagi at pinipigilan ang mga conflict sa installation.
Ang JetBrains integration ay gumagana nang katulad. I-install ang plugin mula sa JetBrains marketplace sa loob ng IntelliJ IDEA, PyCharm, WebStorm, o iba pang JetBrains products.
Pag-verify ng Tagumpay ng Installation
Tinitiyak ng tamang verification na gumagana nang tama ang Claude Code bago simulan ang mga aktwal na development task.
Sinusuri ng basic verification ang availability ng command:
| claude --help claude --version |
Dapat mag-execute ang mga command na ito nang walang error. Ang help command ay naglilista ng mga available na opsyon. Ang bersyon ng command ay nagpapakita ng naka-install na release.
Ang functional testing ay nangangailangan ng pagsisimula ng session. Gumawa ng test directory:
| mkdir test-project cd test-project claude |
Inilulunsad nito ang isang interactive na Claude Code session. Dapat suriin ng tool ang directory (walang laman sa kasong ito) at magpakita ng prompt.
Subukan ang mga simpleng command sa loob ng session. I-type ang help upang makita ang mga available na aksyon. Humiling ng mga simpleng gawain tulad ng "gumawa ng README file" o "ipaliwanag kung ano ang kaya mong gawin."
Ang matagumpay na mga tugon ay nagpapahiwatig ng tamang installation. Kung magkaroon ng mga error, karaniwan itong may kaugnayan sa authentication, network connectivity, o mga nawawalang dependency.
Pamamahala ng Update at Bersyon
Awtomatikong nag-u-update ang Claude Code bilang default. Ipinaliliwanag ng opisyal na dokumentasyon na sinusuri ng tool ang mga bagong bersyon at ini-install ang mga ito nang walang interbensyon ng user.
Maaaring i-configure ang behavior ng update sa pamamagitan ng mga setting ng Claude Code. Sinasaklaw ng opisyal na dokumentasyon ang configuration ng release channel at mga opsyon sa manual update.
Ang mga manual update ay nangangailangan ng muling pagpapatakbo ng installation script. Ang parehong command na ginamit para sa paunang installation ay kinukuha ang pinakabagong bersyon:
| curl -fsSL claude.ai/install.sh | bash |
Posible ang pag-install ng mga partikular na bersyon para sa pagsubok o mga dahilan ng compatibility. Sinasaklaw ng advanced setup documentation ang version pinning at configuration ng release channel.
Kasama sa mga release channel ang stable, beta, at nightly. Inirerekomenda ang Stable para sa production work. Ang mga beta at nightly channel ay nagbibigay ng maagang access sa mga bagong feature ngunit maaaring maglaman ng mga bug.
Mga Karaniwang Problema sa Pag-install
Maraming isyu ang madalas na lumalabas sa mga talakayan sa komunidad tungkol sa pag-install ng Claude Code.
Maraming problema ang nagiging sanhi ng PATH configuration. Kung hindi mahanap ang claude command pagkatapos ng installation, ang binary directory ay wala sa system PATH.
Sa macOS at Linux, ang pagdagdag ng directory sa PATH ay karaniwang nagsasangkot ng pag-e-edit ng ~/.bashrc, ~/.zshrc, o mga katulad na configuration file ng shell. Karaniwang hinahawakan ito ng installation script nang awtomatiko, ngunit nakakatulong ang manual verification sa pag-troubleshoot.
Maaaring kailanganin ng mga user ng Windows sa WSL2 na isara at buksan muli ang terminal pagkatapos ng installation. Ang mga environment variable ay hindi nagre-refresh sa mga umiiral na session.
Ang mga network restriction ay humaharang sa ilang installation. Maaaring pigilan ng mga corporate firewall o proxy server ang pagda-download ng installer o pagkonekta sa mga authentication server.
Ang proxy configuration ay nangangailangan ng mga environment variable:
| export HTTP_PROXY= proxy.example.com:8080 export HTTPS_PROXY= proxy.example.com:8080 |
Nagkakaroon ng mga permission error kapag nag-i-install sa mga protected directory. Kailangan ng installer ng write access sa /usr/local/bin o mga katumbas na lokasyon. Ang pagpapatakbo gamit ang sudo ay lumulutas nito ngunit dapat iwasan maliban kung kinakailangan.
Mga Madalas Itanong
Maaari bang tumakbo ang Claude Code nang walang koneksyon sa internet?
Hindi. Nangangailangan ang Claude Code ng internet connectivity upang gumana. Nagpapadala ang tool ng code at mga query sa mga server ng Anthropic para sa pagproseso. Maaaring payagan ng local caching ang ilang operasyon na gumana pansamantala offline, ngunit ang buong functionality ay nangangailangan ng aktibong koneksyon.
Gumagana ba ang Claude Code sa mga umiiral na AI coding tools?
Oo. Maaaring tumakbo ang Claude Code kasama ang GitHub Copilot, Cursor, o iba pang AI development tools. Tumatakbo sila nang independiyente at hindi nagkakaroon ng conflict. Gayunpaman, ang sabay-sabay na paggamit ng maraming AI assistants ay maaaring lumikha ng kalituhan tungkol sa kung aling tool ang humahawak sa alinmang gawain.
Kailangan ba ang WSL2 para sa lahat ng feature ng Windows?
Kinakailangan ang command-line tool sa Windows. Gayunpaman, ang desktop application ay tumatakbo nang natively sa Windows nang walang WSL2. Ang desktop app ay nagbibigay ng katulad na functionality sa pamamagitan ng isang graphical interface sa halip na purong command-line interaction.
Magkano ang halaga ng paggamit ng Claude Code?
Nag-iiba ang presyo batay sa paggamit at subscription tier. Suriin ang opisyal na website ng Claude para sa kasalukuyang presyo, dahil nagbabago ang mga gastos at istraktura ng plano sa paglipas ng panahon. Ang ilang feature ay nangangailangan ng Claude Pro o Enterprise subscription.
Maaari bang mag-edit ang Claude Code ng mga file sa labas ng project directory?
Bilang default, nililimitahan ng Claude Code ang access sa file sa kasalukuyang project directory para sa seguridad. Maaaring palawakin ng mga configuration setting ang mga pahintulot, ngunit nangangailangan ito ng tahasang awtorisasyon. Sinusuri ng sandboxing documentation ang pamamahala ng pahintulot nang detalyado.
Ano ang pagkakaiba sa pagitan ng Claude Code at ng Claude API?
Ang Claude Code ay isang development tool para sa interactive na coding assistance. Ang Claude API ay nagbibigay ng programmatic access para sa pagbuo ng mga application na gumagamit ng mga AI capability ng Claude. Nagsisilbi sila ng iba't ibang layunin—isa para sa mga developer na nagsusulat ng code, ang isa pa para sa mga application na nag-i-integrate ng mga AI feature.
Inaalis ba ng pag-uninstall ang lahat ng data ng Claude Code?
Inaalis ng pag-uninstall ang application binary ngunit maaaring mag-iwan ng mga configuration file at cached data. Ang kumpletong pagtanggal ay nangangailangan ng manual na pagbubura sa ~/.claude directory sa macOS at Linux, o ang katumbas na AppData location sa Windows.
Pagsisimula Pagkatapos ng Pag-install
Kasama ang Claude Code na naka-install at na-verify, ang susunod na hakbang ay nagsasangkot ng pag-unawa kung paano ito gamitin nang epektibo.
Inirerekomenda ng quickstart documentation ang pagsisimula sa mga simpleng gawain. Mag-navigate sa isang umiiral na proyekto at patakbuhin ang claude upang simulan ang isang interactive session.
Hilingin sa Claude na ipaliwanag ang istraktura ng proyekto. Humingi ng buod kung ano ang ginagawa ng codebase. Ang mga exploratory query na ito ay nakakatulong na maunawaan kung paano binibigyang-kahulugan ng tool ang code.
Subukang gumawa ng maliliit na pagbabago. Hilingin sa Claude na magdagdag ng mga komento sa mga function, lumikha ng mga simpleng test file, o mag-refactor ng mga simpleng code block. Ang mga gawaing ito ay nagpapakita ng mga kakayahan sa pag-e-edit nang walang panganib.
Awtomatikong gumagana ang Git integration kung gumagamit ang proyekto ng version control. Maaaring gumawa ng mga commit ang Claude Code, ipaliwanag ang mga diff, at magmungkahi ng mga pagpapabuti batay sa mga pagbabago.
Kasama sa opisyal na dokumentasyon ang mga workflow example para sa mga karaniwang development task. Sinasaklaw nito ang bug fixing, feature implementation, code review, at automated testing.
Ang Claude Code ay isang nagbabagong tool. Ang installation ay pundasyon lamang. Ang pag-unawa sa mga kakayahan nito, limitasyon, at pinakamahusay na mga kasanayan ay nangangailangan ng eksperimento at pagsasanay.
Handa ka na bang i-install ang Claude Code? I-download ang angkop na installer para sa iyong platform mula sa opisyal na website at sundin ang mga hakbang na nakabalangkas sa gabay na ito. Mag-authenticate gamit ang iyong Claude account, i-verify na gumagana nang tama ang installation, at simulan ang pag-explore sa AI-assisted development.
