Paano I-set up ang Claude Code: Kumpletong Gabay 2026

Buod: Ang Claude Code ay isang AI coding assistant na nakabase sa terminal na tumatakbo sa macOS at Linux nang native, o sa Windows sa pamamagitan ng WSL2. Ang pag-set up nito ay nangangailangan ng paggawa ng Anthropic API key, pagpapatakbo ng platform-specific installer, pag-authenticate gamit ang key, at pag-verify ng installation gamit ang test command. 

Ang Claude Code ay ang opisyal na terminal-based coding assistant ng Anthropic. Ito ay direktang tumatakbo sa command line at humahawak ng lahat mula sa code generation hanggang sa bug fixes sa pamamagitan ng natural language commands.

Ngunit ang proseso ng setup ay hindi palaging direkta. Ang mga user ng Windows ay nangangailangan ng WSL2. Ang API authentication ay maaaring makagulo sa mga baguhan. Nangyayari ang mga version conflict.

Ang gabay na ito ay dadaan sa kumpletong proseso ng setup para sa lahat ng platform, mula sa system requirements hanggang sa iyong unang coding session.

Kung Ano Talaga ang Claude Code

Ang Claude Code ay isang agentic terminal application na nakikipag-ugnayan sa development environments. Nauunawaan nito ang mga codebase, nagsasagawa ng mga routine tasks, at namamahala ng mga git workflow sa pamamagitan ng mga conversational commands.

Hindi tulad ng mga browser-based tools, ang Claude Code ay lokal na tumatakbo sa terminal. Direktang ina-access nito ang mga project files, napapanatili ang context sa iba't ibang session, at nakikipag-ugnayan sa mga kasalukuyang development workflows. Ayon sa opisyal na Claude Code documentation, ang tool ay kumokonekta sa Anthropic API at sumusuporta sa integrasyon sa Amazon Bedrock, Google Cloud Vertex AI, at Azure AI.

Ang tool ay gumagana nang iba kaysa sa mga tradisyonal na coding assistants. Sa totoo lang, mas parang may pair programmer ka sa iyong terminal kaysa sa isang code completion tool.

System Requirements para sa Claude Code

Bago ang installation, kailangang matugunan ng mga system ang mga partikular na requirements. Narito ang kailangan ng bawat platform:

Lahat ng platform ay kailangan ng stable na internet connection para sa API calls. Ang Claude Code downloads ay karaniwang nangangailangan ng humigit-kumulang 50MB, at ang WSL2 sa Windows ay nagdadagdag ng humigit-kumulang 500MB para sa Linux subsystem.

Sa storage, asahan ang hindi bababa sa 4GB ng libreng espasyo. Ang application mismo ay maliit, ngunit mahalaga ang espasyo para sa mga dependencies at project files.

Windows-Specific Requirements

Ang Claude Code ay maaaring tumakbo sa Windows sa pamamagitan ng PowerShell o Command Prompt kung naka-install ang Node.js. Ang tool ay nangangailangan ng Windows Subsystem for Linux 2 upang lumikha ng Linux environment.

Ayon sa mga installation guide mula sa claude.ai, ang mga Windows 10 system ay nangangailangan ng Bersyon 1903 o mas bago na may Build 19041 o mas mataas. Ang mga Windows 11 user ay may built-in na WSL2 support. Kinakailangan ang mga administrator privileges para sa paunang WSL2 setup.

Ang proseso ay kinabibilangan ng pag-enable ng virtualization sa BIOS, pag-activate ng mga Windows features, at pag-install ng Linux distribution. Ang Ubuntu 22.04 LTS ang inirerekomendang distribution para sa compatibility.

Pag-install ng Claude Code: Step-by-Step na Proseso

Ang proseso ng installation ay nag-iiba depende sa platform. Narito kung paano patakbuhin ang Claude Code sa bawat operating system.

Pag-install sa macOS at Linux

Ang mga installation sa macOS at Linux ay sumusunod sa parehong pattern. Parehong sumusuporta ang mga platform sa native installation nang walang karagdagang setup.

Nagsisimula ang proseso sa pag-download ng installer. Buksan ang isang terminal at patakbuhin:

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

Tinatukoy ng script ang operating system, dina-download ang tamang binary, at ini-install ang Claude Code sa lokal na bin directory. Karaniwang natatapos ang installation sa loob ng dalawang minuto na may stable na koneksyon.

Para sa mga system na walang curl, gumagana ang wget bilang alternatibo. Awtomatikong idinaragdag ng installer ang Claude Code sa system PATH.

Pag-install sa Windows via WSL2

Ang Windows installation ay nangangailangan muna ng pag-set up ng WSL2. Narito ang kumpletong proseso:

Buksan ang PowerShell bilang Administrator at paganahin ang WSL:

wsl –install

Pinapagana ng command na ito ang mga kinakailangang Windows features, dina-download ang WSL2 kernel, at ini-install ang Ubuntu bilang default. Hihilingin ng system na mag-restart. Pagkatapos ng reboot, awtomatikong magbubukas ang Ubuntu upang kumpletuhin ang user setup.

Gumawa ng username at password kapag hiniling. Ang mga credentials na ito ay para sa Linux environment, hiwalay sa Windows login details.

Kapag tumatakbo na ang WSL2, nalalapat ang proseso ng Linux installation. Sa Ubuntu terminal, patakbuhin ang curl command mula sa macOS/Linux section sa itaas.

Ang installer na ang bahala sa natitira. Ang Claude Code ay ini-install sa loob ng WSL2 environment at tumatakbo sa pamamagitan ng Ubuntu terminal.

Pagkuha ng Anthropic API Key

Kinakailangan ng Claude Code ang Anthropic API key para sa authentication. Ang key ay kumokonekta sa lokal na installation sa mga server ng Anthropic.

Bisitahin ang Anthropic Console sa console.anthropic.com. Gumawa ng account o mag-sign in gamit ang kasalukuyang credentials. Mag-navigate sa API Keys sa account settings.

I-click ang "Create Key" upang makabuo ng bagong API key. Ang key ay lumalabas nang isang beses—kopiyahin ito kaagad. Hindi na ipapakita ng Anthropic ang buong key pagkatapos umalis sa pahina.

Itago ang key nang ligtas. Nagbibigay ito ng buong access sa Anthropic API at anumang kaugnay na billing.

Pag-unawa sa API Costs

Ang Claude Code ay gumagana sa pay-per-use model sa pamamagitan ng Anthropic API. Batay sa data mula sa claude.ai installation guides, ang mga gastos ay nag-iiba depende sa modelo:

Ang minimum na pagbili upang ma-activate ang billing ay $5, bagaman ang mga talakayan sa komunidad ay nagmumungkahi na ang $20-30 ay nagbibigay ng mas magandang headroom para sa pagsubok. Kasama sa mga alternatibong subscription option ang Claude Pro sa $20 buwanan o Claude Max sa $100 buwanan para sa mabigat na paggamit.

Ang default na pag-uugali ay gumagamit ng Opus hanggang sa maabot ang 50% ng mga limitasyon sa paggamit, pagkatapos ay lumilipat sa Sonnet para sa cost efficiency.

Authentication at Unang Paglulunsad

Pagkatapos ng installation, kailangan ng authentication ng Claude Code bago ang unang paggamit. Ilunsad ang Claude Code sa pagpapatakbo:

claude

Ang unang paglulunsad ay magtatanong para sa API key. I-paste ang key mula sa Anthropic Console at pindutin ang Enter. I-validate ng Claude Code ang key at ligtas itong iimbak sa mga lokal na configuration files.

Ang authentication ay nagpapatuloy sa iba't ibang session. Hindi na kailangang muling ipasok ang API key maliban kung ito ay tahasang tinanggal o kapag nagpapalit ng account.

Upang ma-verify kung gumana ang authentication, magpapakita ang Claude Code ng welcome message at command prompt. Ipinapakita ng interface ang mga available na command at kinukumpirma ang koneksyon sa Anthropic API.

Pag-configure ng mga Kagustuhan sa Modelo

Ang Claude Code ay default na may awtomatikong pagpili ng modelo, ngunit posible ang manual na configuration. Ayon sa opisyal na dokumentasyon, maaaring ayusin ng mga user ang pagpili ng modelo sa pamamagitan ng /model command o sa pamamagitan ng pag-set ng CLAUDE_CODE_EFFORT_LEVEL environment variable.

Kinokontrol ng effort level ang lalim ng pag-iisip para sa Opus 4.6 at Sonnet 4.6 na mga modelo: mababa, katamtaman, o mataas. Ang mas mataas na effort levels ay nagpapataas ng lalim ng pangangatwiran ngunit nagpapataas din ng gastos at oras ng tugon.

Para sa mga proyekto na nangangailangan ng malalim na pagsusuri, ang paglalagay ng "ultrathink" sa mga prompt ay pansamantalang nagse-set ng effort sa mataas para sa partikular na turn na iyon.

Pag-verify ng Tagumpay sa Pag-install

Pagkatapos ng authentication, i-verify na gumagana nang tama ang Claude Code. Patakbuhin ang mga basic test na ito:

claude –help
claude –version

Ipinapakita ng help command ang mga available na opsyon at command. Kinukumpirma ng version output kung aling release ang naka-install. Parehong dapat gumana ang mga command nang walang error.

Susunod, subukan ang Claude Code sa isang project directory. Gumawa ng test folder:

mkdir test-project
cd test-project
echo “# Test Project” > README.md
claude

Sa loob ng Claude Code session, subukan ang mga basic interactions:

• I-type ang "help" upang makita ang mga available na command
• Magtanong ng "explain what you can do"
• Humiling ng "summarize this project"
• Subukan ang /help command

Kinukumpirma ng mga interaksyon na ito na nababasa ng Claude Code ang mga project files at nakakatugon sa mga prompt. Ang mga matagumpay na tugon ay nangangahulugan na gumagana ang installation.

Pag-configure ng Claude Code para sa mga Proyekto

Iniimbak ng Claude Code ang mga project-specific settings sa configuration files. Ang mga file na ito ay nagko-customize ng behavior, nagde-define ng memory, at nagtatatag ng mga workflow.

Ang pangunahing configuration file ay CLAUDE.md sa project root. Ang file na ito ay naglalaman ng mga instruksyon, context, at project-specific guidelines na tinutukoy ng Claude Code sa mga session.

Gumawa ng basic CLAUDE.md file:

# Project Context

Ito ay isang [project type] na binuo gamit ang [technologies].

## Key Guidelines
– [Mahalagang rule 1]
– [Mahalagang rule 2]

## Project Structure
[Maikling paliwanag ng folder organization]

Tumatanggap ang file ng Markdown formatting. Binabasa ng Claude Code ang context na ito sa pagsisimula ng session at pinapanatili ito sa buong pag-uusap.

Advanced Configuration Options

Higit pa sa basic context, sinusuportahan ng Claude Code ang advanced configuration sa pamamagitan ng .claude directory. Ang directory na ito ay maaaring maglaman ng:

• Skills: Mga specialized capabilities na defined sa .claude/skills/SKILL.md
• Commands: Custom slash commands sa .claude/commands/*.md
• Hooks: Mga automated workflow na na-trigger ng mga event
• Plugins: Extended functionality sa pamamagitan ng programmatic integration

Ayon sa opisyal na Agent SDK documentation, ang mga feature na ito ay nagbibigay-daan sa sopistikadong customization. Ang mga skills ay nagde-define ng reusable capabilities. Ang mga commands ay lumilikha ng shortcuts para sa mga karaniwang tasks. Ang mga hooks ay nag-a-automate ng mga tugon sa mga pagbabago ng file o paggamit ng tool.

Paggamit ng Claude Code: Basic Workflows

Kapag kumpleto na ang installation, humahawak ang Claude Code ng mga karaniwang development tasks sa pamamagitan ng natural language.

Simulan ang isang session sa pamamagitan ng pag-navigate sa isang project directory at pagpapatakbo:

claude

Tumatanggap ang prompt ng mga plain language requests. Ilang karaniwang workflows:

• Code Generation: "Gumawa ng Python function na nagva-validate ng email addresses na may tamang error handling."
• Bug Fixing: "Ang function na ito ay nagbibigay ng null pointer exception. Mahahanap at maaayos mo ba ang isyu?"
• Refactoring: "I-refactor ang component na ito upang gumamit ng dependency injection sa halip na direct instantiation."
• Git Operations: "Gumawa ng bagong branch, i-commit ang mga pagbabagong ito na may deskriptibong mensahe, at i-push sa origin."

Napapanatili ng Claude Code ang context sa buong session. Naaalala nito ang mga nakaraang interaksyon, sinusubaybayan ang mga pagbabago ng file, at nauunawaan ang mas malawak na project structure.

Pag-unawa sa Plan Mode

Para sa mga kumplikadong pagbabago, nag-aalok ang Claude Code ng Plan Mode. Ang mode na ito ay lumilikha ng detalyadong execution plan bago gumawa ng mga pagbabago.

I-activate ang Plan Mode sa pamamagitan ng paglalagay ng "plan:" bago ang mga request o sa pamamagitan ng paggamit ng /plan command. Pagkatapos ay ilalatag ng Claude Code ang mga iminungkahing pagbabago, ipapaliwanag ang pangangatwiran, at hihintayin ang pag-apruba bago isagawa.

Ang Plan Mode ay partikular na kapaki-pakinabang para sa refactoring, architectural changes, o mga pagbabago na nakakaapekto sa maraming file. Nagbibigay ito ng visibility sa kung ano ang balak gawin ng Claude Code bago isagawa ang mga pagbabago.

Pakikipag-ugnayan sa VS Code at IDEs

Habang tumatakbo ang Claude Code sa terminal, pinapabuti ng integrasyon sa mga code editor ang workflow. Ang opisyal na VS Code extension ay nagdadala ng mga kakayahan ng Claude Code nang direkta sa editor.

I-install ang extension mula sa VS Code marketplace. Hanapin ang "Claude Code" at i-click ang Install. Nagdaragdag ang extension ng Claude Code panel sa sidebar.

Ayon sa opisyal na VS Code documentation, sinusuportahan ng extension ang:

Napapanatili ng extension ang feature parity sa terminal version habang nagdaragdag ng mga IDE-specific convenience tulad ng inline diffs at @-mention file references.

Pag-update at Pamamahala ng Claude Code

Ang Claude Code ay awtomatikong nag-u-update bilang default. Paminsan-minsan ay sinusuri ng application ang mga bagong bersyon at ini-install ang mga update sa background.

Upang mag-update nang manu-mano, patakbuhin:

claude –update

Pinipilit nito ang isang agarang pag-check at installation ng pinakabagong bersyon. Pinapanatili ng proseso ng pag-update ang configuration files at authentication credentials.

Para sa mga organisasyon na nangangailangan ng version control, maaaring i-disable ang auto-updates. I-set ang CLAUDE_CODE_AUTO_UPDATE environment variable sa false o i-configure sa pamamagitan ng server-managed settings.

Upang mag-install ng partikular na bersyon, gamitin ang:

curl -fsSL claude.ai/install.sh | sh -s — –version=X.Y.Z

Palitan ang X.Y.Z ng target version number.

Mga Karaniwang Isyu sa Setup at Solusyon

Ilang isyu ang karaniwang nangyayari sa panahon ng setup. Narito kung paano ito ayusin:

• Pagtanggi ng API Key: Kung tinatanggihan ng Claude Code ang API key, i-verify na walang dagdag na space o character. Muling kopyahin ang key mula sa Anthropic Console. Siguraduhing naka-activate ang billing—hindi gagana ang mga key kung walang nakalagay na paraan ng pagbabayad.
• Mga Pagkabigo sa WSL2 Installation: Ang mga Windows system ay kung minsan ay nabibigo sa WSL2 installation dahil sa mga setting ng virtualization. Pumasok sa BIOS at i-enable ang virtualization (Intel VT-x o AMD-V). Siguraduhing natutugunan ng Windows version ang minimum requirements.
• Command Not Found: Kung hindi kinikilala ng terminal ang claude command, hindi na-update nang tama ang PATH. Isara at buksan muli ang terminal. Para sa patuloy na mga isyu, manu-manong idagdag ang installation directory sa PATH.
• Connection Timeouts: Ang mga network restriction o firewall ay maaaring makaharang sa mga API calls. Nangangailangan ang Claude Code ng HTTPS access sa api.anthropic.com. Ang mga corporate network ay maaaring mangailangan ng proxy configuration.
• Permission Errors: Ang mga installation sa Linux at macOS ay paminsan-minsan ay nakakaranas ng mga permission issues. Patakbuhin ang installer na may naaangkop na mga pahintulot o i-install sa user directory sa halip na sa system-wide locations.

Suriin ang mga Available na AI Credits Bago Mag-set Up ng Claude Code

Ang pag-set up ng Claude Code ay karaniwang nangangahulugan ng pag-eeksperimento—pagpapatakbo ng mga prompt, pagsubok ng mga integrasyon, at pagbuo ng maliliit na prototypes bago mapunta sa production ang anumang bagay. Ang unang yugto na iyon ay madalas na humahantong sa maraming paggamit ng API. Sa halip na magbayad para sa bawat request kaagad, maraming developer ang unang naghahanap ng mga available na credits o startup programs na nakakatulong na bawasan ang mga paunang gastos.

Kinokolekta ng Get AI Perks ang mga oportunidad na ito sa isang lugar. Naglilista ang platform ng mga AI credits, diskwento, at partner programs sa iba't ibang AI providers, cloud platforms, at developer tools, na may step-by-step na gabay na nagpapaliwanag kung paano ito i-claim. Sa kabuuan, ang database ay naglalaman ng mga perks mula sa higit sa 200 tools at milyun-milyong dolyar sa mga available na credits na maaaring i-apply ng mga startup at builders.

Bago mo matapos ang pag-set up ng Claude Code, tingnan ang Get AI Perks at i-claim ang mga AI credits na maaaring sumakop sa iyong mga unang eksperimento.

Mga Madalas na Itanong

Pagpapatuloy sa Claude Code

Binabago ng Claude Code ang terminal-based development sa pamamagitan ng pag-integrate ng AI assistance nang direkta sa command line. Ang setup ay nangangailangan ng platform-specific installation, API authentication, at basic configuration, ngunit ang proseso ay direkta kapag sinusunod ang tamang mga hakbang.

Ang tool ay mahusay sa mga routine development tasks, code generation, at git workflow management. Nagbibigay ang Plan Mode ng kaligtasan para sa mga kumplikadong operasyon. Pinapalawak ng IDE integration ang mga kakayahan lampas sa terminal.

Magsimula sa mga simpleng gawain upang maunawaan kung paano binibigyang-kahulugan ng Claude Code ang mga kahilingan. Magpatuloy sa mas kumplikadong mga workflow habang lumalago ang pamilyaridad. Gamitin ang /clear command sa pagitan ng magkakaibang tasks upang mapanatili ang malinaw na context. I-configure ang mga CLAUDE.md file para sa project-specific na gabay.

Maaaring tuklasin ng mga team ang mga server-managed settings at plugin marketplaces. Makikinabang ang mga indibidwal na developer mula sa mga skills at custom commands na naka-tailor sa mga madalas na pattern.

Ang GitHub repository sa anthropics/claude-code ay naglalaman ng karagdagang mga halimbawa, mga plugin ng komunidad, at mga mapagkukunan para sa troubleshooting. Ang opisyal na dokumentasyon sa docs.anthropic.com ay nagbibigay ng komprehensibong teknikal na mga sanggunian.

Ngayon na ang oras upang magsimulang mag-code. Mag-navigate sa isang proyekto, ilunsad ang Claude Code, at tingnan kung paano binabago ng AI-assisted development ang iyong workflow.