跳转到主要内容

Cc Safe Setup

插件 已验证 活跃

Claude Code 的 Token 消耗防护。警告大型文件读取(100KB+),限制每个会话的唯一文件读取次数,估算 Token 预算,并限制子代理生成。基于 800+ 小时的自主运行数据。

目的

通过防止与 Token 消耗和潜在的风险操作相关的问题,显著提高 Claude Code 在自主运行期间的安全性和效率。

功能

  • 警告大型文件读取 (>100KB)
  • 限制每个会话的唯一文件读取次数
  • 估算 Token 预算并警告/阻止超出
  • 限制每个会话的子代理生成
  • 为各种安全检查提供钩子

使用场景

  • 防止意外读取大型文件导致 Token 过度消耗
  • 防止无控制地生成子代理
  • 监控和管理 Token 使用量以避免意外成本
  • 提高 Claude Code 的整体操作安全性和稳定性

非目标

  • 取代 Claude Code 的核心功能
  • 直接管理用户凭据或秘密
  • 提供 AI 生成功能

工作流

  1. 通过 npm 或插件市场安装钩子
  2. 重启 Claude Code 以激活钩子
  3. 钩子自动监控文件读取、代理生成和 Token 使用情况
  4. 根据可配置的阈值发出警告或阻止
  5. 用户根据钩子反馈调整行为或 CLAUDE.md

实践

  • 操作安全
  • Token 管理
  • LLM 代理安全

先决条件

  • 系统中已安装 jq

文档

  • info:配置和参数参考README 和 plugin.json 提到了 CC_READ_BUDGET、CC_MAX_AGENTS 等配置变量,但它们的默认值和优先级顺序未明确记录。

调用

  • info:关闭钩子的机制此插件未记录明确的“关闭钩子”机制;禁用钩子可能需要手动删除配置。

安装

请先添加 Marketplace

/plugin marketplace add yurukusa/cc-safe-setup
/plugin install token-guard@cc-safe-setup

质量评分

已验证
97 /100
1 day ago 分析

信任信号

最近提交1 day ago
星标25
许可证MIT
状态
查看源代码