企业官网建设流程全解析

1. 为什么需要一份趁手的命令速查手册

刚接触 Claude Code 那会儿，我最常干的事就是一边翻官方文档一边敲命令，敲完还得回头确认参数对不对。这种割裂感特别影响思路——本来在琢磨一个重构方案，结果注意力全被“那个命令到底叫啥”给带跑了。后来我花了一个周末，把自己高频用到的指令、快捷键和工作流配置全部整理成一份速查表，贴在副屏上，效率直接上了一个台阶。

这份手册面向的是已经在用或者准备上手 Claude Code 的开发者，不管你是刚装好还没跑通第一条命令的新手，还是已经用了一阵但总觉得操作不够顺滑的老用户，都能从里面找到能直接抄作业的内容。核心覆盖三块：高频指令（会话管理、模型切换、上下文压缩）、快捷键（终端交互、编辑器联动）、以及高效工作流（CLAUDE.md 配置、多文件协作、版本升级）。我不会只列命令了事，每条指令背后为什么这么设计、什么场景下用、有什么坑，都会一并说清楚。

先给一个整体认知：Claude Code 本质上是一个跑在终端里的智能编程代理，它通过读取你的项目文件、理解上下文、执行命令来帮你完成编码任务。它的交互模式分两种——交互式会话和一次性命令。交互式会话是你输入claude后进入的持续对话环境，适合复杂任务；一次性命令则是claude -p "你的问题"这种直接返回结果就退出的模式，适合脚本集成。理解这个区分，后面的所有指令你都能找到自己的位置。

2. 核心指令全拆解：从会话管理到模型切换

2.1 会话生命周期管理指令

会话管理是日常用得最多的一类指令，因为 Claude Code 的上下文窗口是有限的，你得知道什么时候该压缩、什么时候该清空、什么时候该恢复之前的会话。

启动与恢复是最基础的操作。直接输入claude进入交互式会话，这是最常用的入口。如果你之前退出过一个会话，想接着聊，用claude --continue或者简写claude -c，它会自动加载最近一次会话的上下文。我实测下来，这个功能在排查一个跨天的问题时特别有用——昨天聊到一半的调试思路，今天接着来，不用重新解释背景。

如果想从一堆历史会话里挑一个恢复，用claude --resume或者claude -r，它会列出最近的会话让你选。这里有个细节：会话列表是按时间倒序排列的，最新的在最上面，用方向键选择就行。

上下文压缩是 Claude Code 里最值得花时间理解的机制。当对话变长，上下文快满的时候，你可以用/compact指令手动触发压缩。它的原理是把之前的对话历史总结成一段精简的摘要，保留关键信息，释放上下文空间。我一般会在完成一个阶段性任务后主动执行一次/compact，而不是等到系统提示上下文不足才动手。主动压缩的好处是你可以控制压缩的时机，确保重要信息不被意外丢弃。

注意：/compact压缩后的摘要会替换掉原始对话历史，所以如果你觉得某段对话特别重要，建议先用/export导出再压缩。

清空与退出方面，/clear会清空当前会话的所有上下文，相当于重新开始，但不会退出程序。/exit或者直接按Ctrl+C两次则是完全退出。这里有个容易混淆的点：/clear之后你的会话历史还在，可以用--resume找回来；但如果你在退出时选择了不保存，那就真没了。

2.2 模型切换与参数调优指令

Claude Code 支持在不同模型之间切换，这个功能在成本和效果之间做平衡时特别有用。用/model指令可以查看当前使用的模型并切换到其他可用模型。我通常的做法是：日常的代码补全和简单问答用轻量模型，遇到复杂的架构设计或者疑难 bug 排查时切到更强的模型。

切换模型时要注意，不同模型的上下文窗口大小可能不一样。如果你从一个窗口大的模型切到窗口小的，之前的长对话可能会被截断。所以我的习惯是：切换模型前先/compact一次，把上下文压到最小，再切。

温度参数虽然不能直接在会话里调，但可以通过配置文件设置。在~/.claude/config.json里可以配置默认的模型和温度值。温度低（比如 0.2）适合需要精确输出的场景，比如生成代码；温度高（比如 0.8）适合头脑风暴和创意类任务。这个配置是全局生效的，改完需要重启会话。

还有一个容易被忽略的指令是/cost，它会显示当前会话的 token 消耗和预估费用。我在跑长任务之前会先看一眼，心里有个数。特别是用强模型跑大批量重构的时候，这个指令能帮你避免月底看到账单时的心跳加速。

2.3 文件与项目操作指令

Claude Code 的核心能力之一是直接操作你的项目文件，所以文件相关指令必须熟练掌握。

/add指令用于把文件添加到当前会话的上下文中。比如/add src/utils/parser.js会让 Claude 读取这个文件的内容，后续的对话它就能基于这个文件来回答。我通常会在开始一个任务前，把相关的几个核心文件都/add进来，这样第一轮对话就能得到比较准确的回答，不用来回补充。

/drop则是从上下文中移除文件。当你发现某个文件已经不需要了，或者上下文太满想腾空间，就用它。这里有个经验：不要一次性 add 太多文件，上下文会被无关代码占满，反而影响 Claude 对核心问题的理解。我一般控制在 5 到 8 个文件以内，只加跟当前任务直接相关的。

/diff指令会显示当前工作区相对于上次提交的所有改动。这个在让 Claude 帮你 review 代码时特别有用——你先/diff让它看到所有改动，然后问“这些改动有没有潜在问题”，它就能基于完整的 diff 来回答，而不是只盯着你贴的那几行。

/undo是后悔药。如果 Claude 帮你改代码改坏了，用/undo可以撤销最近一次文件修改。但要注意，它只能撤销 Claude 自己做的修改，你自己手动改的它管不了。而且撤销是按操作顺序来的，不能选择性撤销某一次。

2.4 信息查询与帮助指令

/help不用多说，忘了什么指令就用它。但很多人不知道的是，/help后面可以跟具体指令名，比如/help compact，会显示这个指令的详细说明和可用参数。

/status显示当前会话的状态信息，包括使用的模型、上下文使用百分比、当前工作目录等。我习惯在开始一个复杂任务前先/status看一眼，确认模型和上下文余量都合适。

/review是一个比较特殊的指令，它会触发 Claude 对你当前项目的代码进行一轮自动 review，找出潜在问题并给出修改建议。这个适合在提交代码前跑一次，当作一道额外的检查关卡。实测下来，它对一些常见的边界条件问题和命名不规范问题抓得挺准，但复杂的业务逻辑问题还是得靠人。

3. 快捷键体系：让手指不离键盘

3.1 终端交互核心快捷键

Claude Code 跑在终端里，所以它的快捷键体系跟终端环境紧密相关。掌握这些快捷键，能让你在会话中的操作流畅很多。

Ctrl+C是最常用的中断键。当 Claude 正在生成回答，你发现它理解偏了想打断，按一次Ctrl+C就能停止生成。但注意，连按两次会直接退出程序，所以打断的时候按一次就够了，等它停下来再输入新的指令。

Ctrl+D是发送 EOF 信号，在 Claude Code 里等同于退出。跟Ctrl+C两次的区别是，Ctrl+D更“干净”，它会正常结束会话并保存历史。

Ctrl+L清屏，但不清除上下文。这个跟/clear有本质区别——Ctrl+L只是把终端显示的内容清掉，让屏幕干净点，对话历史还在；/clear是真的把上下文清空了。我经常用Ctrl+L来整理屏幕，特别是在一长串输出之后想看清楚最新的内容。

上箭头和下箭头用来翻阅历史输入。这个跟 shell 的历史记录类似，但范围仅限于当前会话。如果你想找更早的输入，得用Ctrl+R做反向搜索，输入关键词就能匹配到之前发过的内容。

Tab键在输入文件路径时有自动补全功能。比如你输入/add src/然后按Tab，它会列出src/下的所有文件和目录供你选择。这个在项目结构比较深的时候特别省事。

3.2 编辑器联动快捷键

Claude Code 虽然跑在终端，但它跟编辑器的联动能力很强。最常用的场景是：你在编辑器里选中一段代码，想问问 Claude 这段代码有什么问题。

在 VS Code 里，如果你装了 Claude Code 的扩展，可以用Cmd+Esc（Mac）或Ctrl+Esc（Windows/Linux）快速打开 Claude Code 面板。选中代码后按这个快捷键，选中的内容会自动带入 Claude 的上下文。

在终端里用 Claude Code 时，Ctrl+V粘贴是常规操作，但如果你粘贴的是多行代码，Claude Code 会自动识别并保持格式。我试过直接粘贴一个 200 行的函数，它完整接收了，没有出现格式错乱。

还有一个很实用的快捷键是Ctrl+O，它会打开一个文件选择器，让你快速把文件加入上下文，效果等同于/add但操作更快。我一般在项目里来回切换文件的时候用这个，比手敲路径快得多。

3.3 会话导航与搜索快捷键

当会话变长，往上翻找之前的内容会很麻烦。Ctrl+U和Ctrl+D在有些终端里是翻页用的，但在 Claude Code 的交互模式下，更推荐用/search指令来搜索历史对话内容。输入/search 关键词，它会列出所有匹配的对话片段，你可以直接跳转到对应的位置。

Esc键在 Claude 生成回答时按一下，效果跟Ctrl+C类似，也是中断生成。区别是Esc更轻量，不会触发退出逻辑。我一般打断用Esc，彻底停止用Ctrl+C。

如果你同时开了多个 Claude Code 会话（比如一个在跑重构，一个在写测试），可以用Ctrl+Z把当前会话挂起到后台，然后用fg命令切回来。这个跟 Linux 的作业控制是一样的逻辑，多任务并行的时候很实用。

4. 高效工作流搭建：从 CLAUDE.md 到多文件协作

4.1 CLAUDE.md 配置文件的正确写法

CLAUDE.md 是 Claude Code 的项目级配置文件，放在项目根目录下，Claude 在每次会话开始时会自动读取它。这个文件的作用是告诉 Claude 这个项目的背景信息、编码规范、常用命令等，相当于给 Claude 一份“项目入职指南”。

我见过很多人把 CLAUDE.md 写成了一篇冗长的文档，什么信息都往里塞，结果反而稀释了关键信息。我的经验是：CLAUDE.md 要短而精，只放 Claude 每次都需要知道的核心信息。具体来说，包含这几块就够了：

• 项目概述：一两句话说明这个项目是干什么的，技术栈是什么。
• 目录结构：关键目录的用途说明，让 Claude 知道代码该放哪里。
• 编码规范：命名约定、缩进风格、注释要求等。
• 常用命令：构建、测试、部署的命令，Claude 需要执行时会用到。
• 注意事项：有哪些坑不能踩，哪些文件不能动。

一个实际的 CLAUDE.md 例子：

# 项目概述 这是一个基于 Node.js 的 REST API 服务，使用 Express 框架和 PostgreSQL 数据库。 # 目录结构 - src/routes/ 路由定义 - src/models/ 数据模型 - src/services/ 业务逻辑 - tests/ 测试文件 # 编码规范 - 使用 2 空格缩进 - 函数名用 camelCase，常量用 UPPER_SNAKE_CASE - 每个导出函数必须有 JSDoc 注释 # 常用命令 - npm run dev 启动开发服务器 - npm test 运行测试 - npm run lint 代码检查 # 注意事项 - 不要修改 .env 文件 - 数据库迁移文件在 migrations/ 目录，不要手动改

这个文件我一般控制在 50 行以内，超过这个长度就说明有些信息不该放这里，应该放到具体的代码注释或者单独的文档里。

提示：CLAUDE.md 支持嵌套，你可以在子目录里也放 CLAUDE.md，Claude 会同时读取根目录和当前工作目录下的配置。这个特性适合 monorepo 项目，每个子包可以有自己独立的配置。

4.2 多文件协作与上下文管理策略

Claude Code 最强大的能力之一是跨文件理解和修改代码，但前提是你得把正确的文件放进上下文。我的策略是按任务阶段动态调整上下文，而不是一次性把所有相关文件都加进来。

具体操作上，我会把任务拆成几个阶段。比如一个“给用户模块添加邮箱验证功能”的任务，我会这么分：

第一阶段，先/add用户模型文件和现有的验证逻辑文件，让 Claude 理解现有的数据结构。问它“基于现有的用户模型，添加邮箱验证字段需要改哪些地方”，得到方案后再进入下一阶段。

第二阶段，/add路由文件和控制器文件，让 Claude 基于第一阶段的方案生成具体的代码修改。这时候可以把第一阶段不太相关的文件/drop掉，腾出上下文空间。

第三阶段，/add测试文件，让 Claude 生成对应的测试用例。同时用/diff让它看到前两个阶段的所有改动，确保测试覆盖了所有修改点。

这种分阶段的方式比一次性把所有文件都加进来效果要好得多。我实测过，一次性加 15 个文件的时候，Claude 的回答质量明显下降，因为它要处理的噪音太多了。控制在 5 到 8 个文件，回答的准确率和针对性都高很多。

还有一个技巧是用/compact做阶段切换。每完成一个阶段，执行一次/compact，把之前的对话压缩成摘要，然后开始下一阶段。这样上下文里始终保留着关键决策信息，但不会被细节撑爆。

4.3 版本升级与安装配置工作流

Claude Code 的版本更新比较频繁，保持最新版本能用到最新的功能和模型。升级方式取决于你当初的安装方式。

如果你是用 npm 全局安装的，升级命令是：

npm update -g @anthropic-ai/claude-code

如果你是用原生安装脚本装的，重新跑一遍安装脚本就会自动升级到最新版。升级完成后，用claude --version确认版本号。

安装过程中有几个常见的坑。权限问题是最常见的，特别是在 Linux 和 Mac 上，npm 全局安装可能需要 sudo，但用 sudo 装完之后又会出现权限归属问题。我的建议是配置 npm 的全局目录到用户目录下，避免用 sudo：

mkdir -p ~/.npm-global npm config set prefix ~/.npm-global export PATH=~/.npm-global/bin:$PATH

这样装出来的包都在用户目录下，不会有权限问题。记得把export PATH那行加到你的.bashrc或.zshrc里，否则每次开新终端都要重新设置。

网络问题是另一个常见障碍。如果你在公司内网或者网络环境受限的情况下安装，可能会遇到下载超时。这时候可以配置 npm 的镜像源，或者用代理环境变量。具体怎么配取决于你的网络环境，核心思路是确保 npm 能正常访问包仓库。

安装完成后，第一次运行claude会引导你完成认证配置。按照提示操作就行，认证信息会保存在本地，后续不需要重复登录。

4.4 与外部工具链的集成工作流

Claude Code 可以跟很多外部工具配合使用，形成更完整的工作流。我日常用得最多的几个集成场景：

与 Git 的集成是最基础的。Claude Code 可以直接执行 git 命令，所以你可以在会话里让它帮你git diff、git log、甚至git commit。我通常会让它先/diff看一下改动，然后根据改动内容生成 commit message，确认没问题后再执行提交。这样比手动写 commit message 快，而且描述更准确。

与测试框架的集成也很实用。你可以在 CLAUDE.md 里配好测试命令，然后直接让 Claude “跑一下测试看看有没有问题”。它会执行npm test或你配置的命令，读取输出，然后分析失败原因。我试过让它根据测试失败信息自动修复代码，对于简单的断言失败和类型错误，修复成功率挺高的。

与代码检查工具的集成类似。配置好 lint 命令后，让 Claude 跑 lint 并修复报告的问题。不过要注意，有些 lint 规则是团队约定，Claude 可能会“好心”改掉一些不该改的地方。我的做法是让它先列出所有问题，我确认哪些需要修，再让它动手。

与数据库工具的集成在开发阶段很有用。你可以让 Claude 直接执行 SQL 查询来验证数据，或者生成迁移脚本。但生产环境的数据库连接信息千万不要放进 CLAUDE.md，这是安全红线。

5. 常见问题与排查技巧实录

5.1 安装与启动阶段的典型问题

问题一：安装后运行claude提示命令找不到。这个几乎都是 PATH 没配好。先确认安装位置，npm 全局安装的话用npm root -g看全局包路径，然后检查这个路径下的bin目录有没有加到 PATH 里。如果是原生安装，安装脚本通常会提示你把某个路径加到 PATH，照着做就行。

问题二：启动时报认证失败。先检查网络连接是否正常，然后确认认证信息是否过期。可以尝试删除本地的认证缓存文件重新登录。缓存文件的位置在~/.claude/目录下，具体文件名跟版本有关，删之前建议先备份整个目录。

问题三：启动后界面显示异常，出现乱码或者排版错乱。这通常是终端不支持某些字符导致的。检查你的终端类型和字体设置，确保支持 UTF-8 编码。如果是 Windows 的 cmd 或 PowerShell，建议换用 Windows Terminal，兼容性好很多。

5.2 会话过程中的高频故障

问题四：上下文满了，但/compact之后感觉 Claude 变“笨”了。这是压缩的固有代价——摘要不可能保留所有细节。我的应对策略是：在/compact之前，把关键决策和结论手动记下来，压缩后如果发现 Claude 忘了重要信息，直接把笔记贴给它。另外，压缩的时机很重要，不要在任务做到一半的时候压缩，最好在阶段切换时做。

问题五：Claude 修改了不该改的文件。这个我踩过好几次坑。根本原因是上下文里包含了那些文件，Claude 觉得它们跟任务相关就顺手改了。预防措施是在 CLAUDE.md 里明确写出“不要修改”的文件列表，同时在/add文件时只加真正需要的。如果已经改坏了，用/undo撤销，或者用 git 恢复。

问题六：生成的代码风格跟项目不一致。检查 CLAUDE.md 里的编码规范是否写清楚了。如果写了但还是不对，可能是规范描述不够具体。比如“使用 2 空格缩进”不如“使用 2 空格缩进，不要用 Tab，函数之间空一行”来得明确。规范越具体，Claude 执行得越准确。

问题七：执行命令时卡住不动。有些命令会等待用户输入，Claude 执行时就会卡住。遇到这种情况按Esc中断，然后检查命令是否需要交互式输入。对于需要交互的命令，可以在命令后面加上非交互式的参数，或者用echo管道传入输入。

5.3 性能与成本优化技巧

问题八：响应速度慢。影响速度的因素有几个：模型选择、上下文大小、网络延迟。切换到轻量模型能明显提速，压缩上下文也能减少处理时间。如果网络延迟是瓶颈，那就只能忍了，或者换个网络环境好的时候用。

问题九：token 消耗太快。几个优化方向：一是控制/add的文件数量和大小，大文件可以只加关键部分；二是及时/compact，避免上下文无限增长；三是简单任务用轻量模型，别什么都上强模型。我自己的经验是，做好这三点，token 消耗能降一半以上。

问题十：/cost显示的费用跟预期不符。检查一下是不是有后台会话在跑。Claude Code 的计费是按实际 token 用量来的，如果你开了多个会话同时跑，费用会累加。另外，/compact本身也会消耗 token，因为压缩过程需要模型来处理。

5.4 问题速查表

6. 把工具用成自己的手感

说了这么多指令和配置，最后想聊一个更本质的东西：工具的价值不在于功能多全，而在于你用得多顺。我见过不少人装了 Claude Code，用了几次觉得“也就那样”就放下了。问题往往不是工具不行，而是没找到适合自己的使用节奏。

我的建议是，先从最简单的场景开始——比如让它帮你写一个函数的单元测试，或者解释一段你看不懂的代码。用顺了之后，再逐步把更复杂的任务交给它。CLAUDE.md 也是，一开始不用写得太完整，用着用着发现“这个信息每次都要重复说”，就把它加进去。让配置跟着你的实际需求长出来，而不是一开始就追求大而全。

快捷键这块，不用刻意去背。你只要记住最常用的那几个——Ctrl+C中断、/compact压缩、/add加文件——剩下的在用的过程中自然会记住。我到现在也记不全所有快捷键，但常用的那几个已经形成肌肉记忆了，这就够了。

还有一个我自己的小习惯：每周花十分钟回顾一下这周用 Claude Code 做了什么，哪些操作重复了三次以上，就想想能不能用 CLAUDE.md 或者别名来简化。这个习惯坚持了几个月，我的工作流已经比刚开始时顺畅了不止一个档次。工具是死的，手感是活的，多琢磨怎么让自己少敲几个键、少切几次窗口，效率自然就上来了。