用途:为 Claude Code 网页版(远程会话)配置 SessionStart 钩子,在会话启动时自动安装项目所需的命令行工具,避免远程环境中 pre-commit 钩子或 just 配方因工具缺失而失败。
主要能力:根据项目信号自动检测所需工具,包括 .pre-commit-config.yaml 中的 gitleaks、actionlint、tflint、helm,以及 Chart.yaml、*.tf 或 terraform/ 目录、Justfile 等;生成或更新 scripts/install_pkgs.sh 与 .claude/settings.json 中的 SessionStart 钩子。支持工具:helm、terraform、tflint、actionlint、helm-docs、gitleaks、just、pre-commit。
使用方式:命令为 /configure:web-session,参数包括 --check-only(仅报告状态)、--fix(自动应用更改)、--tools <list>(逗号分隔覆盖自动检测)。脚本包含远程守卫(CLAUDE_CODE_REMOTE 不为 true 时退出)、逐工具幂等守卫(command -v 检查)、安装到 /usr/local/bin、临时目录清理等。验证命令:CLAUDE_CODE_REMOTE=true bash scripts/install_pkgs.sh,可运行两次验证幂等性。
适用场景:首次将仓库接入 Claude Code 网页版、远程会话中 pre-commit 或 just 因工具缺失失败、审计 install_pkgs.sh 是否最新且幂等。
限制:不适用于项目仅使用标准语言运行时(python、node、go、rust)或工具已在基础镜像中的情况;仅需环境变量时应使用网页 UI 的环境变量功能;调试特定钩子失败应先修复钩子本身。下载源需兼容 Limited 网络允许列表(github.com、releases.hashicorp.com、raw.githubusercontent.com、pypi.org)。