用 Claude Code 干活，最怕的不是模型不够聪明，而是你根本不知道怎么指挥它。我用了大半年，从最开始只会敲claude三个字进交互模式，到现在能熟练管理会话、切换模型、配好权限、甚至用非交互模式跑自动化脚本，中间踩了不少坑。这篇就把我日常最常用的指令整理出来，按场景分类，基本覆盖了日常开发和运维的所有高频操作。
先说清楚：这不是官方文档的翻译，是我自己实际每天都在用的指令集合。每条指令我都会说清楚它解决什么问题、在什么场景下用、有什么坑要注意。如果你是刚接触 Claude Code 的新手，建议从前三章看起；如果你已经用了一段时间，直接跳到第 5 章以后的速查表部分。
1. 为什么你需要一份 Claude Code 指令清单
1.1 从"会对话"到"会指挥"的差距
很多人用 Claude Code 的方式，就是打开终端输入claude，然后像聊天一样把需求扔给它。这种方式不是不行，但效率很低。原因是 Claude Code 本质上是一个 agentic 编程工具，它不只是理解你说了什么，还会去读文件、改代码、跑命令、调用工具。如果你不知道怎么控制它的行为边界、怎么切换上下文、怎么恢复历史会话、怎么批处理任务，那它就成了一个昂贵的聊天机器人。
我刚开始用的时候，经常遇到这种情况：让 Claude 改一个文件，它改了，但把另一个文件也顺手动了；让它跑测试，它先装了一堆依赖。后来我学到一个核心思路：你的指令越明确，它的行为越可控。而明确指令的前提，是你知道工具提供了哪些指令可用。
1.2 这份清单适合谁来用
这份清单适合以下三类人：
- 刚装好 Claude Code，还不知道除了聊天还能干什么的新用户；
- 已经用了一段时间，但一直停留在"对话式编程"阶段，想提升效率的中级用户；
- 想把 Claude Code 接入自动化流程、批量处理任务的高级用户。
我会尽量避免堆砌没用的参数说明，每一条都给出实际的使用语境和我的使用心得。
2. Claude Code 的安装、升级与卸载，别在这些基础操作上浪费时间
2.1 安装：一条命令搞定，但要先确认环境
Claude Code 官方推荐的安装方式是使用 npm 全局安装。你需要的环境是 Node.js 18+ 和 npm。安装命令很简单：
npm install -g @anthropic-ai/claude-code装完之后，输入claude --version检查是否安装成功。如果你看到版本号，说明安装没问题。这时候在任意终端目录输入claude，就会进入交互式界面。
补充一点：如果你用的不是 npm 而是其他包管理器，比如 Homebrew 或 pnpm，也可以安装，但我个人建议用 npm 保持最稳定的兼容性。Windows 用户需要注意，Claude Code 在 Windows 上的终端适配偶尔会有小问题，最好用 Windows Terminal 而不是老旧的 cmd 窗口。
2.2 升级：别等出问题才想起来
Claude Code 的迭代速度很快，新功能几乎每周都在加。升级命令和安装一样，用 npm 重新装最新版即可：
npm install -g @anthropic-ai/claude-code@latest升级后最好执行claude --version确认新版本生效。如果遇到某些斜杠命令找不到，很可能是因为版本太旧，先升级再排查。
2.3 卸载：干净卸载的完整步骤
卸载也不难，用 npm 的 uninstall 命令：
npm uninstall -g @anthropic-ai/claude-code但这只是卸载了主程序，用户配置和缓存通常还留在系统里。想要彻底干净，还需要清理用户目录下的.claude文件夹。macOS/Linux 下是：
rm -rf ~/.claudeWindows 下则是删掉用户目录里的.claude文件夹。清理完再安装就会回到全新状态，适合折腾坏配置想重置的场景。
3. 启动与对话管理：每天打开终端第一件事就是这些指令
3.1 启动方式：不止一种，按需选用
最基本的启动方式，直接进交互式对话框：
claude这个方式适合日常开发，你和 Claude Code 在一个会话里来回交流。不过我马上要说一个进阶用法，就是启动时自动恢复上次会话：
claude --continue这个指令会直接接着你最近一次会话的上下文往下聊。我实测下来，这个指令非常省事——比如昨天改到一半的功能，今天想继续，就不用重新描述上下文了，直接继承所有历史内容。
还有一种情况是你同时维护多个项目，每个项目可能有独立的会话。你可以先用claude --resume查看历史会话列表，选择要恢复哪个：
claude --resume运行后会列出最近的会话记录，有会话 ID、项目目录、时间等信息，选中即可恢复。这个命令对多项目切换特别有用。
3.2 对话中的核心管理指令
进入交互模式后，有几个高频斜杠命令必须记住：
/help：查看所有可用命令的帮助文档。新用户遇到不懂的指令先敲这个。/clear：清空当前会话的上下文。当聊天变得杂乱、上下文窗口快满的时候，用这个重置。/compact：压缩会话上下文。它会把之前的对话内容总结成摘要，保留关键信息但减少 token 占用。当对话很长但还不想完全清空时，用这个。/model：切换当前使用的 Claude 模型。默认可能是 opus 或 sonnet，你可以在对话中途切换，比如从 sonnet 切到 opus 获得更强能力。
我个人的习惯是：每完成一个阶段性任务就会执行一次/compact，避免上下文越长理解越偏。
3.3 退出与中断
交互模式中按Ctrl+C两次可以退出，或者输入exit/quit也可退出。中断 Claude Code 正在执行的代码或命令，按Esc或者Ctrl+C即可。
这里有个容易困惑的点：Ctrl+C在终端里既是中断也是取消，具体效果取决于当前状态。如果正在生成代码，按Esc中断更精准；如果只是想要退出整个程序，直接输exit最保险。
4. 每日高频斜杠命令：这 20 多个命令是我每天都在用的
4.1 项目操作类命令
Claude Code 不是一个单纯的聊天界面，它能直接操作你的项目文件。这类命令是它的核心价值所在。
/init：初始化项目配置。在一个新项目里首次使用 Claude Code 时执行，会扫描项目结构生成项目级配置文件。/add-dir：手动添加一个目录到当前会话的工作上下文中。有时候 Claude 没有自动探测到某个目录，你需要手动告诉它。/context：查看当前会话已经加载了哪些文件和上下文。我经常用它来确认 Claude 是否理解了我的项目结构。/status：查看当前任务状态和文件改动情况。
4.2 代码辅助类命令
/review：让 Claude Code 审查最近的代码改动。我会在写完一个功能后执行一次，让它帮我找潜在 bug。/commit：自动生成 git commit message 并提交代码。这个命令会调用 git diff，AI 分析改动后生成规范的提交信息。/pr-comments：拉取 PR 评论让 Claude 处理。/fix：让 Claude 修复测试失败或代码中明显的问题。
4.3 记忆与上下文管理类命令
前面提到的/compact是压缩上下文，和它成对的是：
/memory：管理 Claude Code 的长期记忆。它会读取项目级CLAUDE.md和用户级记忆文件，你可以通过这个命令查看或编辑记忆内容。/forget：忘记某部分上下文，从当前会话中移除指定的文件或信息。
记忆管理这个功能我强烈建议坚持用。每次项目里有重要的架构决策、约定规范，我都会通过自定义指令或 CLAUDE.md 写进去，以后每次启动 Claude Code，它都会自动记住这些约束。
5. CLAUDE.md 与配置文件：用一次配置换一整年的效率
5.1 项目级 CLAUDE.md 的真实用法
CLAUDE.md是 Claude Code 的灵魂配置。放在项目根目录下，启动时会自动读取。它告诉 Claude：这个项目是什么、代码规范是什么、有哪些关键路径、禁止做什么。
我举个最简单的例子，我维护一个 Python 后端项目，CLAUDE.md里写了"所有数据库迁移文件必须放在 migrations 目录，命名格式为 YYYYMMDD_描述"，之后我让 Claude 做迁移相关的修改，它就会自觉地遵循这个格式。
创建它也很简单，执行/init或者在项目根目录手动建一个CLAUDE.md文件即可。
用户级配置文件在~/.claude/CLAUDE.md，写的是跨项目的通用偏好，比如"回答技术问题时默认给出可运行的代码示例"。如果项目级和用户级配置有冲突，项目级优先。
5.2 自定义斜杠命令：把重复劳动变成一条命令
Claude Code 支持自定义斜杠命令，这是被很多人忽略但价值极高的功能。自定义命令放在项目级的.claude/commands/目录下，每个命令对应一个 Markdown 文件，文件内容就是告诉 Claude 要怎么做的一段指令。
比如我创建了一个review-changes命令，在.claude/commands/review-changes.md里写了一句话"请审查当前分支相对 main 分支的所有改动，重点关注潜在 bug 和性能问题，并给出修改建议。"之后我在任何会话里输入：
/review-changes它就会执行这个任务。类似的，我还有一个deploy-check命令，内容是"检查当前代码是否符合生产部署要求，包括配置、依赖、测试等维度"。这类自定义命令非常适合重复性任务，一劳永逸。
5.3 settings.json 与模型偏好配置
Claude Code 的配置文件在~/.claude/settings.json。这里可以设置默认模型、权限策略等。我自己会设置：
{ "model": { "default": "sonnet" }, "permissions": { "allow": ["Bash", "Read", "Edit"] } }模型选sonnet是因为它在速度和质量的平衡上最适合日常开发。如果遇到复杂任务，再通过/model临时切到opus。
6. 权限管理与非交互模式：让 Claude Code 既能干活又守规矩
6.1 权限模式的几种选择
Claude Code 执行代码、修改文件都是需要权限的。默认是逐步询问你，每条工具调用都会弹确认。这种方式安全但麻烦。
- 默认模式：每条操作都询问，适合第一次使用还不熟悉工具行为的阶段。
- 白名单模式：通过
/permissions或配置文件设置允许列表，比如允许Read和Edit，但Bash需要询问。我日常用这个模式。 - 跳过权限模式：启动时加
--dangerously-skip-permissions，不做任何权限询问，全权交给 Claude。这个模式只建议在完全可信的隔离环境里用，比如 Docker 容器内。我在本地从不这么干，风险太高。
6.2 非交互模式：把 Claude Code 接入自动化脚本
Claude Code 最被低估的能力是支持非交互式执行，也就是通过命令行直接传一个提示词，它会执行完输出结果后退出，适合批量任务和脚本集成。
claude -p "请分析当前目录下所有 Python 文件并列出潜在的 bug"还可以指定模型和输出格式：
claude -p "修复 src/main.py 里的语法错误" --model sonnet --output-format json这个能力我用来写自动化代码审查、批量重构工具、生成文档等。用一个 shell 脚本循环处理多个文件，效率非常高。要注意的是，非交互模式下如果遇到权限请求会出错，建议配合权限配置或--dangerously-skip-permissions使用，但后者必须在安全环境里。
6.3 环境变量与 HTTP 代理配置
Claude Code 支持通过环境变量调整行为。比如设置输出主题、调整日志级别等。如果你在严格管控的网络环境下使用，可以通过环境变量指定代理地址，但这里我不展开细说，正常网络环境基本用不上。
7. 100 条常用指令速查总表
下面这份速查表是我按照真实使用频率整理的，不是网上抄来的。每个分类按使用频率从高到低排列，方便你当作桌面备忘录。
7.1 启动与会话指令
| 指令 | 功能 | 使用频率 |
|---|---|---|
claude | 启动交互界面 | 极高 |
claude --continue | 恢复上次会话 | 高 |
claude --resume | 选择历史会话恢复 | 高 |
claude --version | 查看版本 | 中 |
claude --help | 查看命令行帮助 | 中 |
/clear | 清空当前会话 | 高 |
/compact | 压缩上下文 | 高 |
/model | 切换模型 | 中 |
exit/quit | 退出交互模式 | 极高 |
Ctrl+C两次 | 强制退出 | 高 |
Esc | 中断当前生成 | 高 |
/status | 查看状态 | 中 |
/context | 查看上下文 | 中 |
7.2 项目与文件操作指令
| 指令 | 功能 | 使用频率 |
|---|---|---|
/init | 初始化项目配置 | 中 |
/add-dir | 添加目录到上下文 | 中 |
/review | 审查代码改动 | 高 |
/commit | 生成提交并提交 | 高 |
/fix | 修复问题 | 中 |
/pr-comments | 处理 PR 评论 | 低 |
| 自然语言 "读取 src/main.py" | 让 Claude 读取文件 | 极高 |
| 自然语言 "编辑 xxx 文件，将 A 改为 B" | 修改文件 | 极高 |
| 自然语言 "创建新文件 xxx" | 新建文件 | 高 |
7.3 记忆与配置指令
| 指令 | 功能 | 使用频率 |
|---|---|---|
/memory | 管理长期记忆 | 中 |
/forget | 移除指定上下文 | 低 |
/permissions | 查看/修改权限 | 中 |
/config | 查看当前配置 | 中 |
自定义命令 | 执行自定义任务 | 按个人习惯 |
7.4 代码与终端辅助指令
| 指令 | 功能 | 使用频率 |
|---|---|---|
| 自然语言 "解释这段代码" | 代码解释 | 高 |
| 自然语言 "给这段代码写测试" | 测试生成 | 高 |
| 自然语言 "重构这个函数" | 代码重构 | 高 |
| 自然语言 "这个报错是什么意思" | 错误解释 | 极高 |
| 自然语言 "优化这段 SQL" | SQL 优化 | 中 |
| 自然语言 "写一个正则表达式" | 正则生成 | 中 |
| 自然语言 "生成 API 文档" | 文档生成 | 中 |
| 自然语言 "列出当前目录所有文件" | 文件列表 | 高 |
7.5 模型与环境管理指令
| 指令 | 功能 | 使用频率 |
|---|---|---|
--model sonnet | 指定模型启动 | 中 |
--model opus | 使用最强模型 | 中 |
--output-format json | 输出 JSON 格式 | 中 |
-p "提示词" | 非交互模式执行 | 高 |
--dangerously-skip-permissions | 跳过权限检查 | 低（慎用） |
--debug | 开启调试模式 | 低 |
7.6 网络与资源获取指令
| 指令 | 功能 | 使用频率 |
|---|---|---|
| 自然语言 "搜索 xxx 的 API 用法" | 联网查询 | 高 |
| 自然语言 "下载这个文件" | 下载文件 | 中 |
| 自然语言 "查看 xxx 的文档" | 文档查阅 | 中 |
| 自然语言 "这个网站的内容是什么" | 网页读取 | 中 |
7.7 日常开发场景指令
| 指令 | 功能 | 使用频率 |
|---|---|---|
| 自然语言 "这个 bug 怎么排查" | 调试辅助 | 极高 |
| 自然语言 "帮我把 git 的 commit 信息整理一下" | Git 辅助 | 高 |
| 自然语言 "写一个 Dockerfile" | Docker 配置 | 中 |
| 自然语言 "这个依赖怎么安装" | 依赖安装 | 高 |
| 自然语言 "数据库查询很慢怎么优化" | 性能优化 | 中 |
| 自然语言 "这段代码有安全漏洞吗" | 安全审计 | 中 |
| 自然语言 "帮我重构整个模块" | 模块重构 | 中 |
| 自然语言 "生成单元测试" | 测试生成 | 高 |
| 自然语言 "解释这个设计模式" | 概念解释 | 中 |
| 自然语言 "这个需求怎么拆解" | 需求分析 | 中 |
7.8 高级技巧类指令
| 指令 | 功能 | 使用频率 |
|---|---|---|
claude -p "..." --resume 会话ID | 在指定会话中非交互执行 | 低 |
claude -p "..." --continue | 在最近会话中非交互执行 | 中 |
/compact后继续 | 超长会话续聊 | 高 |
| 自定义命令组合 | 多步骤任务一键执行 | 中 |
| CLAUDE.md 写入规则 | 让 Claude 长期遵守规范 | 高 |
settings.json配置默认模型 | 统一模型策略 | 中 |
| 结合 git hooks | 提交前自动审查 | 低 |
8. 高频问题与排查技巧实录
8.1 安装启动类问题
问：claude命令提示找不到？ 答：大概率是 npm 全局路径没有加入到系统的 PATH 环境变量。运行npm config get prefix查看全局安装路径，然后把这个路径配置到 PATH 里。
问：启动后提示登录失败或需要认证？ 答：Claude Code 需要登录 Anthropic 账号。执行claude后按提示打开浏览器授权即可。如果已经登录过但提示失效，需要重新认证。
问：升级后某些命令不见了？ 答：检查版本更新日志，有些命令在新版本中改名了，或者需要重新安装扩展。用claude --version确认版本后查阅对应文档。
8.2 使用体验类问题
问：对话太长后 Claude 会变得不听话，给的建议也开始跑偏？ 答：这是上下文溢出的典型特征。这时候执行/compact压缩上下文，或者/clear清空后重新开始新会话。我自己有一个经验：每完成一个独立功能点就/compact一次，比一次聊到底要稳定得多。
问：Claude Code 修改文件后没有按照项目规范？ 答：把规范写进项目根目录的CLAUDE.md。例如在文件里说明"代码缩进使用 4 空格，不使用 Tab"，之后 Claude 就会自动遵守。临时紧急纠正，你可以直接在对话中强调这个要求。
问：权限弹窗太多，很烦躁？ 答：用/permissions把高频操作加入白名单，比如读取文件和编辑文件。但是注意，危险操作如删除目录、执行任意命令，我建议保持每次询问的状态。
问：非交互模式下执行失败或有奇怪的报错？ 答：先确认当前目录是否是有效项目目录，且没有权限请求冲突。非交互模式下如果遇到需要确认的操作，默认会失败。在安全环境中可以加--dangerously-skip-permissions，或者在配置中提前放行。
8.3 项目协作类问题
问：多个项目共用一套配置，互相干扰怎么办？ 答：项目级配置和用户级配置是分离的。项目相关的规则放根目录CLAUDE.md，个人偏好放~/.claude/CLAUDE.md。这样切换到不同项目时，Claude 会自动读取对应目录的配置，互不干扰。
问：让 Claude 看了大量文件后速度变慢，怎么办？ 答：文件太多会导致上下文占用量暴涨。用/add-dir精准添加目录而不是一股脑让 Claude 扫描整个仓库，同时多使用/compact压缩无效上下文。
问：如何在不进入交互模式的情况下快速让 Claude 干活？ 答：用claude -p "把你的需求写在这里"。这是我最常用的非交互启动方式。批量场景还可以配合 shell 脚本循环调用，比如遍历每个子项目做检查，相当顺手。
9. 关于 Claude Code 使用的几个建议
这篇文章写了这么多，核心是想告诉你：Claude Code 的能力上限不在于模型本身，而在于你会不会指挥它。它能读取文件、修改代码、执行命令、记忆规范，但这些能力都需要你主动控制。
根据我的个人经验，有几个使用习惯是最值得坚持的：
- 每完成一个任务就
/compact一次，避免上下文积累导致理解偏移； - 项目规范一定要固化到
CLAUDE.md里，这样每次启动它都会自动遵守； - 高频重复的操作优先做成自定义斜杠命令；
- 批量任务、CI/CD 集成优先用
-p非交互模式； - 权限白名单谨慎设置，宁可多确认一次也不要让 Claude 擅自执行危险操作。
另外，Claude Code 本身迭代很快，每个新版本都可能增加新的指令和功能。隔一段时间执行一次claude --help和/help，你会发现很多以前没用过的命令已经默默出现了。我自己就是通过这个习惯，发现了不少原本不知道的效率功能。
希望这份指令清单能让你少踩一些我踩过的坑，真正把这个工具用顺手。如果你有什么好用的自定义指令或者使用技巧，也建议沉淀成自己的命令文件，时间越久你会越觉得这个习惯值钱。
