我跟 Claude Code 打交道快半年了从最早的内测版本一直用到现在的正式版本。说句实话这工具给我最大的感受是在真实编码环境里它不是一个“偶尔问问”的聊天框而是一个真正坐在终端里的结对编程搭档——你给它指令它改代码你再审一遍合入主干这套流程已经彻底融进我的工作习惯。今天这篇不打算讲 SDK不讲模型原理只聊一件最实际的事每天用 Claude Code 的人最常用、最高频、真正能解决问题的 100 条指令到底是什么。整理这 100 条花了我不少功夫里面有一部分是官方文档里能查到的斜杠命令还有相当一部分是我自己在项目里摸出来的自然语言触发方式。形式不一样但目标只有一个让你在终端里少敲无效指令、少走弯路真正把它用成生产力工具。1. 环境准备安装、登录与首次配置1.1 安装步骤和版本选择Claude Code 的安装比大多数人想象中简单它本质上是 npm 包一个命令就能装完。前提是你本机得有 Node.js 18 以上版本建议直接用最新的 LTS 版本太老的 Node 版本会直接跑不起来。安装命令就一条npm install -g anthropic-ai/claude-code装完之后验证一下claude --version如果能看到版本号说明安装成功。这里我有一个实际经验全局安装-g是首选因为claude命令需要在整个系统路径里可用按项目局部安装有时候会出现找不到命令的情况。另外macOS 上如果提示权限问题多半是 npm 全局目录的权限配置不对建议先执行npm config get prefix看看全局路径再决定是修权限还是用 nvm 管理 Node 版本。Windows 上则建议直接用 WSL 2 环境跑Claude Code 在 WSL 里比在 CMD 或 PowerShell 里稳定得多路径编码和终端交互都省心不少。1.2 登录认证和 API Key 配置装好之后直接运行claude第一次会走一遍登录流程。Claude Code 的认证分两种路径一种是直接用 Claude 账号登录 Pro/Max 订阅另一种是配置 Anthropic API Key按用量计费。后者更灵活适合有独立结算需求的人。两种方式在配置层面不难关键是搞清楚当前用的是哪种账户体系不然经常会遇到“明明订阅了却提示无权限”的怪问题。如果选择 API Key 方式在终端里设置环境变量export ANTHROPIC_API_KEY你的密钥建议把它写进~/.bashrc或~/.zshrc免得每次开终端都要重新 export。我这里有一个踩过的坑不要把 API Key 写进项目里的.env文件然后提交到 Git 仓库一旦公开仓库泄露账单会让你非常酸爽。另外Claude Code 支持多个项目的配置隔离登录之后会在用户目录下生成配置文件不同项目可以通过环境变量覆盖默认设置这块后面讲配置的时候再展开。1.3 首次启动和交互界面说明首次启动后你会看到终端底部出现一个提示符这就是 Claude Code 的交互入口。和普通命令行不一样你在这里输入的不是 shell 命令而是自然语言指令Claude 会直接在当前项目目录上下文里执行文件读写、命令调用等操作。我见过不少新人在这里犯迷糊上来就输入ls、cd结果发现不好使。其实 Claude Code 的定位是 AI 编码代理不是 Shell 的替代品。常规系统操作你还是得回到原始终端做Claude Code 更擅长的是理解项目结构和代码语义。首次进入项目目录后我强烈建议先敲一条/init它会扫描整个项目的结构、技术栈和关键配置生成一份项目说明文档作为后续所有对话的上下文基础。不夸张地说这一步做没做决定了你后续指令是“一次命中”还是“反复沟通”。2. 日常核心指令100 条高频指令速查2.1 会话与交互控制指令15 条这一组是日常使用频率最高的不管什么场景都会用到。它们解决的是“怎么让 Claude Code 明白我的意图”以及“怎么控制整个对话流程”的问题。以下是我整理的核心会话控制指令每条后面附上使用说明开启新会话claude或输入/clear适合每换一个任务就重置上下文。继续上次会话claude --continue或claude -c会加载最近的会话历史。恢复指定会话claude --resume [会话ID]适合从之前某次会话中继续。查看历史会话列表claude --resume后面不跟 ID会列出所有可恢复会话。中断当前输出Esc或Ctrl C组合键Claude 正在生成时可以立刻打断。强制退出程序连续按两次Ctrl C或输入/exit。查看帮助/help列出所有内置命令和快速上手指引。查看当前会话信息/status显示上下文占用和当前模型信息。清空对话上下文/clear等价于开新对话。压缩历史上下文/compact把长对话压缩成摘要节省上下文空间。切换详细程度在指令里加“请简短回答”或“请详细解释”可以控制回答粒度。要求重新生成输入“重新回答”或“换个思路再来”可以让 Claude 用不同方案重做。引用上一条指令直接说“同上”或“对刚才那只文件再改一下”。保存当前会话到文件claude --output-format json 文件名.json。指定输出格式加参数--output-format json/stream-json适合脚本化调用。这组指令里我特别想提一下/compact。很多重度用户聊到一半发现 Claude 开始“失忆”之前提到的文件路径、变量名都记不清了基本就是上下文窗口塞满了。这时不用开新会话直接敲/compact它会把前面的对话提炼成一份摘要保住关键的约束条件同时释放上下文空间继续聊不打断思路。2.2 文件与目录操作指令15 条Claude Code 很核心的一个能力就是直接读写项目文件。这一组指令是文件的日常增删改查用自然语言描述即可。查看项目结构“列出当前项目的目录结构排除 node_modules”。查看文件内容“读取 src/main.ts 的前 100 行”。定位文件“在项目里找到所有包含 TODO 的文件”。新建文件“在 src/utils 下新建一个 format.ts 文件”。重命名文件“把 utils/helper.js 改名为 helpers/index.js”。移动文件“将 tests/unit/old.test.ts 移到 tests/integration 目录”。删除文件“删除 dist 目录里所有 .map 文件”。批量替换内容“把整个项目中 foo 替换成 bar排除 lock 文件”。追加内容“在 README.md 末尾追加一段使用说明”。统计代码行数“统计 src 目录下各文件的代码行数”。查找引用“搜索 getName 方法在哪些文件里被调用”。监视文件变化“监控 pages 目录只要有文件新增就告诉我”。文件对比“对比 a.js 和 b.js 的差异”。生成目录树“输出到 docs/structure.md包含注释说明每个目录用途”。复制模板文件“把 config.example.yaml 复制为 config.yaml填充默认值”。这里补充一个经验操作文件时指令里尽量包含明确路径和范围限定比如“排除 node_modules”“只看 src 目录”“修改前先备份”。Claude Code 有很强的工具调用能力你给的范围越清楚它就越不会乱动不该动的文件。我在项目里曾经只是说“清理一下无用文件”结果它把所有.log文件全删了那里面有我用做排障的日志教训相当深刻。2.3 代码编写与重构指令20 条这组是 Claude Code 价值最集中的地方。它不只是“写个函数”更重要的是能基于现有代码风格做重构、优化和补齐逻辑。我把最高频的 20 条整理出来生成完整函数“写一个防抖函数支持取消功能TypeScript 类型齐全”。实现接口“根据 types/api.ts 里的接口定义生成对应的 mock 数据”。代码补全“补全 handleSubmit 函数里缺失的表单校验逻辑”。解释代码“逐行解释这个函数的作用用注释标出来”。重构函数“把 processData 拆成三个职责单一的小函数”。优化性能“分析这段循环的复杂度给出优化版本”。转换代码风格“将这段 Promise 链改成 async/await 写法”。生成单元测试“为 utils/date.ts 里的每一个函数写单元测试”。编写集成测试“给登录接口写集成测试覆盖成功和密码错误场景”。生成注释和文档“给 components/Button.tsx 写完整的 JSDoc 注释”。修复静态检查告警“修复 eslint 报告的所有 no-explicit-any 错误”。补类型定义“给这段 JS 代码补充完整的 TypeScript 类型”。沿用代码风格“按照项目里现有模块的写法新增一个用户模块”。生成错误处理“给这段文件读取逻辑加上完整的错误捕获和回退机制”。编写正则表达式“写一个校验手机号的正则支持可选区号”。生成 SQL“写一条 SQL查询最近 30 天订单量前 10 的商品”。数据清洗代码“生成 Python 脚本清洗 CSV 中的空值和重复行”。性能分析辅助“检查这段代码里可能造成内存泄漏的地方”。生成图表代码“用 ECharts 生成一个折线图数据格式要求见附件”。写爬虫脚本“写一个 Node.js 脚本爬取静态网站的公开列表页”。这组指令的核心秘诀在于一定要提供足够的上下文。不要只说“帮我优化”而要说“帮我优化 getList 函数它经常在数据量大时卡住我怀疑是多次 filter 造成的”。Claude Code 会根据你的描述锁定问题点给出的方案会精准很多。另外让 Claude 生成代码后别急着复制先让它跑一遍相关的测试发现问题直接在当前会话里修能省掉不少来回切换的精力。2.4 测试与调试指令15 条代码写完了接下来就是测试和调试环节。Claude Code 在这里也有一整套高效玩法关键是它能把报错信息、堆栈日志和代码本身联动起来看比肉眼人肉排查快得多。解释报错信息“这个报错是什么意思怎么修复附上完整堆栈”。定位崩溃点“程序在跑批时总是崩溃帮我定位可能的原因”。添加日志调试“在关键分支里加上 console.log标明执行顺序和变量值”。单步排查逻辑“帮我梳理这段代码的参数传递链路看看哪里可能丢字段”。审查潜在边界条件“检查这个函数在空字符串、极长输入、负数等情况下的表现”。修复内存问题“分析这段循环里为什么内存持续增长给出修复方案”。生成测试数据“生成 100 条符合 schema 的假数据用于本地联调”。模拟异常场景“这段代码在接口超时、返回空值时会怎样补充防御逻辑”。调试正则“为什么这个正则匹配不到中文请解释并修正”。检查并发问题“这段并发写入会不会有竞态条件怎么加锁”。分析性能瓶颈“用 console.time 给这段代码打点找出最耗时的部分”。修复跨域问题“前端调用 API 报 CORS 错误后端需要怎么配置”。生成调试配置“帮我写一份 VSCode launch.json用于调试当前后端服务”。检查依赖漏洞“检查 package.json 里哪些依赖有已知安全问题”。对比行为差异“为什么本地和线上表现不一致列出需要检查的环境差异点”。调试过程中你会发现Claude Code 最有价值的能力其实是“串联推理”。你把报错贴给它它不只是翻译报错还会直接打开相关源码文件自动回溯调用链然后给你一个“很可能的根因 验证方法 修复代码”的完整方案。这种体验很接近一个资深工程师坐在旁边帮你 debug而不是搜索引擎式的一问一答。2.5 项目与命令执行指令20 条除了代码本身Claude Code 还能在终端里执行命令。这意味着很多常规的构建、测试、包管理操作都可以直接交代给它省去手动敲命令的来回切换。执行构建“运行 npm run build如果失败就把错误信息和修复建议一起给我”。执行测试“运行 pytest并汇总所有失败用例的报错原因”。安装依赖“安装 lodash 的最新版本并更新 package.json”。降级依赖“把 react 降级到 18.2.0同时解决相关的类型冲突”。运行脚本“node scripts/init-db.js需要传入 DATABASE_URL 环境变量”。查看服务状态“检查本地 3000 端口是否被占用列出占用进程”。启动开发服务“启动 dev server并在它崩溃后自动读取日志分析原因”。提交代码“把当前的改动整理成一次提交提交信息按 conventional commits 规范写”。查看 Git 状态“简要说一下当前分支的改动情况哪些是新增、哪些是修改”。解决合并冲突“帮我解决当前分支的合并冲突保留两个分支的核心逻辑”。生成迁移脚本“根据 model 的变化生成数据库迁移 SQL”。执行迁移“运行数据库迁移并验证表结构是否和模型一致”。格式化代码“用 prettier 格式化 src 和 tests 目录不要动配置文件”。检查类型“运行 tsc --noEmit汇总所有类型错误的文件和位置”。清理构建产物“删除 dist 和 .cache 目录然后重新构建”。查看测试覆盖率“运行带 coverage 的命令告诉我低于 80% 的模块有哪些”。生成环境变量示例“根据 .env.example生成一份完整的本地配置说明”。检查代码规范“按照项目里的 eslint 配置扫描列出规则违规最多的文件”。批量重命名文件“把文件名中的 v1 后缀统一替换为 v2保留目录结构”。查看系统资源“当前 CPU 占用高的进程有哪些是不是体感越来越卡”。注意一个前提Claude Code 执行命令前通常会询问一下你对命令内容是否认可取决于权限设置。如果你希望它自动执行可以在配置里开启对应权限白名单。但如果项目是多人共用的仓库我建议不要放开自动执行让它先展示命令、再由你确认这一步能拦住很多不必要的误操作。2.6 内置斜杠命令和白名单机制15 条斜杠命令是 Claude Code 的内置能力相当于预制的指令模板。它们不需要自然语言展开输入/开头就能用效率最高。/init初始化项目说明文档扫描结构、生成 CLAUDE.md。/help打开帮助菜单列出所有斜杠命令。/compact压缩当前会话的上下文历史。/clear清空当前会话重新开始。/status显示当前会话的上下文占用率、模型信息等。/v进入 Vim 键位模式适合 Vim 用户。/review对当前目录或文件的改动进行代码审查输出问题清单。/agents管理子代理subagents用于并行处理任务。/config打开配置文件直接编辑权限、模型、钩子等设置。/hooks管理事件钩子比如任务开始前自动执行脚本。/mcp查看或配置 MCPModel Context Protocol服务器列表。/permissions查看和修改命令执行的权限策略。/model切换底层模型版本。/export导出当前会话记录。/installdocs在本地生成完整的官方文档方便离线查阅。这 15 条斜杠命令里我最常用的是/review和/compact。/review相当于免费的自助代码审查你刚写完一个功能先让它过一遍能挑出不少低级毛病/compact则解决了长会话续聊的痛苦上下文一旦要爆了压一下继续干活不打断心流。大家在用的时候务必记住斜杠命令是上下文相关的有些需要先选中文件或先打开项目才有效输入/help看一下当前环境的可用列表是最快的确认方式。3. 指令在真实场景下的组合策略3.1 新项目从零搭建的指令流水线单独记 100 条指令没用关键是知道什么场景下怎么组合。我这里举一个新项目从零搭建的完整流程大家可以直接拿这套指令流去试感受一下 Claude Code 的节奏。claude进入项目空目录/init初始化项目上下文帮我用 Vite 创建一个 React TypeScript 项目按 src/modules、src/components、src/utils 的目录结构重组项目安装 axios、react-router-dom、zod并封装统一的请求模块在 src/modules 下实现用户登录和注册页面样式使用 Tailwind为两个页面写完整的表单校验逻辑用 zod 做 schema补充用户模块的 API 类型定义导出所有相关 type运行 tsc --noEmit修复全部类型错误启动 dev server我手动点击验证流程。这套流程走下来一个带登录注册的前端骨架一般半小时内就能立起来。关键点在于每一步之间是连贯的Claude Code 记得前面做了什么后续指令可以引用之前的成果比如“把刚才的请求模块用到新页面里”。如果你总是开新会话割裂地发指令效果会大打折扣。3.2 代码评审场景的指令组合代码评审是 Claude Code 的重头戏。以前提 MR 之前要自己反复通读代码现在我会让 Claude 先做一轮预审。进入评审场景后第一件事是明确评审范围帮我 review 当前分支相对 main 的改动只关注逻辑正确性和潜在 bug。等它输出问题清单后再针对每个问题追问第一个问题的具体触发场景是什么给出复现用例。如果问题较多我会让它按严重程度排序把这些问题按 P0/P1/P2 分级并给出每一级的修复建议。这套组合下来基本能在提交前拦住 80% 以上的低级问题。但我要提醒一下Claude Code 的评审更多是静态逻辑层面的它看不到产品需求和业务预期。所以涉及交互设计、业务语义的地方最终还是得靠人来把关别把它的意见当成唯一标准。3.3 接手烂代码项目时的排查思路接手历史遗留项目是很多人的噩梦Claude Code 能把这个过程减轻不少。我第一次接手一个五年老项目时连入口文件都找了半天。后来我总结了一套相对高效的组合指令。第一步是让 Claude 花几分钟梳理项目全貌这个项目的入口在哪主要依赖是什么目录里哪些模块是核心业务哪些是死代码。第二步定位技术债找出项目里代码量最大、复杂度最高的三个文件分析为什么它们这么难维护。第三步制定重构方案如果要重构这个模块你会怎么分步做保证不影响现有 API 返回格式。第四步小步验证先只重构 utils 下的纯函数部分跑一遍测试看看有没有行为变化。这套思路的核心是不要上来就让它大改而是先理解、再定位、后小步实践。历史上多少次重构翻车都是因为一上来就全局替换最后整个项目跑都跑不起来。Claude Code 可以是你理解项目和执行重构的强力助手但项目方向的判断还是得由你来把。4. 配置优化与个性化打造专属指令环境4.1 CLAUDE.md 的写法和作用Claude Code 里有个非常重要的文件叫CLAUDE.md放在项目根目录。它相当于项目的“说明书”每次会话启动时Claude 都会优先读取这份文件作为整个对话的长期上下文。你在这个文件里写清楚项目规范后面所有指令的执行都会自动遵循不用每次重复交代。我在实战里一般会在 CLAUDE.md 里写这几类内容项目技术栈和启动命令比如“React 18 Vitedev 命令是 npm run dev”代码风格约定“组件使用函数式写法样式用 CSS Modules”目录结构说明“api 目录放接口请求hooks 目录放自定义 hook”禁止事项“不要修改 generated 目录下的代码”“不要动 lock 文件”命令白名单“允许执行 npm 相关命令禁止 rm -rf”。这些规则写清楚之后你就会发现 Claude 的表现判若两人。之前它可能偶尔会用错框架或乱改文件有了 CLAUDE.md 后基本不会发生。写这份文件本身也可以让 AI 来辅助先让它扫描项目生成初稿你再手动增删修改效率高很多。4.2 自定义斜杠命令官方自带的斜杠命令只有那些但 Claude Code 允许你自定义斜杠命令把复杂指令一键化。这个功能太适合那些白天要反复执行的重复操作了。实现方式是在项目根目录下建一个.claude/commands/文件夹里面每个.md文件就是一个自定义命令。比如我建了一个daily.md内容是我每天开工时想让它做的检查请帮我执行以下检查 1. 读取 git log看看昨天的提交记录 2. 查看当前分支是否需要更新 3. 运行最新的测试列出失败用例 4. 总结所有待办事项。保存后在会话里输入/daily它就会依次执行这些操作。这个过程你可以不断迭代命令的内容把日常重复性的环境搭建、检查流程、报告整理全固化下来省下的时间非常可观。我个人的习惯是每完成一个批量任务就问自己一句“这个流程我还会不会再做第二次”如果会就把它变成一个自定义斜杠命令。4.3 VSCode 集成和外部工具联动虽然 Claude Code 主打终端但不少人更喜欢在 VSCode 里配合使用。目前 VSCode 侧的集成方式很成熟可以通过终端面板嵌入 Claude Code也可以在侧边栏打开独立面板两边联动使用。编辑器里选中的代码可以直接传入 Claude Code 的上下文让它只针对选区做处理这个体验非常顺手。外部工具方面MCPModel Context Protocol是 Claude Code 链接外部数据源和工具的标准方式。我接得比较多的是让它可以读取数据库表结构、访问内部接口文档、调用某些自动化测试平台。配置完成后你在对话里直接说“查一下 orders 表的结构”它就能通过 MCP 工具执行查询并返回结果非常方便。不过要注意每多接一个 MCP就相当于多开了一个权限入口。安全策略建议是只给最小必要的数据读取权限别把生产环境的写权限也挂上去风险边界务必要清晰。5. 常见问题与排查技巧实录5.1 高频报错与解决方法用 Claude Code 这半年遇到过的坑不少这里列几个出现频率最高的问题和对应的排查思路。第一个是“command not found: claude”。刚安装完就出现这问题基本都是 Node 全局目录不在系统 PATH 里。解决方法是找到 npm 全局安装路径把它加进PATH。macOS/Linux 可以通过npm config get prefix看到路径然后加到 shell 配置文件里。Windows 下检查环境变量或直接改到 WSL 里装会省很多事。第二个是“Enough context”或者“content length exceeded”。这是上下文塞满的典型表现。最直接的解决方式是先/compact压缩上下文再继续之前的话题。如果压缩之后还是不够就考虑把大文件拆小尽量减少一次性塞入的代码量。还有一种做法是在执行大文件分析前先明确告诉它“只需要关注 XXX 函数不要读整个文件”节省上下文开销。第三个是权限问题类似“Command not allowed”。这是因为默认权限策略限制了一些危险命令的执行。你可以在对话里直接说“允许执行 git diff 命令”或者去/config里面调整权限白名单。我把权限策略理解为一条安全底线宁可多确认一次也不要让 AI 自动执行高风险操作。第四个是模型回答前文后忘了前文的“失忆”问题。这通常跟会话过长、上下文被压缩有关。建议每隔一段时间手动/clear开新会话或者把关键需求写进 CLAUDE.md 持久化不要指望每条对话都回放所有上下文。我把以上高发问题汇总成了一张速查表问题现象常见原因快速处理办法命令找不到Node 路径没配置把 npm 全局路径加入 PATH上下文超限会话历史太长/compact压缩或/clear重开命令被拒绝权限策略未放行/config调整白名单回复偏离主题上下文被截断重新给出明确约束并/clear修改范围过大指令范围不清晰补全路径和排除规则明确限定范围生成的代码跑不通依赖版本或环境差异让它结合报错继续修复别急着换思路5.2 成本控制与效率优化心得Claude Code 非常强但它不是免费的。API Key 模式下一次大型重构可能消耗不少 token。我整理了几个控制成本同时保持效率的经验给大家做个参考。第一是按需切换模型不是每个任务都需要最强模型。简单的代码解释、格式化、小范围修改可以使用轻量模型复杂架构分析、跨模块重构再用能力更强的。通过/model命令可以随时切换合理搭配能让账单变得更友好。第二是精简上下文在发起指令前先想清楚“这个问题需要它看哪些文件”。尽量用精确的路径和函数名引导它避免触发大范围扫描。比如“只看 src/utils/date.ts 里的 formatDate 函数”和“帮我看一下项目里日期处理有没有问题”两者消耗的 token 差距很大效果却是天壤之别。第三是用好/compact和/clear长时间不用了直接清掉会话不要让它背负着毫无意义的旧对话继续跑。每个新会话都是一张白纸反而是最高效的。第四是善用自定义命令固化流程把高频、重复、模板化的工作定义成自定义斜杠命令能显著减少来回对话的次数省时省 token 也省心智负担。关于成本控制还有一个容易被忽略的点Claude Code 执行命令产生的外部影响也要关注。比如让它跑一个数据库迁移如果脚本本身有问题产生的影响会远大于 token 费用。所以凡是改动数据库或发布正式版本的命令我都坚持自己先审一遍再放开执行。这不算效率低反而是成本最低的保险。5.3 把 Claude Code 真正融入团队的几条建议文章最后我想聊聊比“记住 100 条指令”更重要的层面怎么把 Claude Code 真正用进团队开发流程而不仅仅是某个开发者的私人玩具。第一CLAUDE.md 应该是项目资产不是个人笔记。团队项目里这份文件最好由核心维护者统一维护把团队规范、命令偏好、禁止事项都写进去。新人接手项目时让 Claude Code 直接读一遍 CLAUDE.md相当于有人把项目背景和约定讲给他听。第二自定义命令要定期归纳。每次有人开发出了新的高效操作就往.claude/commands/里沉淀一个命令慢慢打磨成团队效率工具库。第三运行权限要有统一策略。涉及写操作、删除、依赖安装的命令建议默认手工确认确定安全后再把权限下放。我在实际使用中最深的一个体会是Claude Code 不是用来代替你写代码的而是用来代替你重复劳动、帮你更快理解上下文、替你跑掉那些繁琐但机械的环节。真正的架构决策、需求判断、代码风格争议依然需要人来拍板。工具用得越顺手越要清楚它的边界在哪里。希望这 100 条指令里有那么几条能在你的日常开发里真正发挥作用让你少踩几个我踩过的坑。最后再分享一个小技巧每当你觉得 Claude 输出质量下降时先别急着怀疑工具版本去翻翻对话上下文是不是已经塞了大量无关内容。清一清再开始往往比硬扛着对话更高效。
