“每天用 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/local，npm 全局 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_KEY="your-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：尝试停止整个任务 Shift+Tab：循环切换输入焦点，在对话输入框和权限确认按钮之间切换Ctrl+C：在权限提示时表示拒绝，在对话中表示中断- 上下箭头：切换历史输入
说实话，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 服务器管理的常用指令
MCP（Model 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 不在 PATH | npm config get prefix，把 bin 目录加进 PATH |
| 登录后依然提示未授权 | 环境变量残留旧 Key | echo $ANTHROPIC_API_KEY，确认并清理 |
| 版本升级后行为异常 | 旧会话配置不兼容 | 退出全部会话，执行claude upgrade后重开 |
| 权限确认按钮失灵 | 交互焦点没对 | 按Shift+Tab循环切换焦点 |
| 上下文过长，总忘约束 | 窗口跑满 | /compact或/clear，重新强调关键规则 |
| 一直拒绝执行命令 | allowedTools 限制过严 | 检查settings.json/启动参数，放宽工具白名单 |
| 界面卡住没反应 | 后台任务或日志堆积 | 按两次Esc，必要时重启会话，查看日志定位 |
| 生成代码风格不一致 | 没加载项目记忆 | 确认CLAUDE.md存在且被/init重新初始化 |
这里面我最想划重点的是“权限确认按钮失灵”。最开始用的时候，我以为是 bug，后来发现是焦点没切过去——终端里开了多个面板，输入焦点还停在代码编辑器上，快捷键自然没反应。Shift+Tab循环切焦点这个习惯，值得刻意练一下。
6.3 卸载与清理
卸载 Claude Code，最直接的方式是走 npm：
npm 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 cc="claude --continue" alias ccplan="claude --permission-mode plan" alias ccl="claude --resume"这样“继续上次任务”“先出方案再动手”都只需要很短的口令，手感和效率都会上一个台阶。
第二，复杂的自动化任务我习惯写成 Shell 脚本，然后用--print跑非交互模式。比如每天定时让 Claude 检查一次项目里的 TODO 清单，脚本里固定好--model sonnet --allowedTools "Read,Edit"，跑完把结果写到日志文件。这样不需要有人守在终端前面，整个流程自己就能闭环。
第三，关于成本控制，我给自己的硬规矩是：默认 Sonnet，只有涉及架构设计或大规模重构时才切 Opus；对话超过 40 轮就先/compact再继续，而不是无脑开新会话或硬撑到底。定期看/cost，你会发现模型选型对花费的影响比想象中更大。
Claude Code 这个工具，本质上不是在帮你写代码，是在帮你管理一个能写代码的工作流。100 条指令说到底也就是那么几类：怎么装、怎么问、怎么授权、怎么控成本。真正常用到的，可能永远只有那二三十条。但只要你把那二三十条用明白了，剩下的是水到渠成的事。
