Claude Code Guide

# Claude Code 指南 ## 目的 为充分发挥 Claude Code（智能体编码工具）的潜力提供全面参考。本技能综合了最佳实践、配置模板和高级使用模式。 ## 配置 (`CLAUDE.md`) 启动新项目时，在根目录创建一个 `CLAUDE.md` 文件以引导智能体。 ### 模板 (通用) markdown # 项目指南 ## 命令 - 运行应用: `npm run dev` - 测试: `npm test` - 构建: `npm run build` ## 代码风格 - 所有新代码使用 TypeScript。 - React 使用函数式组件配合 Hooks。 - 样式使用 Tailwind CSS。 - 错误处理使用提前返回 (Early returns)。 ## 工作流 - 先阅读 `README.md` 以了解项目背景。 - 编辑前先读取文件内容。 - 编辑后运行测试进行验证。 ## 高级功能 ### 思考关键词 在提示词中使用这些关键词以触发智能体更深层次的推理： - "Think step-by-step" (逐步思考) - "Analyze the root cause" (分析根本原因) - "Plan before executing" (执行前先规划) - "Verify your assumptions" (验证你的假设) ### 调试 如果智能体卡住或表现异常： 1. **清除上下文**: 开始新会话，或如果智能体感到困惑，要求其“忘记之前的指令”。 2. **明确指令**: 对路径、文件名和预期结果保持极度具体。 3. **日志**: 要求智能体“检查日志”或“以详细输出模式运行命令”。 ## 最佳实践 1. **小上下文**: 不要将整个代码库塞入上下文。先使用 `grep` 或 `find` 定位相关文件。 2. **迭代开发**: 要求进行小幅修改，验证后再继续。 3. **反馈循环**: 如果智能体犯错，立即纠正并要求其将“经验教训”添加到记忆中（如果支持）或 `CLAUDE.md`。 ## 参考 基于 [Claude Code Guide by zebbern](https://github.com/zebbern/claude-code-guide)。