1. 这套速查手册到底解决什么问题第一次接触命令行AI编程助手的人十有八九会经历这么一个阶段装好了打开终端敲了个claude进去然后对着那个朴素的提示符发呆——接下来该干嘛官方文档写得不算少但散落在各个页面里真到用的时候脑子里一片空白只能凭感觉瞎敲。我自己刚开始用的时候光是搞清楚“怎么让它读一个文件”“怎么退出”“怎么切换模型”这几个基础问题就折腾了小半天。这份速查手册就是冲着这个痛点来的。它把日常高频用到的指令、快捷键、工作流模式做了一次系统整理目标很明确让你不用再翻文档打开这一篇就能直接抄作业。不管你是刚装好还没跑通第一条命令的新手还是已经用了一阵子但总觉得效率上不去的老用户都能从里面找到能立刻用上的东西。需要先说明一点命令行AI助手这类工具迭代很快具体命令的拼写、参数名称可能随版本变化。这篇手册讲的是通用模式和使用思路你在实际使用时如果发现某个命令对不上优先以你本地--help输出的结果为准。这个原则后面还会反复提到因为它能帮你省下大量查文档的时间。整篇内容我按“基础操作 → 交互技巧 → 工作流 → 排错”的顺序来组织你可以从头读也可以直接跳到你现在卡住的那一节。下面正式开始。2. 基础命令与启动方式全解析2.1 启动、退出与最常用的几个开关命令行AI助手最核心的入口就是一条启动命令。以常见的用法为例在项目根目录下直接执行claude这会以交互模式启动进入一个对话式的界面你可以连续提问、连续操作。但实际工作中光会这一条远远不够下面这几个启动参数是我用得最多的# 带初始提示词直接启动省去进去再打字的步骤 claude 帮我看看这个项目的目录结构 # 指定工作目录启动 claude --cwd /path/to/your/project # 查看当前版本排查问题时第一步 claude --version # 查看所有可用参数命令对不上时靠它救命 claude --help这里重点说下--help。很多人习惯遇到问题就去搜其实最快的方式是直接在终端敲--help。它会列出当前版本支持的全部子命令和参数比任何第三方教程都准。我踩过的坑就是照着某篇半年前的教程敲了个参数结果报错折腾半天才发现那个参数在新版本里改名了。从那以后我养成了一个习惯——任何命令拿不准先--help。退出交互模式通常是输入/exit或者按CtrlC两次。注意CtrlC一次可能只是中断当前正在生成的内容不会退出程序这个区别在你想“停下但不想走”的时候很有用。2.2 会话管理别让上下文白白浪费命令行AI助手和网页版最大的区别之一就是它天然跟你的项目目录绑定能直接读写文件、执行命令。但这也带来一个问题会话一多你自己都记不清哪个会话在干嘛。几个实用的会话管理操作清空当前上下文输入/clear把当前对话历史清掉重新开始。适合一个任务做完、要切换到完全不相关的新任务时用。查看历史会话多数实现支持/history或类似命令列出你之前的会话记录。恢复上次会话claude --continue或claude -c直接接着上一次的对话继续不用重新交代背景。提示/clear和直接退出重进是两回事。/clear保留程序运行状态但清空对话记忆退出重进则是全新会话。如果你只是想“忘掉刚才聊的”用/clear更快。我个人的习惯是一个独立任务一个会话。比如“重构登录模块”和“写单元测试”是两个任务就开两个会话各自/clear干净。混在一起聊AI很容易把两个任务的上下文搅在一起给出的建议就开始跑偏。2.3 模型与配置的切换逻辑不同任务对模型能力的要求不一样。简单的文件读取、格式转换用轻量模型就够复杂的架构设计、疑难bug排查才需要上更强的模型。切换模型一般通过/model命令或者启动参数完成# 交互模式内切换 /model # 启动时指定 claude --model 模型标识配置文件通常放在用户主目录下的一个隐藏目录里比如~/.claude/这类路径里面会有config或settings相关的文件。你可以手动编辑它来设置默认模型、默认工作目录、API相关配置等。这里有个经验别把配置改得太花哨。我见过有人把默认模型设成最强的那个结果每次启动都慢半拍日常小任务根本用不上。合理的做法是默认用中等模型遇到硬骨头再临时/model切上去。3. 交互过程中的高频快捷键与输入技巧3.1 键盘操作少动手腕的几个关键组合命令行界面里鼠标基本是废的全靠键盘。下面这些快捷键是我实测下来最能提升手速的快捷键作用使用场景CtrlC中断当前生成AI跑偏了想让它停下CtrlD结束输入/退出输入完多行内容后提交CtrlL清屏屏幕太乱想清爽一下上箭头调出上一条输入想改一下刚才的命令重发CtrlR搜索历史命令记不清之前敲过啥Tab自动补全补全文件路径、命令名其中CtrlR是很多人忽略的宝藏功能。你敲过的每一条命令它都记着按CtrlR然后输入关键词就能把历史命令捞出来。比如你三天前敲过一条很长的带一堆参数的命令现在想复用CtrlR搜一下关键词就出来了比重打一遍快得多。Tab补全在输入文件路径时特别有用。你打./src/然后按Tab它会列出该目录下的文件让你选避免手打路径打错。3.2 多行输入与特殊符号的处理命令行AI助手经常需要你粘贴一段代码、一段报错日志或者写一段多行提示词。直接回车会提交所以多行输入有专门的技巧反斜杠续行行尾加\再回车可以继续下一行。粘贴模式直接粘贴多行文本多数实现会自动识别为一次输入不会每行都提交。引用文件内容用文件名的语法让AI直接读取某个文件而不是你手动复制粘贴。这个语法值得单独说。比如你想让AI分析某个配置文件不用把内容复制进去直接帮我看看 config/settings.json 里有没有配置问题它会自己去读那个文件。这个用法在分析大文件时特别省事也避免了复制粘贴过程中格式丢失的问题。注意引用的路径是相对于你启动时的工作目录的。如果你在子目录里启动路径基准会变引用不到文件时先检查一下当前目录。3.3 斜杠命令交互模式内的功能入口在交互模式里以/开头的命令是功能入口常用的有/help列出所有可用的斜杠命令/clear清空上下文/model切换模型/exit退出/compact压缩对话历史保留关键信息但减少token占用/compact这个命令在长会话里非常关键。当你聊了很久上下文越来越长响应变慢、成本变高时用/compact把历史压缩一下能显著改善体验。它的原理是把前面的对话总结成摘要保留核心信息丢掉冗余细节。我一般的节奏是一个会话聊到感觉AI开始“记不住前面说的”或者响应明显变慢就/compact一次。如果压缩后还是不行那就/clear重开把关键背景重新交代一遍。4. 高效工作流的搭建与实战4.1 从“问答”到“协作”工作流的思维转变新手最容易陷入的模式是把AI当搜索引擎问一句答一句。这样用不是不行但效率很低。真正高效的用法是把它当成一个能读写你项目的协作伙伴让它参与到完整的工作流里。举个具体例子。假设你要给一个现有函数加错误处理。低效的做法是把函数复制出来问“怎么加错误处理”拿到答案再手动贴回去。高效的做法是直接说读取 src/utils/parser.js给 parseConfig 函数加上完整的错误处理 包括参数校验、异常捕获和日志输出改完直接写回文件。它会自己读文件、改文件、写回。你只需要最后review一下改动。这个差别看起来小但一天下来能省掉大量复制粘贴的时间。4.2 典型工作流拆解代码审查场景我拿“代码审查”这个高频场景把完整工作流拆一遍你可以照着套。第一步明确范围。不要笼统地说“帮我审查代码”要指定文件或目录审查 src/services/ 目录下的所有文件重点关注 1. 错误处理是否完整 2. 是否有明显的性能问题 3. 命名是否清晰第二步让它先给结论再给细节。我习惯要求它先列问题清单再逐条展开。这样你能快速判断这次审查值不值得细看。第三步逐条确认。对每个它指出的问题你可以追问“这条为什么是问题”“有没有更简单的改法”。不要全盘接受AI也会误报。第四步让它直接改。确认无误后让它把修改写回文件然后你用git diff看一眼改动。第五步跑测试验证。改完代码一定要跑一遍测试别信AI说的“这样就没问题了”。这个五步流程我用了很久基本能覆盖大部分代码相关的任务。核心思路就是先圈范围再要结论逐条确认落地修改最后验证。4.3 批量任务与脚本化调用当你需要重复做同一类操作时交互模式就不够用了得用非交互的方式。多数命令行AI助手支持把提示词作为参数直接传入执行完就退出claude 把 docs/ 目录下所有 markdown 文件的标题层级检查一遍输出有问题的文件列表这种一次性调用的方式适合放进脚本里做批量处理。比如你有一批日志文件要分析可以写个循环for f in logs/*.log; do claude 分析 $f提取所有 ERROR 级别的日志汇总成一句话 done提示批量调用时注意控制并发和频率别一次性甩几百个请求出去容易触发限流或者把本地资源占满。我一般分批跑每批十几个跑完看一眼结果再继续。4.4 把常用提示词沉淀成模板用久了你会发现有些提示词你反复在写。比如“审查这段代码”“解释这个报错”“给这个函数写测试”。与其每次重新组织语言不如把它们沉淀成模板文件需要时直接引用。我的做法是在项目里建一个.prompts/目录把常用提示词存成.md文件用的时候按照 .prompts/code-review.md 里的要求审查 src/ 目录这样既保证了提示词质量的一致性又省去了每次重新措辞的时间。团队协作时这套模板还能共享新人直接拿来用少走弯路。5. 常见问题与排查技巧实录5.1 命令报错的排查顺序遇到命令报错别急着搜按这个顺序排查八成问题能自己解决先看--help确认这个命令、这个参数在当前版本是否存在。看版本--version确认你装的是哪个版本教程和实际版本对不上是常见坑。看配置文件配置写错了也会导致各种奇怪报错检查~/.claude/下的配置文件。看权限文件读写失败多半是权限问题检查目录和文件的权限设置。看网络涉及API调用的确认网络连通性。这个顺序的逻辑是从最可能、最容易验证的原因开始排。命令拼写和版本问题占了报错的一大半先排掉这两个剩下的再深入查。5.2 上下文丢失与“AI失忆”问题用久了最常见的问题就是聊到一半AI突然“忘了”前面说过的关键信息开始给出前后矛盾的建议。这不是bug是上下文长度限制导致的。应对方法有几个层次轻度用/compact压缩历史保留核心信息。中度/clear重开把关键背景重新交代一遍最好用引用相关文件让它重新读取。重度把重要结论、决策记录到一个文件里每次新会话开始时用引用这个文件相当于给它一个“记忆外挂”。我现在的习惯是每个稍大的任务都在项目里维护一个NOTES.md记录已经确认的决策和背景。新会话开始时第一句就是“先读 NOTES.md 了解背景”。这个习惯帮我省了无数次重复解释的功夫。5.3 响应慢、卡顿的优化思路响应慢通常有三个原因上下文太长、模型太重、网络问题。对应的优化手段现象可能原因处理方式越聊越慢上下文累积/compact或/clear一直很慢模型太重/model切轻量模型时快时慢网络波动检查网络错峰使用启动就慢配置问题检查配置文件精简设置我实测下来上下文长度是影响响应速度最大的因素。一个聊了几十轮的会话响应速度可能只有新会话的三分之一。所以别舍不得/clear该清就清。5.4 几个容易踩的坑最后列几个我自己踩过、也见别人踩过的坑都是文档里不太会写但实际很影响体验的工作目录搞错在错误的目录下启动引用文件全部失效。启动前先pwd确认一下。提示词太模糊“帮我优化一下”这种指令AI只能瞎猜。越具体越好最好带上约束条件。全盘接受AI的改动AI改代码也会出错尤其是涉及业务逻辑的地方。改完必须review必须跑测试。忘了保存有些操作是直接改文件的改之前确认一下有没有未提交的改动别把工作区搞乱了。一个会话干所有事前面说过一个任务一个会话混着用上下文会互相污染。提示养成“改前先commit”的习惯。让AI直接改文件之前先git commit一下当前状态改坏了随时能回滚。这个习惯救过我很多次。6. 把工具用成肌肉记忆命令行AI助手这类工具真正的价值不在于它有多强而在于你能多顺手地用起来。命令、快捷键、工作流这些东西看一遍记不住得在实际任务里反复用用到不用想就能敲出来才算真正掌握。我的建议是别想着一次把所有命令都背下来。先从最核心的几条开始——启动、/clear、/model、引用、--help——把这几个用熟覆盖日常八成场景。剩下的遇到再查查多了自然就记住了。另外工具在变命令也在变。今天整理的这套东西过几个月可能就有出入。所以最重要的不是记住具体命令而是养成“拿不准就--help”的习惯。这个习惯比任何速查表都管用。最后分享一个我自己的小技巧我会在项目根目录放一个CLAUDE.md之类的说明文件把项目的技术栈、目录结构、编码规范、常用命令都写进去。每次新会话开始时让它先读这个文件相当于给AI做了一次快速入职培训。这个做法让我每次新会话的“热身时间”从好几分钟缩短到几秒钟实测非常值。