查询并分析远程服务器上的Claude Code会话数据,用于检查会话、查看对话历史、查看工具调用等。
ccsinfo - Claude 代码会话信息是一项面向实际任务的技能,主要用于访问并分析运行在用户机上的远程 ccsinfo 服务器的 Claude 代码会话数据;Server Repository : https://github.com/myk-org/ccsinf。
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;
涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
从用户本地运行的远程 ccsinfo 服务器访问并分析 Claude Code 会话数据。
服务端仓库:https://github.com/myk-org/ccsinfo
ccsinfo 服务端必须运行在拥有 Claude Code 会话数据的机器上。
安装并启动服务端:
# 安装 ccsinfo uv tool install git+https://github.com/myk-org/ccsinfo.git # 启动服务端(局域网内可访问) ccsinfo serve --host 0.0.0.0 --port 9999
该服务端从 ~/.claude/projects/ 读取 Claude Code 会话数据,并通过 REST API 暴露接口。
完整服务端文档请参见:https://github.com/myk-org/ccsinfo
必须已安装 ccsinfo CLI 工具。检查是否已安装:
which ccsinfo
如未安装,请运行安装脚本:
bash scripts/install.sh
设置环境变量 CCSINFO_SERVER_URL,指向你的服务端地址:
export CCSINFO_SERVER_URL=http://192.168.1.100:9999
建议将该行添加至 Shell 配置文件(如 .bashrc、.zshrc 等),以在所有会话中持久生效。
所有命令均自动通过环境变量 $CCSINFO_SERVER_URL 连接远程服务端。
ccsinfo sessions list
ccsinfo sessions show
ccsinfo sessions messages
ccsinfo search sessions "搜索关键词"
ccsinfo stats global
列出会话以获取 ID:
ccsinfo sessions list
查看会话详情:
ccsinfo sessions show
查看消息记录:
ccsinfo sessions messages
检查工具调用记录:
ccsinfo sessions tools
# 在全部会话中搜索 ccsinfo search sessions "refactor" # 在消息内容中搜索 ccsinfo search messages "fix bug" # 在提示词历史中搜索 ccsinfo search history "implement feature"
# 显示所有待处理任务 ccsinfo tasks pending # 列出某一会话下的任务 ccsinfo tasks list -s# 查看特定任务的详细信息 ccsinfo tasks show -s
# 整体使用统计 ccsinfo stats global # 按日活动分解 ccsinfo stats daily # 分析时间维度上的趋势 ccsinfo stats trends
# 列出所有项目 ccsinfo projects list # 查看项目详情 ccsinfo projects show# 查看项目统计信息 ccsinfo projects stats
大多数命令支持 --json 参数,以生成机器可读的 JSON 输出:
ccsinfo sessions list --json ccsinfo stats global --json
该功能适用于程序化解析结果,或配合 jq 进行过滤处理。
会话 ID 支持部分匹配——只需提供前几个字符即可:
ccsinfo sessions show a1b2c3 # 可匹配 a1b2c3d4-e5f6-7890-abcd-ef1234567890
完整命令参考请查阅 cli-commands.md。
# 验证 CCSINFO_SERVER_URL 是否已正确设置 echo $CCSINFO_SERVER_URL # 测试连接(列出会话) ccsinfo sessions list
# 检查 ccsinfo 是否已安装 which ccsinfo # 查看版本号 ccsinfo --version
bash scripts/install.sh
相关专题
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.1万人学习
共49课时 | 82.6万人学习
最新文章