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

继续学习 learn-claude-code 项目。上一篇介绍了 Claude Code 是什么，这一篇进入实战——12个新手最该掌握的基础技巧。

1. 文件操作：像聊天一样操作文件

忘掉复杂的命令行，直接用自然语言：

claude-code "读取 main.py，告诉我这个文件是做什么的"
claude-code "帮我在 utils 目录下创建一个日期处理模块"

我的体会：刚开始会觉得"这能行吗？"，但试几次后发现，它理解上下文的能力确实不错。比如你说"刚才那个文件"，它真的知道指的是哪个。

2. 代码生成：描述即代码

不知道怎么写？描述清楚需求就行：

claude-code "写一个 Python 函数，用递归实现斐波那契数列"
claude-code "给 React 项目加一个带加载动画的按钮组件"

注意点：生成的代码通常需要 review，别直接用到生产环境。它是个"草稿生成器"，不是"完美交付机"。

3. 错误处理：报错翻译官

遇到看不懂的报错，直接丢给它：

claude-code "报错了：ModuleNotFoundError: No module named \u0027pandas\u0027，什么意思？"
claude-code "TypeError: Cannot read property of undefined，怎么解决？"

实用场景：学习新技术时特别有用。它不仅会解释错误，还会给出修复建议，相当于一个耐心的助教。

4. 代码分析：代码解释器

看别人写的代码（或自己三个月前写的），一头雾水？

claude-code "用简单的话解释一下 async/await 是怎么回事"
claude-code "这段正则表达式想匹配什么？"

一个小技巧：可以要求它"像给5岁小孩解释一样"，往往能得到更通俗的说明。

5. 代码重构：让代码更优雅

代码能跑，但看着别扭？

claude-code "这段代码太乱了，帮我重构一下"
claude-code "把这些变量名改得更语义化一些"

我的建议：重构前先备份，或者确保在版本控制下。AI 重构虽然方便，但偶尔会有意外。

6. 文档生成：告别文档恐惧症

写文档很痛苦，但不写更痛苦。

claude-code "给这个函数加上 docstring 注释"
claude-code "帮我写一份 API 接口文档"

实际效果：生成的文档框架通常不错，但细节需要人工调整。毕竟它不知道你业务上的特殊考量。

7. 版本控制：Git 不再可怕

Git 命令记不住？

claude-code "把当前改动提交，写个合适的 commit message"
claude-code "看看我昨天改了哪些东西"

注意：涉及分支合并、冲突解决等复杂操作时，建议还是理解清楚再动手。AI 可以辅助，但别完全依赖。

8. 开发环境配置：一站式搭建

新项目要配环境？

claude-code "帮我配置 React + TypeScript 的开发环境"
claude-code "设置 ESLint 和 Prettier，让代码风格统一"

省时利器：特别是配置各种 linter、formatter 时，省去了查文档、改配置文件的麻烦。

9. 调试辅助：解码错误信息

错误信息像天书？让它翻译：

claude-code "ReferenceError: Cannot access \u0027user\u0027 before initialization 是什么意思？"

学习价值：不只是解决当前问题，还能理解 JavaScript 的暂时性死区（TDZ）概念。

10. 项目上下文：它懂你的项目

Claude Code 会自动分析项目结构，理解你在做什么。

实际体验：我在一个 Django 项目里问"怎么添加用户认证"，它不仅给出代码，还自动识别出我用的 Django 版本，建议了适合的方案。

11. 交互模式切换：灵活使用

快速问题用单行模式，复杂问题用对话模式：

# 快速模式
claude-code "修复这个 bug"

# 对话模式
claude-code
# 然后连续多轮交流

我的习惯：探索性任务用对话模式，已知明确任务用快速模式。

12. CLAUDE.md：给 AI 的 onboarding 文档

在项目根目录创建 CLAUDE.md，写上：

• 项目简介
• 技术栈
• 编码规范
• 特殊约定

小结

这12个技巧覆盖了日常开发中最常见的场景：读写文件、生成代码、处理错误、重构优化、写文档、用 Git。

掌握这些，基本就能用 Claude Code 提升日常效率了。当然，它生成的内容都需要人工 review——把它当成一个聪明的助手，而不是万能的替代品。

下一篇讲进阶技巧，涉及测试、性能优化、安全等更深入的话题。

系列笔记索引：

• （一）初识这位不知疲倦的编程搭档
• （二）新手必学的12个基础技巧 ← 本篇
• （三）进阶玩家的12个效率秘籍（待更新）
• （四）高阶玩家的12个高阶玩法（待更新）

#ClaudeCode #AI编程 #学习笔记 #小凯