ByteNoteByteNote
字

字节笔记本

2026年2月22日

Continuous Claude - Claude Code 的持续学习增强框架

#Claude Code

本文介绍 Continuous Claude，一个基于 Claude Code 构建的持久化、可学习、多代理开发环境。该项目通过 YAML handoffs、记忆系统和智能代码分析，解决了 Claude Code 上下文压缩丢失的问题，实现了跨会话的状态保持。

项目简介

Continuous Claude 是一个开源项目，由 parcadei 开发维护，旨在将 Claude Code 转变为一个持续学习的系统。截至目前，该项目在 GitHub 上已获得 3.5k+ stars 和 271 forks，采用 MIT 许可证。

项目的核心理念是：Compound, don't compact（复利，而非压缩）。通过自动提取学习成果并在新会话中保持完整上下文，让每个会话都使系统变得更智能。

核心特性

特性说明
109 个 Skills自然语言触发的模块化能力
32 个 Agents专业子会话代理，并行处理任务
30 个 Hooks会话生命周期管理和上下文注入
5 层代码分析TLDR 代码分析，节省 95% Token
记忆系统自动提取和召回学习成果
连续性系统YAML handoffs 实现跨会话状态保持

解决的问题

问题解决方案
上下文压缩导致信息丢失YAML handoffs - 更高效的 Token 传输
每次会话从零开始记忆系统自动召回 + 守护进程提取学习成果
读取整个文件消耗大量 Token5 层代码分析 + 语义索引
复杂任务需要协调Meta-skills 编排代理工作流
重复手动工作流109 个 skills 支持自然语言触发

技术栈

  • Python 3.11+ - 核心运行时
  • uv - 包管理器
  • PostgreSQL + pgvector - 向量数据库存储
  • Docker - 本地 PostgreSQL 运行
  • Claude Code CLI - 基础平台
  • FAISS - 语义搜索索引
  • BGE-large-en-v1.5 - 文本嵌入模型

安装指南

前置要求

  • Python 3.11+
  • uv 包管理器
  • Docker（用于 PostgreSQL）
  • Claude Code CLI

安装步骤

bash
# 克隆仓库
git clone https://github.com/parcadei/Continuous-Claude-v3.git
cd Continuous-Claude-v3/opc

# 运行安装向导（12 步骤）
uv run python -m scripts.setup.wizard

注意： pyproject.toml 位于 opc/ 目录下，所有 uv 命令都应从该目录运行。

安装向导流程

步骤功能
1备份现有的 .claude/ 配置（如果存在）
2检查前置条件（Docker、Python、uv）
3-5数据库 + API 密钥配置
6-7启动 Docker 栈，运行迁移
8安装 Claude Code 集成（32 代理、109 skills、30 hooks）
9数学功能（SymPy、Z3、Pint - 可选）
10TLDR 代码分析工具
11-12诊断工具 + Loogle（可选）

卸载

bash
cd Continuous-Claude-v3/opc
uv run python -m scripts.setup.wizard --uninstall

快速开始

bash
# 启动 Claude Code
claude

# 尝试工作流
> /workflow

常用命令

命令功能
/workflow基于目标的路由（研究/规划/构建/修复）
/fix bug <描述>调查和修复 bug
/build greenfield <功能>从零开始构建新功能
/explore理解代码库
/premortem实施前的风险分析

核心系统架构

Skills 系统

Skills 是自然语言触发的模块化能力，位于 .claude/skills/ 目录。

Meta-Skills（工作流编排器）

Meta-Skill工作链使用场景
/workflow路由 → 适当的工作流不知道从哪里开始时
/build发现 → 规划 → 验证 → 实现 → 提交构建功能
/fix侦查 → 预检 → 修复 → 测试 → 提交修复 bug
/tdd规划 → 仲裁（测试）→ 修复（实现）→ 仲裁测试优先开发
/refactor凤凰 → 规划 → 修复 → 审查 → 仲裁安全的代码转换
/explore侦察（快速/深度/架构）理解代码库

Agents 系统

Agents 是专业子会话代理，可以并行工作：

Agent用途
scout代码库探索
oracle研究任务
debug-agent调试助手
plan-agent架构设计
kraken代码实现
arbiter测试验证

Hooks 系统

Hooks 管理会话生命周期：

  • PostToolUse - 工具使用后处理
  • UserPrompt - 用户提示注入
  • SubagentStop - 子代理停止处理
  • PreCompact - 压缩前自动 handoff

TLDR 代码分析

5 层代码分析架构，实现 95% Token 节省：

层级内容Token 数
L1: AST函数、类、签名~500
L2: Call Graph跨文件依赖+440
L3: CFG控制流+110
L4: DFG数据流+130
L5: PDG程序切片+150
总计~1,200
原始代码~23,000

记忆系统

text
┌─────────────────────────────────────────────────────────────┐
│  MEMORY (PostgreSQL+pgvector)                               │
├─────────────────────────────────────────────────────────────┤
│  sessions (heartbeat)        - 会话心跳                     │
│  file_claims (locks)         - 文件锁定                     │
│  archival_memory (BGE)       - 归档记忆                     │
│  handoffs (embeddings)       - 交接嵌入                     │
└─────────────────────────────────────────────────────────────┘

连续性系统

连续性循环确保状态跨会话保持：

  1. 会话开始 - 加载 ledger、handoff、记忆召回、TLDR 缓存预热
  2. 工作阶段 - 跟踪变更、技能提示、代理报告
  3. 预压缩 - 自动 handoff、TLDR 重新索引
  4. 会话结束 - 守护进程提取学习成果到归档记忆

设计理念

代理由五个要素组成：Prompt + Tools + Context + Memory + Model

组件优化方向
PromptSkills 注入相关上下文；hooks 添加系统提醒
ToolsTLDR 减少 Token；agents 并行化工作
Context不仅是 Claude 知道什么，而是如何提供
Memory守护进程提取学习成果；召回使其浮现
Model其他四个要素稳固后，模型可替换

反复杂性原则

  • 时间，而非金钱 - 无必需的付费服务
  • 学习，而非积累 - 学习的系统比收集插件的系统更能处理边界情况
  • 左移验证 - Hooks 在编辑后运行 pyright/ruff，在测试前捕获错误

自然语言交互

无需记忆斜杠命令，直接用自然语言描述需求：

你说触发
"修复登录 bug"/fix 工作流 → debug-agent, scout
"构建用户仪表盘"/build 工作流 → plan-agent, kraken
"我想理解这个代码库"/explore + scout agent
"今天完成了"create_handoff（关键）
"从上次继续"resume_handoff

项目链接

Claude Code
上一篇

EdgeOne Pages AI：免费在边缘部署 DeepSeek R1 大模型

下一篇

Continuous Claude - Claude Code 的持续学习增强框架

分享: