Paano Mag-install ng Claude Code sa Windows (Gabay 2026)

Author Avatar
Andrew
AI Perks Team
8,047
Paano Mag-install ng Claude Code sa Windows (Gabay 2026)

Mabilis na Buod: Ang pag-install ng Claude Code sa Windows ay nangangailangan ng pag-set up ng WSL2 (Windows Subsystem for Linux), pag-install ng Ubuntu, at pagpapatakbo ng isang simpleng installation script. Pinapayagan ng proseso ang mga gumagamit ng Windows na ma-access ang AI coding assistant ng Anthropic sa pamamagitan ng kanilang terminal. Mayroong mga available na native Windows binaries, gayunpaman, ang WSL2 ay nananatiling pinakamahusay na kasanayan para sa pag-install sa Windows.

Ang Claude Code ay isang AI-powered coding assistant na direktang gumagana sa terminal, na tumutulong sa mga developer na bumuo ng mga feature, ayusin ang mga bug, at i-automate ang mga development task. Ngunit mayroong isang problema para sa mga gumagamit ng Windows.

Ang Claude Code ay available bilang isang native na Windows executable at maaaring i-install sa pamamagitan ng npm o isang direktang binary download nang walang WSL2. Gayunpaman, nangangailangan ito ng Windows Subsystem for Linux (WSL2), at ang opisyal na paraan ng pag-install ay nakadepende pa rin sa WSL2.

Narito kung paano ito mapapagana sa Windows 11 o Windows 10.

Mga Kinakailangan sa Sistema

Bago simulan ang pag-install, kumpirmahin na natutugunan ng Windows machine ang mga kinakailangang ito:

  • Windows 10 1809+ o Windows Server 2019+
  • Windows 11 (anumang bersyon)
  • Kahalagahan ng 4GB ng RAM na available
  • Mga pribilehiyo ng Administrator sa sistema
  • Koneksyon sa Internet para sa pag-download ng WSL2 at Ubuntu

Ang pag-install ay nangangailangan ng espasyo sa disk para sa WSL2, Ubuntu, at Claude Code.

Hakbang 1: Paganahin ang Windows Subsystem for Linux

Nagbibigay ang WSL2 ng Linux environment direkta sa loob ng Windows. Ito ang pundasyon na nagpapagana sa Claude Code.

Buksan ang PowerShell bilang Administrator. Mag-right-click sa Start button at piliin ang "Windows PowerShell (Admin)" o "Terminal (Admin)" sa Windows 11.

Patakbuhin ang command na ito:

wsl –install

Pinapagana ng command na ito ang mga kinakailangang Windows feature at nag-i-install ng Ubuntu bilang default na Linux distribution. Malamang na hihilingin ng sistema na mag-restart.

Pagkatapos ng pag-restart, awtomatikong tatapusin ng WSL2 ang pag-setup. Magbubukas ang Ubuntu at hihingi ng username at password. Ang mga kredensyal na ito ay para lamang sa Linux environment—hindi nila kailangang tumugma sa mga kredensyal ng Windows.

Ang tatlong-yugtong proseso para sa pag-install ng Claude Code sa mga Windows system

Hakbang 2: Kumpirmahin ang Pag-install ng WSL2

Kapag nag-restart ang sistema at natapos ang paunang setup ng Ubuntu, kumpirmahin na gumagana nang tama ang WSL2.

Buksan ang Ubuntu terminal (hanapin ang "Ubuntu" sa Start menu) at patakbuhin:

wsl –version

Ito ay magpapakita ng impormasyon ng bersyon ng WSL. Hanapin ang "WSL version: 2.x.x" sa output.

Kung ang command ay nagpapakita ng WSL1 sa halip, mag-upgrade sa WSL2 gamit ang:

wsl –set-default-version 2

Hakbang 3: I-install ang Claude Code

Ngayon para sa aktwal na pag-install ng Claude Code. Ang opisyal na dokumentasyon ay nagbibigay ng isang-linya na installation script.

Sa Ubuntu terminal, patakbuhin:

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

Dina-download ng script ang Claude Code binary, nagse-set up ng mga kinakailangang pahintulot, at idinadagdag ito sa system PATH. Ang tagal ng pag-install ay nag-iiba depende sa bilis ng internet at mga detalye ng sistema.

Ayon sa opisyal na dokumentasyon ng Claude Code, awtomatikong nade-detect ng installer ang architecture ng sistema at dina-download ang naaangkop na bersyon ng binary.

Mga Karaniwang Isyu sa Pag-install

Ang ilang mga gumagamit ng Windows ay nagrereport na nakikita ang "command not found: claude" pagkatapos ng pag-install. Ito ay karaniwang nangyayari dahil hindi pa na-refresh ang PATH variable.

Isara at buksan muli ang Ubuntu terminal, pagkatapos ay subukang muli. Kung magpapatuloy ang isyu, maaaring makatulong ang configuration na ito sa PATH bilang isang hindi opisyal na solusyon:

echo ‘export PATH=”$HOME/.claude/bin:$PATH”‘ >> ~/.bashrc
source ~/.bashrc

Hakbang 4: I-authenticate ang Claude Code

Kinakailangan ng Claude Code ang authentication gamit ang isang Anthropic account bago gamitin.

Patakbuhin ang command na ito:

claude

Ipinapakita ng terminal ang isang URL at humihingi ng authentication. Bahagyang nag-iiba ang proseso para sa mga indibidwal na user kumpara sa mga team account:

Uri ng AccountParaan ng AuthenticationAno ang Kinakailangan 
IndibidwalPersonal API keyAnthropic account na may API access
Team/OrganisasyonOrganization tokenToken ng authentication na ibinigay ng Admin

Buksan ang ibinigay na URL sa isang browser, mag-log in sa Anthropic account, at i-authorize ang Claude Code. Kinukumpirma ng terminal ang matagumpay na authentication.

Paggawa gamit ang Mga Proyekto sa Windows sa WSL2

Dito nagiging kumplikado ang mga bagay. Ang mga file system ng Windows at WSL2 ay hiwalay.

Ang mga file ng Windows ay naa-access mula sa WSL2 sa /mnt/c/ (para sa C: drive), /mnt/d/ (para sa D: drive), at iba pa. Ngunit mayroong gastos sa performance. Ipinapahiwatig ng mga talakayan sa komunidad ang mga pagkakaiba sa performance sa pagitan ng mga naka-mount na Windows at native na WSL2 directories.

Para sa pinakamahusay na performance, kopyahin ang mga project file sa WSL2 home directory:

cp -r /mnt/c/Users/YourName/Projects/your-project ~/projects/your-project

Ang kapalit? Mas nagiging kumplikado ang IDE integration. Mahusay itong hinahawakan ng Visual Studio Code gamit ang Remote-WSL extension nito, ngunit maaaring mahirapan ang iba pang mga IDE.

Pagsubok sa Pag-install

Kumpirmahin na gumagana nang tama ang Claude Code gamit ang isang simpleng pagsubok.

Mag-navigate sa isang project directory (o gumawa ng test folder):

mkdir ~/claude-test
cd ~/claude-test
claude “gumawa ng simpleng hello world Python script”

Dapat sumagot ang Claude Code, gumawa ng file, at iprint ang code. Kinukumpirma nito na naging matagumpay ang pag-install.

Mga trade-off sa performance at integration sa pagitan ng Windows at WSL2 file systems

Huwag Magbayad ng Sobra, Unahin ang Pag-claim ng Magagamit na AI Credits

Karaniwan ay mabilis lang ang pag-install ng Claude Code sa Windows. Ang tunay na gastos ay lumalabas sa bandang huli kapag nagsimulang mag-test ng mga prompt ang mga developer, magpatakbo ng mga script, at i-integrate ang modelo sa mga aplikasyon. Ang yugto ng eksperimentong iyon ay maaaring makagawa ng maraming API calls, at maraming team ang napagtatanto lamang ang gastos matapos silang magsimulang bumuo.

Bago gumastos sa paggamit, sulit na tingnan kung kwalipikado ka para sa AI credits o partner programs. Kinokolekta ng Get AI Perks ang mga oportunidad na ito sa isang lugar, naglilista ng mga credits at diskwento mula sa mga AI provider, cloud platform, at developer tools, kasama ang mga simpleng tagubilin kung paano ito i-claim.

Bago mo patakbuhin ang iyong unang Claude Code project, tingnan ang Get AI Perks at i-claim ang mga AI credits na maaaring sumakop sa iyong mga gastos sa development.

Mga Madalas Itanong

Maaari bang tumakbo ang Claude Code nang native sa Windows nang walang WSL2?

Oo, ngunit nananatiling pinakamahusay na paraan ng pag-install para sa Windows ang WSL2.

Gumagana ba ang Claude Code sa Windows Terminal?

Oo. Maaaring magbukas ang Windows Terminal ng mga tab ng Ubuntu, na nagpapahintulot ng access sa Claude Code nang hindi lumilipat sa isang hiwalay na window ng Ubuntu. Sa Windows Terminal, i-click ang dropdown arrow at piliin ang Ubuntu mula sa listahan ng mga profile.

Gagana ba ang aking mga kasalukuyang development tools sa Windows kasama ang Claude Code?

Nakadepende sa tool. Mahusay na nakikipag-ugnayan ang Visual Studio Code sa pamamagitan ng Remote-WSL extension. Maaaring mangailangan ng karagdagang configuration ang JetBrains IDEs at iba pang mga tool. Binabanggit ng opisyal na dokumentasyon ang VS Code at JetBrains bilang mga suportadong platform.

Paano ako mag-a-update ng Claude Code sa Windows?

Awtomatikong nag-a-update ang Claude Code bilang default. Upang manu-manong mag-update, patakbuhin ang claude update sa Ubuntu terminal. Maaaring i-disable ang auto-update feature sa pamamagitan ng mga configuration file kung kinakailangan para sa mga enterprise environment.

Ano ang pagkakaiba sa pagitan ng Claude Code at ng Claude API?

Ang Claude Code ay isang terminal-based coding assistant na nagpapatupad ng mga command at nag-eedit ng mga file. Nagbibigay ang Claude API ng programmatic access sa language model ng Claude para sa pagbuo ng mga custom na aplikasyon. Sila ay nagsisilbi ng magkaibang layunin at nangangailangan ng magkaibang proseso ng pag-setup.

Maaari ko bang gamitin ang Claude Code sa mga .NET proyekto sa Windows?

Oo, ngunit may mga kundisyon. Ipinapahiwatig ng mga talakayan sa komunidad na gumagana ang suporta sa .NET SDK sa WSL2, ngunit nangangailangan ng pag-install ng Linux version ng .NET SDK sa loob ng Ubuntu. Hindi maa-access ang .NET na naka-install sa Windows mula sa WSL2.

Magkano ang halaga ng Claude Code?

Ang pagpepresyo ay nakadepende sa paggamit at uri ng account. Tingnan ang opisyal na website ng Anthropic para sa kasalukuyang mga tier ng presyo at team plans, dahil nag-iiba ang mga gastos batay sa API consumption at mga kinakailangan ng organisasyon.

Mga Susunod na Hakbang Pagkatapos ng Pag-install

Kapag na-install na ang Claude Code, simulan ang pagtuklas sa mga kakayahan nito. Ang mabilis na dokumentasyon ng pagpapakilala ay nagrerekomenda ng pagsisimula sa mga simpleng gawain tulad ng pagpapaliwanag ng code bago lumipat sa mas kumplikadong mga operasyon.

Subukan ang mga command na ito upang masanay:

  • claude “ipaliwanag ang function na ito” – Kumuha ng mga paliwanag sa code
  • claude commit – Bumuo ng mga Git commit message
  • claude -c – Ipagpatuloy ang pinakahuling pag-uusap

Ang opisyal na dokumentasyon ay nagbibigay ng detalyadong mga gabay para sa IDE integration, pag-install ng plugin, at mga advanced na opsyon sa configuration. Para sa mga team, nag-aalok ang mga setting na pinamamahalaan ng server at analytics tracking ng karagdagang kontrol sa mga deployment ng Claude Code.

Maaaring mukhang dagdag na hakbang ang pag-set up ng WSL2 kumpara sa mga native na Windows application, ngunit sa kasalukuyan ito lamang ang paraan upang mapatakbo ang Claude Code sa Windows. Ang magandang balita? Kapag na-configure na, maayos itong tumatakbo at nakikipag-ugnayan sa karamihan sa mga development workflow.

AI Perks

Nagbibigay ang AI Perks ng access sa mga eksklusibong diskwento, kredito, at deal sa mga AI tool, cloud service, at API upang matulungan ang mga startup at developer na makatipid.

AI Perks Cards

This content is for informational purposes only and may contain inaccuracies. Credit programs, amounts, and eligibility requirements change frequently. Always verify details directly with the provider.