用 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-codelatest升级后最好执行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 退出与中断交互模式中按CtrlC两次可以退出或者输入exit/quit也可退出。中断 Claude Code 正在执行的代码或命令按Esc或者CtrlC即可。这里有个容易困惑的点CtrlC在终端里既是中断也是取消具体效果取决于当前状态。如果正在生成代码按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 diffAI 分析改动后生成规范的提交信息。/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退出交互模式极高CtrlC两次强制退出高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 代码与终端辅助指令指令功能使用频率自然语言 解释这段代码代码解释高自然语言 给这段代码写测试测试生成高自然语言 重构这个函数代码重构高自然语言 这个报错是什么意思错误解释极高自然语言 优化这段 SQLSQL 优化中自然语言 写一个正则表达式正则生成中自然语言 生成 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 辅助高自然语言 写一个 DockerfileDocker 配置中自然语言 这个依赖怎么安装依赖安装高自然语言 数据库查询很慢怎么优化性能优化中自然语言 这段代码有安全漏洞吗安全审计中自然语言 帮我重构整个模块模块重构中自然语言 生成单元测试测试生成高自然语言 解释这个设计模式概念解释中自然语言 这个需求怎么拆解需求分析中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你会发现很多以前没用过的命令已经默默出现了。我自己就是通过这个习惯发现了不少原本不知道的效率功能。希望这份指令清单能让你少踩一些我踩过的坑真正把这个工具用顺手。如果你有什么好用的自定义指令或者使用技巧也建议沉淀成自己的命令文件时间越久你会越觉得这个习惯值钱。