# claude-code-yolo **Repository Path**: wang-zai-le/claude-code-yolo ## Basic Information - **Project Name**: claude-code-yolo - **Description**: 🚀 Claude Code YOLO - 一键安装 Claude Code 完整环境,包含 42+ 专业 Agent、全局 Skills、Hooks 脚本等。让 AI 编程更高效! - **Primary Language**: Unknown - **License**: MulanPSL-2.0 - **Default Branch**: master - **Homepage**: https://gitee.com/wang-zai-le/claude-code-yolo - **GVP Project**: No ## Statistics - **Stars**: 5 - **Forks**: 2 - **Created**: 2026-01-06 - **Last Updated**: 2026-02-04 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 🚀 Claude Code YOLO > **一键安装 Claude Code 完整环境** - 让 AI 编程更高效 [](https://github.com) [](https://www.npmjs.com/package/claude-code-yolo) [](https://github.com/PowerShell/PowerShell) [](LICENSE) --- ## 📖 简介 **Claude Code YOLO** 是一个 Claude Code 完整环境的自动化安装工具,只需一键即可配置包含 **42+ 专业 Agent**、**全局 Skills**、**Hooks 脚本** 等在内的完整开发环境。 ### ✨ 核心特性 - ✅ **一键安装** - 全自动配置,无需手动操作 - ✅ **完整迁移** - 包含所有 Agents、Skills、Hooks、Scripts - ✅ **智能验证** - 自动检测安装状态和配置可用性 - ✅ **自动修复** - 发现问题立即修复,确保环境完整 - ✅ **项目支持** - 支持全局配置 + 项目配置双重安装 - ✅ **安全可靠** - 自动备份现有配置,支持一键回滚 - ✅ **npm 支持** - v4.0.0!支持 npx 一键安装和使用 📦 - ✅ **防幻觉系统** - v4.0.0!全程监控 AI 操作,防止虚构内容 🛡️ - ✅ **WZL 工作流** - v4.0.0!4 大完整工作流,37 个自动化脚本 ⚡ - ✅ **SC 命令集** - v4.0.0!35 个 SuperClaude 命令 🚀 --- ## 📦 安装和用法 > **快速安装**:根据你的需求选择最合适的方式 ### 方式 1:npx 一键安装(推荐,最简单)⭐ > **无需下载项目,一条命令搞定!** 适合想要快速体验的用户 ```bash # 交互式菜单 npx claude-code-yolo # 直接初始化环境 npx claude-code-yolo init # 验证安装 npx claude-code-yolo verify # 查看帮助 npx claude-code-yolo --help ``` **npm 命令详解**: | 命令 | 说明 | 使用场景 | |-----|------|---------| | `npx claude-code-yolo` | 打开交互式菜单 | 首次使用,不确定具体操作 | | `npx claude-code-yolo init` | 初始化环境 | 想要快速安装,使用默认配置 | | `npx claude-code-yolo install` | 安装配置 | 同 init | | `npx claude-code-yolo verify` | 验证安装 | 检查环境是否配置成功 | | `npx claude-code-yolo fix` | 修复环境 | 检测到问题需要自动修复 | | `npx claude-code-yolo status` | 查看状态 | 查看当前安装状态和配置信息 | | `npx claude-code-yolo --help` | 查看帮助 | 查看所有可用命令 | **优势**: - ✅ 无需克隆项目 - ✅ 自动使用最新版本 - ✅ 交互式菜单友好 - ✅ 支持所有安装选项 - ✅ 跨平台支持(Windows/Mac/Linux) --- ### 方式 2:PowerShell 脚本(Windows,完整功能) > **适合需要推土机模式或自定义配置的场景** #### 第 1 步:下载项目 ```powershell # 打开 PowerShell,执行: git clone https://gitee.com/wang-zai-le/claude-code-yolo.git cd claude-code-yolo ``` #### 第 2 步:运行安装脚本 ```powershell # 方式 A:交互式菜单(推荐) .\install.ps1 # 方式 B:命令行参数 # 仅安装全局配置 .\install.ps1 -GlobalOnly # 验证安装 .\install.ps1 -Verify # 一键修复 .\install.ps1 -Fix ``` **安装流程**: ``` ======================================== Claude Code YOLO - 一键环境安装 ======================================== 【主菜单】 1. 安装 Claude Code 配置 2. 验证安装 3. 一键修复 4. 回滚到备份 5. 环境检测与安装 6. 查看安装状态 7. 关于 0. 退出 请选择操作 [0-7]: 1 ``` 然后按照提示操作即可。 --- ### 方式 3:全局安装 npm 包 > **适合频繁使用的用户** ```bash # 全局安装 npm install -g claude-code-yolo # 之后可以直接使用(不需要 npx) claude-code-yolo claude-code-yolo init claude-code-yolo verify ``` --- ### 安装后如何使用 安装完成后,在 Claude Code 中可以使用以下全局命令: #### 🔧 常用命令 ```bash /test-api # API 接口测试(推荐,无缓存) /test-cll # 跨平台测试命令(Git Bash 兼容) /fix # 快速修复问题 /debug # 深度调试复杂问题 /review # 代码审查(并行 3 个 Agent) /test # 运行测试 /commit # 创建 Git 提交 /analyze-error # 错误分析 /full-check # 全面质量检查 ``` #### 🚀 SuperClaude 命令(v4.0.0 新增) ```bash /sc:task # 执行复杂任务,智能工作流管理 /sc:workflow # 从 PRD 生成结构化工作流 /sc:analyze # 全面代码分析 /sc:improve # 系统性改进代码质量 /sc:build # 构建和编译项目 /sc:cleanup # 系统化清理代码 /sc:design # 设计系统架构 /sc:document # 生成专注文档 /sc:test # 执行测试并生成报告 ``` #### 🔧 WZL 工作流命令(v4.0.0 新增) ```bash /wzl:bug # Bug 修复工作流(完整闭环) /wzl:startup # 项目启动失败修复 /wzl:project # 需求开发完整流程 /wzl:update # 需求变更快速落地 ``` #### 🛡️ 中文命令(v4.0.0 新增) ```bash /检查 # 快速健康检查 /评测 # 对指定内容进行评测验收 /验收 # 验收交付物的完整性 ``` #### 🧹 清理命令 ```bash /wzl-clear-c # C 盘清理工具(v1.1.0,已移除 npm 缓存清理) /cleanup:userdir # 清理用户目录临时文件 ``` --- ### 配置文件位置 安装完成后,配置文件位于: ``` C:\Users\你的用户名\.claude\ ├── agents/ # 45+ Agent 定义 ├── commands/ # 95+ Skills 命令 ├── scripts/ # 143+ Hooks 脚本 ├── config.json # Hooks 和 MCP 配置 └── settings.json # 用户设置 ``` --- ### 更新和卸载 #### 更新到最新版本 ```bash # 使用 npm npm update -g claude-code-yolo # 或使用 npx(自动使用最新版) npx claude-code-yolo # 使用 Git git pull .\install.ps1 -GlobalOnly ``` #### 卸载 ```bash # 卸载 npm 包 npm uninstall -g claude-code-yolo # 删除配置文件(可选) Remove-Item -Recurse -Force $env:USERPROFILE\.claude ``` --- ## 🆕 功能详解 ### 防幻觉系统 v4.0.0 🛡️ > **全程监控 AI 操作,防止幻觉和错误** **核心功能**: - ✅ PreToolUse Hooks - 调用前验证 Agent 完成度 - ✅ PostToolUse Hooks - 调用后追踪操作结果 - ✅ Agent 完成验证器 - 验证 Agent 声称的完成是否真实 - ✅ 操作追踪系统 - 记录所有 Agent 操作供审计 - ✅ 文件锁机制 - 防止并发操作导致的状态冲突 **配置位置**:`C:\Users\你的用户名\.claude\config.json` --- ### WZL 工作流系统 v4.0.0 ⚡ > **4 大完整工作流,37 个自动化脚本** | 工作流 | 脚本数量 | 用途 | |-------|---------|------| | Bug 工作流 | 6 | Bug 修复完整流程 | | Startup 工作流 | 9 | 项目启动失败修复 | | Project 工作流 | 12 | 需求开发完整流程 | | Update 工作流 | 7 | 需求变更快速落地 | **使用示例**: ```bash /wzl:bug "服务启动失败,报错端口被占用" /wzl:project "开发用户认证功能,支持 JWT 和 OAuth2" ``` --- ### SC 命令集 v4.0.0 🚀 > **35 个 SuperClaude 命令,完整软件开发工作流** **主要命令**: - **sc-task** - 执行复杂任务,智能工作流管理 - **sc-workflow** - 从 PRD 和功能需求生成结构化实施工作流 - **sc-analyze** - 全面代码分析 - **sc-improve** - 系统性改进代码质量 - **sc-build** - 构建和编译项目 - **sc-test** - 执行测试并生成报告 **使用示例**: ```bash /sc:task "实现用户登录功能,包括前后端" /sc:workflow "根据 docs/prd.md 生成实施计划" ``` --- ## 🆕 历史新功能 ### v3.4.0 新功能:完整配置同步 > **问题**:用户的 `.claude` 目录有大量配置和脚本,但项目只包含部分内容 > > **解决**:v3.4.0 版本完整同步用户所有配置,确保安装包含所有内容 ### ✨ 同步内容 1. **核心文档** (4个) - GLOBAL_AGENT_GUIDE.md - Agent 使用指南 - RESPONSIBILITY_TRACE.md - 链式追责规则 - PYTHON_FIX_REPORT.md - Python 环境修复报告 - FORCE_LOADING_MECHANISM.md - 强制加载机制说明 2. **输出风格** (output-styles/) - 6种不同的 AI 输出风格(编程、结构化思维、工程师等) 3. **WZL 工作流系统** - 17个 wzl-*.py 脚本(bug/project/update/startup) - 4个 wzl-*.md 命令文件 - 集成到 config.json (Stop Hooks + PreToolUse Hooks) 4. **zcf 命令补全** (8个) - bmad-init, feat, git-cleanBranches, git-commit - git-rollback, git-worktree, init-project, workflow 5. **config.json 脱敏处理** - 自动脱敏 postgres 数据库连接字符串 - 自动脱敏 APIFOX_ACCESS_TOKEN - 自动脱敏 GITEE_PERSONAL_ACCESS_TOKEN - 自动脱敏 MCP Server Authorization --- ## 🆕 v3.3.0 新功能:推土机模式 > **问题**:如果电脑没有任何环境(Python、Node.js、Git),如何快速配置? > > **解决**:v3.3.0 版本新增"推土机模式",自动检测并安装所有依赖环境 ### ✨ 功能亮点 1. **自动环境检测** - 检测 Python、Node.js、Git 是否安装 - 显示版本信息和建议 - 一键查看安装状态 2. **自动安装支持** - Python 3.14.2 (推荐版本) - Node.js LTS - Git 最新版 - 使用 winget 自动安装 3. **引导式安装** - 主菜单新增"环境检测与安装"选项 - 自动安装所有缺失环境 - 提供手动安装指引 --- ## 🆕 v3.2.0 新功能:一键回滚支持 > **问题**:如果安装失败或新配置不理想,如何快速恢复到安装前的状态? > > **解决**:v3.2.0 版本新增主菜单"回滚到备份"选项,一键恢复! ### ✨ 功能亮点 1. **主菜单直接回滚** - 在主菜单选择"4. 回滚到备份"即可 - 无需手动执行命令 - 图形化列表显示所有可用备份 2. **智能备份管理** - 自动检测所有备份目录(`.claude.backup_*`) - 按时间倒序排列(最新的在最前面) - 显示备份时间和大小 3. **安全确认机制** - 回滚前需要确认操作 - 明确显示将要删除和恢复的内容 - 防止误操作 4. **完整错误处理** - 回滚失败时提供手动恢复命令 - 详细的错误信息提示 ### 📖 使用示例 #### 示例1:正常回滚流程 ```powershell PS> .\install.ps1 ======================================== Claude Code YOLO - 一键环境安装 ======================================== 【主菜单】 1. 安装 Claude Code 配置(动态路径) 2. 验证安装 3. 一键修复 4. 回滚到备份 ⭐ ← 选这个 5. 查看安装状态 6. 关于 0. 退出 请选择操作 [0-6]: 4 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 回滚到备份配置 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 【可用备份列表】 [1] .claude.backup_20260106_140522 时间: 2026-01-06 14:05:22 大小: 12.50 MB [2] .claude.backup_20260105_093015 时间: 2026-01-05 09:30:15 大小: 11.80 MB [0] 返回主菜单 ======================================== 请选择要恢复的备份 [0-2]: 1 ⚠️ 即将执行以下操作: ℹ️ 1. 删除当前配置: C:\Users\zhangsan\.claude ℹ️ 2. 恢复备份: C:\Users\zhangsan\.claude.backup_20260106_140522 ❌ 此操作不可撤销! 确认回滚? [Y/N]: Y 🔄 正在回滚配置... ℹ️ 删除当前配置... ✅ 已删除当前配置 ℹ️ 恢复备份: .claude.backup_20260106_140522 ✅ 已恢复备份 ======================================== ✅ 回滚成功! ======================================== ℹ️ 当前配置: C:\Users\zhangsan\.claude ℹ️ 备份来源: .claude.backup_20260106_140522 按回车键返回主菜单 ``` #### 示例2:无备份的情况 ```powershell 请选择操作 [0-6]: 4 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 回滚到备份配置 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ⚠️ 未找到任何备份目录 ℹ️ 备份目录命名格式: .claude.backup_YYYYMMDD_HHMMSS 按回车键返回主菜单 ``` ### 🔧 回滚功能详解 **备份目录命名规则**: - 格式:`.claude.backup_YYYYMMDD_HHMMSS` - 示例:`.claude.backup_20260106_140522` - 位置:`C:\Users\<用户名>\.claude.backup_*` **回滚过程**: 1. 删除当前的 `.claude` 目录 2. 将选中的备份目录复制为 `.claude` 3. 验证恢复成功 **安全保障**: - ✅ 回滚前需要确认(输入 Y/N) - ✅ 显示将要删除和恢复的路径 - ✅ 回滚失败时提供手动恢复命令 - ✅ 支持取消回滚(返回主菜单) >>>>>>> dev --- ## 🆕 v3.1.0 新功能:动态路径支持 > **问题**:之前的版本硬编码了 `C:\Users\Administrator\.claude` 路径,导致不同用户无法使用。 > > **解决**:v3.1.0 版本支持动态路径检测和自定义路径! ### ✨ 功能亮点 1. **自动检测当前用户** - 安装时自动识别当前登录用户 - 默认路径自动适配:`C:\Users\<你的用户名>\.claude` 2. **自定义安装路径** - 不满意默认路径?可以选择自定义路径! - 支持任意目录作为 Claude Code 配置目录 3. **智能路径替换** - 配置文件中的所有路径自动替换 - 支持 config.json 和 settings.json - 兼容 Windows 正反斜杠 ### 📖 使用示例 #### 场景1:使用默认路径(推荐,最简单) ```powershell PS> .\install.ps1 选择: 1 # 安装配置 检测到当前用户: zhangsan 默认安装路径: C:\Users\zhangsan\.claude 是否使用默认路径? [Y/N]: Y # 直接按 Y 即可 ✅ 安装完成!配置已安装到: C:\Users\zhangsan\.claude ``` #### 场景2:使用自定义路径 ```powershell PS> .\install.ps1 选择: 1 # 安装配置 检测到当前用户: zhangsan 默认安装路径: C:\Users\zhangsan\.claude 是否使用默认路径? [Y/N]: N # 选择 N 请输入自定义路径: D:\MyTools\ClaudeConfig ✅ 自定义路径: D:\MyTools\ClaudeConfig ✅ 路径验证: 通过 ✅ 安装完成!配置已安装到: D:\MyTools\ClaudeConfig ``` #### 场景3:不同用户名(无需手动配置) **用户 A(Administrator)安装**: ```powershell 默认路径: C:\Users\Administrator\.claude ✅ 安装成功 ``` **用户 B(zhangsan)安装**: ```powershell 默认路径: C:\Users\zhangsan\.claude ✅ 安装成功(无需手动修改任何东西) ``` **用户 C(lisi)自定义路径**: ```powershell 默认路径: C:\Users\lisi\.claude 选择自定义: E:\Tools\Claude ✅ 安装成功 ``` ### 🔧 技术细节 **自动替换的路径格式**: - `C:\Users\Administrator\.claude` → `C:\Users\<当前用户>\.claude` - `C:/Users/Administrator/.claude` → `C:/Users/<当前用户>/.claude` - 所有 Hook 脚本路径 - 所有 MCP 服务器配置路径 **配置文件处理**: ```json // 替换前 "command": "python C:\\Users\\Administrator\\.claude\\scripts\\hook.py" // 替换后(用户 zhangsan) "command": "python C:\\Users\\zhangsan\\.claude\\scripts\\hook.py" ``` --- --- ## 🎯 包含内容 ### 1️⃣ 全局配置(通用) | 类型 | 数量 | 说明 | |-----|------|------| | **Agents** | 45+ | 问题解决、开发、测试、评审等 42 个专业 Agent | | **Skills** | 13+ | `/test-api`, `/fix`, `/review`, `/commit` 等全局命令 | | **Hooks** | 34+ | 自动格式化、错误检测、覆盖率检查等脚本 | | **配置文件** | 2 | `config.json`, `settings.json` | ### 2️⃣ 项目配置(可选) - 项目级 Hooks - 项目级 Scripts - 项目级 Skills - 测试配置 --- ## 📁 目录结构 ``` claude-code-yolo/ ├── install.ps1 # 主安装脚本(带菜单)⭐ ├── README.md # 本文件 │ ├── global-config/ # 全局配置文件 │ ├── agents/ # 45+ Agent 定义 │ ├── commands/ # 全局 Skills │ ├── scripts/ # Hooks 脚本 │ ├── skills/ # 技能流程 │ ├── CLAUDE.md # 全局配置文档 │ ├── config.json # Hooks 配置 │ └── settings.json # 用户设置 │ └── lims-project-config/ # lims 项目配置(示例) ├── scripts/ # 项目级脚本 ├── skills/ # 项目级 Skills ├── test-cll/ # 测试配置 ├── hooks.json # Hooks 配置 └── settings.local.json # 项目设置 ``` --- ## 🔧 高级功能 ### 1. 自动备份 安装前自动备份现有配置到: ``` C:\Users\用户名\.claude.backup_时间戳 ``` ### 2. 一键回滚 如果出现问题,可以手动回滚: ```powershell # 删除当前配置 Remove-Item -Recurse -Force $env:USERPROFILE\.claude # 恢复备份 Move-Item -Path $env:USERPROFILE\.claude.backup_时间戳 ` -Destination $env:USERPROFILE\.claude ``` ### 3. 验证和修复 ```powershell # 验证安装状态 .\install.ps1 选择: 2 # 一键修复问题 .\install.ps1 选择: 3 ``` --- ## 🎨 包含的 Agent ### 问题解决团队(5人) - `debugger` - 调试和修复专家 - `error-analyzer` - 错误分析专家 - `quick-fix` - 快速修复专家 - `code-surgeon` - 代码外科专家 - `issue-resolver` - 问题解决专家 ### 开发团队(8人) - `dev-frontend` - 前端开发专家 - `dev-backend` - 后端开发专家 - `dev-backend-controller` - Controller 层专家 - `dev-backend-service` - Service 层专家 - `dev-backend-mapper` - Mapper 层专家 - `dev-backend-integration` - 第三方集成专家 - `dev-database` - 数据库专家 - `dev-deploy` - 部署专家 ### 测试团队(3人) - `test-unit` - 单元测试专家 - `test-integration` - 集成测试专家 - `test-e2e` - E2E 测试专家 ### 评审团队(3人) - `review-code` - 代码质量评审专家 - `review-performance` - 性能评审专家 - `review-security` - 安全评审专家 ### 文档团队(3人) - `doc-analyst` - 文档分析专家 - `doc-api` - API 文档专家 - `doc-user` - 用户文档专家 ### 其他团队(15+人) - 需求工程、规划与设计、技术勘察、交付、工具等 --- ## 🔗 Skills 命令 安装后可使用的全局命令: ```bash /test-api # API 接口测试 /fix # 快速修复问题 /debug # 深度调试 /review # 代码审查(并行3个Agent) /test # 运行测试 /analyze-error # 错误分析 /full-check # 全面质量检查 /commit # 创建 Git 提交 /cleanup:userdir # 清理临时文件 ``` --- ## ❓ 常见问题 ### Q1: 提示"无法运行脚本"? ```powershell # 设置 PowerShell 执行策略 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser ``` ### Q2: 如何找到项目路径? **方式1**: 文件管理器 1. 打开项目文件夹 2. 点击地址栏复制完整路径 **方式2**: 右键菜单 1. 右键项目文件夹 → 属性 2. 复制路径 **方式3**: IDE 1. 在 IDE 中右键项目 2. Copy Path → Absolute Path ### Q3: 我不需要项目配置? 在项目路径提示时: - 直接按回车跳过 - 或输入 `N` 返回主菜单 ### Q4: 安装后功能不正常? 1. 检查 Python 是否正确安装 2. 运行验证功能检查配置 3. 使用一键修复功能自动修复 ### Q5: 如何回滚到之前的状态? 备份目录位于: ``` C:\Users\用户名\.claude.backup_时间戳 ``` 删除当前的 `.claude` 目录,将备份目录改名为 `.claude` --- ## 🤝 贡献 欢迎贡献代码、报告问题或提出建议! ### 贡献方式 1. Fork 本仓库 2. 创建特性分支 (`git checkout -b feature/AmazingFeature`) 3. 提交更改 (`git commit -m 'Add some AmazingFeature'`) 4. 推送到分支 (`git push origin feature/AmazingFeature`) 5. 开启 Pull Request --- ## 📝 更新日志 ### v4.0.0 (2026-01-07) 🎉 重大更新 - 🛡️ **新增防幻觉系统** - PreToolUse + PostToolUse Hooks 全程监控 - ✨ **新增 WZL 工作流增强** - 37 个脚本(Bug修复、项目启动、需求变更) - ✨ **新增 SC 命令集** - 35 个 SuperClaude 命令(sc-task, sc-analyze, sc-improve等) - ✨ **新增 Agent 监控系统** - 全程跟踪 Agent 操作状态 - ✨ **新增中文命令** - 检查、评测、验收三大工作流 - 📊 **文件数大幅增长** - 从 ~223 增至 ~370(+147 新增) - 📈 **Skills 数量提升** - 从 60+ 增至 95(+35 SC 命令) - 🔧 **Hooks 脚本增强** - 从 105+ 增至 143(+38 防幻觉、WZL、测试) - 📝 **更新文档结构** - 添加详细的 npm 使用说明 - 🐛 **修复 wzl-clear-c 脚本** - 移除 npm 缓存清理,保护 npm 环境 ### v3.1.0 (2026-01-06) 🆕 - ✨ **重大更新:动态路径支持** - 自动检测当前用户,无需手动修改路径 - 支持自定义安装路径 - 智能替换配置文件中的所有路径 - 兼容 Windows 正反斜杠格式 - 📝 完善文档,添加引导式安装指南 - ✅ 修复配置同步问题 - ✅ 7个 wzl 工作流脚本完整集成 ### v3.0 (2026-01-06) - ✨ 新增主菜单系统 - ✨ 新增智能验证功能 - ✨ 新增一键修复功能 - ✨ 新增安装状态查看 - ✨ 支持返回主菜单 - 📝 完善文档说明 ### v2.0 (2026-01-05) - 🔒 清理所有敏感信息 - 🔄 改为用户输入路径模式 - ✅ 添加项目路径验证 - 📚 改进用户体验 ### v1.0 (2026-01-05) - 🎉 初始版本 - ✅ 支持全局和项目配置迁移 - ✅ 智能路径检测 - ✅ 自动备份和验证 --- ## 📄 许可证 本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件 --- ## 📞 支持 - 📧 邮箱: support@example.com - 🐛 问题反馈: [Gitee Issues](https://gitee.com/你的用户名/claude-code-yolo/issues) - 💬 讨论: [Gitee Discussions](https://gitee.com/你的用户名/claude-code-yolo/discussions) --- ## ⭐ Star History 如果这个项目对你有帮助,请给个 Star ⭐ ---