新手常见错误

刚开始使用 Claude Code 的开发者经常会犯一些常见错误，导致效率低下甚至产生问题。本教程列举了八个最典型的新手错误，并给出具体的解决方法。

八个新手错误

跳过计划

直接让 Claude 干活，不提供背景信息。

忽略上下文限制

一直用到上下文快满了才发现问题。

使用模糊提示

“让这段代码更好”之类的指令太笼统。

盲目接受更改

不看 diff 就按”y”确认。

错误做法： 直接跳到”修这个 bug”，不解释上下文。

正确做法： 使用 WHAT/WHERE/HOW/VERIFY 格式：

WHAT: 修复登录超时错误
WHERE: src/auth/session.ts
HOW: 将 token 过期时间从 1 小时改为 24 小时
VERIFY: 刷新浏览器后登录状态持续存在

错误做法： 一直工作到上下文使用率达到 95%，此时响应质量已明显下降。

正确做法： 关注状态栏中的 Ctx(u): 指标。在 70% 时使用 /compact 压缩上下文，在 90% 时使用 /clear 清空重新开始。

错误做法： “让这段代码更好” 或 “检查有没有 bug”

正确做法： 具体明确：“重构 calculateTotal() 使其能处理价格为 null 的情况而不抛出异常”

让这个函数更好
检查有没有问题
优化这段代码

重构 calculateTotal() 使其能处理价格为 null 的情况而不抛出异常
检查 userAuth 模块中是否有 SQL 注入漏洞
将 processOrders() 的时间复杂度从 O(n²) 优化到 O(n log n)

错误做法： 不看 diff 就按”y”确认。

正确做法： 始终审查 diff。用”n”拒绝不合适的更改，然后解释哪里有问题。

错误做法： 在没有提交的情况下进行大规模更改。

正确做法： 在大改动前先提交。使用功能分支。Claude 可以帮忙：/commit

错误做法： 设置 Bash(*) 或使用 --dangerously-skip-permissions

正确做法： 从严格开始，根据需要逐步放宽。使用允许列表：

Bash(npm test)
Bash(git *)

错误做法： “修复认证 bug，同时重构数据库，再加上新测试”

正确做法： 每次会话专注一个任务。不同任务之间使用 /clear 清空上下文。

错误做法： 每次会话都手动输入临时指令。重复解释项目规范、架构和质量标准。

正确做法： 构建随时间积累的结构化上下文：

CLAUDE.md

你的规范、技术栈和模式——每次会话自动加载。

Skills

可复用的工作流（/review、/deploy），确保一致的执行。

Hooks

自动化的防护栏（代码检查、安全扫描、格式化）——零手动操作。

每次开始新会话前，确认以下几项：