Claude Code Serye ng Tutorial 5: Paano I-install ang Claude Code?

Paano I-install ang Claude Code

Ang pag-install ng Claude Code ay walang 'Next' sa graphical interface; lahat ay ginagawa sa command line. Kung karaniwan kang gumagamit ng npm, ang buong proseso ay hindi tatagal ng dalawang minuto.

Mga Kinakailangan

Bago magsimula, tiyaking nasa iyo ang mga sumusunod:

Node.js 18 o mas mataas
Para suriin: patakbuhin ang node -v sa terminal. Kung ang bersyon ay mas mababa sa 18, gamitin ang nvm, fnm, o direktang pumunta sa nodejs.org para i-upgrade.
Isang Anthropic account
Ang rehistrasyon ay nasa https://console.anthropic.com. Ang account ay nagbibigay ng API Key, na kailangan pagkatapos i-install. Libre ang pagrerehistro, ang aktwal na gastos ay batay sa paggamit.
Ang network ay dapat makapag-access sa Anthropic API endpoint
Ang default na domain ay api.anthropic.com. Kung kailangan ng proxy ang kapaligiran, tandaan na itakda ang HTTP_PROXY o HTTPS_PROXY sa terminal.

Paraan ng Pag-install 1: Global na Pag-install gamit ang npm

Ito ang pinakakaraniwang paraan; i-install ito minsan at magagamit kahit saan.

npm install -g @anthropic-ai/claude-code

Pagkatapos, patakbuhin ang claude --version. Kung mag-output ito ng version number, matagumpay ang pag-install. Pagkatapos ng global installation, ang command na claude ay maaaring tawagin sa anumang direktoryo.

Kung makaranas ng permission error (karaniwan sa macOS /usr/local/lib directory), dalawang paraan:

Gamitin ang sudo para i-install (mas madali ngunit may isyu sa seguridad).
I-configure ang npm na gumamit ng user directory, iwasan ang sudo:
bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
Pagkatapos, idagdag ang ~/.npm-global/bin sa PATH, at buksan muli ang terminal.

Paraan ng Pag-install 2: npx Gamit at Tapos

Kung ayaw mong mag-install ng global o gusto mo lang subukan pansamantala, mas diretso ang paggamit ng npx.

npx @anthropic-ai/claude-code

Ang npx ay pansamantalang magda-download ng pinakabagong package, at pagkatapos tumakbo ay hindi mag-iiwan ng global command. Tuwing gagamit ay mag-che-check ito ng update, kaya natural na mananatili sa pinakabagong bersyon. Ang downside ay medyo mabagal (kailangang i-download tuwing gagamitin), at hindi angkop para sa madalas na pagtawag sa mga automated script.

Angkop na sitwasyon: unang karanasan, pansamantalang gamit sa ibang makina, o paminsan-minsang paggamit.

I-verify kung Maaaring Magsimula nang Normal

Pagkatapos i-install, huwag magmadaling mag-authenticate. Patakbuhin ang simpleng utos upang makita kung magsisimula ang tool:

claude --help

Kung mag-output ng help information, okay ang binary file. Ang susunod na hakbang ay ikonekta ang iyong account, na tatalakayin mamaya.

Ang katawan pagkatapos i-install sa parehong paraan ay pareho; ang mga susunod na authentication at paggamit ay ganap na magkapareho. Piliin ang paraan na sa tingin mo ay mas madali.

Mga Karaniwang Problema

Masyadong mababa ang Node version
Kung mas mababa sa 18, direktang mag-error, hindi babala. Ang pag-upgrade ng Node ay ang pinakadiretsong solusyon.
Network timeout
Maging ang npm package download o kasunod na API connection ay maaaring ma-stuck dahil sa proxy o firewall. Siguraduhin munang ma-access ang curl https://api.anthropic.com, bago gawin ang susunod na hakbang.
Direktang paggamit ng native cmd sa Windows
Kahit technically posible, inirerekomenda ang paggamit ng Git Bash, WSL2, o Windows Terminal upang maiwasan ang kakaibang path escape issues.