“每天用 Claude Code 的人常用指令都在这 100 条里”——这个标题听起来有点夸张但说真的我从第一次在终端里敲claude到现在已经把它当成了每天离不开的搭档。一开始我也只会上来就问“帮我写个函数”后来踩了不少坑才慢慢摸清楚哪些指令能让它更听话、更高效、更省钱哪些指令能在它胡说八道时及时把它拉回来。这篇博文不聊原理层面的大道理全是我实际敲过、验证过、每天都在用的指令。我按“安装登录、会话管理、提示词句式、权限执行、模型切换、IDE 集成、排查修复”这几个模块拆开大概凑了 100 条高频用法。不管你是第一次安装 Claude Code 的新手还是已经用了很久但觉得效率上不去的熟手这份清单都能让你少走弯路。照着敲就行不用背收藏起来随用随查。1. 准备工作安装、登录、升级一条龙1.1 安装与升级的常用指令Claude Code 本质上是一个 Node.js 的命令行工具所以最常规的安装方式就是走 npm。确保你已经装好了 Node.js 环境版本尽量在 18 以上然后直接执行npm install -g anthropic-ai/claude-code安装完先别急着用敲一下版本号确认安装成功claude --version如果是第一次装可能会有权限问题尤其是 macOS 或 Linux 下用系统 Node 的时候。报错内容里通常会出现EACCES这种情况我一般建议用 nvm 或者 fnm 管理 Node 版本不要在系统目录上硬改权限。硬改权限短期能跑后面升级 npm 全局包时还会反复踩坑。Claude Code 的更新频率不算低官方会持续修 bug、加模型、调权限系统。我常用的升级指令是claude upgrade这个指令会检查当前版本和最新版本自动完成升级。少数情况下升级会被当前正在运行的会话锁住我一般会先退出所有 Claude Code 进程再升级。也有不少人习惯直接用 npm 全局更新npm update -g anthropic-ai/claude-code两者效果差不多但claude upgrade更省心它会自己处理掉版本缓存和目录迁移问题。Linux 环境下比如 Ubuntu有些朋友会遇到 npm 安装后claude命令找不到的情况。这不是没装上而是 npm 全局 bin 目录没进PATH。用下面两条指令确认一下npm config get prefix echo $PATH如果安装路径确实不在PATH里就把npm prefix/bin加到 shell 配置文件里。我有一次帮朋友排查发现他把 Node 装在/usr/localnpm 全局 bin 在/usr/local/bin按理说应该在PATH里结果他开了 zsh没加载.bashrc折腾半天。还有一个容易被忽略的指令claude --help很多人从来不碰帮助文档觉得丢人。但在命令行工具这个领域--help是最快的宝典。Claude Code 的参数更新频繁我的习惯是每升级一个大版本先花两分钟过一遍claude --help的输出看看有没有新增的标志位尤其是权限相关的参数改一个就能节省大量手动确认时间。1.2 登录鉴权与首次启动安装完成后在项目目录里敲cd ~/projects/myapp claude首次启动会进入登录流程。有几种方式可以完成鉴权最简单的就是选“在浏览器里登录”。它会生成一个一次性验证码你去 Claude 账号页面完成授权终端会自动检测到登录状态。这个流程走一次就好登录凭证会存在本地配置里后续再启动不会重复要你登录。如果你习惯用 API Key也可以提前设置环境变量export ANTHROPIC_API_KEYyour-api-key设置了环境变量之后启动时就不会再走交互式登录页。这里要提醒一件事环境变量的优先级比本地登录态高如果你之前登录过别的账号又设置了新的 ANTHROPIC_API_KEY那 Claude Code 会优先用环境变量里的 Key。遇到“为什么我切了账号没反应”这类问题先检查环境变量有没有残留值echo $ANTHROPIC_API_KEY查看当前登录状态、退出登录、重新登录都有对应指令。进到交互界面后可以直接敲/login /logout/login在会话里也能触发一次重新授权。如果跑在自动化环境里想在非交互模式下完成登录可以先执行claude --login但我实测下来最稳的还是交互式浏览器授权尤其是有订阅账号的人别折腾 API Key 的方式。1.3 初始化项目CLAUDE.md 与项目记忆很多人用 Claude Code 觉得“它好像不太懂我的项目”问题往往出在没做项目初始化。刚进一个新项目第一件事应该敲/init这个指令会让 Claude 自动扫描项目结构、读 README、看依赖文件然后生成一份CLAUDE.md这里面会写清楚项目是什么、构建命令怎么跑、代码风格偏好、测试怎么执行等等。CLAUDE.md就是 Claude 的项目记忆之后每次对话它都会把这份文件作为默认上下文的一部分。项目级的CLAUDE.md一般放在项目根目录。如果你有跨项目通用的偏好比如“所有提交信息都用中文写”“不要改动测试快照”可以直接写到用户级别的全局记忆文件里mkdir -p ~/.claude nano ~/.claude/CLAUDE.md我发现一个比较实用的组织方式全局CLAUDE.md只放跨项目的硬性规则比如“禁止修改锁定文件”“危险命令必须经过确认”项目级CLAUDE.md放针对当前代码库的具体约定比如“前端组件使用 TypeScript”“服务入口在 cmd/server/main.go”。分得太细反而让 Claude 记不住重点保持精简才是王道。2. 会话与对话管理每天都在用的核心指令2.1 启动、继续上一次会话Claude Code 的会话是有粘性的。如果只是临时问个小问题每次都开新会话也行但如果是处理一个跨两天的重构任务我就强烈建议你用会话恢复功能。新开一个会话直接claude继续最近一次会话用claude --continue这个指令很好用它会自动加载上一次会话的上下文让你接着上次的思路继续聊。还有一个高频用法是claude -c-c是--continue的简写手快的人都是直接敲claude -c回车。如果是几天前的会话用--continue会连到最近的那个会话不一定是你想找的那一个。这时可以用claude --resume它会列出历史会话列表用上下箭头选择要恢复的会话。如果你已经知道会话 ID也可以直接指定claude --resume session-id会话 ID 怎么看在交互界面里敲/status它会显示当前会话 ID、当前模型、使用时长等基本信息。我也用这个指令来确认自己到底连到了哪个会话免得继续错了上下文。2.2 会话内的斜杠命令与快捷键进入 Claude Code 交互界面后最核心的斜杠命令我整理成了一张表。这些指令基本覆盖了我 90% 的日常操作指令作用使用频率/help列出所有可用斜杠命令偶尔/clear清空当前会话上下文高/compact压缩上下文保留关键信息高/model切换模型高/init初始化/重新生成 CLAUDE.md高/config打开配置文件中/cost查看当前会话的成本统计高/status查看会话与模型状态中/memory管理项目记忆低/permissions查看和修改工具权限低/login//logout登录 / 退出登录低/resume恢复历史会话低/doctor检查环境与安装问题低/clear和/compact是一对容易搞混的兄弟。/clear是把上下文完全抹掉相当于开一个全新会话/compact则是把长篇对话压缩成摘要保留核心结论和待办事项同时腾出上下文空间。我的经验是如果只是换个话题用/clear如果是在一个长任务中间代码已经写到一半还没做完只是上下文告警了用/compact。压缩之后 Claude 会丢掉一些细节必要时你得把关键文件路径和约束条件重新强调一遍别偷懒。快捷键方面日常使用率最高的几个Esc中断当前生成连续按两次Esc尝试停止整个任务ShiftTab循环切换输入焦点在对话输入框和权限确认按钮之间切换CtrlC在权限提示时表示拒绝在对话中表示中断上下箭头切换历史输入说实话Esc是我用得最狠的键。Claude Code 一旦开写代码会像流水一样往下涌如果发现方向不对我的习惯是立刻按Esc打断然后补充一句“先停一下告诉我你当前的理解和计划”。硬着头皮看它写完一段错方向的重构浪费的时间远比你想象的多。2.3 上下文清理避免对话跑偏Claude Code 的上下文窗口是有上限的日常对话、代码片段、日志输出都会占用空间。对话越长它越容易“忘掉”开头的关键约束或者突然在某个文件里自作主张改了一堆多余的东西。我应对上下文跑偏有三个常用手段第一聊偏了就/clear不要恋战。清掉重来比在一堆垃圾上下文里修补便宜得多模型使用的 token 也更少。第二在关键文件上多用“重新读取”的策略。当你觉得它可能忘掉某个文件内容时直接说请重新看一遍 src/auth/login.ts 的最新内容基于当前代码继续这比让它靠记忆推断要可靠得多。第三用/compact做阶段性摘要。适合那种已经推进了两个小时、上下文快爆掉的长任务。压缩完成后我记得先看一眼摘要是否覆盖了所有关键信息如果发现遗漏补一句“补充一个背景”再继续。3. 提示词指令的写法让 Claude Code 听懂你的项目3.1 面向代码的指令句式很多人对 Claude Code 的期待是“一个会写代码的聊天机器人”但它的真实定位更像“一个能实际动你代码库的结对程序员”。指令写得好不好直接决定你是在掌控它还是在被它带着跑。我对高频提示词做了个分类下面这些都是我实测过、反复在用的句式直接执行型适合明确的小任务把 src/utils/format.ts 里的函数都补上 JSDoc 注释先计划再动手型适合有一定复杂度的任务在动代码前先列出你要改的文件清单和改动点等我说“开始”再执行范围锁定型防止它越界只允许修改 tests/ 目录下的文件其他目录一律不要动分析解释型用来理解陌生代码解释一下 src/engine/scheduler.ts 的核心调度逻辑重点讲清楚优先级队列的实现测试生成型为 src/services/userService.ts 补单元测试覆盖成功和失败两条路径用 vitest重构提议型分析一下当前 auth 模块的重复代码给出重构方案并评估改动风险我每次写提示词都遵循一个原则背景、任务、约束、输出格式四个要素尽量说全。不要只丢一句“优化这段代码”缺背景它就只能猜猜就会跑偏。3.2 限定范围与输出格式Claude Code 最让人头疼的不是不会写而是写太多、改太宽。你想让它修一个 bug它顺手帮你把整个文件的格式都 “优化” 了diff 一拉出来几十个文件看得血压直接上来。解决办法是给“范围”和“输出”立规矩。我常用的输出约束型指令只输出最终代码不要解释过程把改动列成表格文件路径、改动内容、改动原因不要贴完整文件只输出 diff 片段还有一个很好用的说法是“最小化改动”用最小改动方式实现这个需求不要重构无关代码这几个指令用熟了你会明显感觉到 diff 干净了、审查成本低了。尤其是团队协作的场景Claude Code 生成的代码是要进 PR 的规范比速度重要得多。3.3 记忆与规则CLAUDE.md 里的指令沉淀如果你发现自己反复在提示词里强调同一件事比如“不要修改 lock 文件”“测试用 pnpm 跑”“不要格式化整个文件”那你就该把这些写进 CLAUDE.md 了。/init生成的 CLAUDE.md 只是起点后续你完全可以手动维护。我的建议是在里面开三个区块项目命令构建、测试、Lint 分别是哪条命令代码约定目录结构习惯、命名风格、禁止事项工作流偏好希望 Claude 先计划还是直接改、提交信息用什么格式示例## 构建与测试 - 安装依赖pnpm install - 启动开发pnpm dev - 运行测试pnpm test ## 代码约定 - 新代码用 TypeScript 编写 - 禁止修改 pnpm-lock.yaml - 组件命名采用 PascalCase ## 协作偏好 - 每次改动前先说明运行 plan等待确认 - commit message 用中文描述这些规则会在每次会话时被读取相当于把提示词提前“冻结”在项目里。遇到新的协作者加入项目这类文档同样有价值人也能看Claude 也能看。4. 权限、模型与执行策略配置4.1 权限模式与免确认执行Claude Code 会调用各种工具比如读写文件、执行 Shell 命令默认情况下它每执行一个操作都可能弹确认框。频繁确认很烦人但全部放行又危险。好在权限系统是可调的。我用得最多的几个模式默认模式每个关键操作都要确认--permission-mode acceptEdits自动接受文件编辑但 Bash 命令仍会确认--permission-mode plan只做规划不实际改代码适合分析问题--permission-mode bypassPermissions跳过所有权限确认全自动跑启动时指定claude --permission-mode plan日常小改动我倾向于acceptEdits让 Claude 直接改文件但涉及 Shell 命令时依然弹确认这能在效率和安注意“安全”之间拿到一个平衡点。更细粒度的控制可以用--allowedTools和--disallowedTools。比如只允许它执行 git 相关的命令claude --allowedTools Bash(git*),Read,Edit这个写法在自动化脚本里特别好用可以按需赋予最小权限。尤其适合 CI 流程或者定时任务规则定死就不会出现 Claude 自己执行一些危险命令的情况。在交互界面里/permissions可以查看和管理当前会话的权限配置。如果你写了个脚本要批量调用 Claude Code建议在脚本里显式指定 allowedTools宁可先紧后松。4.2 模型切换与适用场景Claude Code 支持在会话内切换模型常用指令是/model它会弹出模型选择列表我日常会在三个模型之间切来切去Opus处理高难度架构设计、长文档理解、复杂重构Sonnet日常编码、bug 修复、中规模改动平衡速度和成本Haiku简单问答、快速生成测试、解释小函数我个人的使用习惯是默认用 Sonnet遇到大需求临时切 Opus查个 API 用法这种小问题切 Haiku。这不仅是为了速度也是为了控制成本——Opus 的 token 费用明显更高不要让它在“给这个变量改名”这种小事上烧高价模型。启动时也可以直接指定模型claude --model sonnet自动化场景下我强烈建议显式指定模型因为默认模型可能随版本升级发生变化你脚本里以为在跑 Sonnet结果某天突然变成 Opus账单一出来直接傻眼。4.3 上下文窗口编排技巧模型再强也在上下文窗口里工作窗口满了就装不下新信息它会“遗忘”甚至开始胡编。我总结了一套窗口编排技巧第一长时间会话要主动分段。干一会、/compact一次、继续。不要真的让它从早上写到下午都不休息。第二多轮任务里把大目标拆成小模块。一次对话只做一件事比如“先完成数据模型定义”完成后再开新会话处理“实现 API 层”。这样做的好处是上下文干净每段上下文都聚焦在一个具体问题上。第三多利用“重读文件”指令。Claude Code 能自己读文件但它不会高频重读上下文一长它就开始依赖记忆。你可以在关键节点明确要求它重新读取某个文件这比手动贴一大段代码进去更省 token。在自动化模式里还可以用--print做无交互提问适合快速验证想法claude --print 用三句话解释什么是闭包-p也支持从标准输入读取内容适合管道组合cat main.py | claude --print 帮我 review 这段代码这些非交互用法非常轻量不需要进入完整会话成本也低。5. 配合 VSCode、Skills 与 MCP 的高频用法5.1 VSCode 集成配置很多朋友希望直接在 VSCode 里用 Claude Code并且做到项目目录、终端、文件编辑之间无缝衔接我在实操里梳理了两种主流路径。第一种是在 VSCode 的集成终端里直接启动claude。终端是 Claude Code 的原生运行环境能显示颜色、支持交互所有斜杠命令都可用。这种方式不需要装任何扩展只要确保 VSCode 集成的终端能识别claude命令。第二种是用 VSCode 扩展插件做图形化辅助。安装好插件后可以在侧边栏或命令面板里直接打开 Claude Code 面板。终端里的操作日志、会话历史、权限确认项都会以更直观的形式呈现适合不习惯命令行界面的人。配置方面有一个经常踩的坑VSCode 扩展可能用自己的 Node 环境如果全局 Node 版本和扩展检测到的版本不一致claude命令就找不到。遇到这种情况先确认 VSCode 的终端which claude node --version如果命令找不到但系统终端里能用多半是 VSCode 的环境变量没继承。重启 VSCode、或者手动在设置里配上 Node 路径就能解决。我在实际使用中的体验是终端模式依然是功能最全的。扩展插件更适合用来查看状态和快速跳转文件真正的大活我还是切回集成终端界面信息密度更高快捷键也更顺手。5.2 Skills 的安装与自定义Skills 是 Claude Code 的可扩展能力包相当于给它装“专用技能”。装了 Skill 之后Claude 在处理对应的任务类型时会自动调用不需要你每次重复描述工作流。Skills 的安装路径不复杂核心是把技能定义放到项目或用户级目录。常见的做法是在项目根目录建一个.claude/skills目录或者放到用户级~/.claude/skills每个技能一个子目录里面放SKILL.md之类的定义文件。如果你是从社区或同事那里拿到一个 Skill 包解压到对应目录后重启会话即可生效。自定义 Skill 是进阶玩法。比如你经常让 Claude 写数据库迁移脚本那你就可以写一个 Skill把迁移脚本的命名规范、目录位置、需要生成的模板都固化下来。之后只要说一句“写一个迁移脚本”它就会按 Skill 里的模板执行不用每次重新解释一遍规则。要确认 Skill 是否被加载可以在会话里问一句你都加载了哪些 Skill列出名字和用途也可以直接给它一个对应类型的任务看它的行为是否发生了变化。我试过几个排版类和代码规范类的 Skill加载后行为差异很明显确实省心。5.3 MCP 服务器管理的常用指令MCPModel Context Protocol是让 Claude Code 接入外部数据源和工具的协议。想让它操作数据库、查 Jira、读浏览器信息都可以通过配置 MCP 服务器来实现。管理 MCP 的指令都在斜杠命令里/mcp敲这个命令会列出所有已配置的 MCP 服务器包括名称、状态和关联工具。新增服务器一般用claude mcp add server-name -- start-command比如添加一个 Postgres 数据库连接claude mcp add my-db -- npx -y modelcontextprotocol/server-postgres --connection-string postgresql://...移除、查看某个服务器的具体工具也都有对应子命令claude mcp remove my-db claude mcp list claude mcp get my-dbMCP 是提高 Claude Code 生产力的利器它能让 Claude 直接查线上数据、读远端配置而不是只靠你手动贴日志。但要注意MCP 服务本质上给 Claude 开了新的能力边界敏感数据库和信息源不要轻易挂上去权限范围尽量收紧。6. 日常排查与故障修复拿来就用6.1 诊断命令用久了大家都会遇到一些奇奇怪怪的问题。我常用的第一招是/doctor/doctor会巡检环境包括 Node 版本、npm 全局包、登录状态、权限配置等发现问题会直接标红提示。升级后如果行为异常先跑这个。如果/doctor没发现问题但明显不对劲那就加启动参数排查claude --debug--debug模式会输出大量调试日志适合定位模型调用或工具执行层面的异常。日志文件是我排查问题的第二招。Claude Code 的日志一般写在用户目录下ls -la ~/.claude/logs找到最新日志用tail查看最后几十行tail -n 50 ~/.claude/logs/最新日志文件.txt如果是权限配置异常检查配置文件nano ~/.claude/settings.json这个文件里存了权限设置、allowedTools、模型偏好等配置改错了确实会导致各种奇怪问题。我一般只手动改能看懂的字段复杂的用/config打开图形界面改。改完配置记得重启会话否则不生效。6.2 常见问题速查表下面这张表是我自己遇到的、以及帮别人排查时高频出现的几类问题处理方式都是验证过的问题现象可能原因处理指令claude命令找不到Node 全局 bin 不在 PATHnpm config get prefix把 bin 目录加进 PATH登录后依然提示未授权环境变量残留旧 Keyecho $ANTHROPIC_API_KEY确认并清理版本升级后行为异常旧会话配置不兼容退出全部会话执行claude upgrade后重开权限确认按钮失灵交互焦点没对按ShiftTab循环切换焦点上下文过长总忘约束窗口跑满/compact或/clear重新强调关键规则一直拒绝执行命令allowedTools 限制过严检查settings.json/启动参数放宽工具白名单界面卡住没反应后台任务或日志堆积按两次Esc必要时重启会话查看日志定位生成代码风格不一致没加载项目记忆确认CLAUDE.md存在且被/init重新初始化这里面我最想划重点的是“权限确认按钮失灵”。最开始用的时候我以为是 bug后来发现是焦点没切过去——终端里开了多个面板输入焦点还停在代码编辑器上快捷键自然没反应。ShiftTab循环切焦点这个习惯值得刻意练一下。6.3 卸载与清理卸载 Claude Code最直接的方式是走 npmnpm uninstall -g anthropic-ai/claude-code如果你用的是官方独立安装脚本那卸载也得用配套方式具体可以翻一下安装时生成的文档。卸载完建议顺手清理配置和日志目录免得残留文件影响下次安装rm -rf ~/.claude rm -f ~/.claude.json这里有个提醒~/.claude里可能存着你积累的登录态、历史会话和全局配置。如果你只是临时想重装建议先把整个目录备份一份用不删的方式重装等确认新版没问题再删备份。mv ~/.claude ~/.claude_backup npm install -g anthropic-ai/claude-code用这种方式重装不会丢历史会话妥妥的防手滑操作。7. 我的几个实操配置经验指令清单列了一堆最后我还是想聊几个不写在官方文档里的实操习惯。第一我会给 Claude Code 配几个自己写的 alias减少重复输入。比如在 shell 配置文件里加上alias ccclaude --continue alias ccplanclaude --permission-mode plan alias cclclaude --resume这样“继续上次任务”“先出方案再动手”都只需要很短的口令手感和效率都会上一个台阶。第二复杂的自动化任务我习惯写成 Shell 脚本然后用--print跑非交互模式。比如每天定时让 Claude 检查一次项目里的 TODO 清单脚本里固定好--model sonnet --allowedTools Read,Edit跑完把结果写到日志文件。这样不需要有人守在终端前面整个流程自己就能闭环。第三关于成本控制我给自己的硬规矩是默认 Sonnet只有涉及架构设计或大规模重构时才切 Opus对话超过 40 轮就先/compact再继续而不是无脑开新会话或硬撑到底。定期看/cost你会发现模型选型对花费的影响比想象中更大。Claude Code 这个工具本质上不是在帮你写代码是在帮你管理一个能写代码的工作流。100 条指令说到底也就是那么几类怎么装、怎么问、怎么授权、怎么控成本。真正常用到的可能永远只有那二三十条。但只要你把那二三十条用明白了剩下的是水到渠成的事。