如果你天天泡在终端里写代码一定体会过这种场景上下文刚切换完思路还没续上又要打开IDE、找到文件、翻出测试用例然后重新读一遍代码才能继续干活。Claude Code 就是冲着这个痛点来的——它不是又一个网页对话框也不是IDE插件而是一个直接跑在命令行里的AI编程搭档。你可以在任何目录下敲一句claude它会读取整个项目的代码结构、定位文件、修改代码、执行命令、跑测试甚至帮你提交git全程不用离开终端。这份速查手册不是把官方文档翻译一遍而是我实际用了大半年、踩了不少坑之后梳理出来的高频指令、终端快捷键和可落地的工作流。如果你已经受够了切窗口式的人机协作想把AI嵌进每天的真实操作里这篇文章对你应该很有用。我会先讲清楚它到底是什么、能做什么然后给你一份可以直接背下来的命令清单最后用一个真实的Bug修复案例把整套工作流串起来。1. Claude Code 到底是什么一个终端里的AI结对编程搭档很多人第一次听说Claude Code以为是类似ChatGPT的聊天工具其实差别很大。它的核心工作方式不是“你问我答”而是“你说目标它读代码、改代码、跑命令、给结果”。这背后是终端上下文感知能力Claude Code会自动扫描你当前项目里的文件结构、git状态、最近改动甚至能追踪你每条消息涉及的文件然后基于真实代码库给出修改建议。这种模式特别适合重构老项目、排查线上Bug、给陌生仓库写测试这类“必须先把代码读明白”的任务。它的能力边界也很清晰。能做的事情包括读取和定位文件、批量替换代码、创建新文件、执行终端命令、运行测试、解释报错栈、生成commit信息、写技术文档。需要注意的事情是它不会替你判断架构合理性也不会主动发现所有潜在副作用更不会在你目标表述模糊时替你猜需求。换句话说它是一名执行力很强但需要清晰指令的实习生而不是能独立拍板的技术负责人。适用场景我大概总结为四类。第一类是快速上手陌生代码库你刚接手一个前人留下的项目让Claude Code带你把目录结构、核心模块、数据流过一遍第二类是重复性编码劳动比如给几十个接口补充参数校验、统一日志格式、生成测试用例第三类是Bug定位闭环把报错信息丢给它让它沿着调用链找原因第四类是代码评审和重构前的风险评估让AI先列出所有涉及到的地方你再决定怎么动。适合的读者也很明确日常用终端、希望减少上下文切换、愿意把AI当成协作工具而不是搜索引擎的开发者。1.1 安装与首次启动一杯咖啡的时间跑起来安装Claude Code的硬性前提是Node.js环境。建议版本是Node 18以上低于这个版本会出现各种奇怪的兼容问题。确认Node没问题后执行一行命令即可npm install -g anthropic-ai/claude-code装完之后敲claude --version验证是否成功。如果提示命令找不到先检查npm全局安装目录是否在PATH里这个坑后面排查章节我会专门讲。第一次启动直接输入claude回车。它有两种认证方式一种是在终端里生成授权链接用浏览器登录你的Anthropic账号完成授权另一种是通过环境变量传入API Key。我个人更推荐用后者因为方便脚本化和在服务器上使用。配置方式很简单在~/.zshrc或~/.bashrc里加一行export ANTHROPIC_API_KEY你的key需要注意的是不要把API Key写进任何会被git追踪的文件里。我有一次在项目根目录的.env里配了key结果差点把它提交到仓库。安全做法是环境变量放到shell配置里或者用.gitignore明确排除.env文件。启动时Claude Code会提示你了解它的权限模型默认情况下AI读取文件、修改文件、执行命令都需要你手动确认。我建议新手不要急着放开所有权限先让它做每一步都跟你打招呼等熟悉之后再按需授权。首次进入项目目录时可以敲/init让它生成一份CLAUDE.md这个文件会作为AI理解这个项目的“说明书”后面工作流章节我会详细展开。1.2 版本管理与升级Claude Code迭代速度很快基本每周都有小版本更新。终端里执行claude update它会自动检查并安装最新版本。如果遇到权限问题或者更新失败最稳妥的办法是重新执行全局安装命令覆盖旧版本。升级后建议用claude --version确认版本号另外留意CHANGELOG里是否新增了命令参数或行为变化因为有些升级会调整默认权限策略之前能跑通的工作流可能需要微调。2. 高频指令全解析这些命令背下来效率直接翻倍Claude Code的指令体系分为两类一类是在交互会话里敲的斜杠命令另一类是启动时附带的参数命令。前者解决的是“会话内怎么控制AI”后者解决的是“怎么把AI嵌入脚本和自动化流程”。我把这两类拆开讲并附上我用下来最顺手的组合。2.1 会话内高频斜杠命令速查先给一份我日常使用频率最高的命令清单命令作用我的使用场景/help查看所有可用命令和说明记不住参数时快速查/init生成或更新CLAUDE.md项目记忆文件新项目第一步/memory添加跨会话持久记忆告诉AI你常用的编码偏好/compact压缩上下文保留关键信息继续对话对话超过30轮、AI开始忘事时/clear清空当前会话上下文切换任务时彻底重置/resume列出历史会话并选择恢复第二天接着上次的工作/model切换使用的模型版本简单任务换轻量模型省钱/status显示当前会话状态、模型和上下文占用怀疑上下文快满了时排查这里重点说一下/compact。很多人不理解为什么对话会“越聊越笨”。Claude Code的每次请求都会把对话历史重新发给模型历史越长占用的上下文窗口越多模型能在意的细节就越少。/compact的本质是让AI把之前的对话总结成一份精简摘要然后用摘要替代完整历史相当于给对话“瘦身”。我一般在两个时机用它一是明显感觉到它开始忘记最开始的需求细节二是即将开始一个大任务之前主动清掉无关的历史包袱。/memory也很实用。它写入的是跨会话的持久记忆会跟随账号保存。比如我习惯让Claude Code生成的commit信息按type(scope): description的规范来这个偏好写入/memory后以后每个会话它都会遵守。这里注意/memory适合放与项目无关的个人通用偏好与具体项目相关的约定应该放进CLAUDE.md否则换项目时记忆会串味。2.2 命令行非交互模式把AI装进脚本里交互模式适合人坐在终端前一步步指挥但真正让效率起飞的是非交互模式。通过-p参数你可以把一段提示词直接传给Claude Code执行完就退出连会话都不需要进入。这是我拼接自动化流程的利器claude -p 查看当前目录的README.md提取其中提到的主要功能清单更实用的是配合管道和其他命令。比如我想让AI给我刚才的改动写commit信息git diff | claude -p 根据以下diff内容生成一份符合 conventional commits 规范的提交信息不要有其他解释或者让AI审查所有未提交的改动git diff --cached | claude -p 你是资深代码评审人请指出这段diff中可能存在的bug和安全隐患按严重程度排序输出这套方式的威力在于可以把AI嵌入到任何已有流程里。我个人的习惯是写一个shell脚本把常用的审查、测试补全、文档生成操作封装好然后配合alias使用比如alias crgit diff | claude -p 请帮我做代码审查...。一旦跑通AI就不再是“需要打开窗口才能用的玩具”而是跟grep、awk一样自然存在的命令。非交互模式有几个容易踩的坑。第一没有对话上下文每次调用都是独立的所以提示词里要把必要信息写完整第二输出结果默认是纯文本到stdout如果需要结构化结果可以在提示词里要求只输出JSON然后交给jq解析第三注意控制输出长度某些任务会产生很长的结果配合--output-format text或--verbose按需选用。2.3 启动参数与权限控制启动时的一些参数能直接改变会话行为。这里列出几个我常用的claude --continue # 继续最近一次会话 claude --resume # 从历史会话列表里选择恢复 claude --model sonnet # 指定模型简单任务用轻量模型 claude --allowedTools Bash,Read # 只允许部分工具 claude --disallowedTools Write # 禁止部分工具 claude --dangerously-skip-permissions # 跳过权限确认高风险慎用权限控制是Claude Code比较有特色的一块。默认它是“事事确认”的这很安全但有打扰。用--allowedTools可以精细授权。比如我喜欢让它直接跑测试命令但不想让它动git远程操作就可以限定它只能用执行终端命令和读文件、改文件。实际使用中我强烈不建议用--dangerously-skip-permissionsAI偶尔会产生幻觉式的操作序列跳过确认等于把方向盘完全交给一个偶尔走神的司机。如果觉得弹窗太频繁更好的方案是把常用操作拆成安全的斜杠命令后面工作流章节会讲怎么定制。3. 快捷键与终端技巧让高频操作变成肌肉记忆命令会背了但如果鼠标还得反复从终端挪到浏览器效率还是上不去。Claude Code的交互体验很大程度取决于你有多会用终端快捷键。这一节我把最常用的操作整理成速查表再讲几个能显著提速的进阶技巧。3.1 会话内快捷键速查表需要说明的是Claude Code跑在终端器里所以它的快捷键其实是“终端通用快捷键 会话内自有键位”的混合体。我整理常用的一组快捷键作用Ctrl C中断当前AI生成或终端命令Ctrl L清空当前屏幕保留会话Ctrl D退出交互会话Ctrl R搜索历史命令Tab自动补全命令或文件路径Esc撤销/停止当前输入框里的内容视终端而定↑/↓查看历史输入这里有三个高频操作必须练成肌肉记忆。第一是Ctrl CAI生成到一半发现方向偏了按下去比说“停”快得多第二是Tab补全Claude Code支持命令和文件路径的补全敲一个/me再按Tab能直接补全成/memory第三个是Ctrl L会话时间久了终端输出很乱随手清屏能让注意力回到当前代码块上。3.2 多行输入、粘贴与超长需求终端里的一个尴尬是需求描述太长一行写完没法换行。Claude Code支持多行输入在输入框里直接按Shift Enter换行这样可以把一个复杂任务拆成几条要求分步写清楚。如果你要粘贴大段代码或文档要格外小心有些终端会逐字符执行粘贴内容如果文本里包含换行符可能在粘贴完成前就按回车执行了。我的安全做法是把大段内容先写入一个临时文件然后用cat传给Claude Code。比如cat prompt.txt | claude -p 根据文件要求完成需求如果是在交互会话里更推荐用斜杠命令!前缀来执行终端命令这样准确性更高。比如!cat data.txt可以把文件内容直接带到对话里不需要复制粘贴。3.3 Vim模式与键盘流工作法如果你是Vim用户Claude Code的编辑区域支持Vim键位这能让整个会话完全脱离鼠标。编辑代码建议时按Esc进入普通模式用h/j/k/l移动光标dd删除当前行u撤销i回到插入模式。这一套说起来简单但用顺了以后你修改AI生成代码的速度会提升一个档次。如果你不熟悉Vim也不用强求。我自己刚开始也觉得多余直到有一次改一段AI生成的复杂函数用Vim键位连续调整了十几处才意识到鼠标操作需要反复切换定位和点击而Vim模式下整个手都停在键盘上改动的节奏是连续不间断的。我的建议是先记住i、Esc、hjkl、dd、u这几个键够用就行其他键位遇到需求再查别一开始就背完整张键位图。4. 高效工作流搭建从“你问我答”到“人机协作流水线”命令背得再熟如果只是零散地对AI提问效果始终有限。真正的效率提升来自把重复性的工作固化成工作流。这一节我分享四个我自己在用的工作流从新项目启动到代码审查全覆盖。4.1 新项目启动工作流从空目录到可运行骨架假设你要开始一个Python项目目标是用FastAPI写一个待办事项接口。过去你要手动建目录、装依赖、写入口文件、配置路由现在可以这样和Claude Code配合。第一步在空目录下启动claude用一句话描述目标“创建一个FastAPI项目骨架支持Todo的增删改查使用SQLite存储包含requirements.txt和README.md”。AI会自动分析当前目录然后询问你是想让它直接创建文件还是一次一个确认。我的建议是第一次运行让它逐个确认因为你可能会发现它对项目结构的默认理解不符合你的预期。第二步生成完骨架后别急着写业务代码先执行claude -p 读取这些新建的文件总结当前项目结构指出哪里缺少错误处理。这一步是为了检查AI生成内容的质量同时让上下文里有完整的项目认知。第三步如果你对生成结果满意用/init让AI生成一份CLAUDE.md把项目结构、技术栈、运行命令写进去。这不仅仅是给AI看也是给队友看的项目入口文档。这个工作流下来一个可运行的项目骨架通常在十分钟内就能完成比起手动搭建省下的主要是建目录、写模板、查依赖的时间。4.2 Bug修复闭环从报错到提交Bug排查是我最喜欢用Claude Code的场景因为它能真正沉进代码里看调用链而不是像搜索引擎那样给你一堆相关链接。我的标准流程是四步。第一步复现Bug拿到完整的报错信息。如果报错栈很长直接全选丢给AI不要自己先精简AI能从完整栈里提取关键路径。第二步让AI先解释后修改。我通常这样写提示词“先分析这个报错的根本原因列出涉及的函数和调用关系不要急着修改代码。确认原因后再给出修复方案。”这个约束很重要否则AI经常跳过分析直接甩一段修改代码你不知道它为什么改出了问题也没法回退。第三步让AI直接改代码并补测试。修改完成后让它针对这次修复补一个回归测试。我踩过最大的坑就是让AI修Bug不补测试结果三天后同样的Bug换了个形式又出现了。第四步验证通过后提交。测试跑通后用git diff | claude -p 生成commit信息工具生成规范提交信息然后手动确认、提交。整个流程里人只负责复现、给目标、最终确认中间的读代码、定位、修改、补测试都由Claude Code完成。这个模式跑顺后修Bug带给我的精神负担少了很多。4.3 代码评审工作流让AI当第一道过滤器每次写完整块代码后我都不直接提交而是先让AI做一次预审。非交互模式跑一条命令git diff | claude -p 你是资深后端工程师请审查以下代码改动。重点检查1.潜在的空指针和异常场景2.事务和并发安全问题3.命名和可读性问题4.遗漏的边界条件。按严重程度输出如果没问题请说明原因。这里的关键是给AI一个“输出格式”的框架而不是泛泛说“帮我看看”。AI的输出质量几乎完全取决于你提供的审查维度。我第一次用的时候只说了“审查代码”结果它给了一堆风格建议全没在点上。后来我把审查维度写成列表它给到的结果就专业得多甚至发现过我遗漏的数据库连接未释放问题。这个工作流特别适合合并请求之前的自检。AI会在你提交给同事之前先挑一轮毛病省去很多来回沟通的成本。同时我还会让AI顺便生成一份变更摘要这样提交说明里就有了一份清晰的中文变更记录。4.4 定制Slash Command把重复劳动变成一键指令Claude Code支持自定义斜杠命令这是把工作流固化下来的杀手锏。在项目的.claude/commands/目录下每个Markdown文件就是一个斜杠命令。我举个例子创建一个review.md你是资深代码评审人。请以以下维度审查代码并输出结构化结果 1. 正确性风险 2. 性能问题 3. 安全漏洞 4. 可维护性 要求每个问题必须附带文件和行号按严重程度排序。 /git_diff注意文件里那个/git_diff是Claude Code的上下文注入语法。它会把当前的git diff注入到命令里这样我只要在会话里敲/reviewAI就能自动开始审查当前改动全程不用我复制粘贴任何代码。除了review我常用的还有test命令让AI为当前文件补测试、doc命令让AI生成模块文档。这些东西放到.claude/commands/目录后团队里其他人也能共享多个人的经验就沉淀成了一套命令库。4.5 用 CLAUDE.md 给AI“立规矩”最后说CLAUDE.md。这个文件是项目级的说明文档Claude Code每次启动都会自动加载它。我在每个中大型项目里都会维护一份内容包含项目背景和技术栈、目录结构说明、编码规范比如用单引号还是双引号、测试的命名方式、常用的构建命令、一些容易踩的坑和约定。一个具体的例子# 项目约定 - 技术栈Python 3.11 FastAPI SQLAlchemy 2.0 - 测试必须使用 pytest测试文件放在 tests/ 目录 - 数据库所有查询必须使用参数化禁止拼接SQL - 日志使用 structlog禁止 print 调试 - 运行测试poetry run pytest有了这份文件AI生成的代码会更贴项目。这里有个经验CLAUDE.md不是写给AI的说明书而是“给新同事的入职文档”加“给AI的项目上下文”的合体。你写的时候想象一下如果有个新人加入项目你最想让他立刻知道什么那就写什么。写得越具体AI的行为就越可预测。5. 常见问题与排查技巧实录用了这么久我遇到过不少奇葩问题。这一节整理成速查表每一条都是真实踩坑后的经验不是纸面推测。5.1 安装失败或命令找不到最典型的问题就是执行claude提示 command not found。排查思路按顺序来先node -v看Node版本低于18的直接升级然后npm config get prefix查看全局安装路径如果这个路径不在你的PATH里需要手动添加到shell配置。另一个常见问题是全局安装时没有权限这通常是因为用了系统级Node。我不推荐用sudo npm install正确做法是用 nvm 管理Node版本这样全局安装路径自动落在用户目录下不会碰权限问题。如果安装很慢可以给npm配置镜像源比如使用npm config set registry https://registry.npmmirror.com。这只是改下载源不出副作用装完之后不影响任何使用。5.2 对话越来越笨上下文爆了怎么办AI突然开始记不住需求、答非所问、频繁重复十有八九是上下文窗口快满了。先敲/status看当前上下文占用情况。如果占用超过50%建议执行/compact压缩历史或者再直接一点先/clear清空会话然后用--continue接着上一个会话的关键结论重新开始。很多人不知道--continue和/resume的区别前者是“接着最近一次会话继续”后者是“从历史列表里手动挑一个会话”。预防办法是大任务拆小任务别让一个会话里堆三四个不相关的需求。我习惯一个任务开一个会话需要接续时用--continue任务彻底完成后用/clear重置保证每个会话的上下文都用在刀刃上。5.3 AI拒绝执行操作或权限弹窗太频繁如果你遇到AI说“我没有权限修改这个文件”或“当前环境不允许执行此命令”大概率是权限模型设置了限制。解决方法是启动时用--allowedTools Read,Write,Bash显式授权或者直接用自定义斜杠命令里配好的权限范围。如果某个操作频繁触发确认但你确认过很多次AI都做得对可以在提示词里明确告诉它“后续同类操作直接执行不需要再询问”Claude Code会把这类指令记在当前会话的上下文里。如果弹窗实在太频繁影响心情可以检查一下是否有旧的settings.json配置文件覆盖了你的默认权限。终端里敲claude config list查看当前配置必要时用claude config set --global更新权限项。5.4 网络连接不稳定或模型切换使用过程中偶尔会遇到连接超时或请求失败。最简单的处理是重试Claude Code内置了重试机制但偶尔也需要手动重新发一次消息。如果频繁超时可以看下是不是你用的模型版本太大、响应太慢换成--model sonnet这类轻量模型往往能明显改善。这里不涉及玄学就是轻量模型的响应时延更短适合日常对话和代码生成。如果你所在的环境没有直接连接API的网络条件Claude Code支持通过环境变量ANTHROPIC_BASE_URL指定API的基地址这个在企业内网部署或使用兼容网关时很有用。配置方式也是在shell里export这个变量重启终端生效。除此之外动画输出、超长文件读入也会让请求变慢遇到性能问题时优先减少单次请求的上下文体积。5.5 快捷键冲突与终端兼容性快捷键不好使多半是终端的键位绑定抢先拦截了。比如iTerm2默认的Ctrl L可能是清除屏幕而不是传给Claude Code或者某些终端的Ctrl D绑定到了关闭面板。排查办法是先试在系统自带终端或干净环境里执行如果正常说明是终端软件的键位冲突去对应终端的键位设置里找。我个人在macOS上常用iTerm2用之前会额外检查Profile下的Keys配置把Claude Code需要的组合键设为“发送给shell”。另外如果你用tmux、zellij这类终端复用工具还要注意它们的prefix快捷键和Ctrl组合键可能冲突。我的处理方案是Claude Code日常直接用系统终端tmux里跑长期运行的命令两者互不干扰。快捷键这东西没有什么统一标准关键是先在纯环境里验证功能本身没问题再逐步排查是哪一层拦截了。最后再分享一个我自己的习惯。我把最常用的斜杠命令和CLAUDE.md模板沉淀到了一个dotfiles仓库里新机器上一键拉取立刻拥有一套完整的人机协作环境。Claude Code真正让我留下来的原因不是它能生成多惊艳的代码而是它把“读代码、找文件、跑测试、写commit”这些重复动作压缩到了极致。刚开始接触的朋友也不用急着背完所有命令先把claude -p、/compact、/init和CLAUDE.md这四件事用熟你的日常效率就已经超过大部分人了。