1. 为什么“指令”才是 Claude Code 的真正生产力用 Claude Code 的人分两种一种把它当聊天窗口问一句答一句另一种把它当终端里的结对工程师用指令驱动它读文件、改代码、跑测试、提交变更。两种用法的效率差距不是百分之几十而是几倍到十几倍。差别就落在“指令”这两个字上。Claude Code 是 Anthropic 推出的命令行 AI 编程工具跑在终端里直接操作你当前的项目目录。它和网页版对话最大的不同在于它能读你的文件、写你的文件、执行 shell 命令、调用 git还能通过斜杠指令和自定义指令扩展行为。换句话说它不是一个“问答机器人”而是一个能动手的代理agent。你给它的每一条指令本质上是在给它下达一个可执行的任务。这篇文章要解决的核心问题很具体把每天高频使用的 Claude Code 指令系统性地梳理清楚让你从“知道有这个工具”变成“每天离不开这个工具”。我会把指令分成几大类——斜杠指令、CLI 启动参数、内置工具调用、自定义指令、配置相关指令每一类都讲清楚它解决什么问题、什么时候用、怎么用、有什么坑。适合刚装上 Claude Code 的新手也适合已经用了一阵但总觉得没榨干它价值的老用户。先给一个认知框架Claude Code 的指令大致分四层。第一层是斜杠指令在会话里以/开头控制会话本身清空上下文、压缩历史、查看用量等。第二层是CLI 参数在启动claude命令时传入决定这次会话怎么跑指定模型、权限模式、继续上次会话等。第三层是自然语言任务指令就是你直接打字让它干活这部分没有固定语法但有高效和低效的写法之分。第四层是自定义指令通过配置文件或 skills 机制把重复性的指令固化成可复用的模板。把这四层搞清楚你就能理解为什么有人用 Claude Code 像开了挂有人用起来磕磕绊绊。下面逐层拆。2. 斜杠指令会话内的控制中枢斜杠指令是 Claude Code 里最容易被低估的一类。很多人装了之后只会打字对话完全不知道斜杠指令能干什么。实际上斜杠指令管的是“会话状态”——上下文够不够、历史要不要清、花了多少钱、当前配置是什么。这些直接决定了 AI 回答的质量和你的钱包。2.1 上下文管理类指令/clear、/compact、/context这三个指令是日常使用频率最高的没有之一。/clear清空当前会话的全部上下文相当于开一个新对话。什么时候用当你切换任务的时候。比如你刚让 Claude 改完一个 Python 脚本现在要它去处理前端组件这时候必须/clear。原因很简单Claude Code 的上下文窗口是有限的旧任务的代码、报错、讨论会一直占着位置不仅浪费 token还会干扰它对当前任务的理解。我踩过的坑是不 clear 直接切任务结果 Claude 把上一个任务的变量名带到了新任务里改出来的代码驴唇不对马嘴。/compact是压缩上下文不是清空。它会把之前的对话历史总结成一段精简的摘要保留关键信息丢掉冗余细节。适合什么场景一个长任务做到一半上下文快满了但你不想丢掉前面的进展。比如你在重构一个模块已经改了五个文件还有三个没改这时候/compact一下Claude 还记得改了什么、接下来要改什么但占用空间小了很多。实测下来一个跑了很久的会话 compact 之后能再撑很长一段对话。/context查看当前上下文的使用情况。它会显示还剩多少空间、哪些内容占了最多。这个指令的价值在于“心里有数”。很多人遇到 Claude 回答变差第一反应是“模型不行了”其实往往是上下文塞太满它已经抓不住重点了。养成定期/context的习惯快满了就 compact 或 clear。提示/clear和/compact的区别要记牢——clear 是失忆compact 是记笔记。切任务用 clear长任务中途用 compact。2.2 状态查看类指令/cost、/status、/help/cost显示当前会话消耗的 token 和费用。Claude Code 按 token 计费长会话、大文件读取、频繁工具调用都会烧钱。/cost让你随时知道这次会话花了多少。我的习惯是每完成一个中等任务就/cost看一眼如果发现某次特别贵回头复盘是哪一步导致的——通常是让它读了一个巨大的文件或者陷入了反复试错的循环。/status查看当前会话的状态信息包括用的哪个模型、当前工作目录、权限模式等。排查问题时特别有用。比如你发现 Claude 突然不能写文件了/status一看权限模式变成了只读那就知道问题在哪了。/help列出所有可用的斜杠指令。新手期建议多按几次把指令列表过一遍你会发现很多之前不知道的功能。这个指令本身不消耗什么但能帮你发现工具的全貌。2.3 配置与扩展类指令/config、/model、/permissions/config打开配置界面可以调整主题、模型、权限等设置。Claude Code 的配置分全局和项目级/config主要管当前会话能改的部分。/model切换当前会话使用的模型。Claude Code 支持不同的模型档位贵的更聪明便宜的更快更省。日常改改小 bug 用快模型复杂架构设计用强模型这个切换很实用。我的经验是不要无脑用最强的很多简单任务用快模型效果一样好成本差好几倍。/permissions管理权限设置。Claude Code 默认在执行敏感操作写文件、跑命令前会问你这是安全设计。但如果你在做一个信任度高的任务反复确认很烦可以调整权限模式。这里要特别小心给完全访问权限意味着 Claude 可以不经确认直接改文件、执行命令方便但风险高。建议只在隔离的、有版本控制的项目里这么干而且确保 git 是干净的出问题能回滚。2.4 会话续接类指令/resume/resume恢复之前的会话。这个指令解决的是“昨天没做完今天接着做”的问题。Claude Code 会保存会话历史/resume能让你选一个历史会话继续。配合 CLI 的--continue参数用效果更好。我经常是早上打开终端claude --continue直接接上昨晚的进度不用重新解释背景。3. CLI 启动参数决定会话怎么跑斜杠指令管会话内CLI 参数管会话外——也就是你敲claude这个命令时传的东西。这部分很多人完全忽略直接用claude裸启动其实浪费了很多能力。3.1 基础启动与目录指定最基本的用法是在项目目录下直接敲claude它会把当前目录作为工作区。但更规范的做法是用参数明确指定claude --project /path/to/your/project或者先 cd 进去再启动。为什么要强调这个因为 Claude Code 的所有文件操作都相对于工作目录目录搞错了它读写的文件就全错了。我见过有人在家目录下启动结果 Claude 去读了一堆无关文件token 哗哗烧。3.2 权限模式参数--permission-mode这是最重要的启动参数之一。Claude Code 的权限模式决定了它执行操作前要不要问你。常见模式模式行为适用场景default敏感操作前询问日常使用安全第一acceptEdits自动接受文件编辑信任的批量改动plan只读只做规划不改文件探索代码、做方案bypassPermissions跳过所有确认隔离环境、自动化脚本plan模式特别值得说。当你刚接手一个陌生代码库想先让 Claude 摸清楚结构、给你一个改造方案但不想它乱改文件就用 plan 模式。它会读代码、分析、给建议但不动手。等方案确认了再切回 default 或 acceptEdits 执行。bypassPermissions要慎用。它让 Claude 完全自主适合在容器里、临时目录里跑自动化任务。在正经项目里裸奔这个模式等于把方向盘交给 AI 还不系安全带。3.3 会话管理参数--continue、--resumeclaude --continue # 继续最近一次会话 claude --resume # 从历史会话列表里选一个恢复--continue是最省事的直接接上上次。--resume给你选择权。这两个参数配合/resume斜杠指令构成了完整的会话续接体系。做长期项目时这个能力太重要了——你不需要每次重新解释项目背景、技术栈、当前进度。3.4 模型与输出参数claude --model claude-sonnet-4-5 # 指定模型 claude --output-format json # 输出格式--model在启动时就定好模型省得进去再切。--output-format在写脚本、做自动化时有用让输出结构化方便程序解析。如果你要把 Claude Code 集成到 CI/CD 流程里这个参数是关键。3.5 非交互模式-p / --printclaude -p 解释这个函数的作用-p或--print让 Claude Code 以非交互方式运行给它一个任务它执行完输出结果就退出不进入交互界面。这是把 Claude Code 当命令行工具用的核心方式。比如你想批量处理一堆文件可以写个循环每个文件调一次claude -p。做自动化脚本、批处理任务时这个模式是基础。4. 自然语言任务指令高效写法的门道这部分没有固定语法但写法好坏直接决定结果质量。同样是让 Claude 改代码有人一句话搞定有人来回十轮还不对。差别在于指令的“信息密度”和“约束清晰度”。4.1 任务指令的三要素目标、范围、约束一条高效的任务指令应该包含三样东西目标要达成什么。比如“把这个函数的 O(n²) 复杂度降到 O(n log n)”。范围动哪些文件、哪些部分。比如“只改 utils/sort.py不要动测试文件”。约束有什么限制。比如“保持函数签名不变不要引入新依赖”。对比一下低效写法“优化一下这个排序函数。”——Claude 不知道你要优化什么维度可能改复杂度可能改可读性可能加缓存方向完全随机。高效写法“utils/sort.py 里的 quick_sort 函数在处理大数组时很慢帮我把它从 O(n²) 优化到 O(n log n)保持函数签名和返回值不变不要引入第三方库改完跑一下现有的测试。”后者信息密度高Claude 一次就能做对。这不是玄学是因为你消除了歧义。4.2 让 Claude 先规划再执行复杂任务不要一上来就让它改代码。先让它读、分析、给方案“先读一下 src/ 目录下的所有文件理解这个项目的结构然后告诉我如果要加一个用户认证模块需要改哪些文件、按什么顺序改。先不要动手。”这一步的价值在于你能在它动手前发现理解偏差。如果它读错了文件、误解了架构你在规划阶段就能纠正而不是等它改了一堆代码再回滚。plan 模式配合这种指令是处理陌生代码库的标准姿势。4.3 分步执行不要一口吃成胖子Claude Code 能处理复杂任务但一次给太多它容易顾此失彼。我的经验是把大任务拆成小步每步验证先让它加一个空函数框架跑通测试。再让它填充核心逻辑跑测试。再让它处理边界情况跑测试。最后让它优化和清理。每步之间你可以 review、可以调整方向。这比一次性让它写完再调试要快得多因为问题定位在每一步都很清晰。4.4 善用“解释”和“为什么”不要只让 Claude 干活还要让它解释。比如“你刚才为什么选择用字典而不是列表来存这个映射解释一下你的考虑。”这有两个好处一是你能学到东西二是如果它的选择有问题你能及时发现。很多时候 Claude 的方案不是最优但它会给出理由你基于理由判断要不要调整。这种互动比单纯下命令质量高得多。5. 自定义指令与 Skills把重复劳动固化下来每天用 Claude Code 的人一定会遇到重复性的指令。比如每次提交前都要它检查代码风格、每次新建组件都要按固定模板、每次排查问题都要它先看日志。这些重复劳动可以用自定义指令和 skills 固化。5.1 CLAUDE.md项目级的常驻指令Claude Code 会在项目根目录找CLAUDE.md文件把它作为常驻上下文。你可以在里面写项目的技术栈、代码规范、常用命令、注意事项。每次启动会话Claude 都会读这个文件相当于自动带上了项目背景。一个典型的CLAUDE.md长这样# 项目说明 这是一个基于 FastAPI 的后端服务Python 3.11用 poetry 管理依赖。 # 代码规范 - 所有函数必须有类型注解 - 用 ruff 做 lint提交前必须通过 - 测试用 pytest覆盖率不低于 80% # 常用命令 - 启动开发服务器poetry run uvicorn app.main:app --reload - 跑测试poetry run pytest - 格式化poetry run ruff format . # 注意事项 - 不要直接改 migrations 目录下的文件 - 数据库操作必须用事务有了这个文件你就不用每次会话都解释一遍项目背景。Claude 一进来就知道规矩。这是提升日常效率最划算的投入写一次长期受益。5.2 Skills可复用的指令模板Skills 是 Claude Code 的扩展机制允许你把一套指令封装成可调用的技能。比如你可以定义一个“代码审查”skill里面写清楚审查的维度、输出格式、检查清单。需要时直接调用不用每次重新描述。Skills 的安装和配置通常在~/.claude/skills/或项目级目录下。每个 skill 是一个目录里面有描述文件和指令内容。具体格式随版本变化建议以官方文档为准。核心思路是把“你反复对 Claude 说的那套话”变成“一个名字”调用名字就行。5.3 自定义斜杠指令除了 skillsClaude Code 还支持自定义斜杠指令。你可以在配置目录下定义自己的/xxx指令绑定一段预设的 prompt。比如定义一个/review指令触发后自动让 Claude 按你的标准审查当前改动。这个机制的价值在于“降低调用成本”。一个复杂的审查流程如果每次都要打一大段字你慢慢就懒得用了。变成一个/review随手就能调使用频率会高很多。6. 内置工具调用Claude 动手能力的来源Claude Code 之所以能干活是因为它有一组内置工具。你不需要直接调用这些工具但理解它们能干什么有助于你写出更好的指令。6.1 文件操作类工具读文件、写文件、编辑文件、列目录、搜索文件内容——这些是 Claude Code 最基础的能力。当你说“看看 utils.py 里有什么”它调用读文件工具当你说“把第 42 行的 bug 修了”它调用编辑工具。理解这一点的意义在于你的指令要明确指向文件。说“改一下那个函数”Claude 得先猜是哪个文件、哪个函数容易出错。说“改 app/services/user.py 里的 get_user 函数”它直接定位准确率高得多。6.2 命令执行类工具Claude Code 能执行 shell 命令。跑测试、装依赖、启动服务、查 git 状态都可以让它做。这是它区别于纯对话工具的关键。但这里有个安全边界执行命令是有风险的。rm -rf之类的破坏性命令Claude 默认会问你。你可以通过权限设置调整但我的建议是保持询问尤其是涉及删除、覆盖、推送的操作。方便和安全的平衡点是让 Claude 执行只读命令ls、cat、git status、git diff时不用问写操作时问一下。6.3 Git 相关操作Claude Code 对 git 的支持很完整。它能看 diff、看 log、创建分支、提交、甚至帮你写 commit message。日常高频用法“看一下当前的 git diff总结我改了什么。”“帮我写一个 commit message描述这次改动。”“创建一个新分支 feature/user-auth然后切过去。”提交前让 Claude 看一眼 diff 并生成 commit message是我每天必用的流程。它写的 message 往往比我随手写的规范而且会覆盖到我忽略的改动。6.4 网络与搜索工具部分版本的 Claude Code 支持联网搜索和抓取网页。当你需要查最新文档、找解决方案时可以让它搜。但要注意联网能力受配置和版本影响不是所有环境都有。如果你的环境不支持它会明确告诉你。7. 常见问题与排查技巧实录用 Claude Code 的过程中问题基本集中在几类上下文相关、权限相关、配置相关、性能相关。下面按类整理。7.1 上下文相关问题的排查症状一Claude 回答越来越差开始胡言乱语。排查思路先/context看上下文占用。如果接近满就是上下文过载。解决/compact压缩或者/clear重开。如果 clear 后还是差可能是任务本身描述不清重新组织指令。症状二Claude 忘记了之前说过的要求。原因通常是上下文被压缩或清空了。/compact会丢细节/clear全丢。解决把关键要求写进CLAUDE.md这样即使 clear 了重启会话它还能读到。症状三切换任务后 Claude 把旧任务的东西带进来。这是没 clear 的典型症状。养成切任务必/clear的习惯。7.2 权限相关问题的排查症状Claude 说它不能写文件 / 不能执行命令。先/status看权限模式。如果是 plan 模式它只能读不能写切回 default 或 acceptEdits。如果是 default 模式它会在写之前问你你可能没注意到确认提示。检查终端有没有等待输入的提示。症状每次操作都要确认太烦。调整权限模式到 acceptEdits文件编辑自动接受。但命令执行建议保持询问或者只对特定命令放行。完全 bypass 要谨慎。7.3 配置相关问题的排查症状Claude 不认识项目结构老是读错文件。检查启动目录对不对。/status看工作目录。如果不对退出cd 到正确目录再启动。另外确认CLAUDE.md存在且内容准确。症状模型行为不符合预期。/model看当前模型。不同模型能力不同快模型在复杂任务上可能力不从心。切换模型试试。7.4 性能与成本问题的排查症状一次会话花了很多钱。/cost看消耗。常见原因读了超大文件、反复试错、上下文太长。解决指令更精确减少试错及时 compact 控制上下文避免让它读无关的大文件。症状响应很慢。可能是模型档位高、上下文长、或者网络问题。切快模型、compact 上下文试试。7.5 常见问题速查表问题可能原因解决回答质量下降上下文过载/compact 或 /clear忘记要求上下文被清写进 CLAUDE.md不能写文件plan 模式切 default/acceptEdits读错文件工作目录错检查启动目录花费过高上下文长/试错多精确指令 及时 compact响应慢模型重/上下文长切快模型 compact7.6 几条踩坑心得第一git 一定要干净。让 Claude 改代码前确保当前改动已提交或 stash。这样出问题能一键回滚。我吃过亏没提交就让 Claude 大改结果改乱了想回退发现之前的改动也混在一起了。第二大文件不要整个读。让 Claude 读一个几千行的文件token 消耗巨大而且它可能抓不住重点。更好的做法是告诉它看哪个函数、哪一段。用搜索工具定位而不是全文读取。第三指令要具体到文件和函数。“优化性能”不如“优化 app/services/order.py 里 calculate_total 函数的性能”。前者它要猜后者它直接干。第四善用 plan 模式做探索。接手新代码库先 plan 模式让它读和分析给方案。确认后再动手。这个流程能避免大量返工。第五定期更新 Claude Code。工具迭代快新版本往往有更好的指令、更优的性能、更多的功能。用旧版本可能错过很多提效点。8. 把指令用成肌肉记忆回到标题——每天用 Claude Code 的人常用指令都在这 100 条里。这 100 条不是让你背下来的清单而是让你形成肌肉记忆的工具箱。真正高频的核心指令其实就那么二三十条/clear、/compact、/context、/cost、/status、/model、/resume加上--continue、--model、-p这些启动参数再配合一套写任务指令的方法论和CLAUDE.md的常驻配置。我自己的日常流程大概是这样早上claude --continue接上昨天的进度先/context看状态然后开始干活。切任务时/clear长任务中途/compact每完成一块/cost看一眼。复杂改动先让它 plan确认后执行。提交前让它看 diff 写 commit message。项目背景全写在CLAUDE.md里新会话不用重复解释。这套流程跑顺之后Claude Code 就不再是一个“需要我伺候的 AI”而是一个“能帮我干活的搭档”。指令是你们之间的接口接口越清晰协作越顺畅。剩下的事就是在实际项目里反复用、反复调把这些指令变成你手指的本能反应。
