Claude Code 使用技巧

Claude Code 是一个可以在终端、编辑器等环境中使用的 AI 编程工具。它能帮助我们阅读项目、分析问题、修改代码和运行检查。用好它的关键,是把目标、边界和验收方式说清楚,再亲自检查结果。
本文围绕日常开发介绍常用方法;命令和功能可能随版本变化,实际使用时可以通过 /help 和官方文档确认。
一、让 Claude 了解项目
用 CLAUDE.md 记录长期约定
项目根目录的 CLAUDE.md 适合保存框架、代码规范、常用验证命令和不应修改的范围。内容尽量简洁、明确,让新会话也能理解项目的基本规则。
可以使用 /init 帮助生成初稿,但生成后仍需要检查:删除不适用的内容,补上项目真正需要遵守的约定。
# 项目约定
- 使用现有分层结构,不随意引入新框架。
- 修改接口后运行相关测试,并说明未验证的部分。
- 未经明确要求,不提交或推送代码。区分项目记忆与个人偏好
项目级规则可以和团队共享;个人偏好适合放在用户级配置中。使用 /memory 查看和管理相关记忆,避免同一条规则散落在多个地方、互相矛盾。
二、管理上下文与会话
一次任务持续太久时,历史信息会占用上下文。可以按任务阶段整理信息,避免把已经过时的判断继续带入后续工作。
| 命令 | 适用场景 |
|---|---|
/context | 查看当前上下文的使用情况 |
/compact | 对较长的对话进行压缩,保留重要信息 |
/clear | 切换到无关任务时开始新的对话 |
/resume | 查找并继续已有会话 |
准备换会话时,可以先记录当前目标、已经完成的内容、验证结果、已知问题和下一步。新会话开始后,再让 Claude 核对文件和代码,避免仅凭旧摘要判断项目状态。
三、把需求说清楚
好的提示词不需要堆砌术语,重点是让任务具备清晰的范围和可检查的结果。一个实用的结构是:背景、目标、限制、验证方式。
请先阅读用户管理模块,了解现有接口和分层结构。
目标:给用户列表增加按姓名查询的功能。
要求:沿用当前项目风格,不修改无关模块。
完成后:运行相关测试,说明修改内容和未验证的部分。如果需求还不明确,可以先让它分析现状并给出方案;等方向确定后,再让它实现。对于复杂问题,也可以拆成几个小任务,逐步检查每一步的结果。
四、配合终端与编辑器
Claude Code 可以结合终端和编辑器使用。在支持的 IDE 中,可通过相应扩展与集成功能查看代码差异,再决定是否接受修改。终端中常用 /status 查看状态,使用 /help 查找当前版本支持的命令。
对于一次性任务或脚本,可以使用非交互模式。例如:
claude -p "阅读当前项目的 README,概括启动步骤"执行前应确认当前工作目录、权限配置和任务范围。让工具运行测试后,也要查看实际输出,不要只依赖一句“已完成”。
五、用 MCP 连接外部工具
MCP 可以让 Claude Code 接入额外的工具或数据来源,例如文档检索、项目管理服务。添加服务之前,先确认来源、需要的权限以及是否会访问敏感数据。
# 查看已配置的 MCP 服务
claude mcp list会话中可以使用 /mcp 查看连接状态。不同服务的安装参数和认证方式可能不同,具体配置以对应服务和 MCP 官方文档为准。
六、权限与自动化
按任务选择权限模式
阅读代码、制定方案和实际修改文件,所需权限并不相同。可以先在适合分析的模式下确认方案,再根据任务需要允许修改或执行命令。涉及删除、批量改动、外部访问等操作时,要仔细检查工具准备做什么。
权限规则可以在用户级或项目级设置中管理。团队共享的配置和个人配置作用范围不同;添加自动批准规则前,先确认匹配范围。具体规则和可用模式以 权限配置文档为准。
用 Hooks 和 Skills 固定重复流程
对于需要反复执行的工作,可以考虑用 Skills 保存工作流程,或使用 Hooks 在指定事件发生时运行命令。例如,在文件修改后检查格式,或在任务完成前提醒执行项目测试。
自动化规则应从小范围开始,并先确认命令的实际效果。不要把耗时很长或会改变大量文件的操作直接挂到每次编辑之后。相关配置可参考 Hooks 文档。
七、并行任务与 Git 协作
当任务能拆成互不依赖的部分时,可以考虑使用子任务分别处理,例如一边检查测试,一边阅读文档。每个子任务需要清晰的目标与范围;涉及相同文件或前后依赖的工作,则更适合按顺序推进。
使用 Git 时,可以先让 Claude 查看工作区状态和差异,再聚焦本次任务。完成后检查改动、运行合适的测试,确认结果后再决定是否提交。提交、推送或创建拉取请求之前,应明确这些操作是否在授权范围内。
八、日常工作流程
一次比较稳妥的 AI 辅助开发,可以按下面的顺序进行:
- 了解项目:阅读项目说明、相关代码和现有工作区状态。
- 明确任务:写清目标、修改范围和验收标准。
- 分步实现:从小范围开始,复杂改动先讨论方案。
- 检查验证:审查差异、运行相关测试,并记录未验证的内容。
- 整理交接:需要继续时,记录当前状态、问题和下一步。
AI 能加快阅读与实现,但最终仍需要自己理解方案、判断结果,并对项目状态负责。
常用命令速查
| 类别 | 命令 | 用途 |
|---|---|---|
| 帮助 | /help | 查看当前版本支持的命令 |
| 项目 | /init、/memory | 初始化或管理项目记忆 |
| 上下文 | /context、/compact、/clear | 查看或整理会话上下文 |
| 扩展 | /mcp | 查看 MCP 服务状态 |
| 会话 | /resume、/status | 恢复会话或查看状态 |
更多细节可查阅 Claude Code 官方文档。