Claude Code 学习笔记（二）：新手必学的12个基础技巧

继续学习 [learn-claude-code](https://github.com/rickysoo/learn-claude-code) 项目。上一篇介绍了 Claude Code 是什么，这一篇进入实战——12个新手最该掌握的基础技巧。 --- ## 1. 文件操作：像聊天一样操作文件 忘掉复杂的命令行，直接用自然语言： ```bash claude-code "读取 main.py，告诉我这个文件是做什么的" claude-code "帮我在 utils 目录下创建一个日期处理模块" ``` **我的体会**：刚开始会觉得"这能行吗？"，但试几次后发现，它理解上下文的能力确实不错。比如你说"刚才那个文件"，它真的知道指的是哪个。 --- ## 2. 代码生成：描述即代码 不知道怎么写？描述清楚需求就行： ```bash claude-code "写一个 Python 函数，用递归实现斐波那契数列" claude-code "给 React 项目加一个带加载动画的按钮组件" ``` **注意点**：生成的代码通常需要 review，别直接用到生产环境。它是个"草稿生成器"，不是"完美交付机"。 --- ## 3. 错误处理：报错翻译官 遇到看不懂的报错，直接丢给它： ```bash claude-code "报错了：ModuleNotFoundError: No module named \u0027pandas\u0027，什么意思？" claude-code "TypeError: Cannot read property of undefined，怎么解决？" ``` **实用场景**：学习新技术时特别有用。它不仅会解释错误，还会给出修复建议，相当于一个耐心的助教。 --- ## 4. 代码分析：代码解释器 看别人写的代码（或自己三个月前写的），一头雾水？ ```bash claude-code "用简单的话解释一下 async/await 是怎么回事" claude-code "这段正则表达式想匹配什么？" ``` **一个小技巧**：可以要求它"像给5岁小孩解释一样"，往往能得到更通俗的说明。 --- ## 5. 代码重构：让代码更优雅 代码能跑，但看着别扭？ ```bash claude-code "这段代码太乱了，帮我重构一下" claude-code "把这些变量名改得更语义化一些" ``` **我的建议**：重构前先备份，或者确保在版本控制下。AI 重构虽然方便，但偶尔会有意外。 --- ## 6. 文档生成：告别文档恐惧症 写文档很痛苦，但不写更痛苦。 ```bash claude-code "给这个函数加上 docstring 注释" claude-code "帮我写一份 API 接口文档" ``` **实际效果**：生成的文档框架通常不错，但细节需要人工调整。毕竟它不知道你业务上的特殊考量。 --- ## 7. 版本控制：Git 不再可怕 Git 命令记不住？ ```bash claude-code "把当前改动提交，写个合适的 commit message" claude-code "看看我昨天改了哪些东西" ``` **注意**：涉及分支合并、冲突解决等复杂操作时，建议还是理解清楚再动手。AI 可以辅助，但别完全依赖。 --- ## 8. 开发环境配置：一站式搭建 新项目要配环境？ ```bash claude-code "帮我配置 React + TypeScript 的开发环境" claude-code "设置 ESLint 和 Prettier，让代码风格统一" ``` **省时利器**：特别是配置各种 linter、formatter 时，省去了查文档、改配置文件的麻烦。 --- ## 9. 调试辅助：解码错误信息 错误信息像天书？让它翻译： ```bash claude-code "ReferenceError: Cannot access \u0027user\u0027 before initialization 是什么意思？" ``` **学习价值**：不只是解决当前问题，还能理解 JavaScript 的暂时性死区（TDZ）概念。 --- ## 10. 项目上下文：它懂你的项目 Claude Code 会自动分析项目结构，理解你在做什么。 **实际体验**：我在一个 Django 项目里问"怎么添加用户认证"，它不仅给出代码，还自动识别出我用的 Django 版本，建议了适合的方案。 --- ## 11. 交互模式切换：灵活使用 快速问题用单行模式，复杂问题用对话模式： ```bash # 快速模式 claude-code "修复这个 bug" # 对话模式 claude-code # 然后连续多轮交流 ``` **我的习惯**：探索性任务用对话模式，已知明确任务用快速模式。 --- ## 12. CLAUDE.md：给 AI 的 onboarding 文档 在项目根目录创建 `CLAUDE.md`，写上： - 项目简介 - 技术栈 - 编码规范 - 特殊约定 **效果**：就像给新同事做入职培训，Claude Code 会参考这些信息，给出的建议更符合项目实际情况。 --- ## 小结 这12个技巧覆盖了日常开发中最常见的场景：读写文件、生成代码、处理错误、重构优化、写文档、用 Git。 掌握这些，基本就能用 Claude Code 提升日常效率了。当然，它生成的内容都需要人工 review——把它当成一个聪明的助手，而不是万能的替代品。 下一篇讲进阶技巧，涉及测试、性能优化、安全等更深入的话题。 --- *系列笔记索引：* - （一）初识这位不知疲倦的编程搭档 - （二）新手必学的12个基础技巧 ← 本篇 - （三）进阶玩家的12个效率秘籍（待更新） - （四）高阶玩家的12个高阶玩法（待更新） --- #ClaudeCode #AI编程 #学习笔记 #小凯