这是我学习 Claude Code 时整理的一份笔记。目标不是背命令而是理解 Claude Code 的基本工作流初始化项目 → 建立记忆 → 规划任务 → 执行修改 → 检查结果 → 管理上下文。1. 为什么要学 Claude Code 的斜杠命令刚开始接触 Claude Code 时我以为它只是一个能在终端里写代码的 AI 工具。但看完官方文档和一些社区文章后我发现它更像是一个可以参与项目开发流程的 AI 编程助手。它可以读取项目文件、理解代码结构、修改代码甚至运行命令。也正因为它能直接操作项目所以不能只靠一句“帮我改一下”。如果没有规则、计划和检查AI 可能会误改文件或者改完之后我自己也看不懂。所以我觉得 Claude Code 的斜杠命令可以理解为控制 Claude Code 工作方式的一组入口而不是简单快捷键。2. 命令总览阶段命令我的理解项目初始化/init让 Claude Code 先了解项目项目记忆/memory管理长期项目规则任务规划/plan复杂任务前先规划模型与推理/model、/effort调整模型和推理强度上下文管理/context、/compact、/clear避免对话过长、上下文混乱修改检查/diff、/code-review、/verify查看改动、审查代码、验证运行问题排查/doctor、/debug检查环境、配置或当前会话问题我目前的学习顺序是/init → /memory → /plan → /effort → /diff → /code-review → /verify → /compact这个顺序比较适合新手因为它不是直接让 AI 修改代码而是先理解项目再规划任务最后检查结果。3./init第一次进入项目时先初始化/init是我认为最适合新手先学习的命令。它的作用是让 Claude Code 分析当前项目并生成或更新CLAUDE.md。我把CLAUDE.md理解成给 Claude Code 看的项目说明书。它通常会记录项目结构、运行命令、测试方式、代码规范和注意事项。项目内容命令/init作用初始化当前项目说明产物CLAUDE.md适合场景第一次进入项目、接手陌生项目、准备长期使用 Claude Code注意自动生成内容需要人工检查/init后我会检查什么检查项问题项目结构是否正确识别主要目录技术栈是否识别 Python、JS 或其他框架运行命令是否写清楚怎么运行测试命令是否写清楚怎么测试隐私风险是否写入私人路径、Token、API Key/init不是结束而是开始。生成的CLAUDE.md需要自己再读一遍。4.CLAUDE.md项目记忆文件CLAUDE.md可以理解为 Claude Code 的项目记忆文件。它不只是给人看的 README也是在告诉 Claude Code这个项目应该怎么运行修改时需要遵守什么规则。一个简单模板可以这样写# Project Notes ## Project Overview 这是一个用于学习和实验的 Python 项目。 ## Common Commands - 安装依赖pip install -r requirements.txt - 运行程序python main.py - 运行测试pytest ## Coding Rules - 不要直接修改 raw data 文件。 - 生成图片保存到 figures/ 文件夹。 - 实验结果保存到 outputs/ 文件夹。 - 修改多个文件前先说明计划。 - 不要随便新增依赖。哪些内容适合写进CLAUDE.md适合写入不适合写入项目结构API Key运行命令Token测试命令账号密码输出路径规范私人电脑路径代码风格要求未公开数据地址哪些文件不要修改内部资料或敏感信息我的理解是CLAUDE.md不是越长越好而是越清楚越好。稳定、长期有效的规则适合写进去临时任务不一定要写进去。5./memory管理长期规则/memory用来查看和编辑 Claude Code 当前加载的 memory。它适合保存长期有效的项目规则而不是用来堆所有信息。规则类型是否适合放进 memory例子项目运行方式适合使用python main.py运行输出路径适合图片保存到figures/代码风格适合函数命名要清楚数据保护适合不要修改原始数据临时任务不适合今天只改一个函数隐私信息不适合密码、Token、私人路径我的原则是只有下次还会用到的规则才值得写进 memory。6./plan复杂任务前先规划我以前用 AI 工具时经常会直接说帮我重构一下这个项目。现在想想这样其实不太安全。因为“重构”可能涉及多个文件、多个函数和多个依赖。如果 Claude Code 直接开始改我可能不知道它为什么这么改也不知道有没有破坏原来的逻辑。所以复杂任务前可以先用/plan。任务是否建议先/plan原因修改一个 typo不一定改动很小修复简单报错视情况可能只涉及一个文件重构多个文件建议影响范围大添加新功能建议需要先确认设计修改数据处理流程建议可能影响结果复现调整项目结构强烈建议容易破坏路径和依赖示例/plan 我想整理这个 Python 项目的结构请先分析当前目录和文件说明你准备修改哪些地方暂时不要直接改代码。对我来说/plan的意义不只是防止乱改也能帮助我学习任务拆解。7./model和/effort调整模型与推理强度/model用来切换模型这部分我目前还没有深入实践。我更想先记录的是/effort。这里容易写错不是/effect而是/effort它表示 reasoning effort也就是推理强度。effort 等级我的理解适合任务low较低推理强度简单解释、轻量修改medium中等推理强度普通代码修改、一般 debughigh较高推理强度跨文件分析、复杂 bugxhigh / max更高推理强度大型重构、关键代码审查我目前的想法是平时不用一直开最高 effort。简单任务用 medium 就够了复杂任务再提高。8./context、/compact、/clear管理上下文AI 工具用久了经常会出现一个问题前面聊得很清楚后面越聊越乱。原因之一就是上下文太长。Claude Code 也需要管理上下文。命令我的理解适合场景/context查看上下文占用对话已经很长想知道是否快满/compact压缩上下文当前任务还没结束但上下文太长/clear清空当前上下文当前任务结束准备新任务我自己的理解命令比喻/context看桌面有多乱/compact整理桌面保留重要东西/clear换一张新桌子如果任务还没做完用/compact如果已经准备换任务用/clear。9./diff、/code-review、/verify改完之后必须检查Claude Code 可以改代码但它改完不代表一定正确。尤其是新手如果 AI 改了很多文件而自己没有看懂就很容易出问题。所以我准备把下面三个命令作为固定检查流程/diff /code-review /verify命令作用我需要看什么/diff查看具体改动改了哪些文件有没有误删/code-review审查当前改动有没有逻辑问题、边界问题/verify验证代码是否可运行测试是否通过程序是否能跑我的检查清单检查项问题文件范围是否只改了应该改的文件逻辑正确是否符合原本目标数据安全是否修改了原始数据依赖变化是否新增了不必要依赖测试运行是否通过测试或正常运行自己理解我是否看懂了主要改动我的原则是AI 可以帮我写代码但我不能把验收责任完全交给 AI。10./doctor和/debug出问题时排查Claude Code 出问题不一定是代码问题也可能是安装、权限、配置或当前 session 的问题。命令更像检查什么适合场景/doctor安装、配置、权限、环境启动异常、命令运行不了/debug当前会话或工具调用某个命令不生效、输出异常这两个命令我目前还没有深入实践后面遇到具体报错时再补充案例。现阶段最重要的是先养成几个习惯习惯对应命令进入项目先理解结构/init长期规则写清楚/memory复杂任务先规划/plan根据任务难度调整推理强度/effort改完代码先看差异/diff重要修改要审查/code-review最后验证能不能运行/verify对话太长要整理/context、/compact
