Ez a Claude Code útmutató végigvezet a hivatalos Anthropic-dokumentáció alapján azon, hogyan telepítsd, indítsd el és állítsd munkába a terminálban futó AI-kódoló eszközt — a telepítéstől egészen az első saját ágensedig.
Ha eddig csak a chatablakban másolgattad ide-oda a kódot a Claude és a szerkesztőd között, ez a lépés más ligában játszik. A Claude Code közvetlenül a projektedben dolgozik: olvassa a teljes kódbázist, szerkeszti a fájlokat, parancsokat futtat, és a saját fejlesztői eszközeidbe kapcsolódik.
Ez a Claude Code útmutató mindent hivatalos forrásból közöl (Anthropic dokumentáció, a hivatalos GitHub-repó és a termékoldal), és tegező, gyakorlati nyelven halad. A végére lesz egy működő telepítésed és érteni fogod, hogyan épül fel az első ágensed.
Mi az a Claude Code, és milyen problémát old meg?
A hivatalos definíció szerint a Claude Code egy „agentic” kódoló eszköz, ami elolvassa a kódbázisodat, fájlokat szerkeszt, parancsokat futtat, és integrálódik a fejlesztői eszközeiddel.
„Claude Code is an agentic coding tool that reads your codebase, edits files, runs commands, and integrates with your development tools.” — Anthropic hivatalos dokumentáció
A kulcsszó itt az „agentic”: nem egy passzív chatbot, ami tanácsot ad, hanem egy ügynök, ami a te felügyeleteddel önállóan végrehajt feladatokat a gépeden. Megtalálja a releváns fájlt, megmutatja a javasolt módosítást, engedélyt kér, majd elvégzi a szerkesztést.
A gyakorlati probléma, amit megold: megszűnik a folyamatos másolgatás és kontextus-átadás. A Claude Code érti a teljes projektkontextust, így nem neked kell minden alkalommal elmagyaráznod, hogyan épül fel a kódod.
Fontos tudni, hogy öt felületen ugyanaz a motor fut: terminál CLI, VS Code kiterjesztés, asztali alkalmazás, web (claude.ai/code) és JetBrains plugin. Mindegyik ugyanazokat a beállítás-, CLAUDE.md- és MCP-fájlokat használja, tehát amit ebben a Claude Code útmutatóban megtanulsz, az mindenhol érvényes.
Rendszerkövetelmények és a szükséges fiók
Mielőtt telepítenél, érdemes ellenőrizni, hogy a géped és a fiókod megfelel-e. A követelmények szerényebbek, mint gondolnád, de van két buktató.
Támogatott operációs rendszerek: macOS 13.0+, Windows 10 build 1809+ (vagy Windows Server 2019+), valamint Linux oldalon Ubuntu 20.04+, Debian 10+ és Alpine Linux 3.19+. Hardverből minimum 4 GB RAM és x64 vagy ARM64 processzor kell, plusz állandó internetkapcsolat.
Shellként Bash, Zsh, PowerShell vagy CMD is jó. Extra függőségként a ripgrep szükséges, ez a legtöbb rendszerre már eleve fel van telepítve.
Az első buktató a fiók: az ingyenes Claude.ai csomag NEM elég. A Claude Code-hoz Pro, Max, Team, Enterprise vagy Claude Console (API) fiók kell. A Console első belépéskor automatikusan létrehoz egy „Claude Code” nevű workspace-t a költségek követéséhez.
Claude Code útmutató: telepítés lépésről lépésre minden platformon
A legegyszerűbb út a natív telepítő, mert ez a háttérben automatikusan frissül. Nyisd meg a terminált, és futtasd a platformodnak megfelelő parancsot.
macOS, Linux vagy WSL:
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
Windows CMD-ben a parancs curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd formában fut. Ha csomagkezelőt szeretnél, macOS és Linux alatt a Homebrew is működik a brew install –cask claude-code paranccsal, Windowson pedig a winget install Anthropic.ClaudeCode.
A csomagkezelős telepítéseknél viszont figyelj: a Homebrew és a WinGet nem frissül automatikusan. Ilyenkor kézzel kell frissítened (például brew upgrade claude-code vagy winget upgrade Anthropic.ClaudeCode). A Linux disztribúciók apt, dnf és apk csomagkezelőihez saját aláírt repó tartozik.
Az npm-es telepítés (npm install -g @anthropic-ai/claude-code) létezik, de a dokumentáció „haladó” opciónak, a repó README pedig már elavultnak jelöli. A 2.1.198-as verziótól Node.js 22+ kell hozzá, és soha ne futtasd sudo-val — a sudo npm install -g jogosultsági és biztonsági kockázatot jelent.
Az első indítás és a bejelentkezés
Ha megvolt a telepítés, ellenőrizd, hogy minden a helyén van-e. A claude –version kiírja a verziószámot (például „2.1.211 (Claude Code)” formában). Ha valami nem stimmel, a claude doctor egy read-only diagnosztika, ami átvizsgálja a telepítést és a beállításokat.
Az első valódi indításhoz lépj be egy projekt könyvtárába, és írd be, hogy claude. Elsőre a rendszer böngészős bejelentkezést kér. Ha viszont be van állítva az ANTHROPIC_API_KEY környezeti változó, akkor a bejelentkezés helyett a kulcs jóváhagyását kéri.
A fiók-típusok közül a Claude Pro, Max, Team vagy Enterprise az ajánlott mindennapi használatra. Aki API-hozzáférést szeretne előre fizetett kredittel, a Claude Console felé induljon. Nagyvállalati környezetben a Claude Code fut Amazon Bedrock, Google Cloud Agent Platform és Microsoft Foundry felett is, vagy céges SSO-val, self-hosted „Claude apps gateway”-en keresztül.
Ha menet közben fiókot váltanál, arra a /login session-parancs való.
Az első munkamenet: így beszélj a kódbázisoddal
A Claude Code ereje az, hogy természetes nyelven kérdezheted a saját projektedről. Nem kell parancsokat magolni — elég úgy fogalmazni, ahogy egy kollégának magyaráznál.
Jó induló promptok egy ismeretlen kódbázison: „what does this project do?”, „where is the main entry point?” vagy „explain the folder structure”. A Claude Code végigolvassa a releváns fájlokat, és emberi nyelven összefoglalja a működést.
Az első kódmódosítás pont ilyen egyszerű. Ha azt kéred, hogy „add a hello world function to the main file”, a folyamat négy lépésből áll: megtalálja a megfelelő fájlt, megmutatja a javasolt módosítást, engedélyt kér, majd elvégzi a szerkesztést.
A Git-műveletek is természetes nyelven mennek. Kérheted, hogy sorolja fel a módosított fájlokat, írjon leíró commit-üzenetet, hozzon létre új branchet, vagy segítsen feloldani egy merge-konfliktust. Aki eddig fejből küzdött a Git-parancsokkal, ezt hamar megszereti.
Alap CLI-parancsok és az engedély-módok
A napi munkához érdemes fejből tudni néhány parancsot. Ezek adják a Claude Code gerincét.
- claude — interaktív munkamenet indítása
- claude „task” — egyszeri feladat futtatása kezdeti prompttal
- claude -p „query” — egyszeri lekérdezés, válasz után kilépés
- claude -c — a legutóbbi beszélgetés folytatása az aktuális könyvtárban
- claude update — frissítés a legújabb verzióra
- claude doctor — telepítési diagnosztika
Session-en belül a /clear törli az előzményt, a /help kilistázza a parancsokat, a /resume pedig egy korábbi beszélgetést folytat. Kilépni a /exit paranccsal vagy kétszeri Ctrl+D-vel tudsz.
A biztonság szempontjából a legfontosabb fogalom az engedély-mód, amit Shift+Tab-bal válthatsz. A default minden módosítás előtt kérdez — kezdőként ezt hagyd bekapcsolva. Az acceptEdits automatikusan jóváhagyja a fájlszerkesztéseket, a plan pedig csak tervet javasol, fájlba nem ír. Egyes fiókoknál van auto mód is, ami háttér biztonsági ellenőrzést futtat, és csak ismétlődő blokkolásnál kérdez vissza.
Ha scriptelnéd vagy CI-be tennéd, hasznos, hogy a Claude Code pipe-olható: a cat logs.txt | claude -p „analyze this” Unix-filozófia szerint komponálható, az –output-format pedig text, json vagy stream-json kimenetet ad.
Az első ágensed: CLAUDE.md, skills, hooks és MCP
Itt lép be a képbe az igazi ágens-gondolkodás. Az „első ágens” nem egy varázslat, hanem néhány jól elhelyezett fájl és beállítás, amivel a Claude Code kiszámíthatóan, a te szabályaid szerint dolgozik.
- CLAUDE.md létrehozása. Tedd a projekt gyökerébe ezt a markdown fájlt — a Claude Code minden munkamenet elején beolvassa. Ide kerülnek a coding standardok, az architektúra-döntések és a preferált könyvtárak. Emellett van „auto memory” is, ami a munkamenetek között automatikusan megjegyez tanultakat (például build-parancsokat).
- Skills beállítása. A skillek újrafelhasználható workflow-csomagok, például egy /review-pr vagy /deploy-staging parancs, amit egyszer definiálsz, és utána egy szóból elindítasz.
- Hooks bekötése. A hookok shell-parancsokat futtatnak automatikusan a Claude Code akciói előtt vagy után — tipikusan auto-formázás minden fájlszerkesztés után.
- MCP-forrás csatolása. Az MCP (Model Context Protocol) nyílt szabvány, amivel külső adatforrásokat (Google Drive, Jira, Slack, saját eszközök) kötsz be. Ezzel lesz az ágensed valóban hasznos a saját rendszereidben.
- Sub-agentek és routine-ok. Több Claude Code ágens párhuzamosan dolgozhat a feladat különböző részein, egy „lead agent” koordinálásával. A routine-ok pedig felhőben futó, ütemezett feladatok (reggeli PR-review, éjszakai CI-hibaelemzés), amiket a CLI-ből a /schedule paranccsal is létrehozhatsz.
Aki teljesen egyedi ágenst szeretne, annak ott az Agent SDK: ezzel a Claude Code motorjára építhetsz saját orchestrationt, teljes kontrollal a tool-hozzáférés és a jogosultságok felett. Ez már a haladó terep, de jó tudni, hogy a platform idáig elvisz.
Ha a gyakorlati MCP-bekötést részletesen is látni akarod, azt külön végigvettük: MCP beállítás lépésről lépésre — Claude és WordPress bekötés. Az ágensek megbízhatóságához pedig érdemes átfutni, hogyan előzd meg az AI hallucinációt kódolásnál.
Mennyibe kerül a Claude Code?
Az árazás tájékoztató jellegű és USD-alapú, ráadásul gyakran változik — a pontos, aktuális díjakért mindig a hivatalos claude.com/pricing oldalt nézd meg. Forintos átváltást szándékosan nem közlünk, mert arra nincs hiteles forrás.
A fetch idején a Pro csomag nagyjából havi 17–20 dollár körül volt (rövid kódolási sprintekhez), a Max 5x körülbelül 100 dollár (nagyobb kódbázisokhoz), a Max 20x pedig nagyjából 200 dollár a power usereknek. Ha API-n keresztül használod, a standard Anthropic API-díjak érvényesek.
A költségek megértéséhez és megfékezéséhez érdemes átgondolni a token-gazdaságtant is — erről szól az AI kódoló ágensek költsége: 5 lépés a token-számlák ellen cikkünk, ami pont az ágensek üzemeltetési kiadásaira fókuszál.
Kinek éri meg a Claude Code — és mikor várj vele?
A Claude Code annak való, aki már egy valódi kódbázison dolgozik, és a fejlesztés helyett túl sok időt tölt kontextus-átadással, keresgéléssel vagy ismétlődő Git-műveletekkel. A hivatalos referenciák között olyan cégek adnak hozzá visszajelzést, mint a Ramp és a Notion, ahol a kódolási hatékonyság érdemi részét gyorsította fel.
A hivatalos repó a fetch idején (2026. augusztus 7.) kb. 140 ezer csillagnál és nagyjából 22 600 forknál járt — ezek a számok gyorsan változnak, de jelzik, mekkora közösség épült köré. Hibát a session-ben a /bug paranccsal vagy a GitHub Issues felületen jelenthetsz.
Kezdőként két dologra figyelj. Egyrészt tartsd a default engedély-módot, amíg meg nem szokod, hogy az ágens mit csinál a fájljaiddal. Másrészt ne feledd: nincs hivatalos magyar nyelvű UI, a felület angol — de ettől a munka pontosan úgy megy, ahogy ez a Claude Code útmutató végigvette, és magyarul is nyugodtan írhatsz neki promptot.
Ha most vágsz bele az ágens-alapú munkába, a legjobb, ha nem egyből egy kritikus éles projekten kísérletezel. Hozz létre egy tesztkönyvtárat, futtasd le rajta az első pár feladatot, állítsd be a CLAUDE.md-t, és csak utána engedd rá az igazi kódra. Az első ágensedig innen már csak néhány munkamenet.
Ha a következő lépés a napi workflow felépítése, olvasd el ezt is: Hogyan dolgozz Claude-dal és AI-agentekkel: teljes kezdő útmutató. Kezdd a hivatalos telepítővel a code.claude.com oldalról, és próbáld ki élesben.