Legfontosabb tudnivalók
- Két telepítési módszer: Használd a natív telepítőt (
curl -fsSL https://claude.ai/install.sh | bash) a függőségmentes beállításhoz, vagy az npm-et (npm install -g @anthropic-ai/claude-code), ha verziórögzítésre van szükséged. - A rendszerkövetelmények minimálisak: macOS 13+, Linux (Ubuntu 20.04+/Debian 10+), vagy Windows 10+ WSL használatával. Legalább 4GB RAM. GPU nem szükséges.
- Fiók szükséges: Szükséged lesz egy Claude Pro, Max, Teams, Enterprise vagy Console (API) fiókra. Az ingyenes Claude.ai csomag nem tartalmaz Claude Code hozzáférést.
- A beállítás kevesebb mint öt percet vesz igénybe: Telepítsd, hitelesítsd magad a böngésződben, és azonnal kezdheted a Claude Code használatát bármely projektkönyvtárban.
Hogyan telepítsük a Claude Code-ot: Teljes körű beállítási útmutató (2026)
A Claude Code az Anthropic AI kódoló asszisztense, amely közvetlenül a terminálodban fut. Olvassa a kódbázisodat, kódot ír, parancsokat futtat, és kezeli a komplex, több fájlt érintő szerkesztéseket -- mindezt egyetlen CLI felületről.
A böngészőalapú AI chat eszközökkel ellentétben a Claude Code a tényleges fejlesztői környezeteden belül működik. Látja a fájlstruktúrádat, érti a projekt kontextusát, és módosításokat hajt végre a gépeden lévő valódi fájlokon.
Ez az útmutató végigvezet a Claude Code 2026-os telepítésének minden lépésén, az előfeltételek ellenőrzésétől az első AI-segített kódolási munkamenet futtatásáig. Akár macOS-t, Linux-ot vagy Windows-t használsz, kevesebb mint öt perc alatt működni fog a Claude Code.
Amire szükséged lesz (Előfeltételek ellenőrzőlistája)
A Claude Code telepítése előtt győződj meg arról, hogy rendelkezel a következőkkel:
- Operációs rendszer: macOS 13.0 (Ventura) vagy újabb, Ubuntu 20.04+ vagy Debian 10+, vagy Windows 10 (1809+ verzió) WSL használatával
- RAM: Legalább 4GB (8GB ajánlott nagyobb kódbázisokhoz)
- Internetkapcsolat: A Claude Code az Anthropic felhő API-jához csatlakozik, ezért aktív kapcsolat szükséges
- Anthropic fiók: Claude Pro ($20/hónap), Claude Max ($100-200/hónap), Teams, Enterprise vagy Console (API) fiók
- Terminál: Bash, Zsh vagy PowerShell
- Node.js 18+ (csak az npm telepítési módszerhez szükséges)
Nincs szükséged GPU-ra. Minden AI feldolgozás az Anthropic szerverein történik. A gépednek csak a CLI klienst kell futtatnia, és kéréseket küldenie a hálózaton keresztül.
1. lépés: Node.js telepítése (Ha még nincs meg)
Ha az npm telepítési módszert tervezed használni, szükséged lesz a Node.js 18-as vagy újabb verziójára. Ha már telepítve van a Node.js, ellenőrizd a verziót:
node --version
Ha a kimenet v18.0.0 vagy magasabb verziót mutat, ugorj a 2. lépésre. Ha nem, telepítsd vagy frissítsd a Node.js-t az nvm (Node Version Manager) segítségével, ami az ajánlott megközelítés, mert elkerüli a jogosultsági problémákat, és lehetővé teszi a könnyű váltást a Node verziók között.
nvm telepítése macOS vagy Linux rendszeren:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
Zárd be és nyisd meg újra a terminált, majd telepítsd a Node.js-t:
nvm install 22
nvm use 22
node --version
Egy v22 kezdetű verziószámot kell látnod. A Node.js 22 a jelenlegi LTS kiadás, és tökéletesen működik a Claude Code-dal.
Node.js telepítése Windows rendszeren (WSL-en belül):
Először győződj meg arról, hogy a WSL telepítve van (lásd a Windows részt lentebb). Ezután nyisd meg a WSL terminált, és futtasd ugyanazokat az nvm parancsokat, mint fent.
2. lépés: A Claude Code telepítése
Két lehetőséged van a Claude Code telepítésére. A natív telepítő mostantól az ajánlott módszer, de az npm továbbra is teljes mértékben támogatott.
A opció: Natív telepítő (Ajánlott)
A natív telepítő nulla függőséget igényel -- nincs Node.js, nincs npm. Automatikusan frissül a háttérben, és ez az elsődleges módszer, amelyet az Anthropic tesztel és támogat.
macOS és Linux:
curl -fsSL https://claude.ai/install.sh | bash
Windows (PowerShell, rendszergazdaként):
irm https://claude.ai/install.ps1 | iex
A telepítő letölti a Claude Code bináris fájlt, elhelyezi a PATH-ban, és konfigurálja az automatikus frissítéseket. A teljes folyamat kevesebb mint egy percet vesz igénybe.
B opció: npm telepítés
Ha az npm-et preferálod -- például egy adott verzió rögzítése miatt, vagy mert az npm a munkafolyamatod alapköve -- futtasd a következőt:
npm install -g @anthropic-ai/claude-code
Fontos: Ne használj sudo-t az npm install parancshoz. Ha jogosultsági hibákat kapsz, a helyes megoldás az nvm használata (amely a Node.js-t a saját könyvtáradba telepíti), ahelyett, hogy root-ként futtatnád az npm-et.
A telepítés ellenőrzése
Függetlenül attól, hogy melyik módszert választottad, ellenőrizd, hogy a Claude Code telepítve van-e:
claude --version
Egy verziószámot kell látnod. Lefuttathatod a beépített diagnosztikát is:
claude doctor
Ez a parancs ellenőrzi a környezetedet, és jelenti az esetleges konfigurációs problémákat.
3. lépés: Hitelesítés
A Claude Code hitelesítést igényel a használat előtt. Futtasd:
claude
A parancs első futtatásakor a Claude Code megnyitja az alapértelmezett böngésződet, és kéri, hogy jelentkezz be az Anthropic fiókodba. Kövesd az utasításokat a CLI felhatalmazásához.
Hitelesítési lehetőségek
Böngészőalapú bejelentkezés (alapértelmezett): A legjobb személyes gépekhez. A Claude Code megnyit egy böngészőablakot, bejelentkezel, és a CLI automatikusan megkapja a hitelesítési tokent. Ez működik Claude Pro, Max, Teams és Enterprise fiókokkal.
API kulcs (CI/CD és automatizálás): Ha a Claude Code-ot headless környezetben vagy CI/CD folyamatban futtatod, állítsd be az API kulcsodat környezeti változóként:
export ANTHROPIC_API_KEY=sk-ant-your-key-here
API kulcsot az Anthropic Console oldalon generálhatsz. Az API használat kiszámlázása tokenenként történik az Anthropic közzétett díjszabása alapján.
Előfizetés vs. API számlázás: Pro vagy Max előfizetéssel a Claude Code használata benne van a havi csomagodban (a használati korlátok függvényében). A Console-ból származó API kulccsal tokenenként fizetsz. Válassz a használati volumen alapján -- az előfizetések egyszerűbbek rendszeres használathoz, míg az API számlázás nagyobb kontrollt biztosít a változó vagy automatizált munkaterhelések esetén.
4. lépés: Az első projekted
Most, hogy a Claude Code telepítve van és a hitelesítés is megtörtént, próbáld ki egy valódi projekten.
Navigálj bármelyik projektkönyvtárba:
cd ~/my-project
Indítsd el a Claude Code-ot:
claude
Most egy interaktív munkamenetben vagy. A Claude Code beolvasta a projektstruktúrádat, és készen áll a segítségre. Próbálj meg feladatot adni neki:
> Explain the architecture of this project
A Claude Code átvizsgálja a fájljaidat, azonosítja a technológiai stacket, és összefoglalót ad a projekt felépítéséről.
Próbálj ki valami gyakorlatibb dolgot:
> Add input validation to the user registration form
A Claude Code azonosítja a releváns fájlokat, javaslatot tesz a módosításokra, és megerősítést kér tőled, mielőtt bármit is megváltoztatna. Minden módosítást diff nézetben nézhetsz át, és elfogadhatod vagy elvetheted őket.
Egyszeri feladat elvégzéséhez, interaktív módba lépés nélkül, használd a -p flaget:
claude -p "Write unit tests for the auth module"
Ez lefuttatja a feladatot, kiadja az eredményt, majd kilép -- hasznos szkriptekhez és gyors kérdésekhez.
5. lépés: Alapvető konfiguráció
A Claude Code ésszerű alapbeállításokkal érkezik, de testre szabhatod a viselkedését a munkafolyamatodhoz.
Modellválasztás
A Claude Code alapértelmezés szerint a legújabb Claude modellt használja. Egy másik modell megadásához:
claude config set model claude-opus-4-6
Vagy egyetlen munkamenethez:
claude --model claude-sonnet-4-20250514
Jogosultságok
A Claude Code megerősítést kér a potenciálisan destruktív műveletek, például fájlok írása vagy shell parancsok futtatása előtt. Ezt a viselkedést konfigurálhatod:
claude config set permissions.auto-accept-edits true
Projektszintű beállítások
Hozz létre egy .claude/settings.json fájlt a projekt gyökerében a csapat által megosztott konfiguráció meghatározásához:
{
"permissions": {
"allow": ["read", "write", "shell"],
"deny": ["shell:rm -rf *"]
},
"model": "claude-sonnet-4-20250514",
"environment": {
"NODE_ENV": "development"
}
}
Ezt a fájlt érdemes a verziókezelőbe commitolni, hogy az egész csapat ugyanazt a Claude Code viselkedést használja.
Személyes felülbírálásokhoz, amelyeket nem kell commitolni, használd a .claude/settings.local.json fájlt.
MCP szerver konfiguráció
A Claude Code támogatja a Model Context Protocol (MCP) szervereket a képességeinek kiterjesztéséhez. Ezeket a projekt gyökerében lévő .mcp.json fájlban konfigurálhatod:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"]
}
}
}
Telepítés különböző környezetekben
macOS
A natív telepítő a legegyszerűbb út macOS-en. Mind az Apple Silicon (M1/M2/M3/M4), mind az Intel alapú gépek támogatottak:
curl -fsSL https://claude.ai/install.sh | bash
Alternatív megoldásként a Claude Code elérhető Homebrew-n keresztül is:
brew install --cask claude-code
Linux
Működik Ubuntu 20.04+, Debian 10+ rendszereken és a legtöbb modern disztribúción:
curl -fsSL https://claude.ai/install.sh | bash
Ha régebbi disztribúciót használsz, alkalmazd az npm módszert nvm-mel, hogy elkerüld a rendszerszintű függőségi problémákat.
Windows (WSL)
A Claude Code Windows-on vagy WSL-t, vagy Git for Windows-t igényel. A WSL az ajánlott megközelítés:
- Nyisd meg a PowerShell-t rendszergazdaként, és telepítsd a WSL-t:
wsl --install
-
Indítsd újra a számítógépedet, amikor kéri.
-
Nyisd meg a WSL terminált (alapértelmezés szerint Ubuntu), és telepítsd a Claude Code-ot:
curl -fsSL https://claude.ai/install.sh | bash
Alternatív megoldásként közvetlenül a PowerShell-ben is használhatod a natív Windows telepítőt:
irm https://claude.ai/install.ps1 | iex
Docker
Konténerizált környezetekhez add hozzá a Claude Code-ot a Dockerfile fájlodhoz:
FROM node:22-alpine
RUN npm install -g @anthropic-ai/claude-code
ENV ANTHROPIC_API_KEY=your-key-here
CI/CD folyamatoknál az API kulcsot futásidőben add át, ne égesd bele az image-be:
docker run -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY my-claude-image claude -p "Run the test suite and fix any failures"
CI/CD folyamatok
A Claude Code headless módja (-p flag) automatizálásra lett tervezve. Íme egy GitHub Actions példa:
- name: AI Code Review
run: |
npx @anthropic-ai/claude-code -p "Review the changes in this PR and suggest improvements" --output-format json
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
Az --output-format json flag strukturált kimenetet ad vissza, amelyet a későbbi lépések fel tudnak dolgozni.
A Claude Code frissítése
Natív telepítő
Ha a natív telepítővel telepítetted a Claude Code-ot, a frissítések automatikusan történnek a háttérben. Nincs szükség teendőre. Konfigurálhatod a frissítési csatornát:
claude config set update-channel stable
Az aktuális verzió ellenőrzéséhez:
claude --version
npm
Ha npm-en keresztül telepítetted, frissíts manuálisan:
npm update -g @anthropic-ai/claude-code
Vagy telepíts egy konkrét verziót:
npm install -g @anthropic-ai/claude-code@latest
IDE integráció
Bár a Claude Code elsősorban terminál-alapú eszköz, közvetlenül integrálódik a népszerű IDE-kkel a vizuálisabb élmény érdekében.
VS Code bővítmény
A VS Code bővítmény natív grafikus felületet biztosít a Claude Code-hoz a szerkesztőn belül. Tartalmaz egy chat panelt, ellenőrzőpont-alapú visszavonást, fájlhivatkozásokat @-említésekkel, és több beszélgetés párhuzamos futtatásának lehetőségét füleken.
A telepítéshez nyisd meg a VS Code-ot, és keress rá a "Claude Code" kifejezésre a bővítmények panelen, vagy futtasd:
code --install-extension anthropic.claude-code
A telepítés után megnyithatod a Claude Code panelt az oldalsávból, és ugyanúgy interakcióba léphetsz vele, mint a terminál verzióval, de a fájlok közötti különbségeket (diff) a VS Code natív nézetében látod.
JetBrains bővítmény
IntelliJ IDEA, PyCharm, WebStorm, GoLand és más JetBrains IDE-k esetén telepítsd a Claude Code bővítményt a JetBrains Marketplace-ről:
- Nyisd meg a JetBrains IDE-t
- Menj a Settings, majd a Plugins, végül a Marketplace menüpontra
- Keress rá a "Claude Code" kifejezésre
- Kattints az Install gombra, és indítsd újra az IDE-t
A JetBrains bővítmény a Claude Code CLI-t az IDE integrált termináljában futtatja, és a javasolt módosításokat az IDE diff nézetében nyitja meg. Jelenleg béta állapotban van, de a napi használathoz már teljesen alkalmas.
Hibaelhárítás
"command not found: claude"
A Claude Code bináris nincs a PATH-ban. Ha a natív telepítőt használtad, próbálj meg megnyitni egy új terminálablakot. Ha ez nem működik, futtasd újra a telepítő szkriptet. npm telepítés esetén győződj meg arról, hogy a globális npm bin könyvtárad a PATH-ban van:
npm config get prefix
Add hozzá ennek az elérési útnak a bin alkönyvtárát a shell PATH változójához.
"Node.js version too old"
A Claude Code Node.js 18+ verziót igényel. Ellenőrizd a verziót a node --version paranccsal. Ha 18 alatti, telepíts egy újabb verziót nvm használatával:
nvm install 22
nvm use 22
npm jogosultsági hibák (EACCES)
Soha ne használj sudo npm install -g parancsot. Ehelyett javítsd az npm alapértelmezett könyvtárát, vagy használd az nvm-et, amely mindent a saját könyvtáradba telepít, és teljesen elkerüli a jogosultsági konfliktusokat:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 22
npm install -g @anthropic-ai/claude-code
A hitelesítés sikertelen vagy a böngésző nem nyílik meg
Ha a böngészőalapú bejelentkezés nem működik (gyakori távoli szervereken vagy WSL-en), hitelesítheted magad API kulccsal is:
export ANTHROPIC_API_KEY=sk-ant-your-key-here
claude
Generálj API kulcsot a console.anthropic.com oldalon.
"Network Error" vagy időtúllépés a telepítés során
A hálózatod vagy a tűzfalad blokkolhatja az npm-et vagy a natív telepítőt. Próbáld meg:
npm config set registry https://registry.npmjs.org/
Ha vállalati proxy mögött vagy, konfiguráld az npm-et a használatára:
npm config set proxy http://your-proxy:8080
npm config set https-proxy http://your-proxy:8080
A Claude Code lassan fut
Maga a Claude Code erőforrás-igénye alacsony -- a lassúság általában az Anthropic API hálózati késleltetését jelenti. Ellenőrizd az internetkapcsolatodat. Ha VPN-t használsz, próbáld meg lecsatlakoztatni. Az API állapotát a status.anthropic.com oldalon is ellenőrizheted.
Következő lépések
A Claude Code telepítve van, hitelesítve és fut. Íme, merre tovább:
- Tanuld meg a munkafolyamatot: Olvasd el a Claude Code tutorial anyagunkat a prompt stratégia, a több fájlt érintő szerkesztés és az AI-segített fejlesztés alapos megismeréséhez.
- Hasonlítsd össze a lehetőségeidet: Nézd meg, hogyan teljesít a Claude Code a Claude Code vs Cursor összehasonlításunkban, ha éppen AI kódoló eszközök között döntesz.
- Fedezd fel a haladó funkciókat: A Claude Code támogatja az MCP szervereket, az egyéni hookokat, a headless automatizálást és a többmodelles konfigurációkat. A hivatalos dokumentáció ezeket részletesen tárgyalja.
A Claude Code a leggyorsabb módja annak, hogy AI-t vigyél a meglévő fejlesztői munkafolyamatodba anélkül, hogy megváltoztatnád az eszközeidet vagy elhagynád a terminálodat. Most, hogy telepítve van, kezdj el egy kisebb feladatot egy valódi projekten -- azonnal látni fogod a különbséget.
