🌐 Ez egy automatikus fordítás. Közösségi javítások szívesen fogadottak!

<h1 align="center">
  <br>
  <a href="https://github.com/thedotmack/claude-mem">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/claude-mem-logo-for-dark-mode.webp">
      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/claude-mem-logo-for-light-mode.webp">
      <img src="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/claude-mem-logo-for-light-mode.webp" alt="Claude-Mem" width="400">
    </picture>
  </a>
  <br>
  <a href="https://vercel.com/open-source-program">
    <img alt="Vercel OSS Program" src="https://vercel.com/oss/program-badge-2026.svg" />
  </a>
</h1>

<p align="center">
  <a href="docs/i18n/README.zh.md">🇨🇳 中文</a> •
  <a href="docs/i18n/README.zh-tw.md">🇹🇼 繁體中文</a> •
  <a href="docs/i18n/README.ja.md">🇯🇵 日本語</a> •
  <a href="docs/i18n/README.pt.md">🇵🇹 Português</a> •
  <a href="docs/i18n/README.pt-br.md">🇧🇷 Português</a> •
  <a href="docs/i18n/README.ko.md">🇰🇷 한국어</a> •
  <a href="docs/i18n/README.es.md">🇪🇸 Español</a> •
  <a href="docs/i18n/README.de.md">🇩🇪 Deutsch</a> •
  <a href="docs/i18n/README.fr.md">🇫🇷 Français</a> •
  <a href="docs/i18n/README.he.md">🇮🇱 עברית</a> •
  <a href="docs/i18n/README.ar.md">🇸🇦 العربية</a> •
  <a href="docs/i18n/README.ru.md">🇷🇺 Русский</a> •
  <a href="docs/i18n/README.pl.md">🇵🇱 Polski</a> •
  <a href="docs/i18n/README.cs.md">🇨🇿 Čeština</a> •
  <a href="docs/i18n/README.nl.md">🇳🇱 Nederlands</a> •
  <a href="docs/i18n/README.tr.md">🇹🇷 Türkçe</a> •
  <a href="docs/i18n/README.uk.md">🇺🇦 Українська</a> •
  <a href="docs/i18n/README.vi.md">🇻🇳 Tiếng Việt</a> •
  <a href="docs/i18n/README.tl.md">🇵🇭 Tagalog</a> •
  <a href="docs/i18n/README.id.md">🇮🇩 Indonesia</a> •
  <a href="docs/i18n/README.th.md">🇹🇭 ไทย</a> •
  <a href="docs/i18n/README.hi.md">🇮🇳 हिन्दी</a> •
  <a href="docs/i18n/README.bn.md">🇧🇩 বাংলা</a> •
  <a href="docs/i18n/README.ur.md">🇵🇰 اردو</a> •
  <a href="docs/i18n/README.ro.md">🇷🇴 Română</a> •
  <a href="docs/i18n/README.sv.md">🇸🇪 Svenska</a> •
  <a href="docs/i18n/README.it.md">🇮🇹 Italiano</a> •
  <a href="docs/i18n/README.el.md">🇬🇷 Ελληνικά</a> •
  <a href="docs/i18n/README.hu.md">🇭🇺 Magyar</a> •
  <a href="docs/i18n/README.fi.md">🇫🇮 Suomi</a> •
  <a href="docs/i18n/README.da.md">🇩🇰 Dansk</a> •
  <a href="docs/i18n/README.no.md">🇳🇴 Norsk</a>
</p>

<h4 align="center">Tartós memória tömörítési rendszer a <a href="https://claude.com/claude-code" target="_blank">Claude Code</a> számára.</h4>

<p align="center">
  <a href="LICENSE">
    <img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License">
  </a>
  <a href="package.json">
    <img src="https://img.shields.io/badge/version-13.4.0-green.svg" alt="Version">
  </a>
  <a href="package.json">
    <img src="https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen.svg" alt="Node">
  </a>
  <a href="https://github.com/thedotmack/awesome-claude-code">
    <img src="https://awesome.re/mentioned-badge.svg" alt="Mentioned in Awesome Claude Code">
  </a>
</p>

<p align="center">
  <a href="https://trendshift.io/repositories/15496" target="_blank">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/trendshift-badge-dark.svg">
      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/trendshift-badge.svg">
      <img src="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/trendshift-badge.svg" alt="thedotmack/claude-mem | Trendshift" width="250" height="55"/>
    </picture>
  </a>
</p>

<br>

<table align="center">
  <tr>
    <td align="center">
      <a href="https://github.com/thedotmack/claude-mem">
        <picture>
          <img
            src="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/cm-preview.gif"
            alt="Claude-Mem Preview"
            width="500"
          >
        </picture>
      </a>
    </td>
    <td align="center">
      <a href="https://www.star-history.com/#thedotmack/claude-mem&Date">
        <picture>
          <source
            media="(prefers-color-scheme: dark)"
            srcset="https://api.star-history.com/image?repos=thedotmack/claude-mem&type=date&theme=dark&legend=top-left"
          />
          <source
            media="(prefers-color-scheme: light)"
            srcset="https://api.star-history.com/image?repos=thedotmack/claude-mem&type=date&legend=top-left"
          />
          <img
            alt="Star History Chart"
            src="https://api.star-history.com/image?repos=thedotmack/claude-mem&type=date&legend=top-left"
            width="500"
          />
        </picture>
      </a>
    </td>
  </tr>
</table>

<p align="center">
  <a href="#gyors-kezdés">Gyors kezdés</a> •
  <a href="#hogyan-működik">Hogyan működik</a> •
  <a href="#mcp-keresési-eszközök">Keresési eszközök</a> •
  <a href="#dokumentáció">Dokumentáció</a> •
  <a href="#konfiguráció">Konfiguráció</a> •
  <a href="#hibaelhárítás">Hibaelhárítás</a> •
  <a href="#licenc">Licenc</a>
</p>

<p align="center">
  A Claude-Mem zökkenőmentesen megőrzi a kontextust munkamenetek között azáltal, hogy automatikusan rögzíti az eszközhasználati megfigyeléseket, szemantikus összefoglalókat generál, és elérhetővé teszi azokat a jövőbeli munkamenetekben. Ez lehetővé teszi Claude számára, hogy fenntartsa a projektekkel kapcsolatos tudás folytonosságát még a munkamenetek befejezése vagy újracsatlakozása után is.
</p>

---

## Gyors kezdés

Telepítés egyetlen paranccsal:

```bash
npx claude-mem install
```

Vagy telepítés OpenCode-hoz:

```bash
npx claude-mem install --ide opencode
```

Vagy telepítés Antigravity CLI-hez ([beállítási útmutató](https://docs.claude-mem.ai/antigravity-cli/setup)):

```bash
npx claude-mem install --ide antigravity
```

Vagy telepítés a plugin marketplace-ről a Claude Code-on belül:

```bash
/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem
```

Indítsa újra a Claude Code-ot. A korábbi munkamenetek kontextusa automatikusan megjelenik az új munkamenetekben.

> **Megjegyzés:** A Claude-Mem az npm-en is elérhető, de az `npm install -g claude-mem` csak a **SDK/könyvtár** részt telepíti — nem regisztrálja a plugin hookokat, és nem állítja be a worker szolgáltatást. Mindig a `npx claude-mem install` vagy a fenti `/plugin` parancsok segítségével telepítsen.

### 🦞 OpenClaw Gateway

Telepítse a claude-mem-et tartós memória pluginként az [OpenClaw](https://openclaw.ai) gateway-eken egyetlen paranccsal:

```bash
curl -fsSL https://install.cmem.ai/openclaw.sh | bash
```

A telepítő kezeli a függőségeket, a plugin beállítását, az AI szolgáltató konfigurációját, a worker indítását, valamint az opcionális valós idejű megfigyelési feedeket Telegramra, Discordra, Slackre és másokra. Részletekért lásd az [OpenClaw integrációs útmutatót](https://docs.claude-mem.ai/openclaw-integration).

**Főbb jellemzők:**

- 🧠 **Tartós memória** - A kontextus túléli a munkameneteket
- 📊 **Progresszív felfedés** - Többrétegű memória-visszakeresés token költség láthatósággal
- 🔍 **Skill-alapú keresés** - Lekérdezheti projekt előzményeit a mem-search skill segítségével
- 🖥️ **Webes megjelenítő felület** - Valós idejű memória stream a worker indításakor kiírt URL-en
- 💻 **Claude Desktop Skill** - Memória keresése Claude Desktop beszélgetésekből
- 🔒 **Adatvédelmi kontroll** - Használja a `<private>` címkéket az érzékeny tartalom kizárásához
- ⚙️ **Kontextus konfiguráció** - Finomhangolt kontroll afelett, hogy milyen kontextus kerül beillesztésre
- 🤖 **Automatikus működés** - Nincs szükség manuális beavatkozásra
- 🔗 **Hivatkozások** - Hivatkozás múltbeli megfigyelésekre ID-k alapján a worker API-n keresztül, vagy megtekintés a webes felületen

---

## Dokumentáció

📚 **[Teljes dokumentáció megtekintése](https://docs.claude-mem.ai/)** - Böngészés a hivatalos weboldalon

### Első lépések

- **[Telepítési útmutató](https://docs.claude-mem.ai/installation)** - Gyors indítás és haladó telepítés
- **[Használati útmutató](https://docs.claude-mem.ai/usage/getting-started)** - Hogyan működik automatikusan a Claude-Mem
- **[Keresési eszközök](https://docs.claude-mem.ai/usage/search-tools)** - Projekt előzmények lekérdezése természetes nyelvvel

### Bevált gyakorlatok

- **[Kontextus tervezés](https://docs.claude-mem.ai/context-engineering)** - AI ügynök kontextus optimalizálási elvek
- **[Progresszív felfedés](https://docs.claude-mem.ai/progressive-disclosure)** - A Claude-Mem kontextus előkészítési stratégiájának filozófiája

### Architektúra

- **[Áttekintés](https://docs.claude-mem.ai/architecture/overview)** - Rendszerkomponensek és adatfolyam
- **[Architektúra fejlődés](https://docs.claude-mem.ai/architecture-evolution)** - Az út a v3-tól a v5-ig
- **[Hooks architektúra](https://docs.claude-mem.ai/hooks-architecture)** - Hogyan használja a Claude-Mem az életciklus hookokat
- **[Hooks referencia](https://docs.claude-mem.ai/architecture/hooks)** - 7 hook szkript magyarázata
- **[Worker szolgáltatás](https://docs.claude-mem.ai/architecture/worker-service)** - HTTP API és Bun kezelés
- **[Adatbázis](https://docs.claude-mem.ai/architecture/database)** - SQLite séma és FTS5 keresés
- **[Keresési architektúra](https://docs.claude-mem.ai/architecture/search-architecture)** - Hibrid keresés Chroma vektor adatbázissal

### Konfiguráció és fejlesztés

- **[Konfiguráció](https://docs.claude-mem.ai/configuration)** - Környezeti változók és beállítások
- **[Fejlesztés](https://docs.claude-mem.ai/development)** - Építés, tesztelés, hozzájárulás
- **[Kiadási ágak](https://docs.claude-mem.ai/branches)** - A stable, core-dev és community-edge ágak folyamata
- **[Hibaelhárítás](https://docs.claude-mem.ai/troubleshooting)** - Gyakori problémák és megoldások

---

## Hogyan működik

**Fő komponensek:**

1. **5 életciklus hook** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook szkript)
2. **Intelligens telepítés** - Gyorsítótárazott függőségellenőrző (pre-hook szkript, nem életciklus hook)
3. **Worker szolgáltatás** - Helyi HTTP API webes megjelenítő felülettel és keresési végpontokkal, Bun által kezelve
4. **SQLite adatbázis** - Munkamenetek, megfigyelések, összefoglalók tárolása
5. **mem-search Skill** - Természetes nyelvi lekérdezések progresszív felfedéssel
6. **Chroma vektor adatbázis** - Hibrid szemantikus + kulcsszó keresés intelligens kontextus-visszakereséshez

Részletekért lásd az [Architektúra áttekintést](https://docs.claude-mem.ai/architecture/overview).

---

## MCP keresési eszközök

A Claude-Mem intelligens memóriakeresést biztosít **4 MCP eszközön** keresztül, egy token-hatékony **3-rétegű munkafolyamat-minta** alapján:

**A 3-rétegű munkafolyamat:**

1. **`search`** - Kompakt index lekérése ID-kkal (~50-100 token/eredmény)
2. **`timeline`** - Időrendi kontextus lekérése az érdekes eredmények körül
3. **`get_observations`** - Teljes részletek lekérése KIZÁRÓLAG a szűrt ID-khez (~500-1000 token/eredmény)

**Hogyan működik:**
- A Claude MCP eszközöket használ a memória kereséséhez
- Kezdje a `search`-sel, hogy egy indexet kapjon az eredményekről
- Használja a `timeline`-t, hogy lássa, mi történt egy adott megfigyelés körül
- Használja a `get_observations`-t, hogy teljes részleteket kérjen le a releváns ID-khez
- **~10x token megtakarítás** azáltal, hogy a részletek lekérése előtt szűr

**Elérhető MCP eszközök:**

1. **`search`** - Memóriaindex keresése teljes szöveges lekérdezésekkel, szűrés típus/dátum/projekt szerint
2. **`timeline`** - Időrendi kontextus lekérése egy adott megfigyelés vagy lekérdezés körül
3. **`get_observations`** - Teljes megfigyelési részletek lekérése ID-k alapján (mindig kötegelve, több ID-vel)

**Példa használat:**

```typescript
// 1. lépés: Index keresése
search(query="authentication bug", type="bugfix", limit=10)

// 2. lépés: Index áttekintése, releváns ID-k azonosítása (pl. #123, #456)

// 3. lépés: Teljes részletek lekérése
get_observations(ids=[123, 456])
```

Részletes példákért lásd a [Keresési eszközök útmutatót](https://docs.claude-mem.ai/usage/search-tools).

---

## Kiadási ágak

A stabil kiadások a `main` ágból jelennek meg, és az npm-re kerülnek publikálásra. A `core-dev` és a
`community-edge` forráskódból futtatott ágak a korai megbízhatósági javításokhoz és a
közösségi integrációkhoz. Lásd a **[Kiadási ágak](https://docs.claude-mem.ai/branches)** oldalt
az ágfolyamatért és a nem-stabil futtatási utasításokért.

---

## Rendszerkövetelmények

- **Node.js**: 20.0.0 vagy újabb
- **Claude Code**: Legújabb verzió plugin támogatással
- **Bun**: JavaScript futtatókörnyezet és folyamatkezelő (automatikusan települ, ha hiányzik)
- **uv**: Python csomagkezelő vektor kereséshez (automatikusan települ, ha hiányzik)
- **SQLite 3**: Tartós tároláshoz (mellékelve)

---
### Windows telepítési megjegyzések

Ha az alábbihoz hasonló hibát lát:

```powershell
npm : The term 'npm' is not recognized as the name of a cmdlet
```

Győződjön meg róla, hogy a Node.js és az npm telepítve van, és hozzá van adva a PATH-hoz. Töltse le a legújabb Node.js telepítőt a https://nodejs.org oldalról, és indítsa újra a terminált a telepítés után.

---

## Konfiguráció

A beállítások a `~/.claude-mem/settings.json` fájlban kezelhetők (automatikusan létrejön alapértelmezett értékekkel az első futtatáskor). Konfigurálható az AI modell, worker port, adatkönyvtár, naplózási szint és kontextus beillesztési beállítások.

Az összes elérhető beállításért és példákért lásd a **[Konfigurációs útmutatót](https://docs.claude-mem.ai/configuration)**.

### Mód és nyelv konfiguráció

A Claude-Mem több munkafolyamat-módot és nyelvet támogat a `CLAUDE_MEM_MODE` beállításon keresztül.

Ez a beállítás mindkettőt vezérli:
- A munkafolyamat viselkedését (pl. code, chill, investigation)
- A generált megfigyelésekben használt nyelvet

#### Hogyan konfigurálja

Szerkessze a beállítási fájlt a `~/.claude-mem/settings.json` helyen:

```json
{
  "CLAUDE_MEM_MODE": "code--zh"
}
```

A módok a `plugin/modes/` mappában vannak meghatározva. Az összes elérhető mód helyi megtekintéséhez:

```bash
ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/
```

#### Elérhető módok

| Mód | Leírás |
|------------|-------------------------|
| `code` | Alapértelmezett angol mód |
| `code--zh` | Egyszerűsített kínai mód |
| `code--ja` | Japán mód |

A nyelvspecifikus módok a `code--[lang]` mintát követik, ahol a `[lang]` az ISO 639-1 nyelvkód (pl. `zh` kínaihoz, `ja` japánhoz, `es` spanyolhoz).

> Megjegyzés: a `code--zh` (egyszerűsített kínai) már beépített — nincs szükség további telepítésre vagy plugin frissítésre.

#### A mód megváltoztatása után

Indítsa újra a Claude Code-ot az új mód konfiguráció alkalmazásához.
---

## Fejlesztés

Az építési utasításokért, tesztelésért és hozzájárulási munkafolyamatért lásd a **[Fejlesztési útmutatót](https://docs.claude-mem.ai/development)**.

---

## Hibaelhárítás

Problémák esetén írja le a problémát Claude-nak, és a troubleshoot skill automatikusan diagnosztizálja és javítási megoldásokat kínál.

Gyakori problémákért és megoldásokért lásd a **[Hibaelhárítási útmutatót](https://docs.claude-mem.ai/troubleshooting)**.

---

## Hibajelentések

Átfogó hibajelentések készítése az automatikus generátorral:

```bash
cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report
```

## Hozzájárulás

A hozzájárulásokat szívesen fogadjuk! Kérjük:

1. Fork-olja a tárolót
2. Hozzon létre egy feature branchet
3. Végezze el változtatásait tesztekkel
4. Frissítse a dokumentációt
5. Nyújtson be egy Pull Requestet

A Claude-Mem három ágból jelenik meg: `main` (stabil), `core-dev` és
`community-edge`. Kizárólag a `main` kerül publikálásra az npm-en; a többi
forráskódból fut. Lásd a [Kiadási ágak](https://docs.claude-mem.ai/branches) oldalt a
stratégiáért és a helyi futtatási utasításokért.

Lásd a [Fejlesztési útmutatót](https://docs.claude-mem.ai/development) a hozzájárulási munkafolyamatért.

---

## Licenc

A Claude-Mem az Apache License 2.0 licenc alatt áll.

Az Apache-2.0-t azért választottuk, mert a tartós ágenskodó memóriának
könnyen beágyazhatónak kell lennie fejlesztői eszközökbe, helyi ügynökökbe, MCP szerverekbe, vállalati
rendszerekbe, robotikai stackekbe és éles ügynök-hordozókba.

A teljes részletekért lásd a [LICENSE](LICENSE) fájlt. Lásd a [docs/license.md](docs/license.md)
és a [docs/ip-boundary.md](docs/ip-boundary.md) fájlokat a licencelési hatókörért és a
nyílt/kereskedelmi határvonalért.

**Megjegyzés a Ragtime-ról**: A `ragtime/` mappa az **Apache License 2.0** licenc alatt áll. Részletekért lásd a [ragtime/LICENSE](ragtime/LICENSE) fájlt.

---

## Támogatás

- **Dokumentáció**: [docs/](docs/)
- **Hibák**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues)
- **Tároló**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem)
- **Hivatalos X fiók**: [@Claude_Memory](https://x.com/Claude_Memory)
- **Hivatalos Discord**: [Csatlakozás a Discordhoz](https://discord.com/invite/J4wttp9vDu)
- **Szerző**: Alex Newman ([@thedotmack](https://github.com/thedotmack))

---

**Claude Agent SDK-val építve** | **Claude Code-dal működik** | **TypeScript-tel készítve**

---

### Mi a helyzet a CMEM-mel?

A CMEM egy harmadik fél által létrehozott token, amelyet a Claude-Mem alkotója (Alex Newman, @thedotmack) hivatalosan is felkarolt. A token a közösségi növekedés katalizátoraként és a CMEM-et az azt leginkább igénylő fejlesztőkhöz és tudásmunkásokhoz eljuttató eszközként funkcionál.

Hivatalos BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3