Claude Connect

核心功能

claude-connect 是专为 macOS 用户设计的 Claude 订阅桥接工具，解决 Clawdbot 无法持久识别 Claude Code CLI Token 的核心痛点。Claude Code 默认将 OAuth Token 存储于 macOS Keychain，但存在两项关键限制：Token 每 8 小时强制过期，且 Clawdbot 无法直接读取 Keychain 中的加密凭据。本技能通过自动化脚本打通这一链路。

显著优点

1. 零运维设计：首次配置后完全后台运行，每数小时静默检测，到期前 30 分钟自动刷新 Token
2. 智能容错：自动扫描 Keychain 中可能存在的重复或残缺条目，筛选完整 OAuth 数据使用
3. 双向同步：同时更新系统 Keychain 与 Clawdbot 的 auth-profiles.json 配置文件，确保两端一致
4. 低门槛部署：依赖仅 jq 与标准 macOS 工具，通过 clawdhub 或 Git 一键安装

潜在局限与风险

• 平台锁定：仅支持 macOS 10.15+，Windows/Linux 用户无法使用
• 订阅前提：必须持有 Claude Pro/Max/Team/Enterprise 有效订阅，免费账户不适用
• 安全依赖：需授予脚本 Keychain 访问权限，虽为本地操作，但涉及明文 Token 的临时处理
• 单点故障：若 Anthropic OAuth 端点变更或风控升级，自动刷新可能失效
• 执行环境敏感：强制要求在新 Terminal 窗口运行，误在 Claude Code CLI 内执行会导致连接中断

适合人群

• 重度依赖 Clawdbot 自动化工作流的 Claude 付费用户
• 希望消除「每 8 小时手动重新登录」痛点的效率极客
• 具备基础命令行操作能力的 macOS 开发者

常规风险提示

Token 刷新脚本需短暂访问网络及本地密钥存储，建议在个人可控设备运行；企业环境部署前应与安全团队确认 Keychain 访问策略合规性。

核心功能

claude-connect 是一款专为 macOS 设计的自动化工具，解决 Clawdbot 与 Claude Code CLI 之间的认证断连问题。其核心机制是通过定期刷新 OAuth token（每 8 小时有效期的前 30 分钟触发），确保 Claude 订阅服务与 Clawdbot 的持久化连接。

显著优点

自动化程度高：安装后零人工干预，通过 launchd 定时任务每 2 小时静默检查并刷新 token，彻底解决"token 过期导致认证失败"的痛点。

架构简洁安全：纯 Shell 脚本实现，零第三方依赖，仅使用系统原生工具（curl、jq、security、python3），显著降低供应链攻击面。

代码质量可靠：具备完整的错误处理、日志记录和原子写入机制，防止竞态条件；开源透明，GitHub 可完整审计。

用户体验友好：自动处理 Keychain 中的重复/不完整条目，支持 force 强制刷新，输出信息清晰明确。

潜在局限与风险

平台绑定：仅限 macOS 10.15+，依赖 Keychain 作为凭证存储后端，Windows/Linux 用户无法使用。

凭证操作敏感：需要读取 macOS Keychain 中的 OAuth token 并写入本地配置文件，涉及敏感数据访问权限；虽使用 TLS 1.2+ 加密传输，但 refresh_token 仍需离开本地系统与 Anthropic 服务器交互。

持久化机制风险：安装 launchd 定时任务建立持久化运行，若脚本被篡改将定期执行恶意代码。

网络依赖：必须保持与 anthropic.com 的连通性，企业内网或代理环境需额外配置。

适合人群

• 已订阅 Claude Pro/Max/Team/Enterprise 的 macOS 重度用户
• 使用 Clawdbot 作为 Claude 代理工具的开发者和自动化工作流用户
• 需要 Claude Code CLI 24/7 在线的无间断开发场景
• 具备基础终端操作能力、能理解 OAuth 和 Keychain 机制的技术用户

常规风险提醒

1. 权限最小化：安装后务必检查 ~/.clawdbot 目录权限为 700，配置文件为 600
2. 定期审计：建议每季度检查 launchd plist 内容完整性和 Keychain 访问日志
3. 网络监控：关注异常 anthropic.com 连接，确保仅访问官方 OAuth 端点
4. 更新追踪：订阅 GitHub Releases，及时应用安全补丁

综合评价

该 Skill 功能与声明高度一致，代码结构清晰、安全实践到位，是 macOS 生态下解决 Claude token 自动刷新的优质方案。72/100 的 CLS 评分和 A 级认证反映了其标准安全级别，适合能接受 T2 社区项目来源、具备基础安全意识的开发者部署使用。