Claude Code 实战诀窍：终端里的 AI 编程搭档

Claude Code 是 Anthropic 推出的命令行 AI 编程 Agent，它不像普通聊天机器人那样只会给建议，而是能直接在终端里读写文件、执行命令、完成多步任务。用了几个月，我总结了五个真正能提升效率的技巧，分享给你。

技巧一：用 .claudeignore 文件精准控制上下文

Claude Code 默认会扫描整个项目目录，但大型项目里 node_modules、dist、venv 这些文件夹不仅没用，还会浪费宝贵的上下文窗口。正确的做法是在项目根目录创建 .claudeignore 文件，语法和 .gitignore 完全一致：

node_modules/
dist/
*.log
.git/
__pycache__/

这样 Claude Code 就不会读取这些目录里的文件，响应速度明显变快，token 预算也花在刀刃上。你还可以针对不同任务准备多个 ignore 配置文件，比如 claude.frontend.ignore 只保留前端相关代码。

技巧二：善用 /fix 命令进行精准修复

很多人遇到错误只会重新描述一遍问题，其实 Claude Code 内置了 /fix 命令。当你运行代码报错时，直接把错误信息复制粘贴到终端，输入 /fix 加上错误日志，Claude 会自动定位到相关代码文件，分析错误原因并给出修复方案。

比如运行测试报错后，直接输入：

/fix TypeError: Cannot read properties of undefined (reading 'length')

它会自动打开相关文件，定位到报错行，分析上下文后给出修改建议，甚至直接帮你改好。比手动复制粘贴错误信息效率高得多。

技巧三：利用 --verbose 模式调试复杂任务

当 Claude Code 执行多步任务（比如重构代码+更新测试+修改配置文件）时，默认只会显示最终结果。如果中间某一步出了问题，很难定位。加上 --verbose 参数启动：

claude --verbose "把用户认证模块从JWT换成OAuth2"

它会打印每一步的具体操作：读取了哪些文件、执行了什么命令、每个步骤的输出结果。这对调试复杂工作流特别有用，你能看到它是在哪个环节卡住的，然后针对性地调整提示词。

技巧四：用 --resume 实现断点续传

Claude Code 的 API 调用有时会因网络波动或超时而中断。如果你正在处理一个需要跑十几分钟的大型重构任务，突然中断会很崩溃。这时候 --resume 参数就派上用场了：

claude --resume

它会从上次中断的位置继续执行，不会重复已经完成的工作。我一般会在执行长任务时保留终端窗口，万一断了直接 resume 继续，省得重新来一遍。

技巧五：用 Markdown 注释写“任务说明书”

Claude Code 对项目中的 Markdown 文件有很好的理解能力。我会在项目里放一个 TASK.md 文件，里面用清晰的 Markdown 结构写好当前任务的目标、约束条件和验收标准：

# 当前任务：重构支付模块
## 目标
- 把 Stripe 替换为微信支付
- 保持 API 接口不变
## 约束
- 不要修改数据库 schema
- 错误处理保持原有格式
## 验收
- [ ] 支付流程跑通
- [ ] 退款功能正常
- [ ] 测试通过率100%

然后在终端里输入：

claude "请根据 TASK.md 完成任务"

这样它就能准确理解你的意图，不会跑偏。而且这个文件本身也是团队协作的好文档，一举两得。

这几个技巧的核心思路是：不要把它当成聊天机器人，而要当成一个能操作你电脑的智能助手。控制好它能看到的文件、用好内置命令、做好任务规划，才能真正发挥 Claude Code 的威力。