claude-mem/README.ja.md at 25684ea8f7bccac1866864d596605d415531a3ed

Files

T

Alex Newman 25684ea8f7 Add Chinese translation for README and implement README translation script

- Created README.zh.md for Chinese localization of the project.
- Developed a README translation script to support multiple languages using Claude Agent SDK.
- Implemented CLI and programmatic usage for the translation tool.
- Added examples for integrating the translation tool into build scripts and CI/CD pipelines.
- Enhanced error handling and logging for translation processes.
- Included support for various languages and output customization options.

2025-12-12 00:58:36 -05:00

20 KiB

Raw Blame History

<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>
</h1>

<h4 align="center"><a href="https://claude.com/claude-code" target="_blank">Claude Code</a>向けに構築された永続的メモリ圧縮システム</h4>

<p align="center">
  <a href="LICENSE">
    <img src="https://img.shields.io/badge/License-AGPL%203.0-blue.svg" alt="License">
  </a>
  <a href="package.json">
    <img src="https://img.shields.io/badge/version-6.5.0-green.svg" alt="Version">
  </a>
  <a href="package.json">
    <img src="https://img.shields.io/badge/node-%3E%3D18.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>

<br>

<p 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="800">
    </picture>
  </a>
</p>

<p align="center">
  <a href="#クイックスタート">クイックスタート</a> •
  <a href="#仕組み">仕組み</a> •
  <a href="#mcp検索ツール">検索ツール</a> •
  <a href="#ドキュメント">ドキュメント</a> •
  <a href="#設定">設定</a> •
  <a href="#トラブルシューティング">トラブルシューティング</a> •
  <a href="#ライセンス">ライセンス</a>
</p>

<p align="center">
  Claude-Memは、ツール使用の観察結果を自動的にキャプチャし、セマンティックサマリーを生成し、それらを将来のセッションで利用可能にすることで、セッション間でコンテキストをシームレスに保持します。これにより、Claudeはセッションが終了または再接続した後でも、プロジェクトに関する知識の連続性を維持できます。
</p>

---

## クイックスタート

ターミナルで新しいClaude Codeセッションを開始し、以下のコマンドを入力してください:

/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem


Claude Codeを再起動します。以前のセッションのコンテキストが新しいセッションに自動的に表示されます。

**主な機能:**

- 🧠 **永続的メモリ** - コンテキストがセッション間で保持されます
- 📊 **段階的開示** - トークンコストの可視化を伴う階層的メモリ取得
- 🔍 **スキルベース検索** - mem-searchスキルでプロジェクト履歴をクエリ(約2,250トークン節約)
- 🖥️ **Web Viewer UI** - http://localhost:37777でリアルタイムメモリストリーム
- 💻 **Claude Desktopスキル** - Claude Desktopの会話からメモリを検索
- 🔒 **プライバシー制御** - `<private>`タグを使用して機密コンテンツをストレージから除外
- ⚙️ **コンテキスト設定** - どのコンテキストが注入されるかの詳細な制御
- 🤖 **自動動作** - 手動介入不要
- 🔗 **引用** - `claude-mem://` URIで過去の決定を参照
- 🧪 **ベータチャンネル** - バージョン切り替えでEndless Modeなどの実験的機能を試す

---

## ドキュメント

📚 **[完全なドキュメントを表示](docs/)** - GitHubでMarkdownドキュメントを閲覧

💻 **ローカルプレビュー**: Mintlifyドキュメントをローカルで実行:

```bash
cd docs
npx mintlify dev

はじめに

インストールガイド - クイックスタートと高度なインストール
使用ガイド - Claude-Memの自動動作方法
検索ツール - 自然言語でプロジェクト履歴をクエリ
ベータ機能 - Endless Modeなどの実験的機能を試す

ベストプラクティス

コンテキストエンジニアリング - AIエージェントコンテキスト最適化の原則
段階的開示 - Claude-Memのコンテキストプライミング戦略の哲学

アーキテクチャ

概要 - システムコンポーネントとデータフロー
アーキテクチャの進化 - v3からv5への道のり
フックアーキテクチャ - Claude-Memがライフサイクルフックを使用する方法
フックリファレンス - 7つのフックスクリプトの説明
Workerサービス - HTTP APIとPM2管理
データベース - SQLiteスキーマとFTS5検索
検索アーキテクチャ - Chromaベクターデータベースとのハイブリッド検索

設定と開発

設定 - 環境変数と設定
開発 - ビルド、テスト、コントリビュート
トラブルシューティング - よくある問題と解決策

仕組み

┌─────────────────────────────────────────────────────────────┐
│ セッション開始 → 最近の観察結果をコンテキストとして注入    │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│ ユーザープロンプト → セッションを作成、ユーザープロンプトを保存 │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│ ツール実行 → 観察結果をキャプチャ(Read、Writeなど)         │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│ Worker処理 → Claude Agent SDKを使用して学習内容を抽出       │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│ セッション終了 → サマリーを生成、次のセッションに備える    │
└─────────────────────────────────────────────────────────────┘

コアコンポーネント:

5つのライフサイクルフック - SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd(6つのフックスクリプト)
スマートインストール - キャッシュされた依存関係チェッカー(プリフックスクリプト、ライフサイクルフックではありません)
Workerサービス - Web Viewer UIと10の検索エンドポイントを備えたポート37777のHTTP API、PM2で管理
SQLiteデータベース - セッション、観察結果、サマリーをFTS5全文検索で保存
mem-searchスキル - 段階的開示を伴う自然言語クエリ(MCPと比較して約2,250トークン節約)
Chromaベクターデータベース - インテリジェントなコンテキスト取得のためのハイブリッドセマンティック+キーワード検索

詳細はアーキテクチャ概要を参照してください。

mem-searchスキル

Claude-Memは、過去の作業について質問すると自動的に呼び出されるmem-searchスキルを通じてインテリジェントな検索を提供します:

仕組み:

自然に質問するだけ: 「前回のセッションで何をしましたか?」または「このバグを以前修正しましたか?」
Claudeは関連するコンテキストを見つけるためにmem-searchスキルを自動的に呼び出します
MCPアプローチと比較してセッション開始あたり約2,250トークン節約

利用可能な検索操作:

観察結果を検索 - 観察結果全体にわたる全文検索
セッションを検索 - セッションサマリー全体にわたる全文検索
プロンプトを検索 - 生のユーザーリクエストを検索
コンセプト別 - コンセプトタグで検索(discovery、problem-solution、patternなど)
ファイル別 - 特定のファイルを参照する観察結果を検索
タイプ別 - タイプで検索(decision、bugfix、feature、refactor、discovery、change)
最近のコンテキスト - プロジェクトの最近のセッションコンテキストを取得
タイムライン - 特定の時点の周辺のコンテキストの統一タイムラインを取得
クエリによるタイムライン - 観察結果を検索し、最適一致の周辺のタイムラインコンテキストを取得
APIヘルプ - 検索APIドキュメントを取得

自然言語クエリの例:

「前回のセッションでどんなバグを修正しましたか?」
「認証をどのように実装しましたか?」
「worker-service.tsにどんな変更が加えられましたか?」
「このプロジェクトの最近の作業を見せてください」
「ビューアUIを追加したときに何が起こっていましたか?」

詳細な例は検索ツールガイドを参照してください。

ベータ機能とEndless Mode

Claude-Memは実験的機能を備えたベータチャンネルを提供しています。Web Viewer UIから直接安定版とベータ版を切り替えることができます。

ベータを試す方法

http://localhost:37777を開く
設定(歯車アイコン)をクリック
Version Channelで「Try Beta (Endless Mode)」をクリック
Workerの再起動を待つ

バージョンを切り替えてもメモリデータは保持されます。

Endless Mode(ベータ)

主要なベータ機能はEndless Modeです - セッション長を劇的に延長する生体模倣メモリアーキテクチャ:

問題点: 標準のClaude Codeセッションは約50回のツール使用後にコンテキスト制限に達します。各ツールは1〜10k+トークンを追加し、Claudeは各応答で以前のすべての出力を再合成します(O(N²)の複雑さ)。

解決策: Endless Modeはツール出力を約500トークンの観察結果に圧縮し、トランスクリプトをリアルタイムで変換します:

作業メモリ(コンテキスト):    圧縮された観察結果(各約500トークン)
アーカイブメモリ(ディスク):  呼び出しのために保存された完全なツール出力

期待される結果:

コンテキストウィンドウで約95%のトークン削減
コンテキスト枯渇前に約20倍のツール使用
二次O(N²)ではなく線形O(N)スケーリング
完全な想起のために保存された完全なトランスクリプト

注意点: レイテンシーが追加されます(観察生成あたり60〜90秒)、まだ実験段階です。

詳細はベータ機能ドキュメントを参照してください。

新機能

v6.4.9 - コンテキスト設定:

コンテキスト注入の詳細な制御のための11の新しい設定
トークンエコノミクス表示、タイプ/コンセプト別の観察結果フィルタリングを設定
観察結果の数と表示するフィールドを制御

v6.4.0 - デュアルタグプライバシーシステム:

ユーザー制御のプライバシーのための<private>タグ - 機密コンテンツをラップしてストレージから除外
システムレベルの<claude-mem-context>タグが再帰的な観察結果の保存を防止
エッジ処理により、プライベートコンテンツがデータベースに到達しないことを保証

v6.3.0 - バージョンチャンネル:

Web Viewer UIから安定版とベータ版を切り替え
手動のgit操作なしでEndless Modeなどの実験的機能を試す

以前のハイライト:

v6.0.0: セッション管理とトランスクリプト処理の大幅な改善
v5.5.0: 100%の有効性を持つmem-searchスキルの強化
v5.4.0: スキルベース検索アーキテクチャ(セッションあたり約2,250トークン節約)
v5.1.0: リアルタイム更新を備えたWebベースのビューアUI
v5.0.0: Chromaベクターデータベースとのハイブリッド検索

完全なバージョン履歴はCHANGELOG.mdを参照してください。

システム要件

Node.js: 18.0.0以上
Claude Code: プラグインサポート付きの最新バージョン
PM2: プロセスマネージャー(バンドル済み - グローバルインストール不要)
SQLite 3: 永続ストレージ用(バンドル済み)

主な利点

段階的開示コンテキスト

階層的メモリ取得は人間のメモリパターンを反映
レイヤー1(インデックス): セッション開始時にどの観察結果が存在するかをトークンコストとともに確認
レイヤー2(詳細): MCP検索を介してオンデマンドで完全なナラティブを取得
レイヤー3(完全な想起): ソースコードと元のトランスクリプトにアクセス
スマートな意思決定: トークン数により、Claudeが詳細を取得するかコードを読むかを選択できる
タイプインジケーター: 視覚的な手がかり(🔴 重要、🟤 決定、🔵 情報)が観察結果の重要性を強調

自動メモリ

Claudeが起動すると自動的にコンテキストが注入されます
手動コマンドや設定は不要
バックグラウンドで透過的に動作

完全な履歴検索

すべてのセッションと観察結果を検索
高速クエリのためのFTS5全文検索
引用が特定の観察結果にリンクバック

構造化された観察結果

AI駆動の学習内容抽出
タイプ別に分類(decision、bugfix、featureなど)
コンセプトとファイル参照でタグ付け

マルチプロンプトセッション

セッションは複数のユーザープロンプトにまたがる
/clearコマンド間でコンテキストが保持される
会話スレッド全体を追跡

設定

設定は~/.claude-mem/settings.jsonで管理されます。ファイルは初回実行時にデフォルト値で自動作成されます。

利用可能な設定:

設定	デフォルト	説明
`CLAUDE_MEM_MODEL`	`claude-haiku-4-5`	観察結果用のAIモデル
`CLAUDE_MEM_WORKER_PORT`	`37777`	Workerサービスポート
`CLAUDE_MEM_DATA_DIR`	`~/.claude-mem`	データディレクトリの場所
`CLAUDE_MEM_LOG_LEVEL`	`INFO`	ログの詳細度(DEBUG、INFO、WARN、ERROR、SILENT)
`CLAUDE_MEM_PYTHON_VERSION`	`3.13`	chroma-mcp用のPythonバージョン
`CLAUDE_CODE_PATH`	(自動検出)	Claude実行ファイルへのパス
`CLAUDE_MEM_CONTEXT_OBSERVATIONS`	`50`	SessionStartで注入する観察結果の数

設定管理:

# CLIヘルパーで設定を編集
./claude-mem-settings.sh

# または直接編集
nano ~/.claude-mem/settings.json

# 現在の設定を表示
curl http://localhost:37777/api/settings

設定ファイル形式:

{
  "CLAUDE_MEM_MODEL": "claude-haiku-4-5",
  "CLAUDE_MEM_WORKER_PORT": "37777",
  "CLAUDE_MEM_CONTEXT_OBSERVATIONS": "50"
}

詳細は設定ガイドを参照してください。

開発

# クローンとビルド
git clone https://github.com/thedotmack/claude-mem.git
cd claude-mem
npm install
npm run build

# テストを実行
npm test

# Workerを起動
npm run worker:start

# ログを表示
npm run worker:logs

詳細な手順は開発ガイドを参照してください。

トラブルシューティング

クイック診断:

問題が発生した場合は、Claudeに問題を説明してください。トラブルシュートスキルが自動的に起動して診断と修正を提供します。

よくある問題:

Workerが起動しない → npm run worker:restart
コンテキストが表示されない → npm run test:context
データベースの問題 → sqlite3 ~/.claude-mem/claude-mem.db "PRAGMA integrity_check;"
検索が機能しない → FTS5テーブルが存在するか確認

完全な解決策についてはトラブルシューティングガイドを参照してください。

コントリビュート

コントリビュートを歓迎します! 以下の手順に従ってください:

リポジトリをフォーク
機能ブランチを作成
テスト付きで変更を行う
ドキュメントを更新
プルリクエストを提出

コントリビュートワークフローについては開発ガイドを参照してください。

ライセンス

このプロジェクトはGNU Affero General Public License v3.0(AGPL-3.0)の下でライセンスされています。

詳細はLICENSEファイルを参照してください。

これが意味すること:

このソフトウェアを自由に使用、変更、配布できます
ネットワークサーバーで変更してデプロイする場合は、ソースコードを公開する必要があります
派生作品もAGPL-3.0の下でライセンスされる必要があります
このソフトウェアには保証がありません

サポート

ドキュメント: docs/
Issue: GitHub Issues
リポジトリ: github.com/thedotmack/claude-mem
作者: Alex Newman (@thedotmack)

Claude Agent SDKで構築 | Claude Codeで駆動 | TypeScriptで作成

20 KiB Raw Blame History