Quick Start¶

5分でClaude Code ⇄ Obsidian連携を開始し、シームレス統合の革新的体験を始めましょう。

前提条件¶

uv: Modern Python package manager（Python 3.11+を自動管理）
- インストール: 公式uv インストールガイド
- クイックインストール: curl -LsSf https://astral.sh/uv/install.sh | sh (Unix/macOS)
Python: 個別インストール不要 - uvがPython 3.11+を自動管理
Claude Codeプロジェクト: .claude/ディレクトリを含むプロジェクト
Obsidianボルト: 接続先のObsidianボルト

連携コマンド¶

基本的なセットアップから初回同期までを、以下のコマンドで一貫して実行します。

# 1. CKCをインストール
uv pip install claude-knowledge-catalyst

# 2. Claude Codeプロジェクトで初期化
cd your-claude-project
uv run ckc init

# 3. Obsidianボルトに接続
uv run ckc add my-vault /path/to/obsidian/vault

# 4. .claude/ファイルをObsidianと同期
uv run ckc sync

何が起こるか:

✅ シームレス統合: Claude Code開発とObsidian知識管理の完全連携が実現します。
✅ 自動構造化: .claude/ディレクトリ内のコンテンツが、Obsidianに最適化された構造で自動的に整理されます。
✅ リアルタイム同期: この後 uv run ckc watch を実行すれば、開発中の知識がリアルタイムでObsidianに反映されます。

コマンド詳細¶

ここからは、各コマンドの動作や、より高度な使い方を解説します。

Step 1: CKCインストール¶

CKCをインストールします。

uv pip install claude-knowledge-catalyst

Step 2: プロジェクト初期化¶

Claude Codeプロジェクト内でCKCを初期化します。これにより、ckc_config.yamlが生成されます。

cd your-claude-project
uv run ckc init

Step 3: Obsidianボルト接続¶

ObsidianボルトへのパスをCKCに登録します。

uv run ckc add main-vault /path/to/your/obsidian/vault

Step 4: 同期と自動化¶

.claudeディレクトリのナレッジをObsidianに同期します。

# 初回同期
uv run ckc sync

# リアルタイム自動同期
uv run ckc watch

サンプルコンテンツでの体験¶

# .claude/にサンプルファイルを作成
echo "# Git便利コマンド集

## ブランチ状態確認
```bash
git branch -vv
git status --porcelain
```

## リモート同期
```bash
git fetch --all
git pull origin main
```" > .claude/git_tips.md

自動分析とObsidian用メタデータ生成を確認¶

uv run ckc classify .claude/git_tips.md –show-evidence

分析結果例:

分析結果:
├── type: code (信頼度: 91%)
│   └── 根拠: "```bash", "git", "コマンド集"
├── tech: [git, bash] (信頼度: 95%)
│   └── 根拠: "git branch", "git status", "bash"
├── domain: [development, version-control] (信頼度: 88%)
│   └── 根拠: バージョン管理、開発ツール
└── complexity: beginner (信頼度: 82%)
    └── 根拠: 基本的なgitコマンド

Obsidianでの確認¶

# 同期実行
uv run ckc sync

# Obsidianボルトを確認
ls -la /path/to/your/obsidian/vault/knowledge/code/

Obsidianで生成されるファイル例:

---
title: "Git便利コマンド集"
type: code
tech: [git, bash]
domain: [development, version-control]
complexity: beginner
confidence: high
claude_project: "your-claude-project"
source_path: ".claude/git_tips.md"
created: 2025-06-20
updated: 2025-06-20
---

# Git便利コマンド集

## ブランチ状態確認
```bash
git branch -vv
git status --porcelain
```

## リモート同期
```bash
git fetch --all
git pull origin main
```

## 関連知識
- [[Git Workflow]]
- [[Version Control Best Practices]]

Step 5: 高度機能の体験¶

プロンプト作成と分析¶

# プロンプトファイルを作成
echo "---
title: API設計レビュープロンプト
type: prompt
---

# API設計レビュープロンプト

以下のAPI設計を以下の観点でレビューしてください：

1. **RESTful設計原則**への準拠
2. **セキュリティ**考慮事項
3. **パフォーマンス**最適化
4. **ドキュメント**の充実度

## API仕様
{API仕様をここに記載}

## 期待する出力
- 改善提案の優先順位付きリスト
- 具体的な修正例
- セキュリティリスクの指摘" > .claude/api_review_prompt.md

# 自動分析実行
uv run ckc classify .claude/api_review_prompt.md --show-evidence

既存Obsidianボルト強化¶

# 既存ボルトをClaude Code統合用に強化
uv run ckc migrate --source /existing/obsidian --target /enhanced/vault --dry-run

# 実際の移行実行
uv run ckc migrate --source /existing/obsidian --target /enhanced/vault

基本的なワークフロー¶

日常の開発フロー¶

# 1. プロジェクト開始
cd new-claude-project
uv run ckc init
uv run ckc add main-vault ~/ObsidianVault

# 2. 開発中の自動同期
uv run ckc watch &

# 3. Claude Code開発（.claude/に知見を蓄積）
# ... 開発作業 ...

# 4. 知識の検索・活用
uv run ckc search --tech python --success-rate ">80"
uv run ckc analyze .claude/my-prompt.md

プロジェクト完了時¶

# プロジェクト総括
uv run ckc project stats current-project

# 知識の成熟化
uv run ckc sync --finalize

設定のカスタマイズ¶

基本設定¶

# ckc_config.yaml
version: "1.0"
project_name: "Claude API Project"
auto_sync: true

# 自動分析設定
automation:
  auto_classification: true
  confidence_threshold: 0.75
  evidence_tracking: true

# Obsidian最適化
obsidian:
  structure_type: "state_based"
  auto_queries: true
  template_generation: true

セキュリティ設定¶

# CLAUDE.md同期（オプション）
watch:
  include_claude_md: false  # デフォルトは無効
  claude_md_sections_exclude:
    - "# secrets"
    - "# private"
    - "# api-keys"

Obsidianでの知識活用¶

自動生成クエリの活用¶

Obsidianボルトに自動生成される検索クエリ：

# 高成功率プロンプト
```dataview
TABLE success_rate, tech, updated
FROM #prompt
WHERE success_rate > 80
SORT success_rate DESC
```

# プロジェクト別コード
```dataview
LIST FROM [[Current Project]]
WHERE type = "code" AND status = "production"
```

タグベース検索¶

# 技術別知識
#tech/python AND #status/production

# チーム別知識
#team/backend AND #complexity/intermediate

# ドメイン横断
#domain/api-design AND #confidence/high

トラブルシューティング¶

よくある問題¶

同期されない

# 設定確認
uv run ckc status

# 手動同期
uv run ckc sync --force

自動分析が不正確

# 信頼度閾値調整
uv run ckc config set automation.confidence_threshold 0.8

Obsidianパスエラー

# パス確認
uv run ckc config get sync_targets

# パス更新
uv run ckc config set sync_targets.0.path "/correct/path"

次のステップ¶

✅ 基本統合完了！ 以下で詳細を学習：

Core Concepts - 統合アーキテクチャの詳細
Obsidian Migration - 既存ボルトの強化方法
Tag Architecture - 多次元タグシステム
Claude.md Sync - セキュアな同期設定

Demo Scripts¶

統合機能を実際に体験：

# Obsidian移行デモ
./demo/tag_centered_demo.sh

# ゼロ設定分類デモ
./demo/demo.sh

# マルチチーム協働デモ
./demo/multi_project_demo.sh

🎉 おめでとうございます！ Claude Code ⇄ Obsidian統合が完了しました。開発プロセスで生まれる知見が自動的にObsidianで構造化され、長期的な知識資産として活用できます。