128 lines
5.1 KiB
Markdown
128 lines
5.1 KiB
Markdown
+++
|
||
author = "FlintyLemming"
|
||
title = "Claude Code 最佳实践（2025年5月）"
|
||
slug = "gXQuQoJyG28kepCiw9M4tp"
|
||
date = "2025-08-05"
|
||
description = "Claude Code 使用经验"
|
||
categories = ["Coding"]
|
||
tags = ["Claude", "AI"]
|
||
image = "https://img.mitsea.com/blog/posts/2025/08/Claude%20Code%20%E6%9C%80%E4%BD%B3%E5%AE%9E%E8%B7%B5%EF%BC%882025%E5%B9%B45%E6%9C%88%EF%BC%89/hirzul-maulana-r-i7U49v4c4-unsplash.avif"
|
||
+++
|
||
|
||
本文来源于官方演讲视频，原地址 [Claude Code best practices - YouTube](https://www.youtube.com/watch?v=gv0WHhKelSE "Claude Code best practices - YouTube") 由 AI 根据内容总结生成
|
||
|
||
### **1. 理解 Claude Code 的工作原理**
|
||
|
||
- **本质是代理（Agent）**：Claude Code 是一个基于终端操作的强大编码助手。它通过系统指令和工具链自动运行，持续调用工具来完成任务。
|
||
- **不依赖索引机制**：不像其他代码辅助工具会预处理和嵌入整个代码库，Claude Code 是“边走边学”，模拟人类开发者探索代码的方式——通过文件查找、目录浏览等命令理解项目结构。
|
||
|
||
***
|
||
|
||
### **2. 充分利用 ****`CLAUDE.md`**** 文件的作用**
|
||
|
||
- 这个文件用于为 Claude 提供上下文相关的说明或规则。
|
||
- 可以包含：
|
||
- 如何运行测试；
|
||
- 项目的组织方式介绍；
|
||
- 编码风格规范；
|
||
- 特殊注意事项或其他团队约定。
|
||
- 放置位置灵活：
|
||
- 项目根目录下并提交至版本控制中（方便多人共享）
|
||
- 家目录下配置全局生效的信息
|
||
|
||
***
|
||
|
||
### **3. 合理管理权限系统**
|
||
|
||
- 在进行危险操作前需手动确认：
|
||
- 写入文件（创建、修改）；
|
||
- 执行 shell 命令；
|
||
- 操作敏感数据或环境变量。
|
||
- **提高效率的小技巧**：
|
||
- 开启 `auto-accept`（Shift + Tab），让其快速启动；
|
||
- 对于重复性高且安全的操作可设置始终允许（如运行单元测试命令）；
|
||
- 学会适时打断与交互干预。
|
||
|
||
***
|
||
|
||
### **4. 充分发挥终端优势 & 工具整合能力**
|
||
|
||
- 因为其擅长执行 CLI 工具指令，因此推荐集成多种开发相关的 CLI 工具：
|
||
- Git、Docker、GitHub CLI (`gh`)等；
|
||
- 自定义脚本工具亦可通过 MCP 协议接入。
|
||
- 注意优先选择稳定公开文档清晰的命令行工具而非复杂自研插件。
|
||
|
||
***
|
||
|
||
### **5. 上下文管理和长会话优化**
|
||
|
||
- 当前模型支持高达 200K tokens 上下文长度。
|
||
- 长时间操作后注意检查提示信息，两种常见策略应对增长的内容：
|
||
- `/clear`: 清空当前会话上下文（保留 .claudemd 文件）；
|
||
- `/compact`: 总结历史内容形成摘要后再继续对话。
|
||
|
||
***
|
||
|
||
### **6. 利用计划驱动思维（Planning）提升可控性和质量**
|
||
|
||
- 强烈建议在正式开始编写前先要求 Claude 先输出解决方案规划，避免盲目推进错误方向。
|
||
- 使用 To-Do List 功能来追踪阶段性步骤，在关键节点校验其路径是否合理。
|
||
|
||
***
|
||
|
||
### **7. 实践智能调试与增量式编程模式**
|
||
|
||
- 推荐采用小步提交+频繁反馈流程：
|
||
- 修改 -> 测试 -> 格式检查 -> 提交循环（TDD理念延伸）；
|
||
- 遇到难以言表的问题可以用截图或图片辅助描述需求。
|
||
|
||
***
|
||
|
||
### **8. 探索高级玩法（进阶技巧）**
|
||
|
||
#### （1）多实例并行
|
||
|
||
- 考虑开启多个 Claude 终端窗口同步协作不同子任务；
|
||
|
||
#### （2）Escape 及回溯功能
|
||
|
||
- 随时按 Esc 中断当前进程，甚至双击进入回溯界面调整思路；
|
||
|
||
#### （3）MCP 插件拓展
|
||
|
||
- 若标准功能无法满足特定场景需要，请考虑添加自定义 MCP Server 来增强功能性；
|
||
|
||
#### （4）Headless 自动化
|
||
|
||
- 将其作为程序化的开发助理接入 CI/CD 或 DevOps 生命周期（例如 GitHub Actions）
|
||
|
||
***
|
||
|
||
### **9. 关注最新特性与更新动态**
|
||
|
||
- 新增功能包括：
|
||
- `/model` 查询使用的具体语言模型（Sonnet / Opus 等）；
|
||
- 跨工具间思考过程可视化（Think Hard between Tools）；
|
||
- 更好的 IDE 集成（如 VS Code 和 JetBrains 系列）；
|
||
- 官方 GitHub 仓库发布 Change Log，定期查看能及时掌握新技巧。
|
||
|
||
***
|
||
|
||
### **10. 处理常见行为挑战的经验分享**
|
||
|
||
| 场景 | 对策 |
|
||
| -------------- | ------------------------------------------------- |
|
||
| 模型不断生成无意义内联注释？ | 更新到 Claude 4 模型已经大幅改善该问题；同时可强化 CLAUDE.md 中禁止此类行为。 |
|
||
| 忽视用户定义规则怎么办？ | 新版更尊重定制约束；也建议清理过期条目保持精简有效。 |
|
||
|
||
***
|
||
|
||
### ✅ 最佳实践总结一句话版：
|
||
|
||
> “善用 `CLAUDE.md` + 规划先行 + 分阶段验证 + 权限管控结合自动化。”
|
||
|
||
如果你正打算深度应用 Claude Code，以上这些要素将极大帮助你在实际工作中事半功倍，构建高质量软件成果。
|
||
|
||
> Photo by [Hirzul Maulana](https://unsplash.com/@ijoelpitulikur?utm_content=creditCopyText&utm_medium=referral&utm_source=unsplash) on [Unsplash](https://unsplash.com/photos/colorful-floating-bubbles-against-a-blue-background-r-i7U49v4c4?utm_content=creditCopyText&utm_medium=referral&utm_source=unsplash)
|
||
|