你每次用 Claude Code 做的一切,都被儲存在
~/.claude/projects/ 裡的 JSONL 檔案。問題是:三天後你想找當初那個「解決 auth bug 的對話」,根本不知道從何找起。search-sessions(Rust CLI,無需索引,280ms 搜完 1000+ sessions)和 cc-session(互動式 TUI,2000+ sessions 500ms 以內),是目前最快最好用的兩款 Claude Code session 管理工具。
問題的根源:Claude Code 的 Session 設計
如果你已經認真用 Claude Code 工作了幾週,你的 ~/.claude/projects/ 目錄大概已經長這樣:
~/.claude/projects/
├── -root-myapp-backend/
│ ├── 7897c935-2069-4b75-bbad-a3fac62ea59c.jsonl (480KB)
│ ├── 3a2b1c0d-...jsonl (220KB)
│ └── ... 48 個 session
├── -root-myapp-frontend/
│ └── ... 31 個 session
├── -root-infra/
│ └── ... 27 個 session
└── ... 共 38 個專案,766MB,超過 3000 個對話每個 session 都是一個 UUID 命名的 JSONL 檔案,內容是 JSON Lines 格式的對話記錄。
你當然記得自己「上週三有一個 Kubernetes RBAC 的討論」,但你完全不知道這個對話在哪個專案目錄、叫什麼 UUID。就算你用 grep 硬幹,1.6GB 的 JSONL 也需要好幾秒,而且你可能連當時用的確切關鍵字都記不清楚。
這就是 search-sessions 和 cc-session 要解決的問題。
工具一:search-sessions — 閃電搜尋,無須索引
search-sessions 是用 Rust 打造的 CLI 工具,最大特色是:不需要索引步驟,不需要資料庫,直接搜尋。
核心特性
- Index 搜尋模式:掃描 session metadata(標題、專案路徑),18ms 完成
- Deep 搜尋模式:搜尋完整對話內容,使用 ripgrep 加速後約 280ms
- 原生 Claude Code 整合:支援設為
/search-sessionsslash command,直接在 Claude Code 裡問「找上週的 auth 討論」 - OpenClaw 支援:加
--openclaw旗標可搜尋 OpenClaw agent sessions - 無外部依賴:純 Rust 一個 binary,不需要 Python、SQLite、Node.js
安裝方法
# macOS / Linux(Homebrew)
brew install sinzin91/tap/search-sessions
# Rust(跨平台)
cargo install search-sessions
# 加速 deep search(可選,約快 3-5x)
brew install ripgrep # macOS
apt install ripgrep # Ubuntu/Debian基本用法
# 最基本搜尋(index 模式,18ms)
search-sessions "kubernetes RBAC"
# 深度搜尋完整對話內容
search-sessions "docker compose" --deep
# 限定某個專案
search-sessions "auth" --project myapp
# 時間範圍過濾
search-sessions "deploy" --since "3 days ago"
search-sessions "bug" --date today
search-sessions "refactor" --since "last week"
# 搜尋 OpenClaw sessions
search-sessions "webhook" --openclaw搜尋結果範例
❯ search-sessions "auth refactor"
[1] auth refactor discussion
Project: ~/Projects/myapp
Date: 2026-01-28 15:30
Session: 7897c935-2069-4b75-bbad-a3fac62ea59c
Resume: cd ~/Projects/myapp && claude -r 7897c935-2069-4b75-bbad-a3fac62ea59c
[2] JWT token refresh auth flow
Project: ~/Projects/api-service
Date: 2026-02-14 09:15
Session: 4b2d8f1a-...
Resume: cd ~/Projects/api-service && claude -r 4b2d8f1a-...找到了,直接 copy-paste 那行 Resume: 指令就能無縫接續當時的對話。
最強功能:當 Claude Code Slash Command
這是 search-sessions 最聰明的設計。你可以把它設為 Claude Code 的 /search-sessions skill,然後直接在 Claude Code 裡說:
# 在 Claude Code 裡直接說
你:search my sessions for that kubernetes RBAC discussion
# Claude Code 會自動執行搜尋,找到相關 session,
# 並可以直接幫你 resume 那個 session不需要切換視窗、不需要記指令。這讓 session 搜尋從「中斷工作流的動作」變成「Claude Code 工作流的一部分」。
工具二:cc-session — 互動式 TUI,完整 Session 瀏覽器
cc-session 走的是另一個路線:互動式終端 UI(TUI),讓你像用文件瀏覽器一樣瀏覽所有 Claude Code sessions。
核心特性
- 2000+ sessions 在 500ms 內完成掃描,Rust 速度優勢
- 即時篩選:直接打字就能過濾,不需要切換模式,支援跨專案名稱、git branch、訊息內容
- Conversation Viewer:按 Enter 可以完整重播那個 session,含語法高亮、Markdown 表格渲染、可點擊 URL
- 對話內搜尋:按
/在 session 內搜尋,n/N跳下一個/上一個結果 - 深色/淺色主題自動偵測,可用
--dark / --light強制切換 - 跨平台剪貼簿:macOS 和 Linux(X11/Wayland)均支援,一鍵複製 resume 指令
安裝方法
# macOS(Homebrew)
brew install cc-deck/tap/cc-session
# Linux(curl installer)
curl --proto '=https' --tlsv1.2 -LsSf \
https://github.com/cc-deck/cc-session/releases/latest/download/cc-session-installer.sh | sh
# Rust(需要 Rust toolchain)
cargo install --git https://github.com/cc-deck/cc-session基本用法
# 開啟互動式 session 瀏覽器
cc-session
# 只顯示最近一週的 sessions
cc-session --since 7d
# 只顯示最近 20 個 session
cc-session --last 20
# 強制淺色主題(截圖/投影時好用)
cc-session --lightTUI 操作方式
cc-session 後,看到所有 sessions 列表,每行左邊是對話摘要,右邊是專案名稱 + 時間
Enter 進入 conversation viewer,完整重播那個 session
y 或 c 複製 resume 指令,貼到 terminal 就能繼續那個 session
Escape 清除篩選,再按一次 Escape 退出
🚀 Claude Code 進階技巧大全
台灣工程師整理的 Claude Code Pack:CLAUDE.md 範本、Multi-Agent 腳本、省錢設定、5 大實戰案例,一次學完
取得 Claude Code Pack($29)→search-sessions vs cc-session:詳細比較
| 功能 | search-sessions | cc-session |
|---|---|---|
| 操作介面 | CLI(命令列) | TUI(互動式終端 UI) |
| 搜尋速度 | 280ms(deep,with ripgrep) | 500ms(2000+ sessions) |
| 無索引直接搜尋 | ✅ 是 | ✅ 是 |
| 時間範圍過濾 | ✅ --since / --date | ✅ --since / --last |
| 完整 session 重播 | ❌ 不支援 | ✅ 語法高亮、Markdown 渲染 |
| 對話內搜尋 | ❌ 不支援 | ✅ / 鍵搜尋,n/N 跳結果 |
| Claude Code Skill 整合 | ✅ /search-sessions slash command | ❌ 無(需切換 terminal) |
| OpenClaw 支援 | ✅ --openclaw | ⚠️ 待確認 |
| 其他工具比較 | vs Copilot Search、aichat | vs Claudoscope(macOS App) |
| 平台支援 | macOS / Linux | macOS / Linux |
| 安裝方式 | Homebrew / cargo | Homebrew / curl installer / cargo |
| 費用 | 免費開源(MIT) | 免費開源 |
把 search-sessions 設為 Claude Code 的 slash command,用於「我記得有個討論但不知道在哪」的場景。
用 cc-session 做日常「今天/這週在做什麼」的瀏覽,以及需要重讀完整 session 內容的場景。
再搭配 ccusage 費用追蹤,就有了完整的 Claude Code 工作流管理工具組。
與其他同類工具的完整比較
| 工具 | 速度 | 依賴項 | 原生 Claude 整合 | 特色 |
|---|---|---|---|---|
| search-sessions | 280ms | 無 | ✅ Slash command | 最快、最輕量 |
| cc-session | 500ms | 無 | ❌ | 最完整 TUI 體驗 |
| cc-conversation-search | ~500ms | Python + SQLite | ❌ | 需要 Python 環境 |
| claude-history | ~400ms | Rust | ❌ TUI only | 功能較基本 |
| aichat claude-code-tools | ~300ms | Python + Tantivy | ❌ | 重量級依賴 |
| Claudoscope | GUI App | macOS App | ⚠️ 獨立 App | macOS 圖形介面、費用追蹤 |
5 大台灣開發者實戰場景
🔍 找上週的架構討論
你上週四跟 Claude Code 討論了電商系統的資料庫 schema 設計,今天前輩問你當時的決策依據,你想翻出那段對話。
# 在 Claude Code 裡直接說(設好 slash command 後)
你:search my sessions for that ecommerce database schema discussion from last week
# 或用 CLI
search-sessions "database schema ecommerce" --since "7 days ago"🐛 找已解決的 bug 解法
三週前用 Claude Code 解決了一個 Next.js 的奇怪水合 (hydration) 錯誤,現在另一個專案出現類似問題,想找回當時的解法。
# Deep search 搜尋完整對話內容
search-sessions "nextjs hydration error" --deep --project my-portfolio
# 或用 cc-session TUI
cc-session --since 30d
# 然後直接打 "hydration" 即時過濾📋 接手同事的 Claude Code 工作
你要繼續同事昨天做到一半的 API 重構任務,需要找到他留下的那個 session 繼續。
# cc-session 瀏覽今天/昨天的 sessions
cc-session --since 2d
# 找到對應 session 後,按 Enter 看對話內容確認
# 確認後複製 resume 指令繼續📊 整理本月的 Claude Code 工作記錄
月底要做工作回顧,需要整理這個月用 Claude Code 完成了哪些任務。
# 搜尋本月的 deploy 相關 sessions
search-sessions "deploy" --since "2026-04-01"
search-sessions "feature" --since "2026-04-01" --deep
search-sessions "refactor" --since "2026-04-01"
# 或用 cc-session 視覺化瀏覽
cc-session --since 30d
# 打字過濾不同關鍵字逐一回顧🔗 Resume 長期進行中的大型任務
你在做一個需要多次 session 累積的大型重構,每次開工前需要快速找回上次的 session 繼續。
# 每天開工前
cc-session --last 10 # 看最近 10 個 session
# 直接打專案名稱過濾,找到後 Enter 確認,copy resume 指令
# 或在 Claude Code 裡
你:resume my last session on the payment refactor☁️ 需要部署 Claude Code 伺服器環境?
DigitalOcean Droplet 是台灣開發者跑 Claude Code 遠端環境的熱門選擇:穩定、便宜、API 友善,新用戶 $200 免費額度
獲取 $200 免費額度 →進階設定:讓 search-sessions 成為 Claude Code Skill
這是 search-sessions 最值得花時間設定的功能。完成後,你可以在任何 Claude Code session 裡直接說「幫我找上週討論過 X 的 session」,Claude Code 會自動執行搜尋並回傳結果。
設定步驟
brew install sinzin91/tap/search-sessions# 把這行貼到任意 Claude Code session
Set up https://github.com/sinzin91/search-sessions as a /search-sessions skill.
# Claude Code 會自動讀取文件、安裝設定# 把這行加到你的 CLAUDE.md
Update your relevant files to use search-sessions when asked to remember or recall information.
# 之後 Claude Code 在你問「你記得嗎...」時會自動搜尋# 在 Claude Code 裡說
你:search my sessions for authentication bug fixes
# Claude Code 應該會執行
# /search-sessions "authentication bug fixes" --deep
# 並回傳搜尋結果建議在你的
CLAUDE.md(全域或專案層級)加上這一行:When the user asks to "remember", "recall", "find a past session", or "do you remember when", use search-sessions tool to find relevant sessions.這樣 Claude Code 就會知道何時要觸發 session 搜尋,大幅改善工作流連貫性。
常見問題 FAQ
Q:搜尋結果不準怎麼辦?
預設的 index 模式只搜尋 session metadata(標題 + 專案路徑),如果你的關鍵字在對話內容裡,需要加 --deep 旗標。另外建議安裝 ripgrep(brew install ripgrep),deep search 速度會快 3-5 倍。
Q:cc-session 的 TUI 在我的 terminal 顯示異常?
試試 cc-session --light 或 cc-session --dark 強制指定主題。某些 terminal(如 iTerm2 的部分主題)自動偵測可能失準,手動指定通常能解決。
Q:能在 CI/CD pipeline 或 script 裡用嗎?
search-sessions 完全適合腳本用途,輸出是純文字格式方便解析。cc-session 是 TUI 工具,不適合 pipeline 場景,請用 search-sessions。
Q:台灣用戶需要特別設定什麼嗎?
不需要,兩個工具對繁體中文關鍵字的支援都很好(Rust 原生 UTF-8 支援)。搜尋中文內容時建議用 --deep 模式,因為中文通常不會出現在 session metadata 裡。
Q:這些工具跟 Claudoscope 有什麼差別?
Claudoscope 是 macOS 的圖形介面 App,強調費用追蹤和 Secret 偵測。search-sessions 和 cc-session 是 CLI/TUI 工具,強調快速搜尋和 resume。功能互補,建議都裝。
Claude Code 工具組推薦:完整工作流
把這幾個工具搭配起來,就是目前台灣 Claude Code 開發者最強的工作流工具組:
| 工具 | 功能 | 重要性 |
|---|---|---|
| search-sessions | 跨 session 快速搜尋 | 必裝 |
| cc-session | 互動式 session 瀏覽 | 強烈推薦 |
| ccusage | 費用追蹤、帳單分析 | 必裝 |
| Claudoscope | macOS GUI、Secret 偵測 | Mac 用戶推薦 |
| AgentShield | Agent 可觀測性、風險偵測 | 進階用戶 |
📚 想學 Claude Code 從入門到進階?
Hahow 提供台灣最完整的 AI 工具應用課程:提示工程、Claude Code 實戰、自動化工作流,繁體中文教學,隨時複習
探索 Hahow AI 課程 →總結:該裝哪個?
1. 如果你只想裝一個:裝 search-sessions,設為 Claude Code slash command,280ms 搜完全部 sessions,零設定成本。
2. 如果你想要完整體驗:兩個都裝。用 cc-session 做日常瀏覽和 session 內容閱讀,用 search-sessions 做關鍵字搜尋和腳本自動化。
3. 如果你同時在意費用:再加上 ccusage,三件套齊了,Claude Code 工作流完整管理。
這兩個工具都是免費開源,安裝不到五分鐘。如果你已經用 Claude Code 累積了幾十甚至幾百個 session,現在就裝,省下的時間比安裝時間多幾百倍。