ck(Context Keeper)是 Claude Code 的按项目持久记忆工具,用于在会话开始时自动加载项目上下文、跟踪会话并写入原生记忆。
用途:为每个项目保存上下文与进度,让 Claude Code 在重新进入项目时快速恢复工作状态。
主要能力:通过 /ck:* 系列命令管理项目。init 注册项目并自动检测信息;save 分析当前对话,生成摘要、leftOff、nextSteps、decisions、blockers 等会话状态;resume 输出完整简报;info 输出快速快照;list 输出项目组合视图;forget 删除项目上下文;migrate 将 v1 数据转换为 v2。数据存放于 ~/.claude/ck/,其中 projects.json 记录路径映射,contexts/<name>/context.json 为结构化 JSON 数据源,CONTEXT.md 为生成视图。
使用方式:命令对应 Node.js 脚本,位于 ~/.claude/skills/ck/commands/。例如注册项目运行 node "$HOME/.claude/skills/ck/commands/init.mjs",保存会话运行 node "$HOME/.claude/skills/ck/commands/save.mjs",恢复运行 node "$HOME/.claude/skills/ck/commands/resume.mjs"。命令不区分大小写。若脚本退出码为 1,将其 stdout 作为错误信息显示。
自动加载:需在 ~/.claude/settings.json 注册 SessionStart 钩子,命令为 node "~/.claude/skills/ck/hooks/session-start.mjs"。该钩子每次会话注入约 100 tokens 的五行摘要,并检测未保存会话、上次保存后的 git 活动以及与 CLAUDE.md 的目标不一致。
限制:不要直接编辑 context.json 或 CONTEXT.md,应始终通过脚本操作;Bash 调用中需将 ~ 展开为 $HOME;若 projects.json 格式错误,需告知用户并可重置为 {}。migrate 会备份原文件为 meta.json.v1-backup,不删除数据。其余收费、平台与效果信息暂未提供。