Claude Code 不只是一个聊天框。它更像一个能进入项目目录、读写文件、执行命令、维护上下文的编程 Agent。
如果只是把需求丢进去让它生成代码,很快会遇到几个问题:计划不够清楚、权限反复确认、上下文越来越长、生成结果不满意、不知道怎么回滚,也不知道怎么把项目规则长期保存下来。
下面整理一组常用操作,适合刚开始使用 Claude Code 的开发者快速建立工作流。
先在项目目录启动
Claude Code 最好在项目目录里启动,而不是随便打开一个终端就开始用。
可以先创建一个文件夹作为项目目录,进入目录后打开命令行,再启动 Claude Code:
|
|
首次进入项目时,如果 Claude Code 询问是否信任当前文件夹,确认后再继续。这样它才能围绕当前项目读取文件、创建文件和执行后续操作。
一个简单的练习方式是让它创建一个摄影师个人网站。这个任务足够直观:能看到页面效果,也能练习文件生成、命令执行、回滚和后续重构。
计划模式先把方向想清楚
Claude Code 在面对较复杂任务时会进入计划模式。计划模式的作用是先讨论需求、拆解步骤,再让用户决定是否批准执行。
当它给出计划后,通常会出现几类选择:
- 批准计划,并允许后续自动使用编辑工具。
- 批准计划,但后续编辑仍然需要手动确认。
- 暂停执行,继续和 Claude Code 讨论计划。
如果任务比较明确,可以批准计划并继续。如果任务还不清楚,建议先让它继续补充方案,比如页面风格、技术栈、目录结构、交互效果和验收标准。
计划模式的好处是减少返工。直接让 Agent 动手,可能很快生成一堆文件;但如果方向错了,后面越改越乱。
用 Shift + Tab 切换模式
在 Claude Code 中,可以用 Shift + Tab 在不同工作模式之间切换。常见用途是进入计划模式,或者切换到自动同意编辑工具的模式。
建议的习惯是:
- 新项目、新功能、大改动:先进入计划模式。
- 小改动、明确修复:可以直接执行。
- 涉及删除、批量替换、安装依赖:保持人工确认。
计划模式下,Claude Code 可能会主动询问项目细节。可以用方向键选择选项,用回车确认。提交反馈后,它会根据你的选择更新计划。
权限确认不要一律放开
Claude Code 执行命令、编辑文件或启动程序时,可能会申请权限。
常见选择包括:
- 只同意本次使用。
- 在当前会话中以后都同意同类命令。
- 拒绝或暂停。
如果只是启动本地页面、运行开发服务器、查看文件,可以根据需要允许。但不要为了省事长期使用“自动同意所有权限”的启动方式。
全自动权限适合非常确定、风险很低、项目已经有 Git 备份的场景。日常使用中,涉及删除文件、覆盖目录、安装依赖、联网、提交代码、执行脚本时,最好保留人工确认。
用终端模式执行本地命令
Claude Code 里可以进入终端命令模式,直接执行一些本地命令。
例如页面生成后,可以用系统命令打开 HTML 文件:
|
|
这里的 start 是 Windows 下打开文件的命令,后面接文件名。这样可以快速查看生成页面,而不用手动去资源管理器里找文件。
终端模式适合执行这些轻量操作:
- 打开生成的页面。
- 查看目录内容。
- 启动本地开发服务器。
- 运行测试或构建命令。
但高风险命令仍然要谨慎,比如递归删除、移动目录、批量覆盖和修改系统环境。
回滚:结果不满意时及时退回
如果 Claude Code 做出的页面或代码不是你想要的,而且越改越乱,就应该及时回滚。
回滚功能可以把对话或代码退回到某个节点。常见选项包括:
- 同时回滚代码和对话。
- 只回滚对话。
- 只回滚代码。
- 把某个节点之前的内容压缩成摘要。
- 取消操作。
更推荐在明显走偏时选择“同时回滚代码和对话”。这样可以让上下文和文件状态一起回到较干净的位置。
需要注意:Claude Code 的回滚通常只能覆盖它通过内置工具创建或修改的文件。如果文件是通过外部命令生成的,未必能完整回滚。因此重要项目仍然要配合 Git 使用。
长提示词用编辑器写
复杂需求不要全挤在一行输入框里。
如果系统支持在文本编辑器中编辑长提示词,可以打开编辑器,把需求写完整后保存,再发送给 Claude Code。
长提示词里建议写清楚:
- 目标是什么。
- 使用什么技术栈。
- 不要做什么。
- 需要保留哪些文件。
- 完成后如何验证。
- 页面或功能的验收标准。
例如让 Claude Code 把一个普通 HTML 页面重构成更现代的技术栈时,不要只写“重构一下”。可以说明希望使用组件化结构、保留视觉内容、增加响应式布局,并要求它运行构建检查。
退出后用历史恢复会话
如果中途需要退出 Claude Code,可以正常退出。之后回到同一个项目目录,再次启动:
|
|
如果发现前面的记录没有直接显示,可以使用历史相关命令查看最近会话,并加载之前的会话。
这个功能适合中断后继续工作。不过不要把会话历史当成唯一记忆。项目规则、技术栈、常用命令和注意事项,最好写进项目文件里。
用 CLAUDE.md 保存项目规则
CLAUDE.md 是 Claude Code 很重要的记忆文件。它通常放在项目根目录,用来告诉 Claude Code 项目规则、技术栈、目录结构和协作约束。
可以让 Claude Code 初始化这个文件:
|
|
CLAUDE.md 适合记录:
- 项目目标。
- 技术栈。
- 常用启动、测试、构建命令。
- 目录说明。
- 代码风格。
- 不允许执行的操作。
- 提交和部署规则。
每次对话时,Claude Code 会把这类规则作为上下文的一部分使用。你可以把它理解成“项目说明书”。
一个简单验证方式是:在 CLAUDE.md 里加入一条明显规则,然后再向 Claude Code 提问。如果回答遵循了这条规则,就说明它确实读到了项目记忆。
用 @ 引用文件
在输入框中使用 @,可以选择文件或 Agent,把指定内容加入当前对话上下文。
这适合几类场景:
- 让 Claude Code 阅读某个配置文件。
- 让它修改某个指定页面。
- 让它根据
CLAUDE.md或其他文档继续工作。 - 明确告诉它“只看这个文件,不要猜项目结构”。
相比把文件内容复制到输入框里,@ 引用更清晰,也更不容易漏内容。
查看和压缩上下文
长时间对话后,上下文会越来越大。上下文太长时,模型可能变慢,也可能开始忽略早期细节。
可以使用上下文查看命令了解当前占用情况:
|
|
如果上下文已经很长,可以压缩历史:
|
|
如果压缩后效果仍然不好,可以考虑清空当前上下文:
|
|
清空上下文后,Claude Code 仍然可以通过项目文件、CLAUDE.md 和当前目录重新理解一部分项目情况,但不会保留完整对话历史。
实用建议是:一个任务完成后就开新会话;项目级规则写进 CLAUDE.md;临时讨论不要无限堆在一个聊天里。
Skills:把固定流程做成说明书
Skills 可以理解为 Claude Code 的工作说明书。它不是一次性提示词,而是一套可复用的任务流程。
例如你经常要生成周报,就可以创建一个周报 Skill,里面写清楚:
- 输入需要哪些信息。
- 输出格式是什么。
- 语气和结构怎么控制。
- 哪些内容必须保留。
- 哪些内容不能编造。
Skills 通常由 name、description 和具体指令组成。安装到全局 Skills 目录后,Claude Code 在遇到相关任务时可以识别并加载。
这适合处理重复工作:
- 周报。
- 代码审查模板。
- 文档整理。
- 图片批处理。
- 固定格式文章。
- 项目初始化流程。
如果你发现自己反复复制同一段提示词,就可以考虑把它做成 Skill。
Agents:把子任务交给独立助手
Agents 和 Skills 不一样。
Skill 更像说明书,告诉 Claude Code 怎么做某类任务;Agent 更像一个独立助手,可以在当前主会话之外执行任务,完成后把结果返回。
Agents 的价值在于隔离上下文。比如做代码巡检时,可以创建一个只读 Agent,让它只读取项目并输出报告,不直接修改文件。这样不会污染主会话,也能降低误操作风险。
创建 Agent 时通常要考虑:
- 是项目级 Agent,还是用户级 Agent。
- 是否需要 Claude Code 帮你生成配置。
- 允许哪些工具权限。
- 使用哪个模型。
- 是否保存记忆。
- Agent 的提示词是否足够明确。
对于代码巡检类 Agent,建议只给读取权限,不给写入权限。先让它输出报告,再由主会话决定是否修改代码。
插件:打包 Skills、Agents、MCP 和 Hooks
插件可以理解为更完整的能力包。它可能同时包含:
- Skills
- Agents
- MCP
- Hooks
相比单独安装一个 Skill,插件更适合成套能力。例如前端设计插件可能会把页面审美、布局规则、组件习惯和相关 Agent 一起打包。
安装插件时通常会有几个位置选项:
- 安装到用户目录,对所有项目生效。
- 安装到项目目录,随项目共享。
- 安装到本地项目目录,只在当前电脑生效。
如果是个人常用能力,可以放在用户目录;如果是团队项目约定,可以放进项目目录;如果只是临时测试,放本地项目目录更稳。
插件能明显改善特定任务效果
在前端页面生成这类任务里,插件往往比裸提示词更稳定。
例如同样是“制作一个摄影师个人网页”,只用普通提示词可能生成一个能看的页面;如果明确使用前端设计插件,页面结构、视觉层次、间距、配色和整体完成度通常会更好。
这并不意味着插件能替代人工审美。更合理的用法是:先让插件生成一个更好的初稿,再由人做细节微调。
一套更稳的 Claude Code 工作流
把上面这些技巧组合起来,可以形成一套比较稳的流程:
- 在项目目录启动
claude。 - 先用计划模式讨论需求。
- 批准计划前确认技术栈和验收标准。
- 涉及高风险操作时保留手动确认。
- 用终端模式执行本地预览和测试。
- 结果走偏时及时回滚。
- 把项目规则写进
CLAUDE.md。 - 长对话定期查看和压缩上下文。
- 重复流程沉淀成 Skills。
- 巡检、研究、分析类任务交给只读 Agents。
- 特定领域任务优先用插件。
- 重要项目始终配合 Git 提交点。
这样使用 Claude Code,会比单纯“发一句需求等它生成”稳定得多。
小结
Claude Code 的效率不只来自模型能力,也来自工作流控制。
计划模式决定方向,权限确认控制风险,回滚减少返工,CLAUDE.md 保存项目规则,/context、/compact 和 /clear 管理上下文,Skills 复用固定流程,Agents 隔离复杂子任务,插件则把成套能力打包进项目。
真正好用的 Claude Code 工作方式,是让它在清楚边界内持续推进任务,而不是把整个项目一次性交给它自由发挥。